Servigistics InService 게시 및 로드 > 게시 및 로드 사용 > PxTAL 실행
  
PxTAL 실행
Px 번들 지원
번들 호환성
TAL은 Servigistics InService 6.5 및 7.1 번들을 지원합니다. 버전은 번들에 있는 게시 정보를 기반으로 식별됩니다.
* 
6.5 또는 7.1 번들을 로드해야 합니다. 서로 다른 유형을 로드할 수 없습니다.
번들 제한 사항
다음은 번들 데이터에 대한 몇 가지 제한 사항입니다.
• Servigistics InService 번들에 있는 파일 이름에 "#" 문자를 사용하지 마십시오.
파일 이름에 이 문자가 포함되면 다음 오류로 인해 변환 및 로드 프로세스가 실패합니다.
[ERROR,ProcessActionHandler] Failed node: fetchApplicableFilesForPartsList within flow:getRegistryFromIMANSubFlow_PD , reason #path to a partslist item(The system cannot find the file specified) java.io.FileNotFoundException:#path to a partslist item(The system cannot find the file specified)
• 논리적 OR을 나타내기 위해 수직 막대(|) 문자를 사용하는 경우가 아니면 이 문자를 APEX 등록 정보 값에서 사용하지 마십시오.
Px 번들 콘텐츠
Px 번들은 다음 표에 나와 있는 폴더 및 파일로 구성됩니다.
이름
파일/폴더
설명
com.ptc.arbortext.windchill.partlist.PartList
폴더
*-DMPmap.xml에서 참조된 부품 목록을 포함합니다. 폴더 이름은 일반적으로 SIM/SP에서 생성된 데이터를 기반으로 하는 유형 이름입니다.
com.ptc.ptcnet.DynamicDocument
폴더
*-DMPmap.xml에서 참조된 동적 문서를 포함합니다. 일반적으로 콘텐츠는 DITA XML, 일반 XML, PDF 또는 이미지와 관련된 것입니다. 폴더 이름은 일반적으로 SIM/SP에서 생성된 데이터를 기반으로 하는 유형 이름입니다.
reps
폴더
*_Hierarchy.xml의 연관된 이미지를 포함합니다.
*_Hierarchy.xml
파일
제품 구조의 계층 구조 정보를 제공하는 제품 계층 파일입니다.
*_Hierarchy.xml.meta
파일
제품 계층 메타데이터 파일입니다.
*-DMPmap.xml
파일
일반적으로 목차를 제공하는 IS(정보 구조) 또는 PS(게시 구조) 파일입니다. 데이터는 계층 구조에도 있습니다.
*-DMPmap.xml.meta
파일
IS 또는 PS 동반 메타데이터 파일입니다.
OptionsDefinition.xml
파일
컨텍스트(PH 또는 IS)에 대한 연관과 함께 옵션 및 선택 사항 정의의 목록입니다.
partThumbnails.zip
파일
부품과 연관된 이미지입니다.
ProductInstances.xml
파일
컨텍스트 매핑에 대한 일련 번호를 제공하는 제품 인스턴스 파일입니다. 이 파일에는 단일 파일의 여러 값이 포함됩니다.
publishInfo.xml
파일
게시된 번들과 관련된 메타데이터 정보입니다. 일반적으로 번들 ID, 게시된 날짜, 로캘, 번들 시퀀스 및 플래그(전체 번들인지 아니면 증분 번들인지를 나타냄)를 지정합니다.
이 파일에는 번들 소유자를 식별하는 Bundle-Source 매개 변수가 포함됩니다. 이 등록 정보가 없으면 TAL은 기본적으로 번들 소스의 Rootobjects에서 orgName 등록 정보를 사용합니다.
번들이 전체인지 아니면 증분인지는 다음 등록 정보에 의해 결정됩니다.
• JobSpecification/@increment
• JobSpecification/@incremental
전체 번들에는 increment="0" 또는 incremental="false" 값이 지정됩니다. 증분 번들에는 increment="1" 또는 incremental="true" 값이 지정됩니다.
번들의 언어는 JobSpecification 요소 아래의 Language 매개 변수에 의해 식별됩니다.
<JobSpecification
…………………………..
<Parameter token="com.ptc.arbortext.
wvs/Language">
<Value>ja</Value>
</Parameter>
<Parameter token="Language">
<Value>ja</Value>
</Parameter>
……………….
</JobSpecification>
ReadyForTAL
파일
번들이 TAL할 준비가 완료되었음을 나타내는 0바이트 감시 파일입니다. 이 파일이 없으면 번들이 처리되지 않습니다.
referencedObjects.xml
파일
서로 다른 객체에서 참조되는 다양한 객체를 나타냅니다.
일반적인 IS 번들의 이 파일에는 relatedContext.xml을 통해 연결되는 컨텍스트(대상 속성)의 URI가 포함됩니다. ServiceInformation 속성과 관련된 PRODUCT 세부 정보와 같이 URI 및 관련 객체에 대한 세부 정보도 이 파일에 있습니다.
referencedParts.xml
파일
부품 목록에서 참조되는 모든 부품의 세부 정보를 제공하는 부품 관련 파일입니다.
relatedContexts.xml
파일
번들(일반적으로 IS 또는 PS)이 연관되는 컨텍스트를 나타냅니다.
relatedParts.xml
파일
대안, 대체 및 상호 참조와 같은 부품 관계에 대한 정보를 제공합니다.
translation.xml
파일
PH, IS, PS, PL, IEXML, PDFM, 그래픽 및 부품과 같은 서로 다른 비즈니스 객체에 사용되는 로컬리제이션된 속성의 로컬리제이션된 값을 제공합니다.
excludedObjects.xml
파일
이전에 게시된 콘텐츠에서 삭제될 콘텐츠의 URI를 제공합니다.
ModelItemPartObjects.xml
파일
소스 IEXML에서 0개 이상의 관련 IEXML 객체로의 링크를 생성하는 데 사용되는 일반 IE 아티팩트입니다.
contentMap.xml
파일
물리적 파일 매핑에 대한 URI를 제공하는 매핑 파일입니다. 체크섬, 메타 체크섬 및 수집된 날짜(데이터를 로드해야 할지를 결정하는 데 사용됨)에 대한 값도 포함합니다.
정보 구조 및 게시 구조
*-DMPMap.xml 파일은 IS 또는 PS 파일을 나타냅니다. 이러한 엔티티의 컴포넌트는 이 단원에서 설명합니다. 사용되는 용어는 SIM/SP에서 사용된 언어입니다. 예를 들어, IsRoot는 …|com.ptc.sis.IsRoot로 끝나는 wt.part.WTPart 소프트 유형입니다.
정보 구조에는 다음 노드가 포함됩니다.
• 노드 <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef(콘텐츠 홀더)
• 상위 노드에서 하위 노드로의 사용 링크
• 위의 노드 중 하나를 대상으로 하는 서비스 유효성
• 이러한 노드의 선택된 표현
구조는 그래픽, XML 문서 또는 부품 목록을 참조할 수 있습니다. 또한 이러한 참조된 객체에서 메타데이터를 가져올 수 있습니다.
게시 구조에는 다음 노드가 포함됩니다.
• 노드(생성된 후크 포함) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• 상위 노드에서 하위 노드로의 사용 링크
• 위의 노드 중 하나를 대상으로 하는 서비스 유효성
구조는 XML 문서 또는 부품 목록을 참조할 수 있습니다. 또한 이러한 참조된 객체에서 메타데이터를 가져올 수 있습니다.
이러한 구조 중 하나의 일반적인 노드 모양은 다음과 같습니다.
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
정보 요소에 대한 변경 사항이 없는 증분 번들에는 copy-to 속성이 없습니다.
정보 요소
모든 정보 요소는 주 콘텐츠 및 해당 메타데이터로 구성됩니다. Px 번들에서는 다음과 같은 여러 유형의 콘텐츠가 지원됩니다.
부품 목록 컴포넌트
• 부품 목록 자체
• 이미지 GDD(그래픽 동적 문서) 또는 사후 게시된 GDD
◦ 주요 콘텐츠
◦ 해당 표현
◦ 해당 첨부 파일
• 부품 목록 항목
◦ 부품
• 상위 노드에서 하위 노드로의 사용 링크
• 위의 항목 중 하나를 대상으로 하는 서비스 유효성
XML 문서 컴포넌트
• 주요 DD(동적 문서)
◦ 해당 메타데이터
◦ 해당 주요 콘텐츠
• 참조된 이미지
◦ 주요 콘텐츠
◦ 해당 표현
◦ 해당 첨부 파일
• 게시 프로세스 중에 해결된 XML 콘텐츠
◦ Xinclude
◦ DITA 항목 참조
◦ DITA conref, conkeyref 등
외부 XML 문서에 대한 상호 참조는 엔티티의 컴포넌트가 아닙니다.
그래픽 콘텐츠
• 주요 GDD(그래픽 동적 문서)
◦ 해당 메타데이터
◦ 해당 주요 콘텐츠
◦ 해당 표현
◦ 해당 첨부 파일
부품
• 부품
◦ 메타데이터(마스터 및 인스턴스)
◦ 관련 부품
◦ 부품을 대상으로 하는 서비스 유효성
◦ 축소판
현재 부품은 추출되고 게시되지만 게시한다고 해당 부품이 엔티티라는 의미가 아닙니다. 오히려 부품 목록의 컴포넌트임을 의미합니다. 현재 게시에는 관련된 부품이 포함됩니다.
서비스 유효성 마크업
서비스 유효성은 엔티티가 아니며 많은 엔티티와 연관된 정보입니다. 여러 IE 객체에 대한 필터링 정보를 나타냅니다. 이는 대상으로 하는 객체 내 메타데이터로 표시됩니다. 예를 들면 다음과 같습니다.
<Metadata ...
<Property token="ServiceEffectivity">
<Value>(OR (AND (PRODUCT '0000016602') (INSTANCE 'SUV_WE_EV4_SN001'
'SUV_WE_EV4_SN002')) (AND (PRODUCT '0000016610') (INSTANCE
'SUV_WE_EE_SN002' 'SUV_WE_EE_SN001')) (AND (PRODUCT '0000016611')
(INSTANCE 'SUV_WF_EV6T_SN001' 'SUV_WF_EV6T_SN002')) (AND (PRODUCT
'0000016617') (INSTANCE )))</Value>
</Property>
...
</Metadata>
번들 유형
Servigistics InService에는 두 가지 유형의 Px 번들이 있습니다. 번들 유형은 publishInfo.xml 파일을 기반으로 식별됩니다.
다음 유형이 지원됩니다.
• PH 번들
이 번들 유형은 통합 제품 계층 및 관련 제품 인스턴스에 대한 정보를 전달합니다. 일반적으로 이 번들의 데이터 유형은 다음과 같습니다.
◦ PH(제품 계층)(*Hierarchy.xml)
◦ PI(제품 인스턴스)(ProductInstances.xml)
◦ 옵션 및 선택 사항(OptionsDefinitions.xml)
◦ PublishInfo.xml
• IS 또는 PS 번들
이러한 번들 유형은 IS(정보 구조) 또는 PS(게시 구조)에 대한 정보를 전달합니다. 일반적으로 이 번들의 데이터 유형은 다음과 같습니다.
◦ relatedContext.xml
◦ IS
◦ 정보 요소(IEXML, PDFM, 그래픽, 부품 목록) - 일반적으로 IS를 통해 연결됩니다.
◦ 일반 정보 요소
◦ 부품 목록과 연관된 부품
◦ 부품 관계
◦ 부품 관련 문서
◦ 옵션 및 선택 사항
◦ 증상 트리
◦ PublishInfo.xml
• 비제품 번들
이 번들은 IS 번들과 비슷하지만 relatedContext.xml 파일이 없습니다. 이는 번들이 제품 컨텍스트와 연관되어 있지 않음을 의미합니다. 일반적으로 이러한 유형의 번들은 publishInfo.xml 파일에 정의된 범주와 연관됩니다.
번들의 컨텍스트 및 범주 식별
컨텍스트 정보는 항목이 연관된 제품 컨텍스트를 나타냅니다. Servigistics InService에서 컨텍스트는 시스템에서 여러 항목을 저장하고, 필터링하고, 찾는 데 사용됩니다. 일반적으로 IS 또는 PS 번들은 컨텍스트와 연관됩니다. PH 번들은 어떤 컨텍스트와도 연관되지 않습니다. 이 유형의 번들은 그 자체가 컨텍스트입니다. Servigistics InService에서 PH 번들은 모든 세그먼트에 로드됩니다.
Px 번들에는 번들이 연관된 컨텍스트를 식별하는 데 사용되는 relatedContext.xml 파일이 있습니다. 번들이 단일 또는 다중 컨텍스트를 참조할 수 있습니다. 다음은 relatedContext.xml 파일의 일부입니다. src 속성은 IS 또는 PS를 참조합니다. target 속성은 컨텍스트 정보를 참조합니다.
예를 들면 다음과 같습니다.
번들의 범주는 PublishInfo.xml 파일에 있습니다. 예를 들면 다음과 같습니다.
번들 감시 파일
감시 파일은 다양한 처리 상태를 나타내기 위해 번들에 생성되는 특수한 0바이트 파일입니다. 다음 감시 파일이 있을 수 있습니다.
• ReadyForTAL
이 파일은 번들 소유자가 생성합니다. 이 파일이 있으면 번들이 완전하게 생성되었고 TAL에 의해 처리될 수 있음을 나타냅니다.
• PrepTAL
이 파일은 여러 번들이 Transform and Load 작업을 사용하여 한 번 로드될 때 생성됩니다.
• TransformInProgress_Collection 또는 TransformInProgress_BundleID
이 파일의 이름은 콘텐츠 공유를 사용 가능으로 설정했는지 여부에 따라 결정됩니다. 콘텐츠 공유가 사용 가능으로 설정되지 않으면 해당 이름은 TransformInProgress_Collection입니다. 콘텐츠 공유가 사용 가능으로 설정되면 해당 이름은 TransformInProgress_BundleID입니다. 파일은 변환이 진행 중일 때 생성됩니다.
• TransformFailed_Collection 또는 TransformFailed_BundleID
이 파일의 이름은 콘텐츠 공유를 사용 가능으로 설정했는지 여부에 따라 결정됩니다. 콘텐츠 공유가 사용 가능으로 설정되지 않으면 해당 이름은 TransformFailed_Collection입니다. 콘텐츠 공유가 사용 가능으로 설정되면 해당 이름은 TransformFailed_BundleID입니다. 이 파일은 변환 작업이 실행되기 시작할 때 생성됩니다. 변환 작업에 성공하면 이 파일이 삭제됩니다.
• TransformCompleted_Collection 또는 TransformCompleted_BundleID
이 파일의 이름은 콘텐츠 공유를 사용 가능으로 설정했는지 여부에 따라 결정됩니다. 콘텐츠 공유가 사용 가능으로 설정되지 않으면 해당 이름은 TransformCompleted_Collection입니다. 콘텐츠 공유가 사용 가능으로 설정되면 해당 이름은 TransformCompleted_BundleID입니다. 이 파일은 변환 작업이 실행되기 시작할 때 생성됩니다. 이 파일은 컬렉션에 대한 변환 작업이 성공적으로 완료될 때 생성됩니다.
• tal_completed
이 파일은 변환 작업이 완료되면 생성됩니다.
• tal_failed
이 파일은 변환 작업이 실패하면 생성됩니다.
번들에서 객체 제외
번들에서 명시적으로 제외할 객체가 있는 경우 번들에 excludedObjects.xml 파일을 포함해야 합니다. 이 파일에는 번들과 함께 로드하지 않을 객체의 id 및 uri를 제공하는 일련의 Object 태그가 있습니다.
다음은 이러한 파일의 예입니다.
<?xml version="1.0" encoding="UTF-8"?>
<ExcludedObjects>
<Object id="PartListItem_8153223"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153223"/>
<Object id="PartListItem_8153222"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153222"/>
<Object id="WTPartMaster_8118901"
uri="x-wc://f5e0179d8f894049:wt.part.WTPartMaster:0069313461"/>
<Object id="WTPartMaster_8118955"
uri="x-wc://134e815ca9117606:wt.part.WTPartMaster:0069313463"/>
<Object id="WTPartMaster_8118947"
uri="x-wc://ce2ace730699a033:wt.part.WTPartMaster:0069313462"/>
<Object id="EPMDocumentMaster_8143009"
uri="x-wc://file=0000020874.png"/>
</ExcludedObjects>