EDIFACT Deenvelope Service

The following table provides an overview of the EDIFACT Deenvelope service:


System Name
DeenvelopeEDIFACT
Graphical Process Modeler (GPM) categories
All Services, EDI > EDIFACT
Description
Handles deenveloping of inbound EDIFACT interchanges. This service performs the following tasks:
  • Compliance checking, except for sequence checking.
  • Generates acknowledgements if no sequence checking is required.
Business Usage
Using this service can:
  • Improve performance by deferring sequence checking, as required.
  • Enable the EDI Processing service to update your database with applicable control numbers.
Usage Example
An inbound purchase order is received inside an EDIFACT interchange. The EDI envelopes are parsed and the document envelopes that match the envelope data are retrieved. With the document envelopes, this service perform the appropriate action for purchase order, such as starting a business process.
Preconfigured?
No pre-configuration necessary
Third Party Files?
No
Platform Availability
All supported application platforms.
Related Services
If sequence checking required, this service works with the EDI Post Processor service.
Application Requirements
None
Bootstrapping
This service may bootstrap business processes specified in envelope definitions for handling incoming documents, and may also invoke business processes to handle outbound acknowledgements associated with an incoming interchange.
Invocation
This service is invoked inside the EDIFACTDeenvelopeUnified business process. Normally, customers would use the business process, and should not need to directly work with this service.
WFC Considerations
None

Document Tracking Levels and Performance

You can boost EDI performance in the IBM® Sterling B2B Integrator by using the TRACKING_LEVEL parameter to adjust the tracking level for business processes.

You set the default global settings for the TRACKING_LEVEL parameter in the enveloping.properties file. However, these global settings can be overridden for certain EDI-related services by using the BPML-only TRACKING_LEVEL parameter. This enables you to obtain maximum EDI performance in some business processes and maximum search and tracking functionality in others. This parameter can be set for the following services:

Inbound Services

  • CII Deenvelope service
  • EDIFACT Deenvelope service
  • EDI Post Processor service
  • X12 Deenvelope service
  • Generic Deenvelope service

Outbound Services

  • EDI Encoder service
  • CII Envelope service
  • EDIFACT Envelope service
  • Envelope Generic service
  • X12 Envelope service

This performance boost is done at the expense of Tracking and Search functionality. The tracking level setting affects the following EDI functionality:

  • EDI Correlation Search
  • EDI Document Tracking
  • EDI Reporting

The TRACKING_LEVEL parameter is not available in the IBM Sterling B2B Integrator service configuration or in the GPM. It must be added manually to the BPML. Use the TRACKING_LEVEL parameter with one of the following settings:

Setting
Description
none
Provides the largest EDI performance boost with the least tracking and search functionality. EDI Correlation Search, EDI Document Tracking and EDI Reporting are nonfunctional.
basic
Provides an EDI performance boost while also providing search functionality. EDI Correlation Search is functional. EDI Document Tracking and EDI Reporting are nonfunctional.
full
Default setting. Provides the lowest EDI performance with the highest search and tracking functionality. EDI Correlation Search, EDI Document Tracking and EDI Reporting are fully functional.
Note: Document tracking is turned off by default in the system-defined EDI business processes. If you define an EDI business process and turn Document Tracking on, that will override the TRACKING_LEVEL settings in both the enveloping.properties file and the EDI service parameter.
Note: All EDI services assign a Unique ID to each log message.

Adding Translation Map Name to Process Data

The EDIFACT Deenvelope service automatically adds the name of the map used by the translator (as specified when building the envelope) in an inbound or outbound translation to process data. The EDIFACT Deenvelope service writes the map name into the process data regardless of the reason the translator was invoked; that is, for a compliance check only, or for both compliance check and translation.The map name in process data enables enhanced configuration possibilities for your business process models. For example, you can configure business processes to use the map name for tracking or cross reference purposes, configure decisions in your process models to choose a subprocess according to the map that was run, or to create a report when there are translation errors.