Transform Settings

Transform configuration defines references to mapping configurations (defined in separate mapping files) that can be used to select and transform the input's objects and their properties. All the transform-related settings are grouped into a set of extensions. Each extension section in the configuration file is optional and can be repeated any number of times. These extensions are used to modify particular parts of an object and its properties.

The default configuration file contains three transform extensions:

• BaseMapping: Modifies the engineering data of a model’s objects present in the extracted data.

• ObjectMergeMapping: Merges the spatially related text strings extracted as Words into a single object based on their X and Y positions for a PDF document.

• CSVReporting: Exports the extracted input data from the extracted data in the form of a readable CSV file format. For more information, see Appendix A: Mapping Configuration.

  Notes:

  • As a number of mapping configuration files can be associated to a project configuration, order of execution of these files is determined as follows:

    • When only one DefaultBaseMapping extension is added to the transform configuration, all the mapping entries from different mapping nodes are consolidated and applied on the extracted data at once.

    • When multiple DefaultBaseMapping extensions are added to the transform configuration, individual extensions are executed in order, independent of each other.

  • Mappings applied as part of an extension are overridden by the other extension if conflicting mapping entries are present in its mapping configurations.

The Transform tab presents the active project's transform settings as read-only content. The content has anchors linked on the special attribute locator that helps in navigating to the configuration file of an individual extension. When you run the project, it invokes the transformation extensions as configured in the configuration file and modifies the output. For more information about the transformation functions and available syntax, see Appendix A: Mapping Configuration.

To update transform settings:

1. Click the Transform tab in the Project Settings page.

2. Click Edit to open the settings in a Notepad where you can modify the default configuration settings relating to Transform.

   

3. If required, modify dependent mapping files by clicking on the anchor links placed in the main configuration view.

   Note: Settings are automatically saved upon saving and closing the Notepad session.

4. After all the settings have been saved successfully, click Run to process the input data.

   Notes:

   • Any update in the configuration document must be saved before running the process.

   • A CSV Report that is defined in the Transformation configuration file can have its output path defined by the outputFolder parameter. This parameter is documented as optional but is mandatory as it is a necessary part of the CSV file definition. Currently, these only folder definitions in a File System are supported, not an S3 Bucket.

   • The optional 'annotations' feature allows you to store additional data about how each object, attribute or association has been changed due to a transformation step. These tracking attributes store data about creation, modification and deletion operations and can be inspected via CSV reporting. This can be achieved by adding XML <annotations> node to the extension configuration. Available annotations level values are 'None' and 'Basic'. For example:

     <extension ...>

     ...

     <annotations level = "Basic" />

     </extension>

     For more information, see Appendix B: CSV Reporting.

   • For more information about handling system attributes, see Appendix G: Handling of System Attributes.