5.4 Creating Input Definitions

An input definition is an object that defines the mapping between an input file and the metadata fields of the selected application when a document is uploaded. The input file includes what document files to upload on the file system, what application to use when uploading the files, and other initial document creation options.

You can reuse an existing input definition within Oracle I/PM by exporting the desired definition to an XML file. You can then import that definition file into other systems and modify it appropriately. For more information about exporting and importing, see "Exporting and Importing Definitions".

Note that you must have Create or Administrative rights for the type of input you are creating, and View rights for the application to which the documents are uploaded. To create an input definition, do the following:

  1. From the navigator pane under Manage Inputs, click the Create Input icon. The Input Basic Information Page displays.

  2. Enter the name of the input. This name will appear under Manage Inputs in the navigator pane. This is a required field.

  3. In the Description field, type a short description of the Input being created.

  4. Enabling Online tells the Input Agent to start polling the definition files of this input once it is completed.

  5. The Auto-detect input file character set field is enabled by default. If you disable it, a picklist displays from which you can select the file character set to be used. Note that this is the character set used to create the input definition file, not the character set of the documents to be uploaded.


    Auto-detect does not work if the provided sample file is not large enough to get an accurate determination of the character set. If the sample file is too small, disable Auto-detect input file character set and manually select the character set.
  6. Select an sample file to use. There are two options to locate an input file:

    • Browse: Displays a list of input files in the Samples directory that are available to use.

    • Upload: Opens a standard file navigation dialog to locate and upload a new input file from a local or shared network drive to the Samples directory. Although any delimited text file is accepted, preferable file types are ASCII or UTF-8 text files.

  7. When a sample file has been selected, click Next. The Input Identify and Parse File Parameters Page is displayed and the Input Mask field lists the selected sample file.

  8. Ensure the delimiter is the same single character that is used to separate columns within the sample file. By default, a pipe is indicated.

  9. Select an application for mapping from the Applications field.

  10. Click Next. The Input Field Mapping Page is displayed.

  11. Define how the input file fields will map to the application. At least one field must be mapped and the file path must be specified. Table columns are defined as follows:

    • Application Fields: Name of field within application

    • Input Column: Number of corresponding column within input file

    • Sample Data: Column data taken from sample file

    • Use Application Default: Specifies whether to use the default value specified in an application when the definition file contains empty data for the field.

    • Date Format: Specifies how the Input Agent parses the date string. If no date format is specified, the server's locale is used to parse date values. To specify a date format, click the Add a date format for this mapping icon. Click the Edit date format icon to change an existing date format. Click the Delete date format icon to delete the date format specified.

  12. Click Next. The Input Security Page is displayed.

  13. Click Add. The Add Security Member Page displays. Type a user name or click Search to display a list of users from which to select.

  14. Select the user you want to add. The user name is added to the Display Name column on the Input Security Page page.

  15. Enable the permissions you want to assign to this user by selecting the field in the appropriate column. Options are:

    • View: Enabled by default. Grants the user or group the right to view this input.

    • Modify: Enable to grant the user or group the right to modify all aspects of this input except for granting security rights.

    • Delete: Enable to grant the user or group the right to delete this input.

    • Grant Access: Enable to grant a user or group the right to grant security rights to others for this input. If this is the only security level granted, the user can modify only the security information for this input.

    A user with Grant Access permission can grant themselves all other rights. At least one user must be given Grant Access rights.

  16. Click Next. The Input Review Settings Page is displayed.

  17. Review your settings. Click Back to return to the appropriate pages to make any necessary changes. When done, return to the Input Review Settings Page and click Submit.