Add Attachments

Instructions for use

This function is used to batch add attachments to objects in a dataset. By specifying the connection field between the source dataset and the matching table, the system will automatically add corresponding attachments to the successfully matched source dataset objects, thereby avoiding manual addition one by one and greatly improving the management efficiency of field survey data (such as photos, vector files, etc.).

After successfully adding attachments, a Relation Dataset and a table containing attachment files and relationship classes will be generated under the data source where the dataset is located, to establish associations between objects and attachment files. If you delete records in the relationship table, the corresponding attachment files will also be deleted.

SuperMap iDesktopX 2026 version starts to support this function.

Parameter description

Parameter Name parameter interpretation parameter type
source datasource The data source where the dataset to add attachments is located. DataSource
source dataset The dataset to add attachments. Supported types: point, line, polygon, text, and CAD Dataset. DatasetVector
connection field

The field in the source dataset used to associate with the matching table. The system will match based on this field and the value of the Matching Connection Field to add attachments for successfully matched records.
Note: When the matching table is the same as the source dataset, the system will automatically use the dataset's SmID as the Connection Field and the Matching Connection Field.

String
match the data源 The data source where the matching table storing attachment information is located. DataSource
Matching Table

The dataset that provides attachment information. Supported types include: point, line, polygon, attribute table, text, and CAD Dataset.

If the source dataset itself already contains an attachment path field, you can specify the matching table as the source dataset itself..

 DatasetVector
Matching Connection Field

The field in the matching table used to associate with the input dataset. Attachments from records with the same value as the Connection Field will be added to the corresponding objects in the source dataset.

 String
Matching Path Field

The field in the matching table used to store the file path information of attachments. The field value can be:

  • Short file name (e.g., attachment.png), which is the relative path relative to the folder where the source data is located or the specified Attachment Folder.
  • Full file path (e.g., F:\attachment files\attachment.png).
 String
Attachment Folder

The folder used to centrally store attachment files. If the Matching Path Field is a complete absolute path, this parameter may not need to be set; if the Matching Path Field is a short file name, you need to specify the folder where the attachments are located, otherwise it will default to matching in the folder where the source data is located.

 String

Notes:

  • Mixed Path Handling: If the Matching Path Field contains both full paths and short file names, the system will handle them separately: full paths are looked up based on the original path; short file names are looked up based on whether an Attachment Folder is specified (if specified, look up from that folder, otherwise look up from the folder where the source data is located)..
  • File Size Limitation: Only attachment files smaller than 100MB are supported; files exceeding this size will fail to be added..

Output Result

After successful execution, objects in the source dataset that are successfully associated with the matching table will automatically have corresponding attachments added. You can view and manage these attachments in the object's Properties panel -> Enclosure tab..