Configure file and directory chooser validations

This topic provides details on how to configure File and Directory Chooser validations.

Overview

A File Chooser field and Directory Chooser field can be used by object types to select a valid file or directory from an environment. Deployment Management connects to the first source environment on a workflow and provides the ability to do one of the following:

  • View all files within a specific directory and select one from the list.

  • Navigate through the directory structure and the selection of a directory from the list.

File Chooser requires the following:

  • A field defining the file location for the directory chooser, described Create file and directory chooser validations.

  • A field whose token is P_SUB_PATH. This field is the directory from which the file is selected and is usually a directory chooser field.

Directory Chooser has the following requirements:

  • You can only use the Directory Chooser field on an object type.

  • On every object type where a Directory Chooser is chosen, it is also necessary to have a field whose token is P_FILE_LOCATION and whose validation is DLV - File Location. The possible values for this field are Client and Server. If Client is selected, the Directory Chooser connects to the Client Base Path of the source environment. If Server is selected, the Directory Chooser connects to the Server Base Path of the source environment.

Back to top

Create file and directory chooser validations

This section provides details on how to create file and directory chooser validations.

To create a file or directory chooser validation:

  1. Open a new or existing validation, see Configure validations.

  2. In the Component Type field, select File Chooser or Directory Chooser.

  3. For file chooser validations, use the Base File Name Only checkbox to define whether the base file name only (without its suffix) or the complete name is displayed.

  4. In the Environment Override Behavior field, select one of the following:

    Selection

    Description

    Default Behavior

    Used to select files from the default environment.

    Static Environment Override

    Lets you override one environment at a time.

    Token-based Environment Override

    Provides the ability to select a token that is to resolve to the overriding environment.

    Depending on your selection the fields you see vary.

  5. For static and token-based selections you need to specify values for the following fields as appropriate:

    Field Name

    For

    Description

    Environment Token

    token-based

    Select the token that is to resolve to the overriding environment.

    Overriding Environment

    static

    Select the environment to be overridden.

    Overriding Client Basepath

    both

    Specify a basepath to override the client basepath of the environment.

    Overriding Server Basepath

    both

    Specify a basepath to override the server basepath of the environment.

  6. Click Save.

Back to top