RosettaNet Map Process Flow

Notes:
  • The DTDs are located in GENSRVNT\RosettaNet\Complete DTD examples.
  • See the IBM® Sterling Gentran:Server® for Microsoft Windows Application Integration User Guide for more information on maps.

This table describes the tasks that you perform to configure each RosettaNet map.

Stage Description
1 Download the DTD for the appropriate Action from the RosettaNet website.
Notes:
  • Locate the DTD in the same folder as the DTDs provided with Sterling Gentran:Server for RosettaNet.
  • Before the system can receive inbound RosettaNet documents, you must place the corresponding DTD for that type of document in GENSRVNT\Bin.
2 Using a text editor, open the DTD depending on what version your map is:
  • inbound and RNIF version 1.1 - CompleteInboundActionRNIF1_1.DTD
  • inbound and RNIF version 2.0 - CompleteInboundActionRNIFV02_00.DTD
  • outbound and RNIF version 1.1 - CompleteOutboundActionRNIF1_1.DTD
  • outbound and RNIF version 2.0 - CompleteOutboundActionRNIFV02_00.DTD
  • outbound with attachments and version 2.0 - CompleteOutboundActionWithAttachmentsRNIFV02_00.DTD
3 For the defineAction entity, enter the name of the DTD that you downloaded.
4 Replace the word "Action" with the root tag of the DTD in the following locations:
  • <!ENTITY % defineAction SYSTEM "Action To be Mapped">
  • %defineAction;
5 Depending on your map version, replace the word "Action" with the root tag of the DTD in the following locations:
  • Inbound RNIF version 1.1 - <!ELEMENT RosettaNetMerge1.1 ( Pxml, PDOCTYPE, Preamble, Pxml, PDOCTYPE, ServiceHeader, Pxml, PDOCTYPE, Action ) >
  • Inbound RNIF version 2.0 - <!ELEMENT RosettaNetMergeV02_00 ( Pxml, PDOCTYPE, Preamble, Pxml, PDOCTYPE, ServiceHeader, Pxml, PDOCTYPE, Action ) >
  • Outbound RNIF version 1.1 - <!ELEMENT RosettaNetMerge1.1 ( ServiceHeader, Action ) >
  • Outbound RNIF version 2.0 - <!ELEMENT RosettaNetMergeV02_00 ( ServiceHeader, Action ) >
  • Outbound RNIF version 2.0 with attachments- <!ELEMENT RosettaNetMergeWithAttachmentsV02_00 ( ServiceHeader, Action ) >
6 Define the XML standards that you and your trading partners will use. Make sure these standards are installed on your hard drive and are available to Sterling Gentran:Server.
7 Using Application Integration, create the import or export map and select the DTD that you modified.
Notes:
  • For inbound you will create an export map.
  • For outbound you will create an import map.

See Creating an Inbound Map for Use with RosettaNet and Creating an Outbound Map for Use with RosettaNet for more information on selecting the DTD when you create the map.

8 For all outbound maps, you need to populate the DTD with the appropriate values. To do so, you need to ensure that you populate the attributes in the following table on the output side of the map with data.
For this value Map it like this
ServiceContentDTD Use an extended or standard rule so the value of this field is equal to the RosettaNet DTD for that action.

For example: #ServiceContentDTD = "3A4PurchaseOrder
AcceptanceMessageGuideline_v1_1.dtd";

Note: This field must be populated only if you are using attachments.
ServiceContentDoctype Use an extended or standard rule so the value of this field is equal to the RosettaNet DTD for that action.

For example: #ServiceContentDoctype = "PIP3A4PurchaseOrderAcceptance";

PartnerName Use a Select standard rule to map the partner name into this field.
InResponseDocumentName No rule is required. This field is equivalent to the proprietary document identifier for the document to which it is responding.
DocumentName Link to the proprietary document identifier for this document for the action being mapped.
GlobalBusinessActionCode Use an extended or standard rule so the value of this field is equal to the value contained in the PIP profile.

For example: #GlobalBusinessActionCode = "Purchase Order Acceptance Action";

9 Configure the Translation Object Details for each map. See Defining RosettaNet Translation Object Details for more information.
10 Save and compile the translation object.
11 Register the translation object with Sterling Gentran:Server.
12 Select the translation object for the appropriate trading partner relationship.