Veröffentlichen und Laden in Servigistics InService > Veröffentlichen und Laden > PxTAL ausführen
  
PxTAL ausführen
Px-Bündelunterstützung
Bündelkompatibilität
TAL unterstützt Bündel aus Servigistics InService 6.5 und 7.1. Die Version wird auf Grundlage von Veröffentlichungsinformationen im Bündel identifiziert.
* 
Sie müssen entweder Bündel der Version 6.5 oder der Version 7.1 laden. Sie können nicht verschiedene Typen laden.
Bündeleinschränkungen
Nachfolgend sind einige Einschränkungen für Bündeldaten aufgeführt:
• Verwenden Sie in Dateinamen in Servigistics InService Bündeln nicht das Zeichen "#".
Wenn ein Dateiname dieses Zeichen enthält, schlägt der Transformations- und Ladeprozess mit dem folgenden Fehler fehl:
[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)
• Verwenden Sie den senkrechten Strich (|) nur dann in APEX-Eigenschaftswerten, wenn Sie damit ein logisches Oder darstellen.
Px-Bündelinhalt
Ein Px-Bündel besteht aus den in der folgenden Tabelle aufgeführten Ordnern und Dateien:
Name
Datei/Ordner
Beschreibung
com.ptc.arbortext.windchill.partlist.PartList
Ordner
Enthält Teilelisten, wie von *-DMPmap.xml referenziert. Der Ordnername ist normalerweise der Typname, auf dessen Basis Daten in SIM/SP erstellt werden.
com.ptc.ptcnet.DynamicDocument
Ordner
Enthält dynamische Dokumente, wie von *-DMPmap.xml referenziert. In der Regel ist der Inhalt für DITA XML, allgemeines XML, PDF oder Bilder spezifisch. Der Ordnername ist normalerweise der Typname, auf dessen Basis Daten in SIM/SP erstellt werden.
reps
Ordner
Enthält zugeordnete Bilder für *_Hierarchy.xml.
*_Hierarchy.xml
Datei
Produkthierarchiedatei, die die hierarchischen Informationen der Produktstruktur bereitstellt.
*_Hierarchy.xml.meta
Datei
Produkthierarchie-Metadatendatei
*-DMPmap.xml
Datei
Datei der Informationsstruktur (IS) oder Veröffentlichungsstruktur (PS), die normalerweise ein Inhaltsverzeichnis bereitstellt. Auch Daten sind in der hierarchischen Struktur vorhanden.
*-DMPmap.xml.meta
Datei
IS- oder PS-Begleit-Metadatendatei
OptionsDefinition.xml
Datei
Liste der Definition von Optionen und Auswahlmöglichkeiten zusammen mit der Zuordnung zum Kontext (PH oder IS).
partThumbnails.zip
Datei
Teilen zugeordnete Bilder.
ProductInstances.xml
Datei
Produktinstanzdatei, die die Zuordnung von Seriennummer zu Kontext enthält. Diese Datei enthält mehrere Werte in einer einzelnen Datei.
publishInfo.xml
Datei
Metadateninformationen zum veröffentlichten Bündel. In der Regel werden Bündel-ID, Veröffentlichungsdatum, Gebietsschema, Bündelsequenz und ein Kennzeichen angegeben, das anzeigt, ob dies ein vollständiges oder inkrementelles Bündel ist.
Die Datei enthält den Parameter Bundle-Source, um den Bündelbesitzer zu identifizieren. Wenn diese Eigenschaft nicht vorhanden ist, verwendet TAL standardmäßig die Eigenschaft orgName aus den Rootobjects der Bündelquelle.
Ob ein Bündel vollständig oder inkrementell ist, wird von den folgenden Eigenschaften bestimmt:
• JobSpecification/@increment
• JobSpecification/@incremental
Ein vollständiges Bündel hat die Werte increment="0" oder incremental="false". Ein inkrementelles Bündel hat die Werte increment="1" oder incremental="true".
Die Sprache des Bündels wird vom Parameter Language unter dem Element JobSpecification identifiziert:
<JobSpecification
…………………………..
<Parameter token="com.ptc.arbortext.
wvs/Language">
<Value>ja</Value>
</Parameter>
<Parameter token="Language">
<Value>ja</Value>
</Parameter>
……………….
</JobSpecification>
ReadyForTAL
Datei
Sentinel-Datei mit einer Größe von null Byte, die angibt, dass das Bündel für TAL bereit ist. Wenn diese Datei nicht vorhanden ist, wird das Bündel nicht verarbeitet.
referencedObjects.xml
Datei
Gibt verschiedene Objekte an, die von anderen Objekten referenziert werden.
In einem typischen IS-Bündel ist hierin der URI des Kontexts (als Zielattribut) enthalten, zu dem eine Verbindung über relatedContext.xml besteht. Die Details über den URI und die zugehörigen Objekte sind ebenfalls in dieser Datei enthalten, ebenso die zum ServiceInformation-Attribut gehörigen Produktdetails (PRODUCT):
referencedParts.xml
Datei
Teilespezifische Datei, die die Details aller von der Teileliste referenzierten Teile bereitstellt.
relatedContexts.xml
Datei
Gibt den Kontext an, dem das Bündel zugeordnet ist (in der Regel IS oder PS).
relatedParts.xml
Datei
Stellt Informationen zu Teilebeziehungen bereit, z.B. Alternativteil, Ablösung und Querverweis.
translation.xml
Datei
Stellt die lokalisierten Werte der lokalisierten Attribute bereit, die in verschiedenen Geschäftsobjekten verwendet werden, wie PH, IS, PS, PL, IEXML, PDFM, Grafiken und Teil.
excludedObjects.xml
Datei
Stellt die URIs von Inhalt bereit, der aus vorherigem veröffentlichtem Inhalt gelöscht werden soll.
ModelItemPartObjects.xml
Datei
Generisches IE-Artefakt, das verwendet wird, um Links von einer Quell-IEXML zu null oder mehr zugehörigen IEXML-Objekten zu erstellen.
contentMap.xml
Datei
Zuordnungsdatei, die den URI zu physischen Dateizuordnungen bereitstellt. Enthält außerdem Werte für Prüfsumme, Metaprüfsumme und Sammlungsdatum, mit deren Hilfe entschieden wird, ob Daten geladen werden müssen.
Informationsstrukturen und Veröffentlichungsstrukturen
Die Datei *-DMPMap.xml stellt die IS oder PS-Datei dar. Die Komponenten dieser Entitäten werden in diesem Abschnitt beschrieben. Die verwendete Terminologie stammt aus der in SIM/SP verwendeten Sprache. Beispielsweise ist IsRoot der Soft-Type wt.part.WTPart, der in …|com.ptc.sis.IsRoot endet.
Informationsstrukturen enthalten folgende Knoten:
• Knoten <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (d.h. Mappe)
• Verwendungs-Links von Elternknoten zu Kind
• Dienstgültigkeit für einen der oben genannten Knoten
• Ausgewählte Darstellungen dieser Knoten
Die Struktur kann Grafiken, XML-Dokumente oder Teilelisten referenzieren. Sie kann auch Metadaten von diesen referenzierten Objekten abrufen.
Veröffentlichungsstrukturen enthalten folgende Knoten:
• Knoten (einschließlich generierter Programmeinstieg) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• Verwendungs-Links von Elternknoten zu Kind
• Dienstgültigkeit für einen der oben genannten Knoten
Die Struktur kann XML-Dokumente oder Teilelisten referenzieren. Sie kann auch Metadaten von diesen referenzierten Objekten abrufen.
Ein typischer Knoten von einer dieser Strukturen würde wie folgt aussehen:
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
In einem inkrementellen Bündel ohne Änderungen an den Informationselementen ist das Attribut copy-to nicht vorhanden.
Informationselemente
Alle Informationselemente bestehen aus dem Hauptinhalt und den zugehörigen Metadaten. Die folgenden verschiedenen Inhaltstypen werden in Px-Bündeln unterstützt.
Teilelistenkomponenten
• Teileliste selbst
• Bild-GDD (dynamisches Dokument mit Grafiken) oder zugehöriges GDD nach Veröffentlichung
◦ Hauptinhalt
◦ Dessen Darstellungen
◦ Dessen Anhänge
• Teilelistenelement
◦ Teil
• Verwendungs-Links von Elternknoten zu Kind
• Dienstgültigkeit für eines der oben genannten Elemente
XML-Dokumentkomponenten
• Haupt-DD (dynamisches Dokument)
◦ Dessen Metadaten
◦ Dessen Hauptinhalt
• Referenziertes Bild
◦ Hauptinhalt
◦ Dessen Darstellungen
◦ Dessen Anhänge
• XML-Inhalt, der während des Veröffentlichungsprozesses gelöst wird
◦ Xinclude
◦ DITA-Topic-Referenz
◦ DITA-Conref, -Conkeyref usw.
Querverweise zu externen XML-Dokumenten sind keine Komponenten der Entität.
Grafikinhalt
• Haupt-GDD (dynamisches Dokument mit Grafiken)
◦ Dessen Metadaten
◦ Dessen Hauptinhalt
◦ Dessen Darstellungen
◦ Dessen Anhänge
Teil
• Teil
◦ Metadaten (Master und Variante)
◦ Zugehörige Teile
◦ Dienstgültigkeit für das Teil
◦ Miniaturansichten
Derzeit werden Teile sowohl extrahiert als auch veröffentlicht; bei der Veröffentlichung werden sie jedoch nicht als Entität behandelt, sondern als Komponente einer Teileliste. Die Veröffentlichung schließt derzeit zugehörige Teile ein.
Dienstgültigkeitsmarkierung
Dienstgültigkeit ist keine Entität, sondern eine Information, die vielen Entitäten zugeordnet ist. Sie stellt die Filterinformationen für die verschiedenen IE-Objekte dar. Sie wird als Metadaten in einem Objekt angezeigt, für das sie gilt. Beispiel:
<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>
Bündeltypen
In Servigistics InService gibt es zwei Typen von Px-Bündeln. Der Bündeltyp wird anhand der Datei publishInfo.xml identifiziert.
Die folgenden Typen werden unterstützt:
• PH-Bündel
Dieser Bündeltyp enthält die Informationen zur einheitlichen Produkthierarchie und zugehörigen Produktinstanz. Normalerweise enthält dieses Bündel die folgenden Typen von Daten:
◦ Produkthierarchie (PH) (*Hierarchy.xml)
◦ Produktinstanzen (PI) (ProductInstances.xml)
◦ Optionen und Auswahlmöglichkeiten (OptionsDefinitions.xml)
◦ PublishInfo.xml
• IS- oder PS-Bündel
Diese Bündeltypen enthalten Informationen zur Informationsstruktur (IS) oder Veröffentlichungsstruktur (PS). Normalerweise enthält dieses Bündel die folgenden Typen von Daten:
◦ relatedContext.xml
◦ IS
◦ Informationselemente (IEXML, PDFM, Grafiken, Teileliste) – in der Regel über IS verbunden
◦ Generische Informationselemente
◦ Teilelisten zugeordnete Teile
◦ Teilebeziehungen
◦ Teilebezogene Dokumente
◦ Optionen und Auswahlmöglichkeiten
◦ Symptombaum
◦ PublishInfo.xml
• Nicht-Produktbündel
Dieses Bündel ist ähnlich wie das IS-Bündel, aber ohne die Datei relatedContext.xml. Dies zeigt an, dass das Bündel keinem Produktkontext zugeordnet ist. In der Regel sind diese Bündeltypen einer Kategorie zugeordnet, die in der Datei publishInfo.xml definiert wird.
Kontext und Kategorie eines Bündels identifizieren
Kontextinformationen geben den Produktkontext an, dem ein Element zugeordnet ist. In Servigistics InService wird der Kontext verwendet, um verschiedene Elemente im System zu speichern, zu filtern und zu suchen. Normalerweise ist ein IS- oder PS-Bündel einem Kontext zugeordnet. Beachten Sie, dass ein PH-Bündel keinem Kontext zugeordnet ist, da dieser Bündeltyp selbst der Kontext ist. In Servigistics InService werden PH-Bündel in jedes Segment geladen.
In einem Px-Bündel gibt es eine Datei namens relatedContext.xml, die verwendet wird, um den Kontext zu identifizieren, dem das Bündel zugeordnet ist. Beachten Sie, dass ein Bündel einen einzelnen oder mehrere Kontexte referenzieren kann. Nachfolgend ist ein Teil der Datei relatedContext.xml dargestellt. Das src-Attribut bezieht sich auf die IS oder PS. Das Attribut target bezieht sich auf Kontextinformationen.
Beispiel:
Die Kategorie eines Bündels ist in der Datei PublishInfo.xml enthalten. Beispiel:
Bündel-Sentinel-Dateien
Sentinel-Dateien sind spezielle Null-Byte-Dateien, die im Bündel erstellt werden, um unterschiedliche Verarbeitungsstadien zu signalisieren. Die folgenden Sentinel-Dateien können vorhanden sein:
• ReadyForTAL
Diese Datei wird vom Bündelbesitzer generiert. Das Vorhandensein dieser Datei bedeutet, dass das Bündel vollständig generiert wurde und von TAL verarbeitet werden kann.
• PrepTAL
Diese Datei wird erstellt, wenn mehrere Bündel gleichzeitig mit der Aufgabe "Transform and Load" geladen werden.
• TransformInProgress_Collection oder TransformInProgress_BundleID
Der Name dieser Datei wird dadurch bestimmt, ob Sie die Inhaltsfreigabe aktiviert haben. Sie heißt TransformInProgress_Collection, wenn die Inhaltsfreigabe nicht aktiviert ist. Sie heißt TransformInProgress_BundleID, wenn die Inhaltsfreigabe aktiviert ist. Die Datei wird erstellt, wenn die Transformation ausgeführt wird.
• TransformFailed_Collection oder TransformFailed_BundleID
Der Name dieser Datei wird dadurch bestimmt, ob Sie die Inhaltsfreigabe aktiviert haben. Sie heißt TransformFailed_Collection, wenn die Inhaltsfreigabe nicht aktiviert ist. Sie heißt TransformFailed_BundleID, wenn die Inhaltsfreigabe aktiviert ist. Diese Datei wird von der Transformationsaufgabe erstellt, wenn ihre Ausführung gestartet wird. Die Datei wird gelöscht, wenn die Transformationsaufgabe erfolgreich ist.
• TransformCompleted_Collection oder TransformCompleted_BundleID
Der Name dieser Datei wird dadurch bestimmt, ob Sie die Inhaltsfreigabe aktiviert haben. Sie heißt TransformCompleted_Collection, wenn die Inhaltsfreigabe nicht aktiviert ist. Sie heißt TransformCompleted_BundleID, wenn die Inhaltsfreigabe aktiviert ist. Diese Datei wird von der Transformationsaufgabe erstellt, wenn ihre Ausführung gestartet wird. Diese Datei wird nach erfolgreichem Abschluss der Transformationsaufgabe für eine Sammlung erstellt.
• tal_completed
Diese Datei wird erstellt, wenn die Transformationsaufgabe abgeschlossen ist.
• tal_failed
Diese Datei wird erstellt, wenn die Transformationsaufgabe fehlschlägt.
Objekte aus einem Bündel ausschließen
Wenn Sie bestimmte Objekte explizit aus einem Bündel ausschließen möchten, müssen Sie die Datei excludedObjects.xml in das Bündel einschließen. Diese Datei enthält eine Reihe von Object-Tags, in denen Sie die id und den uri der Objekte angeben, die Sie nicht mit dem Bündel laden möchten.
Nachstehend sehen Sie ein Beispiel dieser Datei:
<?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>