Informatica® B2B Data Exchange

GDSN Accelerator 10.5.3

GDSN Accelerator Guide

Informatica B2B Data Exchange GDSN Accelerator Guide
GDSN Accelerator 10.5.3
August 2021
© Copyright Informatica LLC 2016, 2022

This software and documentation contain proprietary information of Informatica LLC and are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any
form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica LLC. This Software may be protected by U.S. and/or
international Patents and other Patents Pending.

Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as
provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013©(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III),
as applicable.

The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to
us in writing.

Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange,
PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica
On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging,
Informatica Master Data Management, and Live Data Map are trademarks or registered trademarks of Informatica LLC in the United States and in jurisdictions
throughout the world. All other company and product names may be trade names or trademarks of their respective owners.

Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights
reserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rights
reserved. Copyright © Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright © Meta
Integration Technology, Inc. All rights reserved. Copyright © Intalio. All rights reserved. Copyright © Oracle. All rights reserved. Copyright © Adobe Systems Incorporated.
All rights reserved. Copyright © DataArt, Inc. All rights reserved. Copyright © ComponentSource. All rights reserved. Copyright © Microsoft Corporation. All rights
reserved. Copyright © Rogue Wave Software, Inc. All rights reserved. Copyright © Teradata Corporation. All rights reserved. Copyright © Yahoo! Inc. All rights reserved.
Copyright © Glyph & Cog, LLC. All rights reserved. Copyright © Thinkmap, Inc. All rights reserved. Copyright © Clearpace Software Limited. All rights reserved. Copyright
© Information Builders, Inc. All rights reserved. Copyright © OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo
Communications, Inc. All rights reserved. Copyright © International Organization for Standardization 1986. All rights reserved. Copyright © ej-technologies GmbH. All
rights reserved. Copyright © Jaspersoft Corporation. All rights reserved. Copyright © International Business Machines Corporation. All rights reserved. Copyright ©
yWorks GmbH. All rights reserved. Copyright © Lucent Technologies. All rights reserved. Copyright © University of Toronto. All rights reserved. Copyright © Daniel
Veillard. All rights reserved. Copyright © Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright © MicroQuill Software Publishing, Inc. All rights reserved.
Copyright © PassMark Software Pty Ltd. All rights reserved. Copyright © LogiXML, Inc. All rights reserved. Copyright © 2003-2010 Lorenzi Davide, All rights reserved.
Copyright © Red Hat, Inc. All rights reserved. Copyright © The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright © EMC
Corporation. All rights reserved. Copyright © Flexera Software. All rights reserved. Copyright © Jinfonet Software. All rights reserved. Copyright © Apple Inc. All rights
reserved. Copyright © Telerik Inc. All rights reserved. Copyright © BEA Systems. All rights reserved. Copyright © PDFlib GmbH. All rights reserved. Copyright ©
Orientation in Objects GmbH. All rights reserved. Copyright © Tanuki Software, Ltd. All rights reserved. Copyright © Ricebridge. All rights reserved. Copyright © Sencha,
Inc. All rights reserved. Copyright © Scalable Systems, Inc. All rights reserved. Copyright © jQWidgets. All rights reserved. Copyright © Tableau Software, Inc. All rights
reserved. Copyright© MaxMind, Inc. All Rights Reserved. Copyright © TMate Software s.r.o. All rights reserved. Copyright © MapR Technologies Inc. All rights reserved.
Copyright © Amazon Corporate LLC. All rights reserved. Copyright © Highsoft. All rights reserved. Copyright © Python Software Foundation. All rights reserved.
Copyright © BeOpen.com. All rights reserved. Copyright © CNRI. All rights reserved.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various
versions of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or
agreed to in writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.

This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software
copyright © 1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License
Agreement, which may be found at http:// www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any
kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.

The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California,
Irvine, and Vanderbilt University, Copyright (©) 1993-2006, all rights reserved.

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and
redistribution of this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.

This product includes Curl software which is Copyright 1996-2013, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or
without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The product includes software copyright 2001-2005 (©) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.dom4j.org/ license.html.

The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://dojotoolkit.org/license.

This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations
regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.

This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at
http:// www.gnu.org/software/ kawa/Software-License.html.

This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.

This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software
are subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.

This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at
http:// www.pcre.org/license.txt.

