가져오기 번들 만들기
가져오기 번들을 생성하려면 다음을 수행합니다.
1. 데이터를 가져올 각 데이터 셰이프에 대한 ASCII CSV 텍스트 파일을 작성합니다. 이러한 파일을 편집할 때 해당 파일을 열고 텍스트 파일로 저장합니다. 이 작업은 텍스트 편집기를 사용하면 가장 편리하게 수행할 수 있습니다. Microsoft Excel을 사용하는 경우 파일을 열어 Excel 문서로 저장하지 마십시오. 이로 인해 데이터가 손상되고 파일을 가져올 수 없게 되기 때문입니다.
자세한 내용은 CSV 파일 서식 적용 항목을 참조하십시오.
2. Binaires라는 디렉토리에서 CSV 파일이 참조하는 모든 바이너리 파일을 수집합니다. 필요한 경우 하위 폴더를 사용하여 같은 이름의 여러 파일을 구분합니다. 자세한 내용은 바이너리 콘텐츠 항목을 참조하십시오.
3. 최상위 레벨에서 CSV 파일 및 Binaries 디렉토리를 포함하는 ZIP 파일을 생성합니다. 다음 그래픽에서는 가져오기 번들 구조의 예가 나타나 있습니다.
CSV 파일 서식 적용
각 CSV 파일은 Operator Advisor 데이터 모델의 데이터 셰이프의 이름을 따라 명명하였고 또한 해당 데이터 셰이프를 나타냅니다. 예를 들어, PTC.SCA.SCO.WorkDefinition 데이터 셰이프의 경우 CSV 파일의 이름은 PTC.SCA.SCO.WorkDefinition.csv입니다.
각 CSV의 첫 번째 행에는 해당하는 데이터 셰이프에 대한 필드 이름이 나열됩니다. 각각의 뒤따르는 행은 해당 데이터 셰이프의 인스턴스를 나타내고 가져오기 작업 시 해당 데이터베이스 테이블에 행으로 추가됩니다. 행의 각 엔트리에 대한 콘텐츠는 해당 데이터 셰이프 필드의 데이터 유형과 일치해야 합니다. 특정 필드 값이 비어 있으면 쉼표 사이에 데이터가 없는 것으로 표시됩니다.
다음은 PTC.SCA.SCO.WorkDefinition.csv 파일의 예입니다.
UID,ID,Description,WorkType,Duration,SiteUID,DurationUnitOfMeasure,Name,LongDescription,ExecutionStatus,Version,SequenceNumber,ExecutionNotes
CREATE:1,1000001,PP Description,,,,,PP Name,PP Long Description,,A.1 (Design),0,
CREATE:2,1000002,OP10 Description,,,,,OP10 Name,OP10 Long Description,,A.2 (Design),10,
CREATE:3,1000003,OP20 Description,,,,,OP20 Name,OP20 Long Description,,A.3 (Design),20,
CREATE:4,1000004,OP1010 Description,,,,,OP1010 Name,OP1010 Long Description,,A.4 (Design),10,
CREATE:5,1000005,OP1020 Description,,,BUNDLE:1,,OP1020 Name,OP1020 Long Description,,A.5 (Design),20,
특정 필드는 특정 방식으로 지정해야 합니다.
UID
UID의 값은 CREATE:<#>의 형식으로 지정되어야 합니다. 예를 들어 CREATE:1입니다. 접두사는 CSV 파일 내 해당 행에 대해 수행할 작업을 나타냅니다. 이 경우 CREATE:는 해당 데이터베이스 테이블에 행을 작성함을 나타냅니다. 번호는 CSV 파일 내에서 고유해야 합니다. 실제 UID 값은 새 데이터베이스 행이 추가될 때 ThingWorx에서 자동 생성됩니다.
외부 참조
외부 참조는 이미 Operator Advisor에 있는 데이터베이스 행의 UID를 참조하는 필드입니다 . 예를 들어, CSV의 작업 정의에 대한 SiteUID 필드가 Operator Advisor에 이미 있는 사이트를 참조하는 경우 해당 기존 사이트의 UID를 지정합니다.
내부 참조
내부 참조는 번들의 다른 CSV 파일에 있는 엔트리의 UID를 참조하는 필드입니다. 이러한 값은 BUNDLE:<#>의 형식으로 지정되어야 합니다. #은 해당 CSV 파일의 해당 엔트리에 대한 UID 필드의 #과 일치해야 합니다.
예를 들어, PTC.SCA.SCO.WorkDefinition.csv 파일 내 작업 정의에 대한 SiteUID 필드가 CREATE:7로 지정된 UID 값을 가진 PTC.SCA.SCO.Site.csv 파일을 참조하는 경우, SiteUID 값은 BUNDLE:7로 지정됩니다.
URL
작업 정의 일러스트레이션의 IllustrationURL 또는 작업 정의 관련 문서의 DocumentURL과 같은 URL 필드의 경우 해당 값은 http://abc.com/file.html과 같은 웹 URL이거나 번들의 Binaries 디렉터리에 있는 바이너리 객체에 대한 경로여야 합니다. 값을 비워 둘 수 없습니다. Binaries 디렉터리에 있는 파일에 대한 경로는 file:// 접두사를 포함하며 가져오기 번들의 기본 폴더를 기준으로 합니다. 예: file://Binaries/Safety.doc 또는 file://Binaries/subdir1/Safety.doc 파일 경로에서 참조하는 모든 바이너리 객체가 가져오기 번들에 포함되어야 합니다.
바이너리 콘텐츠
CSV 파일에서 참조한 모든 바이너리 콘텐츠가 Binaries 디렉터리에 포함되어야 합니다. 동일한 이름의 바이너리 파일이 여러 개 있는 경우 하위 폴더를 사용하여 구분합니다. 예를 들어, 각각 고유한 콘텐츠를 가진 여러 개의 Safety.doc 파일이 있는 경우 각 파일에 대해 별도의 하위 폴더를 지정합니다. 각 바이너리 파일은 가져오기 번들 내에서 한 번만 참조할 수 있습니다.
바이너리 파일은 PNG, DOC, PDF 등의 확장자가 있는 연관된 파일입니다. 이러한 파일은 데이터베이스가 아니라 파일 저장소에 저장되며 작업 정의 관련 문서(PTC.SCA.SCO.WorkDefinitionRelatedDocument) 등의 엔티티에서 URL로 참조됩니다. 바이너리 콘텐츠의 가능한 유형에 대해서는 PTC.SCA.SCO.WorkDefinitionRelatedDocumentType 속성에 대해 나열된 파일 유형을 참조하십시오.