버전 지정 및 마이그레이션
기본으로 제공되는 기본 구성 요소 및 구현에는 각각 구성 버전이 있습니다. 버전은 구성 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 서비스를 구현해야 합니다.