This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http:// www.eclipse.org/org/documents/epl-v10.php and at http://www.eclipse.org/org/documents/edl-v10.php.
This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://
www.stlport.org/doc/ license.html, http://asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://
httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/
release/license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/
license-agreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/
licence.html; http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/
Consortium/Legal/2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/
license.html; http://forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/
software/tcltk/license.html, http://www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/
iodbc/wiki/iODBC/License; http://www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/
index.html; http://www.net-snmp.org/about/license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt;
http://www.schneier.com/blowfish.html; http://www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/CreateJS/
EaselJS/blob/master/src/easeljs/display/Bitmap.js; http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://
jdbc.postgresql.org/license.html; http://protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/
LICENSE; http://web.mit.edu/Kerberos/krb5-current/doc/mitK5license.html; http://jibx.sourceforge.net/jibx-license.html; https://github.com/lyokato/libgeohash/blob/
master/LICENSE; https://github.com/hjiang/jsonxx/blob/master/LICENSE; https://code.google.com/p/lz4/; https://github.com/jedisct1/libsodium/blob/master/
LICENSE; http://one-jar.sourceforge.net/index.php?page=documents&file=license; https://github.com/EsotericSoftware/kryo/blob/master/license.txt; http://www.scala-
lang.org/license.html; https://github.com/tinkerpop/blueprints/blob/master/LICENSE.txt; http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/
intro.html; https://aws.amazon.com/asl/; https://github.com/twbs/bootstrap/blob/master/LICENSE; https://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/
LICENSE.txt; https://github.com/documentcloud/underscore-contrib/blob/master/LICENSE, and https://github.com/apache/hbase/blob/master/LICENSE.txt.

This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and
Distribution License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary
Code License Agreement Supplemental License Terms, the BSD License (http:// www.opensource.org/licenses/bsd-license.php), the new BSD License (http://
opensource.org/licenses/BSD-3-Clause), the MIT License (http://www.opensource.org/licenses/mit-license.php), the Artistic License (http://www.opensource.org/
licenses/artistic-license-1.0) and the Initial Developer’s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).

This product includes software copyright © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this
software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab.
For further information please visit http://www.extreme.indiana.edu/.

This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject
to terms of the MIT license.

See patents at https://www.informatica.com/legal/patents.html.

DISCLAIMER: Informatica LLC provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied
warranties of noninfringement, merchantability, or use for a particular purpose. Informatica LLC does not warrant that this software or documentation is error free. The
information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation
is subject to change at any time without notice.

NOTICES

This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software
Corporation ("DataDirect") which are subject to the following terms and conditions:

1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES
OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH
OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

Publication Date: 2022-12-13

Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Product Availability Matrixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 1: GDSN Accelerator Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

GDSN Message Types and Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 2: Installation and Configuration Procedures. . . . . . . . . . . . . . . . . . . . . . . . . 9

Installing the GDSN Accelerator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 3: Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 4: Components and Flows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

B2B Data Exchange and Data Transformation Components. . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Detailed Overview of Processing Flows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4 Table of Contents
Preface
Use the B2B Data Exchange GDSN Accelerator User Guide to learn how to install and configure the GDSN
Accelerator. This guide also contains a reference section documenting the transformation components and
their properties.

Informatica Resources

Informatica Network
Informatica Network hosts Informatica Global Customer Support, the Informatica Knowledge Base, and other
product resources. To access Informatica Network, visit https://network.informatica.com.

As a member, you can:

• Access all of your Informatica resources in one place.

• Search the Knowledge Base for product resources, including documentation, FAQs, and best practices.
• View product availability information.
• Review your support cases.
• Find your local Informatica User Group Network and collaborate with your peers.

As a member, you can:

• Access all of your Informatica resources in one place.

• Search the Knowledge Base for product resources, including documentation, FAQs, and best practices.
• View product availability information.
• Find your local Informatica User Group Network and collaborate with your peers.

Informatica Knowledge Base

Use the Informatica Knowledge Base to search Informatica Network for product resources such as
documentation, how-to articles, best practices, and PAMs.

To access the Knowledge Base, visit https://kb.informatica.com. If you have questions, comments, or ideas
about the Knowledge Base, contact the Informatica Knowledge Base team at
KB_Feedback@informatica.com.

5
 Informatica Documentation
To get the latest documentation for your product, browse the Informatica Knowledge Base at
https://kb.informatica.com/_layouts/ProductDocumentation/Page/ProductDocumentSearch.aspx.

If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation
team through email at infa_documentation@informatica.com.

Informatica Product Availability Matrixes

Product Availability Matrixes (PAMs) indicate the versions of operating systems, databases, and other types
of data sources and targets that a product release supports. If you are an Informatica Network member, you
can access PAMs at
https://network.informatica.com/community/informatica-network/product-availability-matrices.

