Hover your mouse cursor to the extreme right end of the property and click Delete. To delete a parent, hover your mouse cursor to the extreme right end of the parent and click Delete

3. Click Save.

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 cursor over the end of the 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.

Using App Properties in the Mapper

You can use app properties when mapping an input field. The app properties available for mapping are grouped under the $property domain-specific scope in the mapper. All mapper rules and conditions apply to the use of app properties as well. For example, the data type of the app property value must match with the input field data type when mapping. Connection-related app properties that are used by any

connection field in an activity do not appear under $property since they cannot be accessed. 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. Hence, they cannot be used to map input fields.

Refer to the section on Mapper for details on how to use the mapper.

Unlinking an App Property from a Field Value

For a field that has been configured with an app property, if you decide at a later time not to use the app property, you can click and slide its slider ball ( ) to the left. This will remove the app property from the field (unlink it from the field) but will leave the field configured with the default value of the app property.

The field retains the default value of the app property, but it gets be disassociated from the app property

and will appear as a manually entered value. Hence, if you change the default value of the app property beyond this point, it will not affect the value of the field.

Using App Properties in Connections

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. Hence, you cannot use connection-related app properties to map an input field as these properties are not visible in the mapper.

You can only view them in the App Properties dialog, but cannot edit, update, or delete them. Before you build your app, their values can only be edited in the connection details dialog, the dialog where you provided the credentials for the connection. You can open this dialog by editing the connection from the Connections page in the UI. Connection-related properties are useful when you want to change the value for one of the connection fields, for example a URL, when an app goes from the testing stage to production.

How the connection-related app properties get created

You cannot explicitly create connection-related properties. When you select a connection in the Connection field of an activity, the supported properties associated with that connection automatically get created and populated in the App Properties dialog.

While creating a connection, the fields in the connection details dialog that support app properties are marked with icon. One property gets created for each field that is marked with in the connection details dialog The values you enter for such fields in the connection details dialog become the default values for the connection properties. The properties take their name from the connection field they represent in the connection details dialog.

You begin by creating a connection. In the example below, only the Connection URL and Authentication Key fields support app properties. These are the only two fields that display against them.

Once the connection is created, you can use it to configure the Connection field in an activity. In the

After configuring the Connection field with the connection, if you open the App Properties dialog, you should see the connection properties for the field (enclosed in the red box in the image below) displayed.

Notice that only the supported properties (Connection URL and Authentication Key) are displayed in a read-only mode.

The properties that get displayed in the App Properties dialog change dynamically based on your selection of the connection to use. You can only view the connection properties. You cannot edit or delete them from the App Properties dialog. Deleting the activity that uses the connection will automatically remove the associated connection properties that the activity used from the App Properties dialog.

Using connection-related app properties

Connection-related app properties are not available for use from the mapper. You can use these properties to change a connection value (for example, a URL or password) just before an app goes from a testing stage to production. Their values cannot be changed from the App Properties dialog. Change their values in the connection details dialog before building the app.

Editing an App Property

You can change the default value or data type of an app property at any time.

After the app has been built, you can override an app property from the CLI.

Changing the Default Value of a Property from the App Properties Dialog

You can change the default value of an existing app property at any time after creating the property. Before you build the app, you can change the default value in the App Properties dialog.

To change the default value of an existing app property, follow these steps:

Procedure