Reporting Using CATUtil

You can work with a batch, whose inputs are defined through a dialog box, in order to generate unitary reports.

A V6 batch is a non-interactive program requiring an xml file that contains parameters defining inputs and outputs and that provides:

This task shows you how to:

Before you begin: There are two ways to launch CATUtil:
  • From an interactive session, select Tools > Utility.
  • From a MS-DOS window, type catstart -env LocalEnv -run "CATUtil". The Batch Monitor dialog box is displayed, listing all available batches.
Related Topics
Creating Reports

Create a New Parameter File

You can first create a new parameter file.

  1. From the Utilities tab of the Batch Monitor dialog box, right-click UnitaryFastenerReport and select New parameter file.

    The UnitaryFastenerReport dialog box opens:



  2. Click ENOVIA V6 Object Search to choose the products containing the fastener sets from the database.

    The Enovia V6 Object Search dialog box is displayed.

  3. For instance, fill in the Part Number field:



  4. Click Apply to import the results into the UnitaryFastenerReport dialog box and click OK to close the Enovia V6 Object Search dialog box.



  5. Select the products you do not need and click . Here are the selected products:



  6. Select the Unitary Report directory.

    The dialog box enables you to customize the report through several options:


    • Long report: Adds projection results, user-defined additional information and fastener components information for each fastener
    • Include comments: Specifies that the report starts with the commented header block showing keywords description.
    • Ordered zones sorting: Specifies how the joined parts specifications are ordered.
    • Translate coded values: Defines attribute values belonging to a predefined list of codes are translated according to the NLS set-up.
    • Unit: Either be millimeter or inch.
    • Real numbers precision: Number of decimal digits of all the real numbers written in the neutral file and of the discretization values displayed in the dialog box above. This number is comprised between 0 and 10.
    • Scientific notation: Used in the report (power of 10)

  7. Select the Report directory in which the unitary report will be executed.

  8. Optional: Modify the Report name and the Suffix for the object report.

  9. Click Save to save the parameters in the xml file.

  10. In the Save As dialog box, select the xml file and click Save.

    The xml parameter file is automatically generated.

    Tip: Provided you have already saved unitary Report parameters from in an xml file, you can right-click anywhere in the FastenerunitaryReport dialog box and select the Read input from parameter file... contextual item to retrieve these parameters.

Run the Report Batch

You can run the report batch from two different dialog boxes.

From the UnitaryFastenerReport dialog box

You can run the batch from the UnitaryFastenerReport dialog box.

  • Click Run to run the batch process.

    The xml parameter file is generated in the default repository.

From the Start tab of the Batch Monitor dialog box

You can run the batch from the Batch Monitor dialog box.

  1. Right-click Run to generate the report again.

    The Processes tab enables to follow the progress and status of launched batches.

    The following information is displayed:


    • name of the batch
    • name of the parameters file used to run the batch
    • status of the batch ("Ended", etc.)
    • start and end time, respectively in the "Beginning at" and "Ending at" columns
    • return code: "0" means that the batch executed correctly, "-1" means that an error occurred result of the batch execution (either "Succeeded" or "Failed")
    • batch identification number

    The batch ID corresponds to the directory, named after the batch ID, where the log is stored. In case warnings are detected, a warning log is added to the existing log file.

  2. Right-click the UnitaryFastenerReport and select Results.

    The Results dialog box is displayed:

  3. Click Save to save the results in a text file or Close to simply close the dialog box.

Associate an Existing Parameter File

You can associate an existing parameter file.

  1. From the Utilities tab, right-click UnitaryFastenerReport and select Associate a parameters file.

  2. In the dialog box that appears, select an xml parameter file and click Open.

    The xml parameter file appears in the Start tab as an argument for the start of the FastenerunitaryReport utility.

Warning:
  • Unitary report names are automatically generated: Root product name + Version + Maturity.txt.
  • It is not possible to choose a particular spot fastener instance to be reported, i.e. all the fasteners found inside the product will be output.