RosettaNet ajoutant des processus PIP de temps en temps, il peut s'avérer nécessaire de créer vos propres regroupements PIP pour prendre en charge ces nouveaux processus ou les mises à niveau des processus existants. Sauf indication contraire, les procédures de cette section indiquent comment créer le regroupement de flot de documents PIP pour PIP 5C4 V01.03.00. WebSphere Partner Gateway fournit un regroupement de flot de documents PIP pour le PIP 5C4 V01.02.00. Par conséquent, les procédures décrivent en réalité la procédure de mise à niveau. Cependant, la création d'un regroupement de flot de documents PIP est la même et les procédures identifient les éventuelles étapes supplémentaires.
Avant de commencer, téléchargez les spécifications PIP à partir de www.rosettanet.org pour la nouvelle version et, si vous procédez à une mise à niveau, l'ancienne version. Par exemple, si vous effectuez la mise à niveau décrite dans les procédures, téléchargez 5C4_DistributeRegistrationStatus_V01_03_00.zip et 5C4_DistributeRegistrationStatus_V01_02_00.zip. La spécification comprend les types de fichier suivants :
La création ou la mise à niveau d'un regroupement de flot de documents PIP comprend les procédures suivantes :
Un regroupement de flot de documents PIP contient des fichiers de schéma XML qui définissent les formats de message et les valeurs acceptables pour les éléments. La procédure suivante indique comment créer ces fichiers à partir du contenu du fichier de spécification PIP.
Vous créez au moins un fichier XSD pour chaque fichier DTD dans le fichier de spécification PIP. Dans l'exemple de mise à niveau vers PIP 5C4 V01.03.00, comme le format des messages a changé, la procédure décrit la création du fichier BCG_5C4RegistrationStatusNotification_V01.03.xsd, à titre d'exemple. Pour plus d'informations sur les fichiers XSD, voir A propos de la validation.
Pour créer les fichiers XSD pour le regroupement de flot de documents PIP, procédez comme suit :
En général, les éléments dans les recommandations correspondent aux définitions des éléments dans le fichier DTD. Cependant, les recommandations peuvent contenir certains éléments qui portent les mêmes noms mais ont des cardinalités différentes. Comme la DTD ne peut pas fournir la cardinalité dans ce cas, vous devez modifier la XSD. Par exemple, le fichier de recommandations 5C4_MG_V01_03_00_RegistrationStatusNotification.htm comporte une définition de ContactInformation en ligne 15 qui contient cinq éléments enfants dotés des cardinalités suivantes :
La définition de ContactInformation à la ligne 150 comporte quatre éléments enfants dotés des cardinalités suivantes :
Dans le fichier XSD, cependant, chaque enfant de ContactInformation possède une cardinalité conforme aux deux définitions :
<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>
Si vous mettez à jour le regroupement de flot de documents PIP basé sur une autre version du regroupement et que vous souhaitiez réutiliser une définition de l'autre version, procédez comme suit pour chacune de ces définitions :
<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"
Si vous créez un regroupement de flot de documents PIP, ou si vous en mettez un à niveau mais que la définition dont vous avez besoin n'existe pas dans l'autre version, procédez comme suit pour chaque instance de l'élément que vous avez trouvée dans les recommandations :
<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"
Le figure 35 affiche l'élément productProviderFieldApplicationEngineer avant modification.
<xsd:element name="productProviderFieldApplicationEngineer">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="ContactInformation"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Le figure 36 affiche l'élément productProviderFieldApplicationEngineer après modification.
<xsd:element name="productProviderFieldApplicationEngineer">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ContactInformation"
type="ContactInformation_localType1"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Par exemple, dans un message PIP 5C4 V01.03.00, l'élément GlobalRegistrationComplexityLevelCode ne peut prendre que les valeurs Above average, Average, Maximum, Minimum, None et Some.
Si vous mettez à jour le regroupement de flot de documents PIP sur la base d'une autre version du regroupement et si vous souhaitez réutiliser un jeu de valeurs d'énumération provenant de l'autre version, procédez comme suit pour chaque ensemble :
<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"
Si vous créez un regroupement de flot de documents PIP, ou si vous en mettez un à niveau mais que les définitions de valeur d'énumération dont vous avez besoin n'existent pas dans l'autre version, procédez comme suit pour tout élément comportant des valeurs énumérées dans les recommandations :
<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"
Le figure 37 affiche l'élément DesignAssemblyInformation avant modification.
<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>
Le figure 38 affiche l'élément DesignAssemblyInformation avant modification.
<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>
Si vous mettez à jour le regroupement de flot de documents PIP sur la base d'une autre version du regroupement et si vous souhaitez réutiliser une définition d'entité de données provenant de l'autre version, procédez comme suit pour chaque ensemble :
<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"
Si vous créez un regroupement de flot de documents PIP, ou si vous en mettez un à niveau mais que la définition d'entité de données dont vous avez besoin n'existe pas dans l'autre version, procédez comme suit pour chaque élément d'entité de données :
<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"
Le figure 39 affiche l'élément beginDate avant modification.
<xsd:element name="beginDate">
<xsd:complexType">
<xsd:sequence>
<xsd:element ref="DateStamp"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Le figure 40 affiche l'élément beginDate après modification.
<xsd:element name="beginDate">
<xsd:complexType">
<xsd:sequence>
<xsd:element name="DateStamp" type="DateStamp_localType"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Après avoir créé les fichiers XSD pour votre regroupement de flot de documents PIP, vous pouvez créer le fichier XML du regroupement RNIF et le fichier XML du regroupement d'intégration dorsale. Par exemple, ces regroupements s'appellent respectivement BCG_Package_RNIFV02.00_5C4V01.03.zip et BCG_Package_RNSC1.0_RNIFV02.00_5C4V01.03.zip. La procédure suivante décrit la création du fichier XML pour le regroupement RNIF :
Informations à modifier | Ancienne valeur | Nouvelle valeur |
---|---|---|
ID du processus PIP | 5C4 | 5C4 |
Version du processus PIP | V01.02 | V01.03 |
Nom du fichier DTD du message de demande sans extension | 5C4_MS_V01_02_
RegistrationStatusNotification |
5C4_MS_V01_03_
RegistrationStatusNotification |
Nom du fichier DTD du message de confirmation sans extension (pour processus PIP à deux actions seulement) | N/A | N/A |
Nom du fichier XSD du message de demande sans extension | BCG_5C4RegistrationStatus
Notification_V01.02 |
BCG_5C4RegistrationStatus
Notification_V01.03 |
Nom du fichier XSD du message de confirmation sans extension (pour processus PIP à deux actions seulement) | N/A | N/A |
Nom de l'élément racine dans le fichier XSD du message de demande | Pip5C4RegistrationStatus
Notification |
Pip5C4RegistrationStatus
Notification |
Nom de l'élément racine dans le fichier XSD du message de confirmation (processus PIP à deux actions seulement) | N/A | N/A |
Informations à mettre à jour | Description | Valeur dans le regroupement 5C4 |
---|---|---|
Nom de l'activité | Spécifié au tableau 3-2 | Distribute Registration Status |
Nom de rôle de l'initiateur | Spécifié au tableau 3-1 | Product Provider |
Nom de rôle du répondeur | Spécifié au tableau 3-1 | Demand Creator |
Nom de l'action de demande | Spécifié au tableau 4-2 | Registration Status Notification |
Nom de l'action de confirmation | Spécifié au tableau 4-2 (pour processus PIP à deux actions seulement) | N/A |
Informations à mettre à jour | Description | Valeur dans le regroupement 5C4 | Chemin d'accès à l'élément dans le fichier XML |
---|---|---|---|
NonRepudiation
Required |
Spécifié au tableau 3-3 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est NonRepudiationRequired) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
NonRepudiationOf
Receipt |
Spécifié au tableau 3-3 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est NonRepudiationOfReceipt) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
DigitalSignature
Required |
Spécifié au tableau 5-1 | O | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est DigitalSignatureRequired) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
TimeToAcknowledge | Spécifié au tableau 3-3 | 2
(120 min) |
ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est TimeToAcknowledge) ns1:AttributeValue ATTRVALUE |
TimeToPerform | Spécifié au tableau 3-3 | 2
(120 min) |
ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est TimeToPerform) ns1:AttributeValue ATTRVALUE |
RetryCount | Spécifié au tableau 3-3 | 3 | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (son ATTRIBUTEKEY est RetryCount) ns1:AttributeValue ATTRVALUE |
Pour créer le regroupement d'intégration dorsale, répétez les étapes 1 à 6 avec les différences suivantes :
Après avoir créé les fichiers XML et XSD, vous pouvez créer les regroupements de flot de documentation PIP.
Pour créer un regroupement RNIF, procédez comme suit :
Pour créer un regroupement d'intégration dorsale, suivez les étapes 1 à 3, mais utilisez le fichier XML d'intégration dorsale au lieu du fichier RNIF.
Après avoir créé le regroupement PIP, vous pouvez le télécharger en suivant la procédure de la section Regroupements de flot de documents RNIF et PIP.