添加附件

使用说明

本功能用于向数据集中的对象批量添加附件。通过指定源数据集与匹配表之间的连接字段，系统将自动为匹配成功的源数据集对象添加对应附件，从而避免手动逐个添加，大幅提升外业调查数据（如照片、矢量文件等）的管理效率。

成功添加附件之后，在数据集所在的数据源下将生成一个关系数据集和一个包含附件文件和关系类的表，以使对象与附件文件建立关联。若删除关系表中的记录，所对应的附件文件也会被删除。

SuperMap iDesktopX 2026版本开始支持该功能。

参数说明

参数名 参数释义 参数类型
源数据源 待添加附件的数据集所在的数据源。 DataSource
源数据集 待添加附件的数据集。支持类型：点、线、面、文本以及CAD数据集。 DatasetVector
连接字段

源数据集中用于和匹配表进行关联的字段。系统将根据此字段与匹配连接字段的值进行匹配，为匹配成功的记录添加附件。
注意：当匹配表与源数据集相同时，系统将自动使用该数据集的SmID作为连接字段与匹配连接字段。

String
匹配数据源 存储附件信息的匹配表所在的数据源。 DataSource
匹配表

用于提供附件信息的数据集。支持的类型有：点、线、面、属性表、文本、CAD数据集。

若源数据集自身已包含附件路径字段，可将匹配表指定为源数据集本身。

 DatasetVector
匹配连接字段

匹配表中用来与输入数据集进行关联的字段。与连接字段值相同的记录中的附件将被添加到源数据集相应的对象中。

 String
匹配路径字段

匹配表中用于存储附件文件路径信息的字段。字段值可以是：

  • 短文件名（如：附件.png），短文件也就是相对于源数据所在文件夹或指定的附件文件夹的相对路径。
  • 完整文件路径（如：F:\附件文件\附件.png)。
 String
附件文件夹

用于集中存放附件文件的文件夹。若匹配路径字段是完整的绝对路径可以不设置该参数；若匹配路径字段为短文件名，则需指定附件所在的文件夹，否则将默认在源数据所在文件夹中进行匹配。

 String

注意事项：

  • 路径混合处理：若匹配路径字段中同时存在完整路径和短文件名，系统将分别处理：完整路径按原路径查找；短文件名则根据是否指定附件文件夹来决定查找位置（若指定则从该文件夹查找，否则从源数据所在文件夹查找）。
  • 文件大小限制：仅支持添加小于100MB的附件文件，超过此大小的文件将添加失败。

输出结果

执行成功后，源数据集中与匹配表关联成功的对象将自动添加对应附件。您可以在对象的属性面板 -> 附件标签页中查看和管理这些附件。