Open up your Salesforce Org in the Elements Catalyst Org Model
You have sync’d your Org metadata to the Org Model in Elements Catalyst. It uses the Tools and Metadata APIs. You can automate the sync to run nightly.
The trial only syncs the Salesforce core metadata, but you can also add managed packages to the sync.
Now all the metadata is in the Elements Catalyst Org Model, the magic can happen.
The Org Model may be the first time you’ve seen a perspective of your Org like this. The reaction may be “WOW”, “OMG” or “Ahhh, that’s why…”.
How big is your Org? We’ll give you a summary on the right panel.
Log into Elements. It runs on the AWS platform, not inside Salesforce. Go to http://Elements.cloud or http://app.Q9elements.com/signin. You can login using your Salesforce credentials by clicking on the LOGIN WITH SALESFORCE button.
Now you have logged into Elements Catalyst you need to open the Org Model.
Select Salesforce Orgs in left menu. You will see just one listed but there could be multiple Org Models each one sync’d to a different Production or Sandbox Org.
Click on the name of the Org Model to open it in a new browser tab. It is an explorer view and you get a summary of your Org in the right panel.
Resist the urge to start opening up the tree structure. Instead, click on the “Launch Salesforce Org Analytics” in the top bar to run the report. It gives you some powerful insights into your Org. The report opens up in a new tab in the browser and can be run at any time as it builds the report from the latest Org Model data. Let’s look at that first.
The Org Analytics Report
Take a quick look at the contents on the left of the report to see what is currently provided. Click on any item in the contents panel to go to that section. The report is interactive. You can filter and sort the graphs. This is more detailed than Salesforce Optimizer and is focused on the configuration of your Org and how well documented it is.
The analysis in the Org Model and the Org Analytics report has been designed to help you focus your efforts on clean-up and documentation. It reduces the detective and analysis work for you.
Navigating the Org Model explorer view
Let’s go back to the Org Model in the other tab and start to drill into the Org Model. You can see that it is an explorer / tree structure and if you click on the arrow alongside any item (we call them nodes) you can expand it to see the next level of detail (child nodes) and so on down multiple levels.
The node has the name of the customization (e.g. the Object name) and in italics the description field is pulled from Salesforce, if a description field exists for that type of customization. Not everything in Salesforce has a description field, such as Apex Classes or Lightning pages.
The columns - Tags, Status, GDPR, # of links - can be dragged to change position and size.
You can automate the sync to run nightly. If an item in Salesforce is deleted, then the next time the sync runs the Org Model shows the Status as deleted but keeps it in the tree structure along with any documentation you may have linked to it.
Whenever you select a node, the right panel gives specific information for that node. In the image below the custom object Project has been selected.
The Org Model right panel
Click on the top level of the Org Model (the top row of the tree “Salesforce Production”) and the right panel gives you an overview of all customizations in both the core and managed packages, if you have added managed packages to the sync. The right panel scrolls so you can see more information. If you click on the SYNC HISTORY tab you can see the history of the previous syncs, but you can also kick off a new sync from here.
For every node in the right panel, there is a DETAILS, DOCUMENTATION and COMMENTS tab.
The DETAILS tab has the information that is available through the Salesforce APIs. It varies for each type of node in the Org Model. There is also a link to open up that customization in Salesforce Setup if a setup page exists for it.
The DOCUMENTATION tab is where you can add documentation. This can be notes, URL links, Data Tables (metadata on metadata), process diagrams and requirements. More on this later.
COMMENTS is like a Chatter stream for every node where you can @mention colleagues. The free Viewer license allows the posting of comments.
Open up the Objects section. There will be a Standard Objects section and if you have custom objects then there will be a Custom Objects section.
Click on an Object and the right panel gives a summary of the object including the number of records by record type. Just keep scrolling down the right panel.
Objects have an additional tab, USAGE. This shows which fields (system, standard, custom) have data in them. Remember all those custom fields that were asked for? Now you can see if they were even used.
Click on USAGE and then filter the fields by Custom.
Fields have several additional tabs;
- USAGE shows how populated fields are by record type and also where fields are used. The analysis covers email templates, page layouts, reports, automation and rules.
- The ACCESS tab shows the field access by user for permission sets and profiles. This needs to be requested on demand as it is a huge analysis task. That’s why it is not done for every field in every object every time the sync is run. There is a link in the tab to kick off the analysis and collect the data which is done asynchronously.
- GDPR collects the data required for GDPR compliance (outside scope of this trail - see other knowledge articles or engage with us at firstname.lastname@example.org)
The USAGE and ACCESS analysis would be impossible to do manually and keep up-to-date.
Every item that can be edited in Salesforce Setup will have a link that will open it in the specific page in Setup. It is either “Salesforce Setup” or it is a blue cloud icon. This saves so many clicks, time and frustration.
Drill down the tree structure in an Object to a Field.
Look at the DETAILS tab and then the USAGE tab. Keep scrolling down the USAGE tab.
Open up one of the areas where the Field is used, i.e page layout. Click on the icon to launch Salesforce Setup to edit that item. How many clicks and how much time did that save!
Managed packages are included in your sync. The metadata for each managed package is in its own tree structure. This is found below the tree structure for the core metadata. The right panel at the top level of each managed package gives the summary data.