Enabling the debug mode

The InCountry Data Residency for Salesforce package allows you to activate the debug mode when the package works with the replication data regulation model. This mode lets you track the process of saving data records to the InCountry platform and ensure that they first appear on the InCountry platform and only then are replicated to Salesforce.

Prerequisites

1. The replication model is enabled for the Salesforce organization.

2. The Chatter component is enabled at Setup > Chatter > Chatter Settings.

   

3. The Chatter component is available on Flexipages.

   

How to enable the debug mode

1. From Setup, click Custom Code, then select Custom Metadata Types.

2. On the list with custom metadata types, locate InCountry Flags and click Manage records for it.

3. Add a new entry: DEBUG_MODE_ENABLED.

   

4. From Setup, click Objects and Fields, then select Object Manager.

5. On the list with objects, locate the User object and click it to open.

6. On the navigation sidebar, select Fields & Relationships.

7. On the list with fields, locate the InCountry Debug Mode (DebugMode__c) field and click it.

8. Ensure that FLS is configured for your user.

   

9. From Setup, click Objects and Fields, then select Object Manager.

10. On the list with objects, locate the User object and click it to open.

11. On the navigation sidebar, select User Page Layouts.

12. Add the DebugMode__c field to the user page layout.

    

13. In the top right part of the screen, click your user avatar.

14. Select Settings.

    

15. On the navigation sidebar, select Advanced User Details.

    

16. Click Edit.

17. In the InCountry Debug Mode box, select Replication.

    

How to use the debug mode

1. Select the regulated object and go to the corresponding list view for it.

   

2. Click New and create a new record.

   

3. Click Save and take a note that regulated data has not been saved to the Salesforce database.

   

4. Copy the record id from the URL and select the Find in InCountry tab.

5. Ensure that the record has not been created yet on the InCountry platform.

   

6. Append the _debug snippet to the record id and ensure that the debugged record has been created on the InCountry platform. Such record retains a Salesforce Apex memory stamp. This information will be used during the next steps.

   

7. Return to the created record, scroll down to the Chatter component and find the following message.

   

8. The message says that the pre-commit was performed, but the record has not been synchronized yet. Click the link below the message. You will be redirected to the Debug Mode Visualforce page.

   

9. On the opened page, you can view the synchronization status. Click Synchronize Record.

   

10. You will see a request to the InCountry platform and a response from it. Now, return to the Find in InCountry tab and ensure that the record has been created.

    

11. Return to the record and ensure that it still remains in the pre-commit state.

    

12. Check the next Chatter post.

    

13. Navigate to the page again. Click Perform Post-commit. You will see a request to the Salesforce database and a response from it.

    

14. Return to the record and ensure that it is in the post-commit state (a regulated/protected value should be in Salesforce).