Configuring an ION receiver

When you configure an ION receiver, you are telling Infor Process Automation how to handle data that comes in from a particular ION channel.

  1. Access the Process Server Administrator and select Administration > Channels Administrator.

  2. Select the channel that you would like a receiver to be created.

  3. Go to the ION Inbox Receivers tab.

  4. Click Actions > Create.

  5. Specify this information:

    Channel Name

    This field is pre-populated based on the channel for which you are configuring a receiver.

    ION Receiver Type

    Options are:

    • BOD Group: This receiver listens for BOD types that are part of the specified BOD group.

    • ION Pulse: This receiver listens for ION Pulse BODs.

    • BOD Type: The receiver listens for a specific type of BOD.

    The subsections that follow this table provide descriptions of the options for each receiver type.

    To Logical ID

    The ION Connect Logical ID of this Connection Point.

    Description

    Short description of the receiver

    Scan Frequency (Minutes)

    Configures how often to scan the ION Inbox for BODs to process. If the "Run from time" and "Run to time" are configured, the scan will happen only during the indicated time interval.

    Run From Time and Run To Time

    If you want the scan to look for this BOD during a specific timeframe, for example, 2:00 AM to 4:00 AM, use these fields to configure the start and stop times.

    A blank "Run from time" and/or "Run to time" means midnight.

    Startup Type

    Determines when the receiver starts up. Options are:

    • Automatic: File starts up automatically when the system starts.

    • Manual: File does not start automatically when the system starts. The administrator must start it manually.

    • Disable: The receiver has been taken off-line, does not start.

Rcvr Type = BOD Type

The BOD Type receiver is used when you are configuring a single BOD.

Option Description
BOD Type

The name of the BOD (XML document) to listen for in the format: Noun.Verb

Example: Process.Shipment

Process The name of the process that triggers when the BOD is received.
Seq Method

The sequencing method to use. Available selection are:

  • Timestamp - Process BODs based on the timestamp in the ION Inbox record.

  • Variation Id Sequence - Process BODs based on the Variation Id, interpreted as a sequence number.

  • Variation Id Timestamp - Process BODs based on the Variation Id, interpreted as a timestamp.

Number of WU Restarts Number of times to restart a failed workunit.
WU Restart Wait Time (Minutes) Number of minutes to wait before restarting a failed workunit.
Number of Rescans

Number of rescans for "out-of-sequence" BODs. Defaults to 1 and applies to Seq Method of "Variation Id Sequence".

When a BOD is received "out-of-sequence" (e.g.: has a sequence number that is higher than expected), this option determines how many times to rescan the ION Inbox in order to wait for the BOD with the expected Variation Id sequence.

When the configured rescans are exhausted, it is assumed that the expected BOD sequence was lost or not sent. The receiver will then continue processing the next sequence for the BOD.

Skip Old BOD Versions When this flag is enabled and the scan retrieves multiple BODs for the same object, only the latest BOD for the object is processed; the older BODs for the object are skipped.
Enforce Sequential Batch Id

Enable if you are receiving BODs in a batch and want the BODs to be processed sequentially by Batch Id.

If this option is set to True, the following processing occurs:

  • Batches for a specific source (From Logical ID) are processed in sequence based on BatchID.

  • A batch that goes out of sequence waits for the expected batch. No other batch processing from any source occurs until either the expected batch or an abort for that batch is received. (An abort would cause the expected batch to be discarded.)

  • If the receiver is waiting for batch that will never be received, that batch can be manually skipped by updating the LastBatch# in the IONBatchNum record for the BODType and FromLogicalId.

    Do this by setting the field to be the batch number that the receiver is waiting for, to simulate that it was received. This will allow the receiver to scan for the next batch.

If this option is set to False, the following processing occurs:

  • BatchID is ignored.

  • Timestamp is used; "out of sequence" batches will not occur.

Rcvr Type = BOD Group

BOD Group: The name of the BOD Group

Rcvr Type = ION Pulse

Pulse Type: Select the ION Pulse BOD to process:

  • Pulse Task

  • Pulse Alert

  • Pulse Notification