Using App Properties in a Flow

Configuring a field with an app property is recommended for fields that require their values to be overridden when the app goes into production. Hence, the decision as to which fields in an activity should support app properties (which fields can be configured using an app property) must be decided at the time when the extension for the category is being developed. The fields that can be configured using an app property display a slider button against their names in the UI.

Connection-specific app properties are visible in the App Properties dialog after you select a connection when configuring the activity or trigger, but they appear in read-only mode. This is because connections are reusable across apps and connection-related app properties are managed (refreshed) automatically. Connection-related app properties cannot be used for configuration anywhere within an app. Their only purpose is to allow you to change a connection value if need be during runtime. For more details on how the connection properties get created and used, see Using App Properties in Connections.

To configure a field with an app property, follow these steps:

Procedure

  1. Open the flow details page.
  2. Click the activity whose field you want to configure with an app property.
    This opens the configuration pane for the activity.
  3. Click the slider () against the name of the field you want to configure with an app property. If the field does not display a slider, the field can not be configured with an app property.

    The App Properties dialog opens. Only those app properties whose data type match the data type of the field are displayed.
  4. Click the property you want to configure for the field.

    The property name appears in the text box for the field and the default value of the property gets implicitly assigned to the field.

    After configuring the property, if you want to change a field to use a different property, hover your mouse over the end of text box for the field until the Select another property value icon appears. Click the Select another property value icon.

    For a field that has been configured with an app property, you can unlink the property from the field. Refer to Unlinking an App Property from a Field Value for more details.