Troubleshooting

If you're encountering some oddities during the integration, here's a list of resolutions to some of the problems you may be experiencing. If you have any problems or requests, please contact TextMaster support.

Common issues

Translated Content Not Appearing on SFCC

If your translation projects are complete on TextMaster but you can’t find your translated content on SFCC, several issues could be the cause:

• OCAPI Permission Issues on SFCC

Make sure that OCAPI permissions are correctly set up on SFCC. Verify that the OCAPI credentials are correct. Check the configuration of the site path and storefront password.

• Server Blocking External Callbacks

If your server blocks external callbacks, ensure it allows connections for the necessary operations. Check for any callback errors by navigating to TextMaster > API & Loop > View My Callbacks and verifying if there are any errors.

Page Designer Content Not Available

If your Page Designer content is not displayed in the SFCC plugin, this means that you must first run a Job in SFCC to enable the plugin to find this content.

Context: Page Designer content is not immediately available upon plugin installation because there are no straightforward API methods to retrieve lists of Page Designers and Page Components. The plugin’s user interface may have difficulty accessing data for these objects.

To address this:

• A custom cache-based mechanism is used to export Page Designer and Page Component content.

• After integrating the cartridge, convert all page data to a custom cache so that the plugin can access it.

How to fix

To update custom cache for Page Designer content, execute the job TextMasterConvertPagesToCache<siteID>

• This job is not required for regular updates but must be executed whenever a manual change is made to page data. Before an export session, execute this job to ensure that recent changes are reflected in the custom cache and export page.

• A single execution of this job is sufficient after any manual data update.

Verify your changes

Go to Administration panel > Jobs and select TextMasterConvertPagestoCache

• In the Job Steps panel:

  • Confirm that the Library ID is correct.

  • Ensure the Scope is set to the appropriate site, the one including the content.

In Merchant Tools > Site Preferences > TextMaster:

• Verify that the OCAPI Client ID and Password are filled in correctly and are valid.

• Confirm that the Storefront Password is correctly filled in and valid.

Tips: Once these verifications have been made, be sure to restart the job and ensure that the content is now available on the plugin.