Dato che RosettaNet aggiunge PIP di volta in volta, potrebbe essere necessario creare i pacchetti PIP per supportare questi nuovi PIP o per supportare gli aggiornamenti nei PIP. Tranne quando indicato, le procedure in questa sezione descrivono in che modo creare il pacchetto del flusso di documenti PIP per PIP 5C4 V01.03.00. Business Integration Connect fornisce un pacchetto PIP del flusso di documenti PIP 5C4 V01.02.00 in modo che le procedure documentano effettivamente in che modo effettuare un aggiornamento. Tuttavia, la creazione di un pacchetto del flusso di documenti PIP è simile e le procedure identificano quelle aggiuntive.
Prima di iniziare, scricare le specifiche PIP da www.rosettanet.org per la nuova versione e se si effettua un aggiornamento, la versione precedente. Ad esempio, se si effettua l'aggiornamento descritto nelle procedure, scaricare 5C4_DistributeRegistrationStatus_V01_03_00.zip e 5C4_DistributeRegistrationStatus_V01_02_00.zip. La specifica include i seguenti tipi di file:
La creazione o aggiornamento di un pacchetto del flusso di documenti PIP comporta le seguenti procedure:
Un pacchetto del flusso di documenti PIP contiene i file dello schema XML che definiscono i formati del messaggio e i valori accettabili per gli elementi. La seguente procedura descrive in che modo creare questi file in base ai contenuti del file delle specifiche PIP.
Si crea almeno un file XSD per ogni file DTD nel file delle specifiche PIP. Per l'esempio di aggiornamento in PIP 5C4 V01.03.00, dato che il formato del messaggio è cambiato, la procedura descrive in che modo creare il file BCG_5C4RegistrationStatusNotification_V01.03.xsd come esempio. Per informazioni sui file XSD, vedere Informazioni sulla convalida.
Per creare i file XSD per il pacchetto del flusso di documenti PIP, procedere come segue:
In generale, gli elemeti nelle direttive corrispondono alle definizioni degli elementi nel file DTD. Tuttavia, le direttive potrebbero contenere alcuni elementi che presentnao gli stessi nomi, ma diverse cardinalità. Dato che il DTD non può fornire la cardinalità in questo caso, è necessario modificare il XSD. Ad esempio, il file delle direttive 5C4_MG_V01_03_00_RegistrationStatusNotification.htm presenta una definizione per ContactInformation online 15 che presenta cinque elementi figli con le seguenti cardinalità:
1 contactName
0..1 EmailAddress
0..1 facsimileNumber
0..1 PhysicalLocation
0..1 telephoneNumber
La definizione di ContactInformation sulla riga 150 presenta quattro elementi figli con le seguenti cardianalità:
1 contactName
1 EmailAddress
0..1 facsimileNumber
1 telephoneNumber
Nel file XSD, tuttavia, ogni figlio di lContactInformation presenta una cardinalità che è conforme ad entrambe le definizioni:
<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>
Se si aggiorna il pacchetto del flusso di documenti PIP di un'altra versione del pacchetto e si desidera utilizzare una definizione dall'altra versione, procedere come segue per entrambe le definizioni:
<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"
Se si crea un pacchetto del flusso di documenti PIP o si aggiorna un pacchetto del flusso di documenti PIP, ma la definizione necessaria non è presente nell'altra versione, procedere come segue per ogni istanza dell'elemento trovato nelle direttive:
<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"
Elemento productProviderFieldApplicationEngineer prima della modifica
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element ref="ContactInformation"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Elemento productProviderFieldApplicationEngineer dopo la modifica
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element name="ContactInformation" type="ContactInformation_localType1"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Quindi, in un messaggio PIP 5C4 V01.03.00, GlobalRegistrationComplexityLegelCode può avere solo i seguenti valori: Superiore alla media, Media, Massimo, Minimo, Nussuno e Alcuni.
Se si aggiorna il pacchetto del flusso di documenti PIP su un'altra versione del pacchetto e si desidera utilizzare un gruppo dall'altra versione, procedere come segue per entrambe igruppi:
<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="Minimo"/> <xsd:enumeration value="None"/> <xsd:enumeration value="Some"/> </xsd:restriction> </xsd:simpleType>
<xsd:include schemaLocation= "BCG_GlobalRegistrationComplexityLevelCode_Types.xsd" />
name="GlobalRegistrationComplexityLevelCode" type="_GlobalRegistrationComplexityLevelCode"
Se si crea un pacchetto del flusso di documenti PIP o si aggiorna un pacchetto del flusso di documenti PIP, ma le definizioni del valore di enumerazione necessarie non sono presenti nell'altra versione, procedere come segue per ogni elemento con i valori enumerati nelle direttive:
<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"
Elemento DesignAssemblyInformation prima della modifica
<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>
Elemento DesignAssemblyInformation dopo la modifica
<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>
Se si aggiorna il pacchetto del flusso di documenti PIP su un'altra versione del pacchetto e si desidera utilizzare una definizione dell'entità dei dati dall'altra versione, procedere come segue per entrambe i gruppi:
<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"
Se si crea un pacchetto del flusso di documenti PIP o si aggiorna un pacchetto del flusso di documenti PIP, ma la definizione dell'entità dei dati necessaria non è presente nell'altra versione, procedere come segue per ogni elemento di entità dei dati:
<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"
Elemento data di inizio prima della modifica
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element ref="DateStamp"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Elemento data di inizio dopo la modifica
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element name="DateStamp" type="DateStamp_localType"/> </xsd:sequence> </xsd:complexType> </xsd:element>
Dopo la creazione dei file XSD per il pacchetto del flusso di documenti PIP, si è pronti per creare il file XML per il pacchetto RNIF e il file XML per il pacchetto di Integrazione di backend. Ad esempio, questi pacchetti vengono denominati BCG_RNIFV02.00_5C4V01.03.zip e BCG_RNSC1.0_RNIFV02.00_5C4V01.03.zip rispettivamente. La seguente procedura descrive in che modo creare il file XML per il pacchetto RNIF:
Tabella 8. Informazioni di aggiornamento 5C4 PIP
Informazioni da modificare | Valore vecchio | Valore nuovo |
ID PIP
|
5C4
|
5C4
|
Versione del PIP
|
V01.02
|
V01.03
|
Il nome del file DTD del messaggio di richiesta senza l'estensione del
file
|
5C4_MS_V01_02_
|
5C4_MS_V01_03_
|
Il nome del file DTD del messaggio di conferma senza l'estensione del
file (solo per i PIP di due azioni)
|
N/A
|
N/A
|
Il nome del file XSD del messaggio di richiesta senza l'estensione del
file
|
BCG_5C4RegistrationStatusNotification_
|
BCG_5C4RegistrationStatusNotification_
|
Il nome del file XSD del messaggio di conferma senza l'estensione del
file (solo per i PIP di due azioni)
|
N/A
|
N/A
|
Il nome dell'elemento root nel file XSD per il messaggio di richiesta
|
Pip5C4RegistrationStatusNotification
|
Pip5C4RegistrationStatusNotification
|
Il nome dell'elemento root nel file XSD per il messaggio di conferma
(per i PIP di due azioni solo)
|
N/A
|
N/A
|
Tabella 9. Le informazioni di aggiornamento 5C4 PIP dalla specifica PIP
Informazioni da aggiornare | Descrizione | Valore nel pacchetto 5C4 |
Nome attività
|
Specificato nella Tabella 3-2
|
Stato di registrazione di distribuzione
|
Nome del ruolo di iniziatore
|
Specificato nella Tabella 3-1
|
Fornitore del prodotto
|
Nome del ruolo del risponditore
|
Specificato nella Tabella 3-1
|
Creatore della domanda
|
Nome azione della richiesta
|
Specificato nella Tabella 4-2
|
Notifica dello stato di registrazione
|
Nome azione di conferma
|
Specificato nella Tabella 4-2 (solo per i PIP di due azioni)
|
N/A
|
Tabella 10. Aggiornamenti dell'attributo 5C4 PIP
Informazioni da aggiornare | Descrizione | Valore nel pacchetto 5C4 | Percorso dell'elemento nel file XML |
NonRepudiationRequired
|
Specificato nella Tabella 3-3
|
N
|
ns1:Pacchetto
|
NonRepudiationOfReceipt
|
Specificato nella Tabella 3-3
|
N
|
ns1:Package
|
DigitalSignatureRequired
|
Specificato nella Tabella 5-1
|
Y
|
ns1:Package
|
TimeToAcknowledge
|
Specificato nella Tabella 3-3
|
2
|
ns1:Package
|
TimeToPerform
|
Specificato nella Tabella 3-3
|
2
|
ns1:Package
|
RetryCount
|
Specificato nella Tabella 3-3
|
3
|
ns1:Package
|
Per creare il pacchetto di Integrazione di backend, ripetere la procedura in alto tranne che per le seguenti differenze:
Dopo aver creato l'XML e i file XSD, si è pronti per creare i pacchetti del flusso di documentazione PIP.
Per creare il pacchetto RNIF, procedere come segue:
Per creare il pacchetto di Integrazione di backend, effettuare la procedura in alto, ma utilizzare il file XML di Integrazione di backend invece del file RNIF:
Dopo aver creato il pacchetto PIP, è possibile scaricarlo utilizzando la procedura nei pacchetti Aggiornamento RNIF.