ThingWorx에서 가져오기 및 내보내기

내보내기에는 제대로 보호되어야 하는 민감한 정보가 포함될 수 있습니다. 시스템 내보내기, 필터링된 내보내기 또는 단일 엔티티 내보내기가 발생할 때마다 내보낸 파일을 암호화하고 기밀 위치에 저장해야 합니다. 내보내기를 신뢰하지 않는 당사자와 공유하지 않아야 하며, 대상 시스템으로 가져오기가 성공한 것으로 확인되면 내보내기는 안전하게 삭제하거나 장기간 저장소 솔루션에 안전하게 저장해야 합니다. 자세한 내용은 암호를 참조하십시오.

옵션

설명

지원되는 형식

추가 정보

파일에서

선택한 로컬 파일(동기식이 아님)에서 또는 파일 저장소에서 엔티티 또는 데이터의 단일 파일을 가져옵니다.

XML, JSON 및 바이너리

• 엔티티의 경우 기본 지속성 공급자 사용 옵션이 선택되면 올바른 지속성 공급자가 없는 가져온 엔티티가 시스템 정의 기본 지속성 공급자를 사용합니다.

• 엔티티의 경우 하위 시스템 포함 옵션이 선택되면 연관된 하위 시스템 구성을 엔티티와 함께 가져옵니다.

• 엔티티의 경우 속성 값 덮어쓰기 옵션이 선택된 경우 현재 엔티티에 존재하는 속성 값이 가져오기에 존재하는 해당 엔티티에 대한 속성 값으로 덮어쓰여집니다. 이 옵션이 선택 취소된 경우 가져오기의 모든 속성 값이 무시됩니다.

Thingworx 스토리지에서

서버의 ThingworxStorage/exports 폴더에 있는 선택된 (서버 측) 파일에서 비동기식으로 엔티티 및 데이터(선택 사항)를 가져옵니다.

XML, JSON 및 바이너리

• 데이터 포함 옵션이 선택된 경우 엔티티 외에도 데이터를 가져옵니다. 파일은 ThingworxStorage/exports에 있어야 합니다. ThingWorx에서 자동으로 엔티티와 데이터 파일을 쌍으로 지정합니다.

각 데이터 파일에 가져올 때 만든 연관된 import.log 파일이 있습니다. 이 파일을 삭제하지 않으면 동일한 데이터를 가져올 수 없습니다.

• 기본 지속성 공급자 사용 옵션이 선택되면 올바른 연관 지속성 공급자가 없는 가져온 엔티티가 시스템 정의 기본 지속성 공급자를 사용합니다. 특히

◦ 가져온 엔티티에 올바른 지속성 공급자가 설정되어 있는 경우 ThingWorx가 해당 지속성 공급자를 사용하여 이 엔티티를 가져옵니다.

◦ 가져온 엔티티에 올바른 지속성 공급자가 설정되어 있지 않는 경우 ThingWorx가 기본 지속성 공급자를 사용합니다.

• 하위 시스템 포함 옵션이 선택되면 구성된 모든 하위 시스템 설정이 가져올 때 덮어쓰여집니다.

• 컬렉션 권한과 조직 덮어쓰기 설정이 선택되면 가져오기 파일의 컬렉션 권한 및 조직이 서버의 설정을 덮어씁니다. 기본 동작은 가져온 파일의 컬렉션 권한 및 조직을 서버에 이미 정의된 항목에 병합합니다.

• 엔티티의 경우 속성 값 덮어쓰기 옵션이 선택된 경우 현재 엔티티에 존재하는 속성 값이 가져오기에 존재하는 해당 엔티티에 대한 속성 값으로 덮어쓰여집니다. 이 옵션이 선택 취소된 경우 가져오기의 모든 속성 값이 무시됩니다.

다음 시나리오에서는 ThingWorx Storage에서 가져오기가 실패하고 다음 조건이 충족될 경우 가져오기가 두 단계 프로세스로 수행되어야 합니다.

1. 태그가 하나 이상의 데이터 엔트리에 추가되었으며 어휘가 동적이 아닙니다.

2. 해당 태그는 나중에 어휘에서 삭제됩니다.

3. 엔티티 및 데이터를 ThingWorx Storage로 내보냅니다.

이 시나리오에서는 ThingWorx가 어휘를 가져오므로 데이터와 함께 ThingWorx Storage에서 가져오기가 실패한 다음 태그가 존재하지 않고 동적이 아닌 어휘에 추가할 수 없으므로 데이터를 가져올 때 실패합니다. 이 시나리오에서 데이터 가져오기를 활성화하려면 다음 단계 중 하나를 수행해야 합니다.

• 누락된 태그를 원래 ThingWorx 서버의 어휘에 추가하고 ThingWorx Storage로 다시 내보냅니다.

• 원래 ThingWorx 서버에서 어휘를 동적으로 만들고 ThingWorx Storage로 다시 내보냅니다.

• 엔티티만 새 ThingWorx 서버로 가져오고 누락된 태그를 적절한 어휘에 추가한 다음 파일에서 가져오기 옵션을 사용하여 데이터를 가져옵니다.

