在 ThingWorx 中导入和导出
导入和导出数据、实体和扩展
在 ThingWorx 中有多种选项可用于导入和导出数据和实体。根据您的起点，将包含数据和实体的扩展导入 ThingWorx 可能是您的流程中的第一步。流、值流、数据表、博客和 wiki (行条目、博客帖子、wiki 页面) 中的信息即为数据。仅可导入扩展。虽然“导入/导出”菜单仅可供管理员用户使用，但数据和实体可以由非管理员手动导入和导出。请参阅手动导出和导入。
对于较小的导入和导出，您可以使用“自文件”导入并使用“至文件”导出，原因在于您要导入或导出特定文件。对于较大的导入和导出，您可以“自 ThingWorx 存储”导入并导出“至 ThingWorx 存储”。它们用于从 ThingworxStorage/exports 文件夹异步导入或导出所有实体和数据。
 |
导出可包含应给予适当保护的敏感信息。在任何时候进行系统导出、筛选导出或单一实体导出时，导出文件应加密并存储在敏感位置。不应与任何不受信任方共享导出，并在确认成功导入目标系统后，应安全删除导出或将其安全存储到长期存储解决方案中。有关详细信息，请参阅密码。
|
有关 ThingWorx 中可用的所有导入和导出选项的更多信息，请参阅下表。
导入
不支持导入从较新版本的 ThingWorx 导出的实体。
|
选项
|
说明
|
支持的格式
|
其他信息
|
||||
|---|---|---|---|---|---|---|---|
|
自文件
|
从选定的本地文件 (非异步) 或从文件信息库导入单个的实体或数据文件。
|
XML、JSON 和二进制
|
• 对于实体，如果选择“使用默认的持久化方案提供工具”选项，则没有有效持久化方案提供工具的导入实体将使用系统定义的默认持久化方案提供工具。
• 对于实体，如果选择“包括子系统”选项，则关联子系统配置与实体一起导入。
• 对于实体，如果选择“覆盖属性值”选项，且导入中存在适用于该实体的任何属性值时，则会覆盖当前存在于实体中的属性值。如果未选择该选项，则导入中的所有属性值都将被忽略。
|
||||
|
自 Thingworx Storage
|
从在服务器上的 ThingworxStorage/exports 文件夹内选定的 (服务器端) 文件中异步导入实体和数据 (可选)。
|
XML、JSON 和二进制
|
• 如果选择“包括数据”选项，则除实体外，还会导入数据。文件必须位于 ThingworxStorage/exports 中。ThingWorx 会自动将实体与数据文件进行配对。
• 如果选择“使用默认的持久化方案提供工具”选项，则任何没有有效关联持久化方案提供工具的导入实体将使用系统定义的默认持久化方案提供工具。具体而言，
◦ 如果导入的实体已经建立了有效的持久化方案提供工具，则 ThingWorx 会将其与该持久化方案提供工具一起导入。
◦ 如果导入的实体未建立有效的持久化方案提供工具，则 ThingWorx 将使用默认的持久化方案提供工具。
• 如果选择“包括子系统”选项，则导入时将会覆盖所有已配置的子系统设置。
• 如果选择“覆盖集合权限和组织”设置，则导入文件中的集合权限和组织将覆盖服务器上的设置。默认行为将合并从导入文件到服务器上已定义的内容的集合权限和组织。
• 对于实体，如果选择“覆盖属性值”选项，且导入中存在适用于该实体的任何属性值时，则会覆盖当前存在于实体中的属性值。如果未选择该选项，则导入中的所有属性值都将被忽略。
|
||||
|
源控制实体
|
从 ThingworxStorage 中 FileRepository 事物的源控制文件夹或“源控制信息库”事物中的源控制文件夹导入 ThingWorx 实体。有关这些信息库的更多信息，请参阅事物模板。
|
XML
|
• 如果选择“使用默认的持久化方案提供工具”选项，则没有有效持久化方案提供工具的导入实体将使用系统定义的默认持久化方案提供工具。
• 如果选择“包括子系统”选项，则关联子系统配置与实体一起导入。
• 对于实体，如果选择“覆盖属性值”选项，且导入中存在适用于该实体的任何属性值时，则会覆盖当前存在于实体中的属性值。如果未选择该选项，则导入中的所有属性值都将被忽略。
• 如果发生错误，则不会导入文件夹中的任何实体。无法解析为 XML 或 ThingWorx 文件的文件会被跳过。错误记录在应用程序日志中。
|
||||
|
扩展名
|
导入扩展 zip 文件。
|
.zip
|
请参阅导入扩展。
|
导出
|
选项
|
说明
|
格式
|
其他信息
|
||
|---|---|---|---|---|---|
|
至文件 - 实体集合
|
• 可以按模型标记、项目或日期 (由文件上的“上次修改日期”时间戳确定) 同步导出指定实体集合 (应用程序密钥、仪表板、混搭、媒体实体等) 中的实体。
• 如果未指定信息库，则会将实体导出到本地。
|
二进制和 XML
|
• 如果未指定文件信息库，则将在以下位置自动创建名为 FileRespository 的文件夹：ThingworxStorage\repository\FileRepository
• 如果选中“导出匹配模型标记”，则只会导出包含“标记”字段中指定的所有标记的实体。如果未选中“导出匹配模型标记”，则会导出包含“标记”字段中指定的任何标记的实体。
|
||
|
至文件 - 数据集合
|
• 可以按模型标记或日期 (由数据记录的时间戳确定) 同步导出指定集合 (博客、数据表、流、值流或 Wiki) 中的数据。
|
二进制
|
• 如果未指定信息库，则将在以下位置自动创建名为 FileRespository 的文件夹：ThingworxStorage\repository\FileRepository
• 如果选中“导出匹配模型标记”，则只会导出包含“标记”字段中指定的所有标记的实体。如果未选中“导出匹配模型标记”，则会导出包含“标记”字段中指定的任何标记的实体。
|
||
|
至文件 - 单一实体
|
可以将单一实体导出到选定的本地目标位置 (同步)。
|
二进制或 XML
|
如果未指定信息库，则会将实体下载到本地。
|
||
|
至文件 - 单一数据
|
可以将单一数据导出到选定的本地目标位置 (同步)。
|
二进制
|
• 如果选中“导出匹配模型标记”，则只会导出包含“标记”字段中指定的所有标记的实体。如果未选中“导出匹配模型标记”，则会导出包含“标记”字段中指定的任何标记的实体。
|
||
|
至 Thingworx Storage
|
将所有实体和数据 (可选) 异步导出到服务器 (在 ThingworxStorage/exports 文件夹中)。
|
二进制
|
• 导出到 ThingworxStorage 文件夹时没有大小限制。
• 导出按日期、实体/数据类型和数据类型名称分解为多个文件夹。例如，C:\ThingworxStorage\exports\20150625140545\Blogs\AcmeVendingEquiptmentBlog\data-0.twx
• 导出文件的大小可以在导出导入子系统中进行配置。
• 可为每个数据和实体文件添加随附的校验和 (chk) 文件。
|
||
|
源控制实体
|
通过集合、模型标记、项目、开始和结束日期导出 ThingWorx 实体。指定的实体可以指向 FileRepository 或 SourceControlRepository 事物。导出实体时，可在目标位置创建文件结构，类似于源控制系统管理其构件时的方式。如果要将导出的文件移动或复制到其他位置，则可以将文件结构导出为 zip 文件。
|
XML
|
• 指定实体的导出时，以下选项可用：
◦ “集合”-“全部”、“应用程序密钥”、“仪表板”、“数据形状”、“数据标记”、“目录服务”、“扩展包”、“本地化表”、“日志”、“混搭”、“媒体”、“菜单”、“模型标记”、“网络”、“组织”、“持久化方案提供工具”、“项目”、“资源”、“脚本函数库”、“状态定义”、“样式定义”、“样式主题”、“子系统”、“事物组”、“事物包”、“事物”、“事物形态”、“事物模板”、“用户”、“用户组”。
◦ “项目”- 指定要用于导出的项目。导出实体时，所有应用了所选项目的实体都将被导出。
◦ “标记”- 使用魔术拾取器通过模型标记进行导出。
◦ “导出匹配模型标记” - 如果选中此选项，则只会导出包含“标记”字段中指定的所有标记的实体。如果未选中“导出匹配模型标记”，则会导出包含“标记”字段中指定的任何标记的实体。
◦ “开始日期”- 使用开始日期根据实体记录的时间戳限制导出实体的内容。开始日期可导出开始日期之后加上时间戳的实体。
◦ “结束日期”- 使用结束日期根据数据条目记录的时间戳限制导出实体的内容。结束日期可导出在指定结束日期前加上时间戳的实体。如果结束日期为空，则使用当前的日期和时间。
◦ “信息库”- 指定要导出的信息库。
◦ “路径”- 指定导出的位置。
◦ “导出至 Zip 文件”- 将导出实体放入指定位置的 zip 文件夹中。必须提供文件名。
|
||
|
从“更多”菜单中导出
|
XML
|
 |
|||
|
通用导出
|
如果每个系统使用唯一的加密密钥，将数据从一个系统迁移到另一个系统时，此选项非常有用。例如，在将预生产系统迁移到生产系统时，此选项非常有用。在这种情况下，从一个系统中导出的加密敏感信息 (例如基本类型 PASSWORD 的属性) 无法导入到另一个系统。
此选项仅适用于管理员用户，并且仅用于导出实体，可将实体从一个 ThingWorx 服务器导出，并随后导入另一个服务器。请注意，与实体关联的数据不随其一同导出。
请参阅密码基本类型主题。
|
二进制或 XML
|
当满足以下条件时，此选项在导出用户界面中可用：
• “导出选项”为“至文件”或“至 ThingWorx 存储”
• “导出类型”为“实体集合”或“单一实体”
• 用户为管理员组的成员
如果非管理员用户在启用通用选项的情况下调用 Export 服务目录，则服务器将阻止用户执行导出。
|
