Managing Catalog Part Usage data

Managing Catalog Part Usage data provides the details of the number of instances (or usage) of part family items from a chapter. You have to generate the part usage data by executing a batch process after selecting the chapters on which the part usage data has to be computed. To update the part usage data, you have to periodically run the batch process. You can access the computed part usage data by selecting the chapter and then clicking View Part Usage from the Edit section of the action bar.

Required access roles:

Baseline: Leader

This task shows you how to:


Before you begin: The DWH (Data Warehouse) server to store part usage data.

Use Catalog Part Usage Batch Tool

This shows you how to launch the Catalog Part Usage Batch tool for generating the part usage data.

  1. Select Utility from the Tools section of the action bar.
    The Batch Monitor appears.
  2. Double-click the CatalogPartUsage.
    The CatalogPartUsage dialog box appears.
  3. Click 3DEXPERIENCE Platform Object Search to search the part usage data for the selected chapters and sub-chapters.
    The 3DEXPERIENCE Platform Object Search dialog box appears.
  4. Type your search criteria.
    For more information about search, see 3DEXPERIENCE Basics | Search.
  5. Select Add Results to display the part usage data in the Search results or Replace Results to replace the current search results.
  6. Click Apply to get the list of chapters resulting from the search criteria.
  7. Click OK once you are satisfied with the list of displayed chapters and return to the CatalogPartUsage dialog box.
  8. Select the chapters you want to remove from computation and click Removes the selected objects from the list
  9. Enter the path in the Report Directory box to store the reports and processed documents.
    You may also browse the file tree by using the Change the Target Directory
  10. Enter the name of the report in the Report name box. By default, the report is generated in HTML format.
    This is a global report dealing with all the chapters that have been processed.
  11. Enter a search string in the Suffix for object report box to add an extension at the end of each report file name.
  12. Click Run to run the batch from the interface of the selected batch or click Cancel to close the CatalogPartUsage dialog box and go back to the Batch Monitor dialog box (if you want to start other batches for instance).
  13. From the batch interface, click Open Main HTML Report which is activated as soon as a report has been generated. This opens directly the global report in HTML format. You can also visualize the report by opening the result file from the directory where it has been saved.
    In addition to this global report, the batch also creates an individual report for each processed document in the report directory. For detailed information about the computation for any one chapter, click OK or KO. The Results appears.
    Note: If a GlobalResults.htm file already exists, it is automatically replaced by the new one.
  14. Click Save to save the part usage data in an xml file.
    The Save As dialog box appears.

    By default, the input parameters xml files are saved in a temporary folder. When saved, this file can be used later on to run the batch directly without having to re-access the batch interface.

Display Part Usage

This task shows you how to view the part usage data on a selected chapter.

  1. Type the search string in the Search box on the top bar and press Enter or click .
    The search results list appears with available catalogs displayed.
  2. Right-click the selected catalog, and click Explore.
    The Design IP Classification appears with the selected catalog displayed.
  3. Right-click the catalog structure and select Expand All.
  4. Select the desired chapter and click View Part Usage from the Edit section of the action bar.
    The result of part usage data appears. An error message appears if the part usage data is not already computed.
    Note:
    • The part usage data is computed once the batch process is run on a chapter, even if the chapter does not have any part family item.
    • There is no display of visual mask in the catalog structure to indicate if a part usage report has been generated.
    • The part usage data do not get exported, when you export the required catalog.