소스 제어 엔티티

ThingworxStorage에 있는 FileRepository 사물의 소스 제어 폴더에서 또는 소스 제어 저장소 사물의 소스 제어 폴더에서 ThingWorx 엔티티를 가져옵니다. 이러한 저장소에 대한 자세한 내용은 사물 템플릿을 참조하십시오.

XML

• 기본 지속성 공급자 사용 옵션이 선택되면 올바른 지속성 공급자가 없는 가져온 엔티티가 시스템 정의 기본 지속성 공급자를 사용합니다.

• 하위 시스템 포함 옵션이 선택되면 연관된 하위 시스템 구성을 엔티티와 함께 가져옵니다.

• 엔티티의 경우 속성 값 덮어쓰기 옵션이 선택된 경우 현재 엔티티에 존재하는 속성 값이 가져오기에 존재하는 해당 엔티티에 대한 속성 값으로 덮어쓰여집니다. 이 옵션이 선택 취소된 경우 가져오기의 모든 속성 값이 무시됩니다.

• 오류가 발생하면 폴더에 있는 엔티티를 가져오지 않습니다. XML 또는 ThingWorx 파일로 분석하지 못한 파일은 건너뜁니다. 오류가 응용 프로그램 로그에 기록됩니다.

확장

확장 zip 파일을 가져옵니다.

.zip

확장 가져오기를 참조하십시오.

옵션

설명

형식

추가 정보

파일로 - 엔티티 컬렉션

• 지정된 엔티티 컬렉션(응용 프로그램 키, 대시보드, 매쉬업, 미디어 엔티티 등)에서 모델 태그를 사용하거나 프로젝트별 또는 날짜(파일의 "마지막으로 수정한 날짜" 타임스탬프에 의해 결정됨)별로 동기식으로 엔티티를 내보낼 수 있습니다.

• 저장소가 지정되지 않은 경우 엔티티를 로컬로 내보냅니다.

바이너리 및 XML

• 파일 저장소가 지정되지 않은 경우 이름이 FileRespository인 폴더가 ThingworxStorage\repository\FileRepository 위치에 자동으로 생성됩니다.

• 일치하는 모델 태그 내보내기를 선택하면 태그 필드에 지정된 모든 태그를 포함하는 엔티티만 내보냅니다. 일치하는 모델 태그 내보내기를 선택하지 않으면 태그 필드에 지정된 태그를 포함하는 엔티티를 내보냅니다.

파일로 - 데이터 컬렉션

• 지정된 컬렉션(블로그, 데이터 테이블, 스트림, 가치 스트림 또는 Wiki)에서 모델 태그를 사용하거나 날짜(데이터의 기록된 타임스탬프에 의해 결정됨)별로 동기식으로 엔티티를 내보낼 수 있습니다.

바이너리

• 저장소가 지정되지 않은 경우 이름이 FileRespository인 폴더가 ThingworxStorage\repository\FileRepository 위치에 자동으로 생성됩니다.

• 일치하는 모델 태그 내보내기를 선택하면 태그 필드에 지정된 모든 태그를 포함하는 엔티티만 내보냅니다. 일치하는 모델 태그 내보내기를 선택하지 않으면 태그 필드에 지정된 태그를 포함하는 엔티티를 내보냅니다.

파일로 - 단일 엔티티

단일 엔티티를 선택된 로컬 대상으로 내보낼 수 있습니다(동기식).

바이너리 또는 XML

저장소가 지정되지 않은 경우 엔티티를 로컬로 다운로드합니다.

파일로 - 단일 데이터

단일 데이터를 선택된 로컬 대상으로 내보낼 수 있습니다(동기식).

바이너리

• 일치하는 모델 태그 내보내기를 선택하면 태그 필드에 지정된 모든 태그를 포함하는 엔티티만 내보냅니다. 일치하는 모델 태그 내보내기를 선택하지 않으면 태그 필드에 지정된 태그를 포함하는 엔티티를 내보냅니다.

Thingworx 스토리지로

ThingworxStorage/exports 폴더에서 모든 엔티티 및 데이터(선택 사항)를 서버에 비동기식으로 내보냅니다.

바이너리

• ThingworxStorage 폴더로 내보낼 때 크기 제한이 없습니다.

• 내보내기는 날짜별, 엔티티/데이터 유형별 및 데이터 유형 이름별로 폴더로 나눠집니다. 예를 들어, C:\ThingworxStorage\exports\20150625140545\Blogs\AcmeVendingEquiptmentBlog\data-0.twx입니다.

• 내보낸 파일의 크기는 내보내기 가져오기 하위 시스템에서 구성될 수 있습니다.

• 각 데이터 및 엔티티 파일에 대해 해당되는 체크섬(chk) 파일이 추가됩니다.

소스 제어 엔티티

