GDSN Migration Guide from B2B to OpenAS2
This page describes the migration of the Standard GDSN Data Source scenario.
Export template migration
All export templates
File split
In older versions, data transformations in B2B Data Exchange split the files in packages of a certain number of documents the pool can handle. Using OpenAS2 this is now done by a post export step.
Please see Export/File split on how to customize it.
Copy to hotfolder
The exported files will now be sent to the pool by OpenAS2. This means the export template has to be adjusted to copy the exported files to the OpenAS2 hotfolder instead of the B2B DX ones.
Please see Export/Connection to OpenAS2 on how to change the used hotfolder.
CIN_CatalogItemNotification
Hierarchies for DSE
In older versions, B2B Data Exchange was used to create hierarchies of items. Using OpenAS2 this is now done by a post export step.
Please see Export/DSE Hierarchies for more information.
Changed content
Changes in CIN_CatalogItemNotification were needed to comply with the standard XSD files.
Module: Header
The complete content of the Header module of the provided export template should be used.
Module: Items
Lines 1 to 2 were replaced by new lines 1 to 27:
<
transaction
>
<
transactionIdentification
>
<
entityIdentification
>tran_{?ValueGet "globalIdentifier"}_{?DatasetCounter}</
entityIdentification
>
<
contentOwner
>
<
gln
>{%Information provider GLN}</
gln
>
</
contentOwner
>
</
transactionIdentification
>
<
documentCommand
>
<
documentCommandHeader
type
=
"{%Operation (ADD, CHANGE_BY_REFRESH or CORRECT)}"
>
<
documentCommandIdentification
>
<
entityIdentification
>cmd_{?ValueGet "globalIdentifier"}_{?DatasetCounter}</
entityIdentification
>
<
contentOwner
>
<
gln
>{%Information provider GLN}</
gln
>
</
contentOwner
>
</
documentCommandIdentification
>
</
documentCommandHeader
>
<
catalogue_item_notification
:catalogueItemNotification>
<
creationDateTime
>{?FormatDate {?GetDate}, "yyyy-MM-dd"}T{?FormatTime {?GetTime}, "HH:mm:ss"}</
creationDateTime
>
<
documentStatusCode
>ORIGINAL</
documentStatusCode
>
<
catalogueItemNotificationIdentification
>
<
entityIdentification
>cin_{?ValueGet "globalIdentifier"}_{?DatasetCounter}</
entityIdentification
>
<
contentOwner
>
<
gln
>{%Information provider GLN}</
gln
>
</
contentOwner
>
</
catalogueItemNotificationIdentification
>
<
isReload
>true</
isReload
>
<
catalogueItem
>
<
catalogueItemState
>
<
catalogueItemStateCode
>REGISTERED</
catalogueItemStateCode
>
Lines 254 to 259 (last 6 lines) were replaced by new lines 279 to 282:
</
tradeItemSynchronisationDates
>
</
tradeItem
>
</
catalogueItem
>
</
catalogue_item_notification
:catalogueItemNotification>
</
documentCommand
>
</
transaction
>
Module: Footer
The complete content of the Footer module of the provided export template should be used.
CIP_CatalogItemPublication
In addition to the changes for the new export post step to split the exported file which is described above there are changes to create unique identification values.
Module: Header
Line 3 was added, line 15 was changed
It is recommended to use the complete content of this module
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<
catalogue_item_publication
:catalogueItemPublicationMessage
xmlns:catalogue_item_publication
=
"urn:gs1:gdsn:catalogue_item_publication:xsd:3"
xmlns:sh
=
"http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
xmlns:xsi
=
"http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation
=
"urn:gs1:gdsn:catalogue_item_publication:xsd:3 http://www.gdsregistry.org/3.1/schemas/gs1/gdsn/CatalogueItemPublication.xsd"
>
{?ValueSet "globalIdentifier", {?FormatDate {?GetDate}, "yyyy-MM-dd"}_{?FormatTime {?GetTime}, "HH:mm:ss.SSS"}}
<
sh
:StandardBusinessDocumentHeader>
<
sh
:HeaderVersion>1.0</
sh
:HeaderVersion>
<
sh
:Sender>
<
sh
:Identifier
Authority
=
"GS1"
>{%Information provider GLN}</
sh
:Identifier>
</
sh
:Sender>
<
sh
:Receiver>
<
sh
:Identifier
Authority
=
"GS1"
>{%Recipient GLN (data pool)}</
sh
:Identifier>
</
sh
:Receiver>
<
sh
:DocumentIdentification>
<
sh
:Standard>GS1</
sh
:Standard>
<
sh
:TypeVersion>3.1</
sh
:TypeVersion>
<
sh
:InstanceIdentifier>CIP_{?ValueGet "globalIdentifier"}</
sh
:InstanceIdentifier>
<
sh
:Type>catalogueItemPublication</
sh
:Type>
<
sh
:MultipleType>false</
sh
:MultipleType>
<
sh
:CreationDateAndTime>{?FormatDate {?GetDate}, "yyyy-MM-dd"}T{?FormatTime {?GetTime}, "HH:mm:ss"}</
sh
:CreationDateAndTime>
</
sh
:DocumentIdentification>
</
sh
:StandardBusinessDocumentHeader>
Module: Publication status DSE
Line 1 was added, lines 4, 12 and 23 were changed
{?NumberIncrement "counter"}
<
transaction
>
<
transactionIdentification
>
<
entityIdentification
>cip_tran_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>
<
gln
>{&GDSN 1WS DSE Publication.Information provider.GLN}</
gln
>
</
contentOwner
>
</
transactionIdentification
>
<
documentCommand
>
<
documentCommandHeader
type
=
"{?EnumerationKey {&GDSN 1WS DSE Publication.Publication operation}}"
>
<
documentCommandIdentification
>
<
entityIdentification
>cip_cmd_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>
<
gln
>{&GDSN 1WS DSE Publication.Information provider.GLN}</
gln
>
</
contentOwner
>
</
documentCommandIdentification
>
</
documentCommandHeader
>
<
catalogue_item_publication
:catalogueItemPublication>
<
creationDateTime
>{?FormatDate {?GetDate}, "yyyy-MM-dd"}T{?FormatTime {?GetTime}, "HH:mm:ss"}</
creationDateTime
>
<
documentStatusCode
>ORIGINAL</
documentStatusCode
>
<
documentStructureVersion
>3.1</
documentStructureVersion
>
<
catalogueItemPublicationIdentification
>
<
entityIdentification
>cip_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>
<
gln
>{&GDSN 1WS DSE Publication.Information provider.GLN}</
gln
>
CIPHW_CatalogItemPublicationHierarchyWithdrawal
In addition to the changes for the new export post step to split the exported file which is described above there are changes to create unique identification values.
Module: Header
Line 3 was added, line 15 was changed
It is recommended to use the complete content of this module
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<
catalogue_item_hierarchical_withdrawal
:catalogueItemHierarchicalWithdrawalMessage
xmlns:catalogue_item_hierarchical_withdrawal
=
"urn:gs1:gdsn:catalogue_item_hierarchical_withdrawal:xsd:3"
xmlns:sh
=
"http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
xmlns:xsi
=
"http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation
=
"urn:gs1:gdsn:catalogue_item_hierarchical_withdrawal:xsd:3 http://www.gdsregistry.org/3.1/schemas/gs1/gdsn/CatalogueItemHierarchicalWithdrawal.xsd"
>
{?ValueSet "globalIdentifier", {?FormatDate {?GetDate}, "yyyy-MM-dd"}_{?FormatTime {?GetTime}, "HH:mm:ss.SSS"}}
<
sh
:StandardBusinessDocumentHeader>
<
sh
:HeaderVersion>1.0</
sh
:HeaderVersion>
<
sh
:Sender>
<
sh
:Identifier
Authority
=
"GS1"
>{%Information provider GLN}</
sh
:Identifier>
</
sh
:Sender>
<
sh
:Receiver>
<
sh
:Identifier
Authority
=
"GS1"
>{%Recipient GLN (data pool)}</
sh
:Identifier>
</
sh
:Receiver>
<
sh
:DocumentIdentification>
<
sh
:Standard>GS1</
sh
:Standard>
<
sh
:TypeVersion>3.1</
sh
:TypeVersion>
<
sh
:InstanceIdentifier>CIPHW_{?ValueGet "globalIdentifier"}</
sh
:InstanceIdentifier>
<
sh
:Type>catalogueItemHierarchicalWithdrawal</
sh
:Type>
<
sh
:MultipleType>false</
sh
:MultipleType>
<
sh
:CreationDateAndTime>{?FormatDate {?GetDate}, "yyyy-MM-dd"}T{?FormatTime {?GetTime}, "HH:mm:ss"}</
sh
:CreationDateAndTime>
</
sh
:DocumentIdentification>
</
sh
:StandardBusinessDocumentHeader>
Module: Publication withdrawal
Line 1 was added, lines 4, 12 and 23 were changed
{?NumberIncrement "counter"}
<
transaction
>
<
transactionIdentification
>
<
entityIdentification
>ciphw_tran_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>
<
gln
>{%Information provider GLN}</
gln
>
</
contentOwner
>
</
transactionIdentification
>
<
documentCommand
>
<
documentCommandHeader
type
=
"DELETE"
>
<
documentCommandIdentification
>
<
entityIdentification
>ciphw_cmd_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>
<
gln
>{%Information provider GLN}</
gln
>
</
contentOwner
>
</
documentCommandIdentification
>
</
documentCommandHeader
>
<
catalogue_item_hierarchical_withdrawal
:catalogueItemHierarchicalWithdrawal>
<
creationDateTime
>{?FormatDate {?GetDate}, "yyyy-MM-dd"}T{?FormatTime {?GetTime}, "HH:mm:ss"}</
creationDateTime
>
<
documentStatusCode
>ORIGINAL</
documentStatusCode
>
<
documentStructureVersion
>3.1</
documentStructureVersion
>
<
catalogueItemHierarchicalWithdrawalIdentification
>
<
entityIdentification
>ciphw_{?ValueGet "globalIdentifier"}_{?NumberGet "counter"}</
entityIdentification
>
<
contentOwner
>