Informatica Velocity
Informatica Velocity is a collection of tips and best practices developed by Informatica Professional
Services. Developed from the real-world experience of hundreds of data management projects, Informatica
Velocity represents the collective knowledge of our consultants who have worked with organizations from
around the world to plan, develop, deploy, and maintain successful data management solutions.

If you are an Informatica Network member, you can access Informatica Velocity resources at
http://velocity.informatica.com.

If you have questions, comments, or ideas about Informatica Velocity, contact Informatica Professional
Services at ips@informatica.com.

Informatica Marketplace
The Informatica Marketplace is a forum where you can find solutions that augment, extend, or enhance your
Informatica implementations. By leveraging any of the hundreds of solutions from Informatica developers
and partners, you can improve your productivity and speed up time to implementation on your projects. You
can access Informatica Marketplace at https://marketplace.informatica.com.

Informatica Global Customer Support

You can contact a Global Support Center by telephone or through Online Support on Informatica Network.

To find your local Informatica Global Customer Support telephone number, visit the Informatica website at
the following link:
http://www.informatica.com/us/services-and-training/support-services/global-support-centers.

If you are an Informatica Network member, you can use Online Support at http://network.informatica.com.

6 Preface
Chapter 1

GDSN Accelerator Overview

The B2B Data Exchange Accelerators are a packaged B2B Data Exchange solution that addresses common
business-to-business integration use cases for vertical industries, and reduces implementation efforts.

GDSN is a uniform standard that enables trading partners to globally share trusted product data. For more
information about GDSN, see http://www.gs1.org/gdsn.

The B2B GDSN Accelerator mediate communication between data pool and partners. The accelerator
receives and handles messages addressed to the pool and to partners. The accelerator also tracks the
correlation between messages sent to the pool and the pool response message through the reconciliation
status.

GDSN Message Types and Routes

The B2B GDSN Accelerator currently supports the following European Union and United States GDSN
message types:

• GDSN (EU):
- CIC

- CIHW

- CIN

- CIP

- CIS

- gs1Response

- RFCIN
• 1Sync (USA):
- catalogueRequest

- catalogueResponse

- CIC

- CICResponse

- CINResponse

- CIS

- CISResponse

- gdsnItemRegistryResponse

7
 - gdsnPartyRegistryResponse

- itemAuthorizationResponse

- itemReqResponse

- itemSyncResponse

- newItemConfirmResponse

- orgInfoMsgResponse

- RFCIN

- RFCINResponse

- validValueListResponse

Note: 1WorldSync USA supports the Global Data Synchronization Network™ (GDSN) Major Release 3 (MjR3).

The GDSN Accelerator manages the following message routes:

• Messages between a data source (DS) and a source data pool (SDP), in which a data source usually
represents a supplier.
• Messages between a data recipient (DR) and a recipient data pool (RDP), in which a data recipient usually
represents a customer.
The following table shows the messages that the different routes transfer:

Route Messages

DS to SDP CIP, CIN, CIHW

SDP to DS gs1Response, CIC

DR to RDP CIC, CIS, RFCIN

RDP to DR gs1Response, CIN

Note: This table uses the European Union GDSN naming convention. The route information also applies to the
1Sync GDSN standard in the United States.

8 Chapter 1: GDSN Accelerator Overview

Chapter 2

Installation and Configuration

Procedures
The following procedures apply when you install the GDSN Accelerator.

Installing the GDSN Accelerator

Before you install the GDSN Accelerator, ensure that you have installed the following programs:

• PowerCenter and Data Transformation 9.6.1 HF4 and above.

• B2B Data Exchange 10.1 or 10.2, with Informatica Managed File Transfer when AS2 connectivity is
needed.

Activate the license with the GDSN options.

1. If you have a previous version of GDSN installed, perform the following steps:
a. Disable the PowerCenter workflows related to GDSN.
b. Disable the existing GDSN endpoints and profiles in B2B Data Exchange.
2. Unzip the GDSN Accelerator installation zip file named GDSN_10.2.0.zip to another location, such as the
following directory: c:\temp.
The zip file contains the following directories: DT_Services, DX_Partners, and PwC_Exports. Use these
directories to install the GDSN Accelerator on the Data Transformation machine, B2B Data Exchange
machine, and PowerCenter Integration Service machine.
3. Copy the DT_Services directory to the Informatica Data Transformation server machine, and add the
DT_Services directory files to the following directory: <Install_Dir>\DataTransformation\ServiceDB
4. To define the B2B Data Exchange endpoint root directory, open the Operation Console. In the Navigator,
select the System Properties node under the Administration node. Change the property
dx.endpoint.file.prefix.path to the desired prefix path of the endpoints folder.
The default value is the B2B Data Exchange installation directory.
5. To update definitions, run the following command on the B2B Data Exchange server machine:
<Data_Exchange_Installation>\DataExchange\dx-tools\import-all.bat -f <unzip_path>
\DX_B2B_GDSN_Accelerator_export.xml -u<user_name> -p<password>
For more information about the import tool, refer to the B2B Data Exchange Administrator Guide.

