Da RosettaNet von Zeit zu Zeit PIPs hinzufügt, müssen Sie möglicherweise Ihre eigenen PIP-Pakete erstellen, um diese neuen PIPs zu unterstützen oder um Upgrades für PIPs zu unterstützen. Die Prozeduren in diesem Abschnitt beschreiben, mit Ausnahme der angegeben Stellen, wie das PIP-Dokumentenflusspaket für PIP 5C4 V01.03.00 erstellt wird. Business Integration Connect stellt ein PIP-Dokumentenflusspaket für PIP 5C4 V01.02.00 bereit, so dass die Prozeduren tatsächlich dokumentieren, wie ein Upgrade ausgeführt wird. Das Erstellen eines PIP-Dokumentenflusspakets ist allerdings gleich und die Prozeduren geben alle zusätzlichen Schritte an.
Bevor Sie beginnen, laden Sie die PIP-Spezifikationen von www.rosettanet.org für die neue Version und, falls Sie ein Upgrade ausführen, auch für die alte Version herunter. Wenn Sie z. B. das Upgrade ausführen, das in den Prozeduren beschrieben ist, laden Sie 5C4_DistributeRegistrationStatus_V01_03_00.zip und 5C4_DistributeRegistrationStatus_V01_02_00.zip herunter. Die Spezifikation umfasst die folgenden Dateitypen:
Das Erstellen oder Upgraden eines PIP-Dokumentenflusspakets umfasst die folgenden Prozeduren:
Ein PIP-Dokumentenflusspaket enthält XML-Schemadateien, die die Nachrichtenformate und zulässige Werte für Elemente definieren. Die folgende Prozedur beschreibt, wie Sie diese Dateien basierend auf dem Inhalt der PIP-Spezifikationsdatei erstellen.
Sie erstellen mindestens eine XSD-Datei für jede DTD-Datei in der PIP-Spezifikationsdatei. Im Falle eines Upgrades auf PIP 5C4 V01.03.00 beschreibt die Prozedur, da das Nachrichtenformat sich geändert hat, als Beispiel wie Sie die Datei BCG_5C4RegistrationStatusNotification_V01.03.xsd erstellen. Weitere Informationen zu XSD-Dateien finden Sie in Informationen zur Validierung.
Gehen Sie wie folgt vor, um die XSD-Dateien für das PIP-Dokumentenflusspaket zu erstellen:
Im Allgemeinen stimmen die Elemente in den Richtlinien mit den Definitionen der Elemente in der DTD-Datei überein. Die Richtlinien könnten jedoch einige Elemente enthalten, die denselben Namen aber unterschiedliche Kardinalitäten haben. Da die DTD-Datei in diesem Fall nicht die Kardinalität zur Verfügung stellen kann, müssen Sie die XSD-Datei modifizieren. Die Richtliniendatei 5C4_MG_V01_03_00_RegistrationStatusNotification.htm hat z. B. eine Definition für ContactInformation in Zeile 15, die über fünf untergeordnete Elemente mit den folgenden Kardinalitäten verfügt:
1 contactName
0..1 EmailAddress
0..1 facsimileNumber
0..1 PhysicalLocation
0..1 telephoneNumber
Die Definition für ContactInformation in Zeile 150 verfügt über vier untergeordnete Elemente mit den folgenden Kardinalitäten:
1 contactName
1 EmailAddress
0..1 facsimileNumber
1 telephoneNumber
In der XSD-Datei verfügt aber jedes untergeordnete Element von ContactInformation über eine Kardinalität, die beiden Definitionen entspricht:
<xsd:element name="ContactInformation"> <xsd:complexType> <xsd:sequence> <xsd:element ref="contactName"/> <xsd:element maxOccurs="1" minOccurs="0" ref="EmailAddress"/> <xsd:element maxOccurs="1" minOccurs="0" ref="facsimileNumber"/> <xsd:element maxOccurs="1" minOccurs="0" ref="PhysicalLocation"/> <xsd:element maxOccurs="1" minOccurs="0" ref="telephoneNumber"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Wenn Sie das PIP-Dokumentenflusspaket basierend auf einer anderen Version des Pakets aktualisieren, und Sie eine Definition von der anderen Version wiederverwenden wollen, führen Sie für jede dieser Definitionen Folgendes aus:
<xsd:complexType name="ContactInformation_type7"> <xsd:sequence> <xsd:element name="contactName" type="common_FreeFormText_R"/> <xsd:element name="EmailAddress" type="common_EmailAddres_R" minOccurs="0"/> <xsd:element name="facsimileNumber" type="common_CommunicationsNumber_R" minOccurs="0"/> <xsd:element name="PhysicalLocation" type="PhysicalLocation_type1" minOccurs="0" /> <xsd:element name="telephoneNumber" type="common_CommunicationsNumber_R minOccurs="0" /> </xsd:sequence> </xsd:complexType>
<xsd:include schemaLocation="BCG_ContactInformation_Types.xsd"/>
name="ContactInformation type="ContactInformation_type7"
Wenn Sie ein PIP-Dokumentenflusspaket erstellen, oder Sie ein PIP-Dokumentenflusspaket upgraden, aber die benötigte Definition nicht in der anderen Version vorhanden ist, führen Sie Folgendes für jedes Exemplar des Elements aus, das Sie in den Richtlinien gefunden haben:
<xsd:complexType name="ContactInformation_localType1"> <xsd:sequence> <xsd:element ref="contactName"/> <xsd:element maxOccurs="1" minOccurs="0" ref="EmailAddress"/> <xsd:element maxOccurs="1" minOccurs="0" ref="facsimileNumber"/> <xsd:element maxOccurs="1" minOccurs="0" ref="PhysicalLocation"/> <xsd:element maxOccurs="1" minOccurs="0" ref="telephoneNumber"/> </xsd:sequence> </xsd:complexType>
name="ContactInformation type="ContactInformation_localType1"
Element productProviderFieldApplicationEngineer vor der Modifikation
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element ref="ContactInformation"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Element productProviderFieldApplicationEngineer nach der Modifikation
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element name="ContactInformation" type="ContactInformation_localType1"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Daher kann in einer PIP 5C4 V01.03.00-Nachricht GlobalRegistrationComplexityLevelCode nur über die folgenden Werte verfügen: Above average (Über dem Durchschnitt), Average (Durchschnitt), Maximum (Maximum), Minimum (Minimum), None (Kein) und Some (Einiges).
Wenn Sie das PIP-Dokumentenflusspaket basierend auf einer anderen Version des Pakets aktualisieren, und Sie eine Gruppe von Aufzählungswerten von der anderen Version wiederverwenden wollen, führen Sie für jede dieser Gruppen Folgendes aus:
<xsd:simpleType name="_GlobalRegistrationComplexityLevelCode"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Above average"/> <xsd:enumeration value="Average"/> <xsd:enumeration value="Maximum"/> <xsd:enumeration value="Minimum"/> <xsd:enumeration value="None"/> <xsd:enumeration value="Some"/> </xsd:restriction> </xsd:simpleType>
<xsd:include schemaLocation= "BCG_GlobalRegistrationComplexityLevelCode_Types.xsd" />
name="GlobalRegistrationComplexityLevelCode" type="_GlobalRegistrationComplexityLevelCode"
Wenn Sie ein PIP-Dokumentenflusspaket erstellen, oder Sie ein PIP-Dokumentenflusspaket upgraden, aber die benötigten Aufzählungswertdefinitionen nicht in der anderen Version vorhanden sind, führen Sie Folgendes für jedes Element mit Aufzählungswerten in den Richtlinien aus:
<xsd:simpleType name="GlobalRegistrationComplexityLevelCode_localType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Above average"/> <xsd:enumeration value="Average"/> <xsd:enumeration value="Maximum"/> <xsd:enumeration value="Minimum"/> <xsd:enumeration value="None"/> <xsd:enumeration value="Some"/> </xsd:restriction> </xsd:simpleType>
name="GlobalRegistrationComplexityLevelCode" type="GlobalRegistrationComplexityLevelCode_localType"
Element DesignAssemblyInformation vor der Modifikation
<xsd:element name="DesignAssemblyInformation"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="0" ref="assemblyComments"/> <xsd:element maxOccurs="1" minOccurs="0" ref="demandCreatorTrackingIdentifier"/> <xsd:element maxOccurs="unbounded" minOccurs="0" ref="DesignPartInformation"/> <xsd:element ref="DesignRegistrationIdentification"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GeographicRegion"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationComplexityLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationInvolvementLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="RegistrationStatus"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Element DesignAssemblyInformation nach der Modifikation
<xsd:element name="DesignAssemblyInformation"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="0" ref="assemblyComments"/> <xsd:element maxOccurs="1" minOccurs="0" ref="demandCreatorTrackingIdentifier"/> <xsd:element maxOccurs="unbounded" minOccurs="0" ref="DesignPartInformation"/> <xsd:element ref="DesignRegistrationIdentification"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GeographicRegion"/> <xsd:element maxOccurs="1" minOccurs="0" name="GlobalRegistrationComplexityLevelCode" type="GlobalRegistrationComplexityLevelCode_localType"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationInvolvementLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="RegistrationStatus"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Wenn Sie das PIP-Dokumentenflusspaket basierend auf einer anderen Version des Pakets aktualisieren, und Sie eine Datenentitätsdefinition von der anderen Version wiederverwenden wollen, führen Sie für jede Gruppe Folgendes aus:
<xsd:simpleType name="_common_DateStamp_R"> <xsd:restriction base="xsd:string"> <xsd:pattern value="[0-9]{8}Z" /> </xsd:restriction> </xsd:simpleType>
<xsd:include schemaLocation="BCG_common.xsd" />
name="DateStamp" type="_common_DateStamp_R"
Wenn Sie ein PIP-Dokumentenflusspaket erstellen, oder Sie ein PIP-Dokumentenflusspaket upgraden, aber die benötigte Datenentitätsdefinition nicht in der anderen Version vorhanden ist, führen Sie Folgendes für jedes Datenentitätselement aus:
<xsd:simpleType name="DateStamp_localType"> <xsd:restriction base="xsd:string"> <xsd:pattern value="[0-9]{8}Z" /> </xsd:restriction> </xsd:simpleType>
name="DateStamp" type="DateStamp_localType"
Element beginDate vor der Modifikation
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element ref="DateStamp"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Element beginDate nach der Modifikation
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element name="DateStamp" type="DateStamp_localType"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Nachdem Sie die XSD-Dateien für Ihr PIP-Dokumentenflusspaket erstellt haben, können Sie nun die XML-Datei für das Paket RNIF und die XML-Datei für das Paket Backend Integration erstellen. Diese Pakete heißen z. B. jeweils BCG_RNIFV02.00_5C4V01.03.zip und BCG_RNSC1.0_RNIFV02.00_5C4V01.03.zip. Die folgende Prozedur beschreibt, wie Sie die XML-Datei für das RNIF-Paket erstellen:
Tabelle 8. 5C4 PIP-Aktualisierungsinformationen
Zu ändernde Informationen | Alter Wert | Neuer Wert |
PIP-ID
|
5C4
|
5C4
|
PIP-Version
|
V01.02
|
V01.03
|
Der Name der Anforderungsnachrichten-DTD-Datei ohne Dateierweiterung
|
5C4_MS_V01_02_
|
5C4_MS_V01_03_
|
Der Name der Bestätigungsnachrichten-DTD-Datei ohne Dateierweiterung (nur
für Doppelaktions-PIPs)
|
N/A
|
N/A
|
Der Name der Anforderungsnachrichten-XSD-Datei ohne Dateierweiterung
|
BCG_5C4RegistrationStatusNotification_
|
BCG_5C4RegistrationStatusNotification_
|
Der Name der Bestätigungsnachrichten-XSD-Datei ohne Dateierweiterung (nur
für Doppelaktions-PIPs)
|
N/A
|
N/A
|
Rootelementname in der XSD-Datei für die Anforderungsnachricht
|
Pip5C4RegistrationStatusNotification
|
Pip5C4RegistrationStatusNotification
|
Rootelementname in der XSD-Datei für die Bestätigungsnachricht (nur für
Doppelaktions-PIPs)
|
N/A
|
N/A
|
Tabelle 9. 5C4 PIP-Aktualisierungsinformationen von der PIP-Spezifikation
Zu aktualisierende Informationen | Beschreibung | Wert im 5C4-Paket |
Aktivitätsname
|
Angegeben in Tabelle 3-2
|
Distribute Registration Status
|
Initiatorrollenname
|
Angegeben in Tabelle 3-1
|
Product Provider
|
Responderrollenname
|
Angegeben in Tabelle 3-1
|
Demand Creator
|
Anforderungsaktionsname
|
Angegeben in Tabelle 4-2
|
Registration Status Notification
|
Bestätigungsaktionsname
|
Angegeben in Tabelle 4-2 (nur für Doppelaktions-PIPs)
|
N/A
|
Tabelle 10. 5C4 PIP-Attributaktualisierungen
Zu aktualisierende Informationen | Beschreibung | Wert im 5C4-Paket | Elementpfad in der XML-Datei |
NonRepudiationRequired
|
Angegeben in Tabelle 3-3
|
N
|
ns1:Package
|
NonRepudiationOfReceipt
|
Angegeben in Tabelle 3-3
|
N
|
ns1:Package
|
DigitalSignatureRequired
|
Angegeben in Tabelle 5-1
|
Y
|
ns1:Package
|
TimeToAcknowledge
|
Angegeben in Tabelle 3-3
|
2
|
ns1:Package
|
TimeToPerform
|
Angegeben in Tabelle 3-3
|
2
|
ns1:Package
|
RetryCount
|
Angegeben in Tabelle 3-3
|
3
|
ns1:Package
|
Um das Paket Backend Integration zu erstellen, wiederholen Sie die oben aufgeführte Prozedur, mit Ausnahme der folgenden Unterschiede:
Nachdem Sie die XML- und XSD-Dateien erstellt haben, können Sie die PIP-Dokumentenflusspakete erstellen.
Gehen Sie wie folgt vor, um das RNIF-Paket zu erstellen:
Um das Paket Backend Integration zu erstellen, führen Sie die oben aufgeführte Prozedur aus, aber verwenden Sie die Backend Integration-XML-Datei anstelle der RNIF-Datei.
Nachdem Sie das PIP-Paket erstellt haben, können Sie es mit der im Abschnitt RNIF-Pakete hochladen beschriebenen Prozedur hochladen.