An Object relationship map is a visual representation of a bot and all interactions between objects. They are generated for each bot and every job within a bot only if the bot has been added to a Project using the Projects feature.
- Learn more about how to create a new Project and add an existing bot here.
- Learn more about how to manage existing Projects here.
Locate Object Relationship Maps
Object relationship maps are found within existing Projects using the Projects feature.
- Navigate to the top menu bar and select Projects.
- Click on an existing Project and select View.
Object Relationship Map - Bots
Find the object relationship map for a bot within a Project.
- Click on the "Bots and Related Objects" dropdown option to expand it.
- Select the map icon next to any bot.
- Once selected, the object relationship map for the selected bot will appear on the right side of your screen.
Understanding Object Relationship Maps - Bots
Object relationship maps generated for bots will include the following information:
- The title of the bot or job that is displaying an object relationship map
- Checkboxes to display Data Sources and/or Data Targets in the object relationship map. Uncheck any box to remove that object from the displayed map. Fill any box for that object to reappear in the displayed map.
- Reset Diagram - drag/drop or zoom in/out on the object relationship map being displayed on the screen. Reset viewing settings by clicking on the "Reset Diagram" option.
- Print Diagram - print the object relationship map and any attached objects.
- Object relationship map - represented by boxes and connections. Each box contains an icon on the left side indicating what that object is. Refer to the icon key below.
Icon Key
Use the following key to understand what each icon inside of a box means.
| Icon | Description |
| Data sources being imported in a bot or used as the input data source for a job within a bot or referenced in a job as an attached object. | |
| Jobs included in a bot. | |
| Data Targets that are configured in any job included in a bot. |
Attached Objects
Attached objects are any external or internal data sources, data service providers, or Marketplace tables referenced in a job. Jobs containing task templates, which reference other objects, will contain a blue bubble next to their name.
- However over a blue bubble on the map to pull up additional information about the attached object being referenced in a job. Attached objects will be listed on the far right side.
- The attached objects section will list the name of the job within the bot that is referencing an object.
- The name of the object being referenced in the job will be displayed directly below. An icon on the left of the name will indicate what type of object is being referenced.
Example
Below is an example of a Salesforce Lead to Account Matching bot and its object relationship map.
The bot is configured to import the Salesforce Lead, and Account data sources before purging the first two L2A jobs. The bot then runs all L2A matching jobs in the process. The object relationship map below visualizes what is happening in this bot.
- Each trunk begins with an input data source that is associated to the bot. This trunk begins with the Salesforce Leads data source. It chains all jobs, data targets, and attached objects from the bot that depend on this data source.
- This trunk begins with the Salesforce Accounts data source. It chains one job from the bot that is dependent on this data source.
- Trunks can also produce branches. Branches are created when one jobs outputs are used as the input data source to another job. The input data source to job L2AExtra01 is the output of job L2A02.
- You may use a manual data source created in one of your jobs as the input data source for a different job. To identify where a manual data source was created, click on any box containing the input data source/manual data source icon, and then select "Highlight All Occurrences".
For instance, this trunk uses the manual data source created in job L2AExtra01 as the input data source to job L2AExtra02.
Object Relationship Map - Jobs within a Bot
Find the object relationship map for each job included in a bot within a Project.
- Click on the "Bots and Related Objects" dropdown option to expand it.
- Click on any bot to expand it.
- Select the "Jobs" option to see all jobs associated to the bot you selected.
- Select the map icon next to any job.
- Once selected, the object relationship map for the selected job will appear on the right side of your screen.
Note: Refer to the 'Understanding Object Relationship Maps - Bots' section above for items that are the same for bots and jobs.