Configure Fileout¶
This use case describes how to configure distribution via the FILEOUT channel: PLOSSYS Distribution Engine stores documents from a SAP structure on the file system instead of sending them by e-mail or to another channel.
Prerequisites¶
- SAP DDD is connected to PLOSSYS Distribution Engine, refer to Architecture Overview. For the SAP-side setup, refer to the chapter "Output via PLOSSYS Distribution Engine" in the SAP Document Distribution Director documentation.
- SAP transaction
/n/seal/imgis available. TARGETDIRis configured for the target order type, refer to File Naming and Target.
Activate the Fileout Channel¶
To activate the Fileout channel, execute the following steps in SAP:
-
Start transaction
/n/seal/img. -
Navigate to
SEAL BC Sets→BC Sets PLOSSYS Distribution Engine(BC Set/SEAL/DDD_DST_DEV, registers theFILEOUToutput device together withEMAILandWEBPORTALin one shared BC Set). -
Check the delivered defaults and activate the BC Set for the desired SAP order type, for example
PUR.Hint - related BC Set
/SEAL/DDD_DST_FILEOUT_DATpresetsDIST_CONFIGandQUEUEtoFILEOUT, andTARGETDIRto a default value, for order typePUR.
Configure the Distribution Engine Server¶
Execute the following steps on the Distribution Engine server.
Hint - work with a copy in the customer directory
We recommend copying fileout.ini from %DPFSRV%/conf/dpf4distribute/ to %SEAL_CUSTOMDIR%/server/dpf/conf/dpf4distribute/ and editing only the copy. For the directories, refer to DPFSRV and SEAL_CUSTOMDIR. If the copy exists, DPF reads it instead of the delivered file. The copy replaces the delivered file completely. Keep all entries of the delivered file in the copy.
-
Open
fileout.ini.Hint - file name follows
DIST_CONFIGThe file name follows the
DIST_CONFIGvalue passed from SAP. For the default valueFILEOUT, this isfileout.ini. -
Check that the file contains the channel activation entry, and add the target directory:
DistChannel_1 = dpf4distribute.DistributeFileSystem TARGETDIR = <target-path>Caution -
DistChannel_1is requiredWithout this
DistChannel_nentry, no file is stored even ifTARGETDIRis set correctly.
Adjust Parameters Not Needed for Fileout¶
The FILEOUT channel does not send e-mail, so the mandatory e-mail receiver requirement has to be deactivated. Execute the following steps in SAP:
-
Navigate to
Grundeinstellungen→Parameter-Konfiguration→Parameter festlegen (Detail)(table/seal/out_cr010). -
For your order type (for example
PUR), find the row for parameter IDMAILRECEIVERand remove the mandatory flag (Pflicht= empty).
Validate¶
-
In SAP, confirm that your order type is registered for the
FILEOUTchannel in the Structure Explosion configuration variant. -
In SAP, trigger a message for a purchase order (transaction
me22n). -
In SAP, check that the DDD output order was created with
QueueandProzess-Konfigurationset toDateiablage. -
On the Distribution Engine server, check that the output order was processed in the DPF Tracker.
-
On the Distribution Engine server, check that the files are present in the configured target directory.