Disable sync

Owned by Evgeniy Ermolaev, created
Last updated: Jan 03, 2024
4 min read

To disable the integration, follow these instructions

 Prevent Salesforce from sending data to the Adobe Commerce

A step-by-step guide:

  1. Log in to your Salesforce Org

  2. Click the nine-dot menu in the top-left corner of your page

  3. Type the “Powersync“ in the search box

  4. Click the “PowerSync Settings“ menu item

  5. On the “Powersync Configuration“ page:

    1. untick the “Push Changes To Magento“

    2. untick all checkboxes under the “Automated Synchronization Settings“

    3. click the “Save“ button

 Prevent Adobe Commerce from sending data to Salesforce

A step-by-step guide:

  1. In the Adobe Commerce admin area, open the Salesforce primary menu item

  2. Click on General Configuration

  3. On the Configuration page, under the Salesforce API section, change the Integration Mode dropdown to Disabled

  4. Click on the Save Config button to save your changes

 

Extensions tnw/salesforce=2.10.60 and tnw/sforceenterprise=2.10.65 and later versions have the following improvements to this process:

  • This action will stop all consumers and disable all CRON jobs. Consumers and CRON jobs will remain stopped until the integration is disabled.

    • Also you can kill all consumers manually by the command (it could require root permissions):

      kill $(ps aux | grep 'queue:consumer[s]\?:start tnw' | awk '{print $2}')

  • Entity updates and creation will NOT be tracked while the integration is disabled.

 

Once you enable the integration - the consumers will restart and CRON jobs will be scheduled to process your data. We assume here all crons and cosumers were configured according to our documentation:

Advanced (data cleanup)

If you choose to clean up the database and files related to this integration, follow the instructions below.

There are three areas of focus:

  1. File Logs

  2. Database Logs

  3. Pre-queue Records

  4. Queue Records

File Logs

There is no risk to remove these at any point. These files only contain information for past data sync processes (successful and failed).

Our integration stores file logs in the following folder

{adobe_commerce_root_folder}/var/log/sforce

Feel free to delete all files in this folder at any point.

Database Logs

  1. In the Adobe Commerce admin area, open the Salesforce primary menu item

  2. Click on Synchronization Log (DB) menu item

  3. Click on the Clear Table button (see image below)

There is no risk in clearing these records and you can do this at any point.

Pre-queue Records

  1. In the Adobe Commerce admin area, open the Salesforce primary menu item

  2. Click on Scheduled Entities menu item

  3. Use Select All and Delete mass action to remove all records from this table (see image below)

IMPORTANT: These are entities that have changes and they are scheduled for further processing. Deleting these records will remove them from the synchronization process. You will have to manually re-synchronize these records in the future if needed.

Queue Records

IMPORTANT: Following these steps will remove all data pending synchronization from Adobe Commerce to Salesforce. It is possible that some data might be partially synchronized to Salesforce and this action will NOT remove/delete partial data from Salesforce.

  1. In the Adobe Commerce admin area, open the Salesforce primary menu item

  2. Click on From Magento (old) menu item

  3. Click on the Clear Queue button to empty this table

FAQ

I don't see the menu items you are referencing under Salesforce main menu item

  1. In the Adobe Commerce admin area, open the Salesforce primary menu item

  2. Click on General Configuration

  3. On the Configuration page, under the Advanced section, change the Developer Mode dropdown to Yes

  4. Flush Magento cache

  5. Now you should be able to see the menu items (see the image below)