Related lists are records that have relationships to the records of the selected table. For example, if you view a Computer (cmdb_ci_computer) record, you will see the related lists at the bottom that show relationships to Software Instances (i.e. the installed_on field on the cmdb_software_instance table is a reference to the cmdb_ci_computer table) and Storage Devices (cmdb_ci_storage_device) among other relationships. With the Share Related Lists option on bulk shares, you can choose to share the related records from Software Instances and Storage Devices as well.

You can share related list records, in addition to your choice of one of the main share options:

Prerequisites


(warning) First, you will need to install DataSync for ServiceNow and run the Perspectium Finish Install scripts.

(warning) You will also need to create a shared queue.

Procedure 

To start selecting which related records you want to share, follow the procedures below:


Navigate to Bulk Share

In ServiceNow's left side navigation window, navigate to Perspectium > Replicator > Bulk Share or simply type and then click on Bulk Share.

Create a bulk share 

Follow the steps to create a bulk share without clicking Execute Now.

Enable additional settings

This feature can be used in conjunction with Share child class only, Include all child tables, or Share selected table only.

Under the Additional Settings tab, enable one of the three options listed above. 

(info) NOTE:

  • Exactly one of these three options must be checked in order to save and execute the Bulk Share.
  • Checking Share selected table only shares out base table records only. This has the same effect as not checking either Include all child tables or Share child class only

Check Share Related Lists

Check the Advanced box to access the Advanced tab.

In the Advanced tab, check Share Related Lists

Choose the related list

Click to unlock the Related Lists list. Search for a specific related list by typing in the search bar, or hit the search button to see all related lists of the selected table.

In the example above, the bulk share is set on the Computer (cmdb_ci_computer) table. There are two related lists chosen to share records from, in addition to the Computer table, cmdb_software_instance.installed_on and cmdb_ci_storage_device.computer.

Save or execute your bulk share

Click the Save button at the bottom of the form to save the configurations for your bulk share. Once your bulk share configurations have been saved, you can click back into the bulk share record and click the Execute Now button at the bottom of the form to bulk share out the specified records immediately. Alternatively, you can choose to run a bulk share at specified interval(s) by creating a scheduled bulk share.

Upon execution, records from the related lists selected will be shared out, in addition to records from the bulk share table, which we can see in the list of Records ProcessedIf a record from the Computer table contained records in either its Software Instances related list or its Storage Devices related list, those records were also shared out.