Add or edit application environment properties

This topic describes how to create and modify environment properties for an application environment.

Overview

The application environment properties are specific to the application's use of an environment.

Environment properties added at this level are displayed under the application environment's Properties tab, and not under the environment's Properties tab, because they are set for this application only.

The values for same-named environment properties are resolved at the most specific level:

  • An environment property value at the application level overrides the value for the same property at the environment level.
  • An environment property value at the component level overrides the values for the same property at both the environment level and the application environment level.

Note: If you have added component environment properties to a component mapped to the environment, those properties are displayed in the environment's Component Mapping page, where you can edit their values as needed. For details, see Set component environment property values.

Back to top

Add or edit a single property

You can add or update application environment properties one by one.

To add a property to an application environment:

  1. Navigate to Management > Application > [select application].

  2. Select the Environments tab.

  3. Click the name of the environment to which you want to add properties and select View Details from the menu. The environment's page opens.

  4. Select the Properties tab.

  5. Click Add Property. The Add Property dialog box opens.
  6. Specify the following details for the new property:

    Field Description
    Name Enter a name for the property.
    Description (Optional) Provide additional information about the property.
    Secure Select this option if you want the property to be secure.

    Secure properties are stored encrypted and displayed obscured in the Deployment Automation user interface.
    Value (Optional) Enter the value of the property to be used by steps in a process.
  7. Click Save.

    To create another property, click Save and New.

To edit a property, click the Edit icon next to the property.

Note: When editing a single property, you can't rename it. To change the name, use the Batch Edit option described in the next section.

To use environment properties in a process, reference them in relevant process steps with the following syntax:

${p:environment/<property name>}

For details on applying user-defined properties, see How properties are resolved.

Back to top

Add or edit multiple properties

To create or update several environment properties at once, use Batch Edit.

To add or edit multiple application environment properties:

  1. Navigate to Management > Application > [select application].

  2. Select the Environments tab.

  3. Click the name of the environment to which you want to add properties and select View Details from the menu. The environment's page opens.

  4. Select the Properties tab.

  5. Click Batch Edit. The Edit Entry dialog box opens.
  6. In the Properties field, specify properties with or without their values.

    Enter each property on a new line in the following format:

    Format Description
    myProperty
    myProperty=

    Use this syntax to specify properties without values. For example, for the port property, enter:

    port
    or
    port=

    Note: When you save properties without values, the system automatically changes the myProperty syntax to myProperty=

    myProperty=value

    Use this syntax for properties with values, for example:

    host=myServer
    port=8080

    Note: The following batch editing restrictions apply:

    • You cannot set the Secure option. If you want the properties to be secure, edit them individually as described in the earlier section.
    • The value cannot contain the equals sign (=).
  7. Click Save.

Back to top

See also: