Using PIDX

Petroleum Industry Data Exchange (PIDX) is the organization that develops EDI data requirements for the petroleum (oil and gas) industry and represents the industry regarding maintenance of the X12 standard. PIDX provides a forum for delivering the process, information, and technology standards, using the X12 standard as well as XML standards.

PIDX defines a format for business processes, which include data formats and flows using PIDX-defined transport methods and security. The PIDX-defined processes serve as frameworks for business flows throughout trading partner systems.

The PIDX implementation in Sterling B2B Integrator follows the RosettaNet RNIF 2.0 specification (message building and parsing), and it supports asynchronous HTTP.

Note: Prior to using PIDX in Sterling B2B Integrator, you must activate your license. Contact IBM® Customer Support if you have any questions about license activation.
Note: This manual assumes that you are familiar with PIDX.

This table describes how Sterling B2B Integrator supports PIDX:

Functionality Details Action You Need to Take to Implement PIDX
Services
  • RosettaNet Message Builder service constructs PIDX messages from documents and data stored in the business process context and uses standard trading profile objects to encrypt or sign message (if necessary)
  • RosettaNet Message Parser service parses PIDX messages, storing the extracted headers in process data, and places the service content and attachments as the body of the application documents, using standard trading profile objects to encrypt or sign message (if necessary)
  • RosettaNet Message Sending service is required to send PIDX messages to a trading partner
  • RosettaNet PIP Tracking service manages RosettaNet PIP tracking data and is used by PIDX business processes to ensure that the PIPs execute in the proper order and to add correlation data for PIDX messages
  • RosettaNet Profile service loads the standard trading profile data as well as PIDX Profile data from the configured trading partner contracts (the data is retrieved from the database and serialized as XML, and the XML is returned and can be mapped into process data)
  • HTTP Client adapter sends Action and Signal messages
  • HTTP Server adapter sends documents to and receives documents from a trading partner using HTTP
  • None
Predefined business processes
  • Initiator business processes for each of the 11 PIDX transactions (business processes beginning with PIPP)
  • Responder business processes for each of the 11 PIDX transactions (business processes beginning with PIPP)
  • The following action templates for business processes (if you want to customize your own business processes) are located at:

    <standardsclump>/product/resources/services/cidx/files/data/cidx/templates

    - OneActionTxn_Initiator_Private_ Template.bpml

    - OneActionTxn_Responder_Private_ Template.bpml

    - TwoActionTxn_Initiator_Private_ Template.bpml

    - TwoActionTxn_Responder_Private_ Template.bpml

  • RNIF Envelope business process uses the RosettaNet Message Builder service to build the final PIDX message
  • RNIF Deenvelope business process uses the RosettaNet Message Parser service to handle incoming PIDX messages
None
IBM Sterling B2B Integrator Map Editor
  • Sterling B2B Integrator Map Editor wizard enables you to generate a file layout using the PIDX message that you select. Included in the PIDX map are the map components that are defined by PIDX.
  • Properties dialog boxes that enable you to define and modify PIDX map components.
  • Autolink function automatically creates links between input and output fields that have the same name or business name. This function can be used with any data format.
  • Additional mapping operations as needed.
  • Download Sterling B2B Integrator Map Editor.
  • Create a map or maps to translate your PIDX messages.
Correlation Search Search by PIDX information. Use the Correlation search functionality to search for PIDX correlation information.
Trading Partner
  • The Trading Partner Contract Wizard includes a PIDX extension type.
  • The Trading Partner Contract Wizard uses PIDX terminology for parameters.
Create PIDX trading partner records, including Identities, Transports, Document Exchange, Packaging (to support SIGNING and/or ENCRYPTION), Profiles, and Contracts.
PIP Codes Codes for 11 PIDX transactions are available in the PIP definition file that is preloaded with Sterling B2B Integrator. None