Managing File Sets

The File Sets page lets you view, edit, and create file sets. The available actions depend on your security role.

To access the page, click on the File Sets icon on the left menu bar in the process designer, or click the Manage file sets link when editing a file set field in the form designer canvas. If a file set is selected in the field, you can open it directly from the Open selected file set link.

The file sets menu icon:

The file set links in the field editor:

List of file sets

The list of file sets shows, for each file set, the file set name, the version number of the file set, when and who published it, when and who last modified it, and when and who created it. Click on a column name to sort sets by their values in that column, or search for file sets using the search bar at the top of the page.

For each file set, you can use the following buttons when the file set is selected.

Creating file sets

  1. Click the New button.
  2. Specify the name, and provide a description for the file set.
  3. Verify that the correct Repository is specified.
  4. If an end user will be able to get or download documents from the file set, select the Source folder where the files will be retrieved from.
  5. If an end user will be able to upload documents using the file set, specify the Destination folder within the repository where the documents should be stored.
  6. Click Create to create the file set and open the set in the configuration page.
  7. Once configuration is complete, click the Save button to save the changes.
  8. Click Publish to allow the file set to be used by the process.

Configuring file sets

The file set configuration page allows you to set up how the file set handles files and the appearance of the set table on a form, edit the file set details, and publish the file set to make it available to the process.

To change the source or destination default folders:

  1. Click the Settings icon to access the File Set Settings dialog.
  2. Edit the Source and/or Destination folders.
  3. Click Save to save your changes or Cancel to close the dialog without saving changes.

To change the file set name or description:

The name and description fields in the right pane allow you to edit the file set name or its description. Be sure to Save and Publish the file set after any changes.

File types

The Types tab provides the ability to create and edit what types of files can be added to a form. By setting up types, you can quickly organize a set of files as they relate to the process. Each type created has a name, how many files of this type are required for submission, and a maximum number of allowed files of this type.

To create a type:

  1. Click Add type
  2. Replace the placeholder text in the Type field with your desired type name.
  3. Set the Min count for the required number of files for this type.
  4. Set the Max count for the maximum number of files allowed for this type.
  5. Click the Save button to save the changes to the file set.

Note: The maximum number of files allowed for any type is 100.

Example: For an HR process, a file set may require (min count 1) a single (max count 1) resume (type - Resume), several letters of reference as optional, and a required application form.

To delete a type, click the delete button (X) to the right of the type row in the table.

File statuses

The Statuses tab allows you to create statuses with custom labels. The statuses allow you to both label an item for a step in your process, and control when a form can be submitted.

To create a status:

  1. Click Add status to add a status.
  2. Give the status a name.

To control form submission using a status:

  1. Place a file set field on a form.
  2. Select a file set that has at least one status.
  3. Check the Set required status for submission option.
  4. Select the status that will be required.
  5. Note: Each file in the file set must be set to the specified status before submitting the form.

  6. Save the form.

Columns

The Columns tab allows you to control which columns are displayed on the form. The file set appears as a table that displays a list of the types and other information about the files in the file set.

To control what columns are visible to the user, select or deselect the column names in the Select columns table. To change the displayed order of columns, drag a column name up or down in the Reorder selected columns table.

Note: Always remember to Save and Publish the file set whenever changes have been completed.