Skip to content

Configure Document Processing

PLOSSYS Distribution Engine converts, archives, or merges each document before distribution, based on DIST_TYPE. DIST_TYPE determines what happens to a document. The Want* keys enable or disable each processing step globally. Within an active step, DIST_TYPE then filters which individual documents get processed.

This use case covers the standard document processing scenarios.

Convert a Document to PDF

This converts a document to PDF before distribution.

Requirements:

Hint - defaults

WantProcess and WantConvert default to Y, so a job only needs to set them if a project-specific configuration disabled one.

Steps:

  1. Set DIST_TYPE = PDF on the document, or on the job to convert every document without its own value.

  2. Optionally set DIST_FILENAME to name the converted PDF. If DIST_FILENAME does not end with .pdf, PLOSSYS Distribution Engine replaces the file extension with .pdf and keeps the directory path.

Result: PLOSSYS Distribution Engine converts the document to PDF, on the same RLI line. IS_DIST_FILE = Y applies, since DIST_TYPE is PDF.

Archive Documents in a ZIP File

This archives one or more documents of a job in one ZIP file before distribution.

Requirements:

Hint - defaults

WantProcess and WantZip default to Y, so a job only needs to set them if a project-specific configuration disabled one.

Steps:

  1. Set DIST_TYPE = ZIP on the documents to archive.

  2. Set DIST_ZIP_FILENAME on job level, to name the ZIP file.

  3. Optionally set DIST_FILENAME per document, to name the file inside the ZIP file.

Result: PLOSSYS Distribution Engine creates the ZIP file and appends it to the RLI as a new line, with IS_DIST_FILE = Y. The original documents stay in the RLI but are not distributed separately, since they do not receive IS_DIST_FILE = Y.

Merge Documents into One PDF

This merges multiple documents of a job into one PDF before distribution.

Requirements:

Hint - defaults

WantProcess, WantMerge, and WantConvert default to Y, so a job only needs to set them if a project-specific configuration disabled one.

Steps:

  1. Set DIST_TYPE = MERGE on the documents to merge.

  2. Set DIST_MERGE_FILENAME on job level, to name the merged PDF. Use a unique name if the job produces more than one merge result.

Result: PLOSSYS Distribution Engine creates the merged PDF and appends it to the RLI as a new line, with IS_DIST_FILE = Y. The original documents stay in the RLI but are not distributed separately, since they do not receive IS_DIST_FILE = Y.

Distribute a Document Unchanged

This distributes a document unchanged, without conversion, merging, or zipping.

Requirements: none. NATIVE documents skip conversion, merging, and zipping, regardless of WantProcess, WantConvert, WantMerge, and WantZip.

Steps:

  1. Set DIST_TYPE = NATIVE on the document.

  2. Optionally set DIST_FILENAME to rename the file.

Result: PLOSSYS Distribution Engine distributes the document as is, on the same RLI line. IS_DIST_FILE = Y applies, since DIST_TYPE is NATIVE.

Validate

  1. Trigger a test job in SAP with one document for each scenario.

  2. Check that PLOSSYS Distribution Engine produces the expected converted, zipped, merged, or unchanged file per document.

  3. Check that only the expected files reach the distribution channel, refer to IS_DIST_FILE.

Back to top