ThingWorx 엔티티를 컬렉션별, 모델 태그별, 프로젝트별, 시작 날짜 및 종료 날짜별로 내보냅니다. 지정된 엔티티가 FileRepository 또는 SourceControlRepository 사물로 이동할 수 있습니다. 엔티티를 내보낼 때 소스 제어 시스템이 해당 가공물을 관리하는 방식과 유사한 대상에서 파일 시스템이 생성됩니다. 내보낸 파일을 다른 위치로 이동하거나 복사하려는 경우 파일 구조를 zip 파일로 내보낼 수 있습니다.

소스 제어를 통해 엔티티를 내보낼 때 엔티티에 연관된 암호 해시 또는 응용 프로그램 키 ID와 같은 중요 정보는 내보내지 않습니다. 소스 제어 내보내기를 시스템으로 다시 가져오면 엔티티와 연관된 중요한 정보가 손실됩니다.

XML

• 엔티티의 내보내기를 지정할 때 다음 옵션을 사용할 수 있습니다.

◦ 컬렉션 - 모두, 응용 프로그램 키, 대시보드, 데이터 셰이프, 데이터 태그, 디렉터리 서비스, 확장 패키지, 로컬리제이션 테이블, 로그, 매쉬업, 미디어, 메뉴, 모델 태그, 네트워크, 조직, 지속성 공급자, 프로젝트, 리소스, 스크립트 함수 라이브러리, 상태 정의, 스타일 정의, 스타일 테마, 하위 시스템, 사물 그룹, 사물 패키지, 사물, 사물 형태, 사물 템플릿, 사용자, 사용자 그룹입니다.

◦ 프로젝트 - 내보내기에 사용할 프로젝트를 지정합니다. 엔티티를 내보낼 때 선택한 프로젝트가 적용된 모든 엔티티를 내보냅니다.

◦ 태그 - Magic Picker를 사용하여 모델 태그별로 내보냅니다.

◦ 일치하는 모델 태그 내보내기 - 선택하면 태그 필드에 지정된 모든 태그를 포함하는 엔티티만 내보냅니다. 일치하는 모델 태그 내보내기를 선택하지 않으면 태그 필드에 지정된 태그를 포함하는 엔티티를 내보냅니다.

◦ 시작 날짜 - 시작 날짜를 사용하여 엔티티와 함께 기록된 타임스탬프를 기반으로 내보낸 엔티티의 콘텐츠를 제한합니다. 시작 날짜는 시작 날짜 이후에 타임스탬프된 엔티티를 내보냅니다.

◦ 종료 날짜 - 종료 날짜를 사용하여 데이터 엔트리와 함께 기록된 타임스탬프를 기반으로 내보낸 엔티티의 콘텐츠를 제한합니다. 종료 날짜는 지정된 종료 날짜 이후에 타임스탬프된 엔티티를 내보냅니다. 종료 날짜가 비어 있으면 현재 날짜 및 시간이 사용됩니다.

◦ 저장소 - 내보내기를 위한 저장소를 지정합니다.

◦ 경로 - 내보내기의 위치를 지정합니다.

◦ Zip 파일로 내보내기 - 내보낸 엔티티를 지정된 위치에 zip 폴더로 배치합니다. 파일 이름을 제공해야 합니다.

더 보기 메뉴에서 내보내기

XML

범용 내보내기

이 옵션은 한 시스템의 데이터를 다른 시스템으로 내보낼 때 각 시스템에서 고유한 암호화 키를 사용하는 경우 유용합니다. 예를 들어 생산 전단계 시스템을 생산 시스템으로 마이그레이션할 때 유용합니다. 이 경우 한 시스템에서 내보낸 암호화된 중요한 정보(예: PASSWORD 기본 유형의 속성)는 다른 시스템으로 가져올 수 없습니다.

이 옵션은 관리자 사용자만 엔티티를 내보낼 때에 한해 사용할 수 있으며 이 옵션을 사용하면 이후 다른 시스템으로 가져오기 위해 ThingWorx 서버에서 엔티티를 내보낼 수 있습니다. 엔티티와 연관된 데이터는 함께 내보내지지 않습니다.

이 범용 내보내기 옵션을 선택하면 중요한 정보를 일반 텍스트로 내보냅니다. 그러나 ThingWorx Flow의 경우 중요한 정보가 내보내지지 않으며 대상 시스템으로 가져온 후 ThingWorx Flow UI를 통해 다시 입력되어야 합니다. 이 옵션을 선택하면 보안 경고가 나타납니다. 내보낸 파일은 적절한 방법으로 안전하게 보호되어야 합니다.

암호 기본 유형 항목을 참조하십시오.

바이너리 또는 XML

이 옵션은 다음 조건에 해당하는 경우 내보내기 UI 내에서 사용할 수 있습니다.

• 내보내기 옵션이 "파일로" 또는 "Thingworx Storage로"입니다.

• 내보내기 유형이 "엔티티 컬렉션" 또는 "단일 엔티티"입니다.

• 사용자는 관리자 그룹의 멤버입니다.

관리자가 아닌 사용자가 범용 옵션을 활성화하고 Export 서비스 디렉터리를 호출할 경우 서버에서는 사용자가 내보내기를 수행하지 못하게 방지합니다.