版本控制和迁移
预置的每个基本组件和实施都具有配置版本。版本用于跟踪配置 JSON 对象，并且确保自定义组件在将来可以迁移到新的 ThingWorx Navigate 版本。
版本控制详细信息
配置 JSON 对象包含两个用于跟踪版本的键：baseConfigurationVersion 和 implementationConfigurationVersion。请注意，这两个键在 Mashup Builder 的配置对话框中处于隐藏状态，但包含于 GetConfigurations 服务返回的配置中。
 |
要标识组件的配置版本，请在组件事物上执行以下服务：
• GetBaseConfigurationVersion，获取基本组件的版本
• GetImplementationConfigurationVersion，获取实施的版本
|
调用迁移服务
为组件创建自定义实施时，可通过扩展现有基本组件或实施来创建事物模板。自定义实施中所有调用 GetConfigurations 服务的服务，必须先调用 Migrate 服务。
Migrate 服务有四个参数：
• migrationType- 字符串，迁移类型，当前仅支持 “Configuration”
• data - JSON，配置 JSON 对象的名称
• targeBaseVersion – 字符串，基本组件的版本
• targetImplementationVersion – 字符串，实施的版本
以下是调用 Migrate 服务的代码示例：
var migratedConfig = me.Migrate(
{
"migrationType":"Configuration",
"data":"configuration",
"targetBaseVersion":"9.0.0",
"targetImplementationVersion":"1.0.0"
}
);
{
"migrationType":"Configuration",
"data":"configuration",
"targetBaseVersion":"9.0.0",
"targetImplementationVersion":"1.0.0"
}
);
Migrate 服务将 targetBaseVersion 的值与配置 JSON 对象的 baseConfiguration 的值进行比较，将 targetImplementationVersion 的值与配置 JSON 对象的 implementationConfigurationVersion 的值进行比较。如果版本值不匹配，则 Migrate 服务会调用 MigrateBase 服务或 MigrateImplementation 服务，这将迁移配置 JSON 对象以匹配目标基本组件或目标实施组件的版本。
通常，在创建自定义业务逻辑实施组件时，无需调用 MigrateImplementation 服务。但是，如果您创建现有自定义实施的新版本，并且该新版本使用不同的配置版本，则需要实现 MigrateImplementation 和 GetBaseMigrationVersion。
创建自定义基本业务逻辑组件时，必须实现 MigrateBase 服务。