Response "File"

Settings


(1) Is backup of target data: This checkbox creates backup output files that are assigned to the job and can be viewed in the Control Center on page "Overview". This gives you a chance to check which data has been sent. If several Responses have this option set, only the content of the last one is available. A name of the output file cannot be specified. The output file is created in the backup directory of the profile and has the name ARC_<job number>_<Response number>. If the option Enter output channels for each record is set, the output files have the name ARC_<job number>_<record number>#<Response number>.

(2) Channel selection: You can select an "SMB" channel here. See also (3) and (4). Important note: The complete UNC path to the file (3) must be specified, since the server specification in the channel only serves for the log in. Note : If an SMB channel is selected, the value //<SMBHOST>/ is automatically entered in (3). The placeholder <SMBHOST> is replaced at runtime with the value of field "Server" in the SMB channel (without smb:// ) . Old profiles (which do not yet contain the placeholder) can be adjusted in the Admin Console by executing the class com.ebd.hub.datawizard.util.update.AdjustSMBUrl (without parameters).

(3) File: Path and file name pattern of the output file. Under Windows, access to external shares is possible using the UNC syntax: //<server name>/<directory name>. Slashes (/) and no backslashes (\) are to be used.

(4) SMB Share: When accessing external shares, you can specify an explicit SMB login or use a channel (2).

(5) Append: If this checkbox is set, no new file will be created for the output data, instead, it will be added to the end of an already existing file. But if the file does not exist yet, it will be created. Attaching to an existing file is not possible in the following cases. In those cases, the setting of the checkbox will be ignored and a new file will always be created.

  • Output format XML. An XML file may only have one root node.

  • Output format Excel. An Excel file is a file in a binary file format.

  • A file containing compressed data is also a file in a binary file format.

(6) Target directory must exist: If this checkbox is set, there will be a check to see if the destination directory exists before writing the file. If it does not exist, the Response creates an error. This checkbox should be used especially if the destination directory is a mounted directory.

(7) Transmit empty data: If this checkbox is set, empty files are transferred as well.

(8) Mark whole job as failed if this response fails: Normally a job is not necessarily considered to be erroneous if a single Response fails (see section Status of Response - Error Behaviour). But it can be enforced with this option here.

(9) Additional text on error: Here you can specify an additional log text for the error case.

Notes


  • See also section "Security - Defining function restrictions".

  • If the content to be written to a file is empty, the Response is not entered. That is, no output file is generated. This behaviour can be changed by setting the system property "-Ddatawizard.removeZeroFile=false". If this property has the value "false" and the content is empty, the Response is entered and a file is created, or the empty content is attached to an existing file.