Managing Custom Salesforce Objects

When you use custom objects with protected fields in Salesforce you need to register them within the InCountry Data Residency for Salesforce package, so that the regulated data will be correctly processed and written to the InCountry platform.

note

Management of custom objects is required for operation of the restriction, redaction, and UI-based replication models from the three-model package.

Creating the custom object Lightning page

1. From Setup, click User Interface, then select Lightning App Builder.

   

2. On the Lightning App Builder page, click New.

   

3. In the Create a new Lightning page form, select App Page.

4. Click Next.

   

5. Enter the label for the page and click Next.

   

6. Select the One Region as page layout and click Finish.

7. On the opened page with Layout Builder, on the sidebar, locate the InCountry List View component (within custom components).

   

8. Drag this component to the layout.

   

9. For the added component, fill out the following information:

   • Object Api Name - enter the API name of a custom object that you have created.

   • Country Field Name - enter the field which contains information about the country which a custom object attributes to. The InCountry Data Residency for Salesforce package will use this field to redact data in regulated fields according to the configuration.

     

10. When complete, click Save.

11. Then you will be prompted to activate the layout, click Activate.

12. In the Activation: {OBJECT} form, click Save. Additionally, you can choose another icon.

13. Click Save.

14. Click Finish.

Creating a tab for a custom object

To show a custom object within an application in Salesforce, you need to create a tab for it.

1. From Setup, click User interface and then select Tabs.

   

2. On the Tabs page, click New.

   

3. Fill out the following information for a new tab:

   1.Lightning Page - select the page which attributes to the custom object you want to add.

   2.Tab Label - enter the label of the tab which will show records pertaining to the custom object.

   3.Tab Name - update the tab name or leave as is.

   4.Tab Style - select the appropriate tab style.

4. When complete, click Next.

   

5. Regulate the visibility to the available user profiles.

6. Click Save.

Adding the created tab to the InCountry Data Residency for Salesforce package

1. From Setup, click User Interface, then select App Manager.

2. On the list with registered apps, locate the app containing 'InCountry' in its name.

   

3. For this app, click the down arrow icon and select Edit.

   

4. Within the app details, switch to the Navigation Items tab.

   

5. Locate the tab which attributes to your custom object and click Add,

6. When complete, click Save.

Creating custom global actions

note

Please consider that custom objects from other installed packages may not be fully supported. Such objects have names according to the following pattern [namespece_prefix]__Custom_Object_Name__c. Global actions do not tolerate two consecutive underscores in their names. The List View and Record Detail components are supported, the standard actions (like New) are not supported yet.

1. From Setup, click User Interface and then select Global actions.

2. On the Global Actions page, click New Action.

   

3. On the New Action page, fill out the following information:

   • Action Type - select 'Create a Record'.

   • Target Object - select your custom object.

   • Standard Label Type - select ‘New [Record]'.

   • Name - enter the name of the action according to the pattern NewCustom_Object. You need to replace spaces between parts of the custom object API name with underscore and remove the prefix (__c) if it is present in the object API name. For example, if your custom object has the API name as Custom_Object__c, so the name of the global action should be NewCustom_Object.

     

4. Click Save.

5. Drag the fields to the layout of the form for creating new records of your custom object.

   

6. When complete, click Save.