Add/Edit File dialog box

This dialog box allows adding or editing an item containing file information.

Option Description
File name Specify the file name. You can use RRT in this text box, in particular the RRT provided from XPath queries configured on the Fields tab. This text box is enabled only if the Base64 content type is selected. In this case, it is mandatory to fill out this text box.
Content type Specify the type of content to determine how the file information will be received. You can select one of the two ways:
  • Base64 in this case the component will read the Base64 encoded content from a node or attribute of the input XML file.
  • File Path in this case the component will get the file located at the specified path.
Is required If this check box is selected, the component will require the file to be loaded:
  • For Base64 content type, this means that the XPath query should return a non-empty result. If the query does not return any value at run time or returns an empty value, an error message will appear at run time and the component will reject the document. If this check box is not selected and some query returns an empty value, the component will generate an empty file and a warning message will appear at run time.
  • For File Path content type, this means that the file should exist in the specified path. If there is no file located in the specified path, an error message will appear at run time, and the component will reject the document.
File content Specify information needed by the system to load a file at run time. The form of this information depends on the Content type value:
  • For Base64 content type, specify the XPath query that will retrieve Base64 encoded content from a node or attribute of the input XML file. For example:
    • *//Title[.='Beginning XML']/../Text
    • *//KnowledgeDocument/@Content

    You can click the Design button to design the query in the XPath Designer dialog box.

  • For File Path content type, specify the full path of the file that will be loaded at run time. This path may consist of several RRTs and strings, in particular the RRT provided from XPath queries configured on the Fields tab may be used. For example:
    • \\Srv01\~XIM::%publisher%~\~XIM::%Author info%~
    • ~XIM::%FilePath%~
Design Click this button to design an XPath query in the XPath Designer dialog box. This button is enabled only if the Base64 content type is selected.

All the files that the component passes to the subsequent components should have different names. If the component tries to create or upload a file, and another file with the same name has been already created/uploaded or an original file with such name is passed to the subsequent component, then the component behavior is as follows:

  • For a required file — The component gives an error message and the processed document is rejected.
  • For an optional file — The component gives a warning message and the file is not created/uploaded.

If the Base64 content type is used and the query returns non-empty value that is not Base64 encoded, then the component behavior is as follows:

  • For required file — The component gives an error message and the processed document is rejected.
  • For an optional file — The component gives a warning message and the file is not created/uploaded.

The order of the files in the Files tab does not matter. The component will first upload the required files, then optional files.