Skip to content

Configure Multiple Receivers

This use case describes how to distribute the documents of one SAP job to several receivers. SAP sends one main RLI that references one sub-RLI per receiver. PLOSSYS Distribution Engine processes each sub-RLI in its own sub job. Use this configuration if receiver lists are used in Document Distribution Director.

Prerequisites

Activate Multiple Receivers

Perform the following steps on the Distribution Engine server:

  1. Open main.customer.xml in an editor:

    • Windows: %SEAL_CUSTOMDIR%\server\dpf\templates\main.customer.xml
    • Linux: %SEAL_CUSTOMDIR%/server/dpf/templates/main.customer.xml

  2. In the jobConfig element named dpf4distribute, set workflow to dpf4distribute.MultiRli. Keep the existing job parameters, for example DIST_CONFIG.

    <jobConfig name="dpf4distribute" workflow="dpf4distribute.MultiRli">
    <!-- existing job parameters, unchanged -->
</jobConfig>

    dpf4distribute.MultiRli processes jobs with one receiver as well. SAP can send all jobs to the same job configuration.

  3. Open dpf4distribute.customer.ini in an editor:

    • Windows: %SEAL_CUSTOMDIR%\server\dpf\conf\dpf4distribute\dpf4distribute.customer.ini
    • Linux: %SEAL_CUSTOMDIR%/server/dpf/conf/dpf4distribute/dpf4distribute.customer.ini

  4. Add the RECEIVER section to RliSectionNames:

    RliSectionNames = JOBINFO default RECEIVER

    Without this line, PLOSSYS Distribution Engine does not read the receiver parameters from the sub-RLIs.

  5. Run dpfupdate.

Validate

  1. In SAP, start a test job with at least two receivers.

  2. In DPF Tracker, check that the job runs with the dpf4distribute.MultiRli workflow. The job has one sub job per receiver.

  3. Check that each receiver gets the documents. For e-mail, each receiver gets its own e-mail.

  4. Check that SAP receives one status for the whole job.

Background Information

How the Workflow Processes a Job

dpf4distribute.MultiRli checks whether the main RLI references at least two further RLIs:

  • If not, it processes the job with the standard dpf4distribute.main workflow.
  • If yes, it starts one sub job with dpf4distribute.main for each sub-RLI.

The sub jobs do not send a status to SAP. After all sub jobs have finished, the main job sends one status for the whole job:

  • If all sub jobs succeed, the job succeeds.
  • If at least one sub job fails, the job fails.

Hint - behavior with multiple receivers

  • PLOSSYS Distribution Engine checks out the documents once per receiver. A document for three receivers is checked out three times.
  • In DPF Tracker, the main job shows 100 % as soon as the sub jobs have started. It keeps this value until all sub jobs have finished.
Back to top