TransformX Tool

Feature Description

The TransformX Tool is used to integrate SuperMap TransformX Model Files within the SuperMap iDesktopX toolbox. It can add TransformX Model Files (*.xml) as tool nodes for standalone use or participation in GPA model construction within iDesktopX.

The TransformX Tool is created based on a model file. Content set as parameter variables in the model will be displayed as runtime parameters for the tool, which can be modified in iDesktopX. To adjust internal nodes, connections, or the complete workflow structure within the model, SuperMap TransformX must be used for editing.

Application Scenarios

  • Natural resources data compilation: Integrate the data reading, quality check, transformation, and export processes already orchestrated in TransformX into iDesktopX for batch processing of survey result data.
  • Urban construction and pipeline conversion: Reuse TransformX models to perform conversions among CAD, SHP, databases, and other multi-source data, utilizing them as preprocessing steps in iDesktopX GPA models.
  • Transportation and power data processing: Encapsulate common format conversion or attribute processing workflows as TransformX Tools for direct execution in the toolbox.

Feature Description

  • Before using the TransformX Tool, iDesktopX must obtain the Data Forwarding Tools module license.
  • The added TransformX Model File must contain parameter variables. After importing into iDesktopX, only parameter variables will be displayed as tool parameters.
  • Running the TransformX Tool or modifying parameter variables in iDesktopX does not require installing SuperMap TransformX; to edit the TransformX Model File, SuperMap TransformX must be installed and the main program path configured.

Version Information

SuperMap iDesktopX 2026 and later versions support the TransformX Tool integration capability.

Entry Point

  • Toolbox panel > Toolbox option > TransformX Tool node.

Operation Instructions

  1. Add TransformX Tool
    1. In the Toolbox panel, expand the Toolbox option and locate the TransformX Tool node.
    2. Right-click on the TransformX Tool node and select Add TransformX Tool.
    3. In the Add TransformX Tool dialog that opens, click the Add button to select one or more TransformX Model Files (*.xml).
    4. In the tool list, check the model file path and tool name. By default, the tool name uses the model file name and can be manually modified.
    5. Use the Select All, Select Reverse, Delete, Bring to Front, Move Up, Move Down, and Bring to Back buttons as needed to adjust the list content and order.
    6. After confirming, click the OK button to complete the addition. The tool will appear under the TransformX Tool node.
      Tip:
      The Add TransformX Tool dialog is not only used to add model files but also to manage all tools under the TransformX Tool node. The order in the dialog determines the display order of tools under the TransformX Tool node.
  2. Run TransformX Tool
    1. Double-click the target tool under the TransformX Tool node to open the parameter dialog.
    2. Configure runtime parameters in the parameter dialog. The parameter list comes from the content set as parameter variables in the original TransformX Model File.
    3. Click the execute button to run the tool. If the model contains export tools, the output window will list the output result path upon successful execution, allowing you to locate the result file based on the path.
  3. Edit TransformX Model
    1. Right-click on an added TransformX Tool sub-node and select Edit TransformX Model.
    2. If the TransformX main program path is not set, the system will pop up the Setting up the TransformX main program dialog. Select the TransformX main program and then proceed with editing.
    3. The system launches SuperMap TransformX and loads the model file corresponding to the current tool.
    4. Adjust model nodes, connections, or parameter variables in SuperMap TransformX, then save the model file.
    5. After returning to iDesktopX, the TransformX Tool node will synchronously use the saved model content.
  4. Use TransformX Tool in GPA Model
    1. Right-click on a TransformX Tool sub-node and select Add to New Model, or in the current GPA model window, select Add to Current Model.
    2. The TransformX Tool will be added as a regular function node in the GPA canvas, with the internal workflow running as a single node.
    3. The input end of the tool node can receive upstream data or parameters, with input ports coming from the parameter variables set in the TransformX model.
      Note:

      When using the TransformX Tool as a GPA node, the output port cannot directly serve as a data source for downstream tools. You need to use export tools within the TransformX model to generate actual results, then connect subsequent processing through file paths or iterate file and other methods.

    4. If the TransformX model contains export tools, you can continue using the output results in the GPA model via Iterate File, Variable, and other methods.

Related Topics