Trading Networks 10.3 | Administering and Monitoring B2B Transactions | webMethods Module for EDI | Optional Inbound Processing When Using Trading Networks | Reprocessing EDI Documents with Invalid Control Numbers | Reprocessing Documents with Out-of-Sequence Control Numbers | Creating a Service to Reprocess Documents with Out-of-Sequence Control Numbers
 
Creating a Service to Reprocess Documents with Out-of-Sequence Control Numbers
The following diagram shows sample code that includes the logic you need to locate and reprocess out-of-sequence ANSI X12 documents. See the table below the diagram for more information.
Flow operation
Description
1
Invoke the wm.b2b.editn.util.reprocess:listInSequence service to retrieve a list of EDI documents that had out-of-sequence control numbers, but now due to missing documents arriving, are in sequence.
For more information about the listInSequence service, see the webMethods Module for EDI Built-In Services Reference .
2
The wm.b2b.editn.util.reprocess:listInSequence service returns a list of Trading Networks internal IDs in the docList parameter. This list represents EDI documents that are now in sequence. Loop to perform the following steps against each internal ID in the list.
3
Steps 3 through 6 are needed if you use automatic functional acknowledgment (FA) generation for ANSI X12 or UN/EDIFACT documents. If you use automatic FA generation, when reprocessing Interchange documents, you will want to generate FAs; however, when reprocessing Group documents, do not generate FAs because the FAs have already been generated for the document. For more about automatic FA generation, see Automatically Generating Functional Acknowledgments.
Invoke the wm.tn.doc:view service to retrieve information about the document. Specifically, the value of the EDI Group Type attribute is needed to determine whether the document is an Interchange or Group document.
When you invoke wm.tn.doc:view, set the following input parameters:
*Map the docList parameter under Pipeline In to internalID under Service In.
*Set the value of getContent under Service Into false.
*Set the value of getRelated under Service In to false.
4
The value of the EDI Group Type attribute is in the bizdoc/Attributes/EDI Group Type pipeline variable. To branch based on its value, set the Switch property to the following:
bizdoc/Attributes/EDI Group Type
*When bizdoc/Attributes/EDI Group Type is Envelope, it is an Interchange document.
*When bizdoc/Attributes/EDI Group Type is another value (for example, PO), it is a Group document.
5
Add a MAP flow operation to set the value of the generateFA parameter, which is an input to the wm.b2b.editn.util.reprocess:reprocessDocument service.
To do so, with the MAP flow operation selected on the Pipeline tab, add a generateFA parameter under Pipeline Out and set the value to one of the following:
*In the SEQUENCE for when the EDI Group Type attribute is Envelope, set the value to true, which indicates the wm.b2b.editn.util.reprocess:reprocessDocument service should generate the FAs.
*In the SEQUENCE for when the EDI Group Type attribute is another value, set the value to false, which indicates the wm.b2b.editn.util.reprocess:reprocessDocument service should not generate the FAs.
For example, the diagram shows the pipeline for the MAP when the EDI Group Type attribute is Envelope (that is, the generateFA parameter is set to true).
6
Use a MAP flow operation to clean up the pipeline by dropping all parameters related to invoking the wm.tn.doc:view service. Drop the following parameters: internalID, getContent, getRelated, bizdoc, sender, receiver, relatedDocCount, relatedDocs, groupDocCount, and groupedDocs.
7
Invoke the wm.b2b.editn.util.reprocess:reprocessDocument service to reprocess an EDI document that is now in sequence.
To set the inputs for this service, with this flow operation selected, perform the following on the Pipeline tab:
*Map the docList parameter under Pipeline In to internalID under Service In.
*If you added the generateFA parameter to the pipeline in the previous steps, the generateFA parameter exists under Pipeline In and is automatically mapped to the generateFA input parameter under Service In. If you are not using automatic FA generation, you can set the value of generateFA under Service In to false.
*Set the value of the updateControlNumber parameter under Service In to true. This is necessary so the service updates the next expected control number in the EDIControlNumber table.
For more information about the reprocessDocument service, see webMethods Module for EDI Built-In Services Reference .
8
After you reprocess a document, there might be another out-of-sequence document that is now in sequence. This next document that is now in sequence would be one that has the same sender/receiver and group type as the one you just reprocessed. For example, if you reprocess a Group document of group type "PO" from sender A and receiver B, and the Group document had the control number 4. The Group document of group type "PO" from sender A and receiver B with control number 5 might also be available to process, and it is now in sequence.
To locate and reprocess the next document in sequence, use a REPEAT loop. You will exit this loop when a pipeline variable becomes null, indicating there are no more next documents in sequence. (See step 11 below.) When defining the properties for the REPEAT loop, do the following:
*Set the Repeat Interval property to -1.
*Set the Repeat On property to SUCCESS.
9
Invoke the wm.b2b.editn.util.reprocess:nextInSequenceDoc service to determine whether there is another document that had an out-of-sequence control number that is now in sequence due to the processing the document in step 2 above.
The input to this service (bizdoc) is in the pipeline because it is an output of the wm.b2b.editn.util.reprocess:reprocessDocument service. The Pipeline In variable will automatically map to the Service In variable. You should drop the bizdoc parameter in Pipeline Out.
If the nextInSequenceDoc service locates a next document, it returns the Trading Networks internal ID of the document in the nextDoc parameter. Otherwise, the nextDoc parameter will be null.
For more information about the nextInSequenceDoc service, see webMethods Module for EDI Built-In Services Reference .
10
Use a BRANCH flow operation to branch based on the value of the nextDoc parameter, which is the result of the nextInSequenceDoc service.
11
If the value of nextDoc parameter is null, exit the REPEAT loop.
12
If the nextDoc parameter has a value, prepare to execute the wm.b2b.editn.util.reprocess:reprocessDocument service against this next document to reprocess it.
The following flow operations are similar to steps 3 through 6 described above. Differences are noted below.
*INVOKE wm.tn.doc:view
When setting the inputs to this service, map the nextDoc parameter under Pipeline In to internalID under Service In.
*BRANCH on bizdoc/Attributes/EDI Group Type
*SEQUENCE for setting generateFA when EDI Group Type is Envelope
*SEQUENCE for setting generateFA when EDI Group Type has another value
*MAP to drop variables related to invoking wm.tn.doc:view
13
Invoke the wm.b2b.editn.util.reprocess:reprocessDocument service against the next document to reprocess it.
To set the inputs for this service, with this flow operation selected, perform the following on the Pipeline tab:
*Map the nextDoc parameter under Pipeline In to internalID under Service In. You should drop the nextDoc parameter in Pipeline In.
*If you added the generateFA parameter to the pipeline in the previous steps, the generateFA parameter exists under Pipeline In and is automatically mapped to the input variable generateFA under Service In. If you are not using automatic FA generation, you can set the value of generateFA under Service In to false.
*Set the value of the updateControlNumber parameter under Service In to true. This is necessary so the service updates the next expected control number in the EDIControlNumber table.