Tokenizing Application Properties

To tokenize application properties, a new button Tokenize the property is added in the Properties view for application properties. Tokenizing supports properties of type boolean, string, integer, long, and password.

After tokenization, the property value is set in the format //<ApplicationName>//<PropertyName>. Once the user tokenizes a property, the original default value for the property is lost.

Note: Tokenize the property button is available only for applications with Deployment Target set as Container.

By default, the Tokenize checkbox is unchecked. Select the Tokenize checkbox to auto-tokenize property value for the Export as properties file profile.

The following table lists the values of five different types of properties if the default tokenized values are not provided for all the properties and exported as properties file
Data Type Property Name Values Before Tokenization Values After Tokenization/ Values Before Export Values after Export Values after Export in the properties file
  DefaultDefaultDefaultDefault
String newProperty5   #//test//newProperty5# #//test//newProperty5# newProperty5
Password newProperty4   #//test//newProperty4# #//test//newProperty4#

a String:

PASSWORD

Integer newProperty3 0 #//test//newProperty3# #//test//newProperty3# 0
Long newProperty2 0 #//test//newProperty2# #//test//newProperty2# 0
Boolean newProperty1 false #//test//newProperty1# #//test//newProperty1# false

The following table lists the values of five different types of properties if the default tokenized values are provided for all the properties and exported as properties file

Data Type Property Name Values Before Tokenization Values After Tokenization/ Values Before Export Values after Export Values after Export in the properties file
  DefaultDefaultDefaultDefault
String newProperty5 TIBCO #//test//newProperty5# #//test//newProperty5# newProperty5
Password newProperty4 *** #//test//newProperty4# #//test//newProperty4#

a String:

PASSWORD

Integer newProperty3 1 #//test//newProperty3# #//test//newProperty3# 0
Long newProperty2 12345 #//test//newProperty2# #//test//newProperty2# 0
Boolean newProperty1 true #//test//newProperty1# #//test//newProperty1# false

Note: For String type property in group, the values after export in properties file is //test///newGroup/newGroup1/newProperty5=newGroup.newGroup.newProperty5

The following table lists the values of five different types of properties if the default tokenized values are provided for all the properties and exported as properties file using dot (.)as a separator.
Data Type Property Name Values Before Tokenization Values After Tokenization/ Values Before Export Values after Export Values after Export in the properties file
  DefaultDefaultDefaultDefault
String newProperty5 TIBCO #//test//newProperty5# #test.newProperty5# newProperty5
Password newProperty4 *** #//test//newProperty4# #test.newProperty4#

a String:

PASSWORD

Integer newProperty3 1 #//test//newProperty3# #test.newProperty3# 0
Long newProperty2 12345 #//test//newProperty2# #test.newProperty2# 0
Boolean newProperty1 true #//test//newProperty1# #test.newProperty1# false

Note: For String type property in group, the values after export in properties file is test.newGroup.newGroup1.Property5=newGroup.newGroup.newProperty5

Retaining Tokenization Value for External Shared Module Version Change

Important: This section is applicable only after you upgrade to TIBCO ActiveMatrix BusinessWorks™ (Container Deployment) 2.10.0 HF-004 and above.

If an application module is using any module property from the External Shared Module and this property is tokenized, use this option to retain existing tokenized values of the Module Property in case the External Shared Module version is changed.

Before you begin
  1. Select Windows > Preferences > BusinessWorks > Application Properties.

  2. In the preferences, select Retain tokenized values.
  3. Click Apply and OK.

    4. Result:This will retain the tokenized value across ESM version upgrades.

    Procedure

  1. Add ESM details in the module POM under dependency tag.

  2. Double-click Application Properties.

  3. Tokenize the properties and save.

  4. Upgrade the ESM version in the module pom.

  5. Double-click the Properties view.

    6. Result: Tokenized values for the properties with the same name have been retained.