Puesto que RosettaNet en ocasiones añade PIP, quizás necesite crear sus propios paquetes PIP para dar soporte a estos nuevos PIP o para dar soporte a ampliaciones de los PIP. Si no se indica lo contrario, los procedimientos de esta sección describen cómo crear el paquete de flujo de documentos PIP para PIP 5C4 V01.03.00. WebSphere Partner Gateway suministra un paquete de flujo de documentos PIP para PIP 5C4 V01.02.00. Por lo tanto, los procedimientos en realidad documentan cómo realizar una actualización. Sin embargo, la creación de un paquete de flujo de documentos PIP es similar y los procedimientos identifican a todos los pasos adicionales.
Antes de empezar, descargue las especificaciones de PIP de www.rosettanet.org para la nueva versión y, si está realizando una actualización, la versión anterior. Por ejemplo, si está realizando la actualización que se describe en los procedimientos, descargue 5C4_DistributeRegistrationStatus_V01_03_00.zip y 5C4_DistributeRegistrationStatus_V01_02_00.zip. La especificación incluye los siguientes tipos de archivo:
La creación o actualización de un paquete de flujo de documentos PIP implica los procedimientos siguientes:
Un paquete de flujo de documentos PIP contiene archivos de esquema XML que definen formatos de mensaje y valores aceptables para elementos. El siguiente procedimiento describe cómo crear estos archivos basándose en el contenido del archivo de especificación de PIP.
En el archivo de especificación de PIP, se creará como mínimo un archivo XSD para cada archivo DTD. En el ejemplo de la actualización a PIP 5C4 V01.03.00, puesto que ha cambiado el formato de mensaje, el procedimiento describe cómo crear el archivo BCG_5C4RegistrationStatusNotification_V01.03.xsd como ejemplo. Para obtener más información sobre los archivos XSD, consulte Acerca de la validación.
Para crear los archivos XSD para el paquete de flujo de documentos PIP, siga estos pasos:
Normalmente, los elementos de las directrices coinciden con las definiciones de los elementos en el archivo DTD. Sin embargo, las directrices podrían incluir algunos elementos que tienen los mismos nombres pero cardinalidades diferentes. Puesto que DTD no puede proporcionar la cardinalidad en este caso, será necesario modificar el XSD. Por ejemplo, el archivo de directrices 5C4_MG_V01_03_00_RegistrationStatusNotification.htm tiene una definición para ContactInformation en la línea 15 que tiene cinco elementos hijo con las siguientes cardinalidades:
La definición de ContactInformation de la línea 150 tiene cuatro elementos hijo con las siguientes cardinalidades:
En el archivo XSD, sin embargo, cada hijo de ContactInformation tiene una cardinalidad que obedece a ambas definiciones:
<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 está actualizando el paquete de flujo de documentos PIP basándose en otra versión del paquete y desea volver a utilizar una definición de la otra versión, realice los pasos siguientes para cada una de estas definiciones:
<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 está creando un paquete de flujo de documentos PIP o está actualizando un paquete de flujo de documentos PIP pero la definición que necesita no existe en la otra versión, realice los pasos siguientes para cada instancia del elemento que ha encontrado en las directrices:
<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"
La Figura 35 muestra el elemento productProviderFieldApplicationEngineer antes de modificarse.
<xsd:element name="productProviderFieldApplicationEngineer">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="ContactInformation"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
La Figura 36 muestra el elemento productProviderFieldApplicationEngineer después de modificarse.
<xsd:element name="productProviderFieldApplicationEngineer">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ContactInformation"
type="ContactInformation_localType1"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Por ejemplo, en un mensaje PIP 5C4 V01.03.00, GlobalRegistrationComplexityLevelCode sólo puede tener los siguientes valores: Above average (por encima de la media), Average (normal), Maximum (máximo), Minimum (mínimo), None (ninguno) y Some (alguno).
Si está actualizando el paquete de flujo de documentos PIP basado en otra versión del paquete y desea volver a utilizar un juego de valores de enumeración de la otra versión, realice los pasos siguientes para cada juego:
<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 está creando un paquete de flujo de documentos PIP o está actualizando un paquete de flujo de documentos PIP pero las definiciones del valor de enumeración que necesita no existe en la otra versión, realice los pasos siguientes para los elementos con valores enumerados en las directrices:
<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"
La Figura 37 muestra el elemento DesignAssemblyInformation antes de modificarse.
<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>
La Figura 38 muestra el elemento DesignAssemblyInformation después de modificarse.
<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 está actualizando el paquete de flujo de documentos PIP basado en otra versión del paquete y desea volver a utilizar una definición de entidad de datos de la otra versión, realice los pasos siguientes para cada juego:
<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 está creando un paquete de flujo de documentos PIP o está actualizando un paquete de flujo de documentos PIP pero la definición de entidad de datos que necesita no existe en la otra versión, realice los pasos siguientes para cada elemento de entidad de datos:
<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"
La Figura 39 muestra el elemento beginDate antes de modificarse.
<xsd:element name="beginDate">
<xsd:complexType">
<xsd:sequence>
<xsd:element ref="DateStamp"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
La Figura 40 muestra el elemento beginDate después de modificarse.
<xsd:element name="beginDate">
<xsd:complexType">
<xsd:sequence>
<xsd:element name="DateStamp" type="DateStamp_localType"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Después de crear los archivos XSD para el paquete de flujo de documentos PIP, puede crear el archivo XML para el paquete RNIF y el archivo XML para el paquete de integración de programas de fondo. Por ejemplo, estos paquetes se denominan BCG_Package_RNIFV02.00_5C4V01.03.zip y BCG_Package_RNSC1.0_RNIFV02.00_5C4V01.03.zip. El siguiente procedimiento describe cómo crear el archivo XML para el paquete RNIF:
Información que debe modificarse | Valor anterior | Valor nuevo |
---|---|---|
ID de PIP | 5C4 | 5C4 |
Versión de PIP | V01.02 | V01.03 |
El nombre del archivo DTD del mensaje de petición sin la extensión del archivo | 5C4_MS_V01_02_
RegistrationStatusNotification |
5C4_MS_V01_03_
RegistrationStatusNotification |
El nombre del archivo DTD del mensaje de confirmación sin la extensión del archivo (sólo para PIP de dos acciones) | N/D | N/D |
El nombre del archivo XSD del mensaje de petición sin la extensión del archivo | BCG_5C4RegistrationStatus
Notification_V01.02 |
BCG_5C4RegistrationStatus
Notification_V01.03 |
El nombre del archivo XSD del mensaje de confirmación sin la extensión del archivo (sólo para PIP de dos acciones) | N/D | N/D |
Nombre del elemento raíz en el archivo XSD para el mensaje de petición | Pip5C4RegistrationStatus
Notificación |
Pip5C4RegistrationStatus
Notificación |
Nombre del elemento raíz en el archivo XSD para el mensaje de confirmación (sólo para PIP de dos acciones) | N/D | N/D |
Información que debe actualizarse | Descripción | Valor en el paquete 5C4 |
---|---|---|
Nombre de la actividad | Especificado en la tabla 3-2 | Distribución de estado de registro |
Nombre de rol del iniciador | Especificado en la tabla 3-1 | Proveedor de productos |
Nombre de rol del respondedor | Especificado en la tabla 3-1 | Creador de la demanda |
Nombre de acción de petición | Especificado en la tabla 4-2 | Notificación de estado de registro |
Nombre de acción de confirmación | Especificado en la tabla 4-2 (sólo para PIP de dos acciones) | N/D |
Información que debe actualizarse | Descripción | Valor en el paquete 5C4 | Vía de acceso del elemento en el archivo XML |
---|---|---|---|
NonRepudiation
Obligatorio |
Especificado en la tabla 3-3 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es NonRepudiationRequired) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
NonRepudiationOf
Recepción |
Especificado en la tabla 3-3 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es NonRepudiationOfReceipt) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
DigitalSignature
Obligatorio |
Especificado en la tabla 5-1 | Y | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es DigitalSignatureRequired) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
TimeToAcknowledge | Especificado en la tabla 3-3 | 2
(120 min) |
ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es TimeToAcknowledge) ns1:AttributeValue ATTRVALUE |
TimeToPerform | Especificado en la tabla 3-3 | 2
(120 min) |
ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es TimeToPerform) ns1:AttributeValue ATTRVALUE |
RetryCount | Especificado en la tabla 3-3 | 3 | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (su ATTRIBUTEKEY es RetryCount) ns1:AttributeValue ATTRVALUE |
Para crear el paquete de integración de programas de fondo, repita los pasos 1 a 6, con las diferencias siguientes:
Después de crear los archivos XML y XSD, podrá crear los paquetes de flujo de documentos PIP.
Para crear el paquete RNIF, siga estos pasos:
Para crear el paquete de integración de programas de fondo, siga los pasos 1 a 3, pero utilice el archivo XML de la integración de programas de fondo del archivo RNIF.
Tras crear el paquete PIP, puede subirlo mediante el procedimiento descrito en Paquetes de flujo de documentos RNIF y PIP.