9
 6. In the PowerCenter Workflow Manager, to create the application connections that the GDSN Accelerator
needs in PowerCenter, perform the following steps:
a. Create an application connection for a JNDI connection. Specify the connection name as
DX_messageBroker. The context factory value is com.informatica.b2b.dx.jndi.DXContextFactory.
The provider URL is failover:tcp://localhost:18616, where 18616 is the value of the AMQ port. If you
changed the value of the AMQ port, change the URL accordingly.
b. Create the following application connections for a JMS connection. The destination type is QUEUE
and the JMS connection factory value is connectionfactory.local:

JMS Connection Name JMS Destination

input_gdsn_message_from_PIM queue.wf_m_gdsn_message_to_data_pool

input_gdsn_message_from_data_pool queue.wf_m_gdsn_message_from_data_pool

DX_return queue.tssa.return

7. In the PowerCenter Workflow Manager, create an application connection of type HTTP Transformation
with the following properties:

Field Value

HTTP Connection Name Http_set_status

User Provide the same user as for the REST API.

Password Provide the same password as for the REST API.

Base URL PIM URL

The default value is http://localhost:1501/rest/V1.0/manage/
publicationStatus/setStatus

Timeout 60

Certificate File Type PEM

Key File Type PEM

Authentication Type Auto

8. Create a folder in the PowerCenter Repository Manager and import the workflows from the second step.
9. Assign a PowerCenter Integration Service for each workflow that you imported, and then start the
workflow.

10 Chapter 2: Installation and Configuration Procedures

Chapter 3

Upgrade
GDSN Accelerator version 10.2.1 replaces the previous GDSN packages. Because MjR3 in not backward
compatible, GDSN Accelerator version 10.2.1 is also not backward compatible. To upgrade to GDSN
Accelerator version 10.2, follow the installation instructions.

11
Chapter 4

Components and Flows

The B2B GDSN Accelerator package includes definitions for B2B Data Exchange partners, endpoints, profiles,
workflows, and event types. It also contains Data Transformation services and PowerCenter workflows.

B2B Data Exchange and Data Transformation

Components
The B2B GDSN Accelerator package includes the dx_export_gdsn.xml file that provides definitions for B2B
Data Exchange partners, endpoints, profiles, workflows, and event types. It also contains Data
Transformation services.

The package provides the following B2B Data Exchange components:

• Partners:

Partner Name Description

Data Pool Partner associated with the GDSN data pool.

PIM Partner associated with the customer Product Information Management system.

• Profiles:

Profile Name Description

prof_gdsn_message_to_data_pool Profile associated with messages sent to the data pool.

prof_gdsn_message_from_data_pool Profile associated with messages sent from the data pool.

• Accounts:

Account Name Description

PIM_acc_name:PIM_acc_number Account number for the Product Information Management

system.

pool_response_acc_name:pool_response_acc_number Account number for the pool response.

12
• Endpoints:

Endpoint Name Type and Description

endpoint_gdsn_message_from_PIM_to_data_pool File receive endpoint for the Product Information Management

(PIM) hot folder path.

endpoint_gdsn_message_from_data_pool File receive endpoint that receives messages and responses

from the data pool.

endpoint_gdsn_from_dx_to_data_pool File send endpoint that sends messages from the data pool.

endpoint_gdsn_message_from_dx_to_PIM File send endpoint that sends messages from the PIM hot
folder path.

• Workflows: Includes the following PowerCenter and B2B Data Exchange workflows.

Workflow Name Description

wf_m_gdsn_message_from_data_pool Handles messages and responses from the source data pool (SDP) to the
data source (DS) and from the recipient data pool (RDP) to the data
recipient (DR). Updates the product information management system
using REST API calls.

wf_m_gdsn_message_to_data_pool Handles messages from the data source (DS) to the source data pool
(SDP), and messages from the data recipient (DR) to the recipient data
pool (RDP). Updates the product information management system using
REST API calls.

• Event Types:
- catalogueRequest

- catalogueResponse

- CIC

- CICResponse

- CIHW

- CIN

- CINResponse

- CIP

- CIS

- CISResponse

- gdsnItemRegistryResponse

- gdsnPartyRegistryResponse

- gs1Response

- Invalid File

- itemAuthorizationResponse

- itemReqResponse

