The sharedConfig.properties file identifies which repositories can be promoted and how each of those promotions will behave.
Warning: All sharedConfig.properties files should have the exact same property definitions for promotions. As a best practice, one file should be updated and then the entire repo.promote section be copied from that file to all of the other sharedConfig.properties files in the same environment.
The Promotion Properties editor will allow you to modify the following values:
repo.promote.config.list: A list of the names of the repositories that can be promoted. This list must specify the repository name of each source repository to be promoted. The repository name must exactly match what is defined in the Name field on the Edit -> Properties page for the repository. This name must be referenced as the <promotion_name> in the properties listed below.
repo.promote.config.<promotion_name>.default.validation.option:
0 = Promote all records.
1 = Validate and promote all records.
2 = Validate and promote valid records only -- no records with errors or warnings.
repo.promote.config.<promotion_name>.desc: The display name of the promotion. In the Model Configuration feature, if you select Promotion Configuration, the Promotion Configuration drop-down list will display this description as the name of the promotion.
repo.promote.config.<promotion_name>.srcRepo.name: The name of the source repository.
Linked Repositories settings:
repo.promote.config.<promotion_name>.srcRepo.linkList= <linkName1>, <linkName2>,…,<linkName<n>>: a list of the linked repositories to be promoted at the same time a record is promoted from the source repository.
For example, if the promotion is for the Product_Staging repository, which is linked to the Item_Staging repository, when a Product record is promoted, all of the Item records linked to that Product will also be promoted (subject to the promotion settings). The <linkName> values are used in subsequent properties
repo.promote.config.<promotion_name>.srcRepo.linkList.<linkName<n>>.name= The name of the linked repository.
Attribute settings: (Optional)
Source Repository Attribute settings:
repo.promote.config.<promotion_name>.srcRepo.updateAttr.list=<attrName1>,<attrName2>,…,<attrName<n>>: The values in this list will be used in the subsequent properties to identify attributes and their values.
The attributes listed here will be set to their specified values in the source repository after the record is promoted.
repo.promote.config.<promotion_name>.srcRepo.updateAttr.<attrName<n>>.name: The name of the attribute.
repo.promote.config.<promotion_name>.srcRepo.updateAttr.<attrName<n>>.value: The value the attribute will be set to after the record is promoted.
Target Repository Attribute settings:
repo.promote.config.<promotion_name>.targetRepo.updateAttr.list=<attrName1>,<attrName2>,…,<attrName<n>>: The values in this list will be used in the subsequent properties to identify attributes and their values.
The attributes listed here will be set to their specified values in the target repository when the record is promoted.
repo.promote.config.<promotion_name>.targetRepo.updateAttr.<attrName<n>>.name: The name of the attribute.
repo.promote.config.<promotion_name>.targetRepo.updateAttr.<attrName<n>>.value: The value the attribute will be set to when the record is promoted.
Status Settings:
Source Repository Status settings:
repo.promote.config.<promotion_name>.srcRepo.updateStatus.list=<statusName1>, <statusName2>,…, <statusName<n>>: Contains a list of attribute statuses in the source repository that you want to set to a particular value after the records are promoted. The common state fields to set are:
record_state = 0: This indicates the record is in sync.
external_session_info: This indicates the update was due to promotion.
repo.promote.config.<promotion_name>.srcRepo.updateStatus. <statusName<n>>.name: The name of the status.
repo.promote.config.<promotion_name>.srcRepo.updateStatus. <statusName<n>>.value: The value of the status.
Target Repository Status settings:
repo.promote.config.<promotion_name>.targetRepo.updateStatus.list=<statusName1>, <statusName2>,…, <statusName<n>>: Contains a list of attribute statuses in the target repository that you want to set to a particular value when the records are promoted.
record_state = 0: This indicates the record is in sync.
external_session_info: This indicates the update was due to promotion.
repo.promote.config.<promotion_name>.targetRepo.updateStatus. <statusName<n>>.name: the name of the status.
repo.promote.config.<promotion_name>.targetRepo.updateStatus. <statusName<n>>.value: the value of the status.
Edit the properties as desired, then save the file and exit.
Restart services for the new property values to take effect.