View a component usage report for multiple project components

You can select a project component and create a report that shows the complete hierarchy of references. This report provides more details than when you select a component and choose Details to open the Where Used tab. On the Where Used tab, you can see the list of components that directly reference the selected component. If you want to trace those parent components all the way back to their first reference, you can create a component usage report. When you select multiple project components to report on, you get a separate report for each one.

Tips and tricks

To view a component usage report for multiple project components:

  1. Click Projects.
  2. On the Project Management tab, find the project that includes the component you want to create a report for.
  3. To open project details, select the project and double-click it.
    You can also open a project by:
    • Right-clicking the project and then selecting Open.
    • Clicking the Options menu and then selecting Open.
  4. In the Content pane, select the checkbox for the components you want to run reports on.
  5. On the Selected Components panel, select Reports, and then Component usage report.

  6. On the Convert Time screen, select one of the following options:

    • Yes. Changes all dates and times in the report to reflect the Time Zone specified in your Profile. (To change your Time Zone, follow the steps in: Select your time zone.)
    • No. Displays all dates based on the Time Zone where your Inspire server instance is located.
    Results:
    When you run a report on multiple components:
    • Inspire always creates a separate report for each component
    • You see a notification for each report process that starts
    • You see another set of notifications for each report that has been created
  7. In the top menu, click Notification TopMenu Notifications.

    You do not receive a copy of the report in email or Slack, and it cannot be configured.

  8. From the list of notifications, select any with a Subject of Component Usage Report.

    There is no way to tell from the Subject or Summary which component is included in the report.

    • Both the Subject (Component Usage Report) and the Summary (A component usage report request is completed.) only provide generic text.
    • To see which component is included in the report, you will have to open each notification.

    For each separate report that Inspire creates, it adds the component name to the report's CSV file name

  9. To download a report, click the link containing the name of the CSV file.
  10. On your local computer, open the report to see the details.

    Results: There are two columns in the spreadsheet.

    • ComponentNames. This is the first column, which lists the names of components that, at some level, reference the selected component. A greater-than sign is used as a separator, and the selected component is always listed last.
    • ComponentFilenames. The second column lists the same hierarchy except that the display names are appended with the GUID to create the full filenames.

    The following sample report has been modified to add bolding and color.

    The report can be visualized in the following hierarchical relationships:

    • The root-level component is shown in Bold.
    • On the left side:

      • is directly referenced by .

      • has a relationship with because it is a branched copy of .

      • is not directly referenced by the map.

      • is directly referenced by the map.

    • On the right side:
      • is directly referenced by .
      • is directly referenced by the map.