Esecuzione di PxTAL
Supporto di bundle di Px
Compatibilità dei bundle
Il processo TAL supporta i bundle di Servigistics InService 6.5 e 7.1. La versione viene identificata in base alle informazioni di pubblicazione presenti nel bundle.
|
|
È necessario scegliere se caricare i bundle 6.5 o 7.1 perché non è possibile caricare tipi differenti.
|
Limitazioni dei bundle
Di seguito sono riportate alcune limitazioni per i dati dei bundle.
• Non utilizzare il carattere "#" nei nomi file che si trovano in bundle di Servigistics InService.
Se un nome file contiene questo carattere, il processo di trasformazione e caricamento restituisce l'errore indicato di seguito.
[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)
• Non utilizzare la barra verticale ( | ) nei valori della proprietà APEX a meno che non sia necessaria per rappresentare un valore OR logico.
Contenuto del bundle Px
Un bundle Px è costituito dalle cartelle e i file riportati nella tabella di seguito.
|
Name
|
File/Cartella
|
Descrizione
|
|
com.ptc.arbortext.windchill.partlist.PartList
|
Cartella
|
Contiene gli elenchi di parti come referenziati da *-DMPmap.xml. Il nome della cartella di solito è il nome tipo basato sui dati creati in SIM/SP.
|
|
com.ptc.ptcnet.DynamicDocument
|
Cartella
|
Contiene i documenti dinamici come referenziati da *-DMPmap.xml. In genere, il contenuto è specifico di XML DITA, XML generale, PDF o immagini. Il nome della cartella di solito è il nome tipo basato sui dati creati in SIM/SP.
|
|
reps
|
Cartella
|
Contiene le immagini associate per *_Hierarchy.xml.
|
|
*_Hierarchy.xml
|
File
|
File di Gerarchia prodotti che fornisce informazioni sulla gerarchia della struttura del prodotto.
|
|
*_Hierarchy.xml.meta
|
File
|
File di metadati di Gerarchia prodotti
|
|
*-DMPmap.xml
|
File
|
File della struttura informazioni (IS) o della struttura pubblicazione (PS), che in genere fornisce un sommario. I dati sono presenti anche nella struttura gerarchica.
|
|
*-DMPmap.xml.meta
|
File
|
File di metadati supplementare IS o PS
|
|
OptionsDefinition.xml
|
File
|
Elenco di opzioni e definizione di scelte con la relativa associazione al contesto (PH o IS).
|
|
partThumbnails.zip
|
File
|
Immagini associate alle parti.
|
|
ProductInstances.xml
|
File
|
File dell'istanza di prodotto che fornisce il numero di serie alla mappatura di contesto. Questo file contiene più valori in un singolo file.
|
|
publishInfo.xml
|
File
|
Informazioni sui metadati correlate al bundle pubblicato. In genere indicano l'ID bundle, la data di pubblicazione, la lingua, la sequenza di bundle e un flag che indica se è un bundle completo o incrementale.
Il file contiene un parametro Bundle-Source che identifica il proprietario del bundle. Se questa proprietà non esiste, il processo TAL utilizza di default la proprietà orgName da Rootobjects dell'origine del bundle.
Le proprietà di seguito determinano se un bundle è completo o incrementale.
• JobSpecification/@increment
• JobSpecification/@incremental
Un bundle completo avrà valori come increment="0" o incremental="false". Un bundle incrementale avrà valori come increment="1" o incremental="true".
La lingua del bundle è identificata dal parametro Language nell'elemento JobSpecification:
|
|
ReadyForTAL
|
File
|
Il file sentinel a zero byte che indica il bundle è pronto per TAL. Se questo file non è presente, allora il bundle non viene elaborato.
|
|
referencedObjects.xml
|
File
|
Indica i vari oggetti con riferimento da oggetti diversi.
In un tipico bundle IS, contiene l'URI di contesto (come attributo di destinazione) a cui è connesso tramite relatedContext.xml. In questo file sono presenti anche dettagli dell'URI e gli oggetti correlati così come i dettagli del prodotto (PRODUCT) correlati all'attributo ServiceInformation.
|
|
referencedParts.xml
|
File
|
File specifico della parte che fornisce i dettagli di tutte le parti referenziate dall'elenco parti.
|
|
relatedContexts.xml
|
File
|
Indica il contesto a cui il bundle (di solito, IS o PS) è associato.
|
|
relatedParts.xml
|
File
|
Fornisce informazioni sulle relazioni della parte, ad esempio Alternativa, Sostituzione e Riferimento incrociato.
|
|
translation.xml
|
File
|
Fornisce i valori localizzati degli attributi localizzati utilizzati nei diversi business object, ad esempio PH, IS, PS, PL, IEXML, PDFM, Immagini e Parte.
|
|
excludedObjects.xml
|
File
|
Fornisce gli URI del contenuto che deve essere eliminato dal precedente contenuto pubblicato.
|
|
ModelItemPartObjects.xml
|
File
|
Elemento IE generico utilizzato per creare link da un'origine IEXML a zero o più oggetti IEXML correlati.
|
|
contentMap.xml
|
File
|
File mappatura che fornisce l'URI alle mappatura dei file fisici. Contiene inoltre i valori per checksum, metachecksum e data raccolta utilizzati per decidere se i dati devono essere caricati.
|
Struttura informazioni e strutture di pubblicazione
Il file *-DMPMap.xml rappresenta il file IS o PS. I componenti di queste entità sono descritti in questa sezione. La terminologia utilizzata proviene dalla lingua utilizzata in SIM/SP. Ad esempio, IsRoot è la wt.part.WTPart fine del tipo soft in …|com.ptc.sis.IsRoot.
Le strutture informazioni contengono i nodi riportati di seguito.
• Nodi <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (ovvero contenitore)
• Link di utilizzo dal nodo padre al figlio
• Effettività di servizio diretta a uno dei nodi di cui sopra
• Rappresentazioni selezionate di questi nodi
La struttura può fare riferimento a grafici, documenti XML o elenchi parti. Può inoltre ottenere i metadati dagli oggetti referenziati.
Le strutture di pubblicazione contengono i nodi riportati di seguito.
• Nodi (compreso l'hook generato) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• Link di utilizzo dal nodo padre al figlio
• Effettività di servizio diretta a uno dei nodi di cui sopra
La struttura può fare riferimento documenti XML o elenchi parti. Può inoltre ottenere i metadati dagli oggetti referenziati.
Un tipico nodo da una di queste strutture assomiglierebbe a quanto riportato di seguito.
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
In un bundle incrementale senza modifiche agli elementi informativi, l'attributo copy-to non è presente.
Elementi informativi
Tutti gli elementi informativi sono comprensivi del contenuto principale e dei relativi metadati. I seguenti diversi tipi di contenuto sono supportati nei bundle di Px.
Componenti dell'elenco parti
• Elenco parti
• Immagine GDD (graphic dynamic document) o il relativo GDD successivo alla pubblicazione
◦ Contenuto principale
◦ Relative rappresentazioni
◦ Relativi allegati
• PartListItem
◦ Parte
• Link di utilizzo dal nodo padre al figlio
• Effettività di servizio diretta a uno degli elementi di cui sopra
Componenti del documento XML
• DD principale (documento dinamico)
◦ Relativi metadati
◦ Relativo contenuto principale
• Immagine referenziata
◦ contenuto principale
◦ Relative rappresentazioni
◦ Relativi allegati
• Contenuto XML risolto durante il processo di pubblicazione
◦ Xinclude
◦ Riferimento all'argomento DITA
◦ Conref DITA, conkeyref e così via
I riferimenti incrociati ai documenti XML esterni non sono componenti dell'entità.
Contenuto dell'immagine
• GDD (documento dinamico di immagine) principale
◦ Relativi metadati
◦ Relativo contenuto principale
◦ Relative rappresentazioni
◦ Relativi allegati
Parte
• Parte
◦ Metadati (master e istanza)
◦ Parti correlate
◦ Effettività di servizio che presenta la parte
◦ Miniature
Al momento le parti vengono estratte e pubblicate, ma la pubblicazione non le considera un'entità, piuttosto un componente di un elenco parti. La pubblicazione attualmente include parti correlate.
Markup di effettività del servizio
L'effettività di servizio non è un'entità, ma rappresenta le informazioni associate a più entità. Rappresenta le informazioni di filtraggio sui diversi oggetti IE e appare come metadati all'interno di un qualsiasi oggetto a cui è diretta. Esempio:
Tipi di bundle
In Servigistics InService sono disponibili due tipi di bundle di Px. Il tipo di bundle viene identificato in base al file publishInfo.xml.
Sono supportati i tipi indicati di seguito.
• Bundle PH
Questo tipo di bundle include le informazioni sulla gerarchia di prodotti unificata e l'istanza di prodotto correlata. Generalmente questo bundle ha i seguenti tipi di dati:
◦ Gerarchia del prodotto (PH) (*Hierarchy.xml)
◦ Istanze di prodotto (PI) (ProductInstances.xml)
◦ Opzioni e scelte (OptionsDefinitions.xml)
◦ PublishInfo.xml
• Bundle IS o PS
Questi tipi di bundle contengono le informazioni sulla struttura informazioni (IS) o la struttura di pubblicazione (PS). Generalmente questo bundle ha i seguenti tipi di dati:
◦ relatedContext.xml
◦ IS
◦ Elementi informativi (IEXML, PDFM, immagini, elenco parti), di solito connessi attraverso IS
◦ Elementi informativi generici
◦ Parti associate agli elenchi parti
◦ Relazioni di parti
◦ Documenti correlati a parti
◦ Opzioni e scelte
◦ Struttura ad albero di sintomi
◦ PublishInfo.xml
• Bundle non di prodotto
Questo bundle è simile al bundle IS, ma senza il file relatedContext.xml. Ciò indica che il bundle non è associato ad alcun contesto del prodotto. Tali tipi di bundle sono di solito associati a una categoria definita nel file publishInfo.xml.
Identificazione del contesto e della categoria di un bundle
Le informazioni di contesto indicano il contesto del prodotto a cui è associato un elemento. In Servigistics InService il contesto è utilizzato per memorizzare, filtrare e individuare i diversi elementi nel sistema. Generalmente un bundle IS o PS è associato a un contesto. Un bundle PH non è associato ad alcun contesto in quanto questo tipo di bundle è esso stesso il contesto. In Servigistics InService i bundle PH sono caricati in ogni segmento
In un bundle Px, è presente un file relatedContext.xml utilizzato per identificare il contesto a cui è associato il bundle. Tenere presente che un bundle può fare riferimento a uno o più contesti. Di seguito è riportata parte del file relatedContext.xml. L'attributo src si riferisce alla struttura informazioni (IS) o alla struttura di pubblicazione (PS). L'attributo target fa riferimento alle informazioni di contesto.
Esempio:
La categoria di bundle si trova nel file PublishInfo.xml. Esempio:
File sentinel di bundle
I file sentinel sono speciali file a zero byte creati nel bundle per segnalare i differenti stati di elaborazione. È possibile che siano presenti i seguenti file sentinel:
• ReadyForTAL
Questo file viene generato dal proprietario del bundle. La sua presenza indica che il bundle è stato generato completamente e può essere elaborato dal processo TAL.
• PrepTAL
Questo file viene creato quando più bundle più vengono caricati in una volta sola con il task di trasformazione e caricamento (TAL).
• TransformInProgress_Collection o TransformInProgress_BundleID
Il nome di questo file è determinato dall'attivazione della condivisione del contenuto. Quando la condivisione del contenuto non è attivata, il file si chiama TransformInProgress_Collection. Se invece la condivisione del contenuto è attivata, il file si chiama TransformInProgress_BundleID. Il file viene creato durante il processo di trasformazione.
• TransformFailed_Collection o TransformFailed_BundleID
Il nome di questo file è determinato dall'attivazione della condivisione del contenuto. Quando la condivisione del contenuto non è attivata, il file si chiama TransformFailed_Collection. Se invece la condivisione del contenuto è attivata, il file si chiama TransformFailed_BundleID. Questo file viene creato dal task di trasformazione all'inizio dell'esecuzione. Il file viene eliminato se il task di trasformazione viene completato correttamente.
• TransformCompleted_Collection o TransformCompleted_BundleID
Il nome di questo file è determinato dall'attivazione della condivisione del contenuto. Quando la condivisione del contenuto non è attivata, il file si chiama TransformCompleted_Collection. Se invece la condivisione del contenuto è attivata, il file si chiama TransformCompleted_BundleID. Questo file viene creato dal task di trasformazione all'inizio dell'esecuzione. Questo file viene creato in seguito al corretto completamento del task di trasformazione per una raccolta.
• tal_completed
Questo file viene creato una volta completato il task di trasformazione.
• tal_failed
Questo file viene creato se il task di trasformazione non riesce.
Esclusione di oggetti da un bundle
Se sono presenti degli oggetti che si desidera escludere in maniera specifica da un bundle, è necessario includere il file excludedObjects.xml nel bundle. In questo file è una serie di tag Object in cui fornire id e uri degli oggetti che non si desidera caricare con il bundle.
Di seguito è riportato un esempio di questo file.
<?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>
