App Properties
App properties provide a way to override property values after an app has been pushed to the cloud. You can configure some supported fields with app properties when configuring triggers and activities. 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. Configuration fields in your flow that require their values to be changed when the app goes from a testing stage to production are best configured using app properties instead of hard coding their values. App properties for triggers and activities reside within the app. App properties for connections are not modifiable from the App Properties dialog box in the app.
The URL field in an Activity is a good example of a field for which you would want different values – may be an internal URL when testing the app and an external URL when the app goes into production. You may want the URL used in the Activity to change when the app goes from a test environment to production. In such a case, it is best to configure the URL field in the Activity with an app property instead of hard-coding the URL. This way, you can change the URL by changing the value of the app property used to configure the URL field.
Before deploying the app, you can change the default value of an app property from the App Properties dialog. Once you have pushed your app, you can change the default values of the Environment Controls tab after an app has been pushed to the cloud.
An app property value can have one of the following data types:
- string
- boolean
- number
- password
Values for the password data type are encrypted and are not visible by default. But when configuring the password value, you can click on the
Show/Hide password property value icon (
) to see the value temporarily to verify that it has been entered correctly.
When you push an app configured with app properties, the properties appear under the Environment controls tab in TIBCO Cloud Integration. You can change the values for any property from this tab, but doing so requires a re-push of the app for the new values to take effect. Similarly, any property that is added, deleted, or updated from the App Properties dialog box within an app, is reflected in Environment controls tab only after re-pushing the app.
App properties are saved within the app, so when you export or import an app, app properties configured in the app also get exported or imported with the app. Properties of data type
password do not retain their values when an app is exported. So, you must reconfigure the password after importing the app.
If you import an app that was created prior to the support of this feature in TIBCO Cloud Integration, you cannot use app properties in the app. You must recreate that app in order to take advantage of the app properties feature.