RosettaNet ajoutant des processus PIP de temps en temps, il peut s'avérer nécessaire de créer vos propres modules 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 module de flot de documents PIP pour PIP 5C4 V01.03.00. Business Integration Connect fournit un module de flot de documents PIP pour PIP 5C4 V01.02.00, afin que les procédures expliquent effectivement comment procéder à une mise à niveau. Cependant, la création d'un module 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 module de flot de documents PIP comprend les procédures suivantes :
Un module 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 module 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 :
1 contactName
0..1 EmailAddress
0..1 facsimileNumber
0..1 PhysicalLocation
0..1 telephoneNumber
La définition de ContactInformation à la ligne 150 comporte quatre éléments enfants dotés des cardinalités suivantes :
1 contactName
1 EmailAddress
0..1 facsimileNumber
1 telephoneNumber
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 module de flot de documents PIP sur la base d'une autre version du module et que vous souhaitiez réutiliser une définition de l'autre version, procédez comme suit pour chaque 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 module de flot de documents PIP, ou que 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é 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"
Elément productProviderFieldApplicationEngineer avant modification
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element ref="ContactInformation"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Elé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 conséquent, dans un message PIP 5C4 V01.03.00, l'élément GlobalRegistrationComplexityLegelCode ne peut avoir que les valeurs suivantes : Above average, Average, Maximum, Minimum, None et Some.
Si vous mettez à jour le module de flot de documents PIP sur la base d'une autre version du module et que vous souhaitiez 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 module de flot de documents PIP, ou que 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"
Elé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>
Elément DesignAssemblyInformation après 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 module de flot de documents PIP sur la base d'une autre version du module et que vous souhaitiez 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 module de flot de documents PIP, ou que 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"
Elément beginDate avant modification
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element ref="DateStamp"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Elé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 module de flot de documents PIP, vous pouvez créer le fichier XML du module RNIF et le fichier XML du module d'intégration dorsale. Par exemple, ces modules s'appellent respectivement BCG_RNIFV02.00_5C4V01.03.zip et BCG_RNSC1.0_RNIFV02.00_5C4V01.03.zip. La procédure suivante décrit la création du fichier XML pour le module RNIF :
Tableau 8. Informations de mise à jour PIP 5C4
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_
|
5C4_MS_V01_03_
|
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_5C4RegistrationStatusNotification_
|
BCG_5C4RegistrationStatusNotification_
|
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
|
Pip5C4RegistrationStatusNotification
|
Pip5C4RegistrationStatusNotification
|
Nom de l'élément racine dans le fichier XSD du message de confirmation
(processus PIP à deux actions seulement)
|
N/A
|
N/A
|
Tableau 9. Informations de mise à jour PIP 5C4 à partir de la spécification PIP
Informations à mettre à jour | Description | Valeur dans le module 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
|
Tableau 10. Mises à jour d'attributs PIP 5C4
Informations à mettre à jour | Description | Valeur dans le module 5C4 | Chemin d'accès à l'élément dans le fichier XML |
NonRepudiationRequired
|
Spécifié au tableau 3-3
|
N
|
ns1:Package
|
NonRepudiationOfReceipt
|
Spécifié au tableau 3-3
|
N
|
ns1:Package
|
DigitalSignatureRequired
|
Spécifié au tableau 5-1
|
O
|
ns1:Package
|
TimeToAcknowledge
|
Spécifié au tableau 3-3
|
2
|
ns1:Package
|
TimeToPerform
|
Spécifié au tableau 3-3
|
2
|
ns1:Package
|
RetryCount
|
Spécifié au tableau 3-3
|
3
|
ns1:Package
|
Pour créer le module d'intégration dorsale, répétez la procédure ci-dessus, avec les différences suivantes :
Après avoir créé les fichiers XML et XSD, vous pouvez créer les modules de flot de documentation PIP.
Pour créer le module RNIF, procédez comme suit :
Pour créer le module d'intégration dorsale, procédez comme ci-dessus en utilisant le fichier XML d'intégration dorsale à la place du fichier RNIF.
Après avoir créé le module PIP, vous pouvez le télécharger en suivant la procédure de la section Téléchargement de modules RNIF.