Repository Promotion Properties in the Classic UI - EnterWorks - EnterWorks Process Exchange (EPX) - Precisely EnterWorks - 10.5

EnterWorks Classic Administration Guide

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks > EnterWorks
Precisely EnterWorks
Precisely EnterWorks > EnterWorks Process Exchange (EPX)
Version
10.5
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Classic Administration Guide
First publish date
2007
Last updated
2023-08-02
Published on
2023-09-20T17:55:59.992423

Note: You can modify a repository’s Promotion properties through the EnterWorks Classic UI, however, the name of the source repository must be defined in the sharedConfig.properties file.

To modify a repository’s Promotion properties through the EnterWorks Classic UI:

  1. Log into EnterWorks Classic as a user with Administrative privileges.

  1. In the Feature bar, open the Content Feature, select the desired repository, select Edit, and select Promotion Properties.

A screenshot of a cell phone Description automatically generated

  1. The Promotion Properties editor will appear.

A screenshot of a cell phone Description automatically generated

  1. The Promotion Properties editor will allow you to modify the following values:

  • IsPromotionEnabled: Check this checkbox to enable promotions for this repository.

  • ValidationOptions:

    • 0 = Promote all records.

    • 1 = Validate and promote all records.

    • 2 = Validate and promote valid records only -- no records with errors or warnings.

  • LinkRelationships: These checkboxes identify the repositories (via link relationships) that are linked to the one being edited. If checked, when a record in the parent repository is promoted, any linked record in the designated linked repository will also be promoted (subject to the same validation options).

  • Attribute and Status Lists: To add attributes to the list, click the Add button. Each time you click Add, a new attribute or status dropdown selector will be added. Use the dropdown’s down arrow to select the desired attribute or status. Enter the desired value in the Value box.

To enable an attribute or status value assignment, check the checkbox to the left of the attribute’s or status’ name.

Attribute Lists:

  • Source Attribute List: Contains a list of attributes in the source repository that you want to set to a particular value after the records are promoted. The most common use of this feature is when needing to distinguish between add/new vs. update for a record in a syndication. For example, if the attribute “Add or Update” represents this status, it would default to the value “Add” for new records. When that record is promoted to Production and then syndicate, the downstream system will be notified that it is a new record. The promotion operation itself causes the attribute to be updated to “Update” in the Staging repository. The next time the staging record is modified, promoted, and syndicated, the syndication will indicate the record is existing and is being updated. This assumes the Production record is syndicated after the initial promotion before the same record can be modified and promoted a second time.

Warning: Attributes set through this mechanism are not recorded in the History information.

  • Target Attribute List: Contains a list of attributes in the target repository that you want to set to a particular value when the records are promoted.

Status Lists:

  • Source Status List: 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 set are:

    • record_state = 0: This indicates the record is in sync.

    • external_session_info: This indicates the update was due to promotion.

  • Target Status List: Contains a list of attribute statuses in the target repository that you want to set to a particular value after the records are promoted. The common state fields set are:

    • record_state = 0: This indicates the record is in sync.

    • external_session_info: This indicates the update was due to promotion.

  1. Edit the properties as desired, then save the properties and exit from the Promotion Properties editor.

  2. Restart EnterWorks services and clear the data cache.