- itemSyncResponse

B2B Data Exchange and Data Transformation Components 13

 - newItemConfirmResponse

- orgInfoMsgResponse

- RFCIN

- RFCINResponse

- validValueListResponse
• Event Statuses:

Event Status Name Description

Complete The message was successfully processed, or there is no status update from a REST API
call.

Invalid File The file is not recognized.

PIM Updated The Rest API call succeeded.

PIM Update Failed The Rest API call failed.

The package provides the following Data Transformation Services. Both workflows use these services.

• B2B_DSE_CIC_DS_to_status
• B2B_DSE_Request_To_Status
• B2B_DSE_Response_to_Status
• B2B_GDSN_extract_messageId
• B2B_GDSN_extract_messageName_from_data_pool
• B2B_GDSN_extract_messageName_to_data_pool
• B2B_GDSN_CIC_split
• B2B_GDSN_CIHW_split
• B2B_GDSN_CIS_split
• B2B_GDSN_RFCIN_split
• B2B_GDSN_CIN_split
• B2B_GDSN_CIP_split
• B2B_GDSN_flat_to_message
• B2B_GDSN_flatHierarchy
• B2B_GDSN_no_request_to_status
• B2B_1SYNC_catalogueRequest_split
• B2B_1SYNC_CIC_split
• B2B_1SYNC_CIN_to_CINR
• B2B_1SYNC_CIS_split
• B2B_1SYNC_RFCIN_split
• B2B_1Sync_request_to_status
• B2B_1Sync_response_to_status

14 Chapter 4: Components and Flows

Detailed Overview of Processing Flows
The GDSN Accelerator contains workflows that manage the processing flows described in this section.

Messages Sent to the Data Pool (DS to SDP, DR to RDP)

The Accelerator receives the GDSN file from the partner product information management system and
identifies the message type. Next, the Accelerator splits the message into files containing no more than 10
transactions, and creates a child event for each split.

The B2B Data Exchange event statuses identify the event life cycle and indicate processing success or
failure, or any other significant event in the processing life cycle. Events can be associated with logs that
provide additional information. For example, the input file is attached to the root event and an output file is
attached to each child event.

Reconciliation
The Accelerator indicates the correlation between messages addressed to the pool and the pool response
message.

The Accelerator creates a correlation flag set to Pending for every message sent to the pool. When the pool
sends a response message, the reconciliation flag is set to Complete.

The Accelerator defines a default period of 24 hours for responses to be sent. If the response is not sent
during this period of time, the status is set to Timed Out.

Messages Sent from the Data Pool (SDP to DS, RDP to DR)
The pool sends files that can be one of the following:

• A response file, acknowledging that the pool received a message sent to the pool
• A CIN message in a hierarchical format, which the recipient data pool sends to a data recipient
• A CIC message, that a source data pool sends to a data source
When a response file is processed, the Accelerator extracts the unique message identifier to correlate the
message with the original message sent to the pool.

The Accelerator transforms the CIN message from a hierarchical structure into a flat format, which the DR
and PIM can handle. When the Accelerator receives a CIC message it currently does not require any further
processing.

The B2B Data Exchange event statuses identify the event life cycle and indicate processing success or
failure, or any other significant event in the processing life cycle. Events can be associated with logs that
provide additional information. For example, the input file is attached to the root event.

Message to Data Pool Process Details

The Accelerator receives a GDSN file from either a data source or a data recipient at the landing zone. The
file can contain multiple transactions from a single type of message. After the Accelerator receives the GDSN
file, it identifies the message type, splits it according to the defined restriction with no more than ten
transactions per file, and creates a reconciliation flag for each split.

A file that does not conform to any of the expected GDSN messages structures, such as an invalid file, will
result with a failure. The event status is set to Error and event type is set to File Level Event.

For valid files, the event type is the short message name. For example, the event type is set to CIC for catalog
Item Confirmation, or CIS for catalog Item Subscription.

Correlation to the original message is performed when the corresponding response arrives from the pool. The
product information management catalog is updated when the Accelerator receives the CIN message.

Detailed Overview of Processing Flows 15

 The Accelerator updates the product information management catalog using the REST API with data from the
catalog request and catalog response messages sent by the data source and source data pool. The REST API
update status is sent for data source files. There are no status updates for data recipient files.

Documents Attached to Events

When a file is received or sent, it is attached to the corresponding event as a log. The following table
describes the logs:

Log Name File Description

Input Message The incoming file that the Accelerator receives.

Output Message The result output file.

HTTP Request The request to update the product information management system.

HTTP Response The response that the product information management system returns to the Accelerator.

16 Chapter 4: Components and Flows