Configuring a promotion failure transition

You configure a promotion failure transition by specifying a <failure> element in a <transition-action> element in the promotion transition definition.

About this task

Note: The current asynchronous promotion capability is deprecated, and will be removed in a future release; the promotion failure transition capability is therefore also deprecated.

The value of the <failure> element is the transition that is made if the promotion fails. The <failure> element can be used, for example, to move the object back to the state it was in before the transition that caused the asynchronous promotion. The transition must be valid for the state the governed object is in at the time the promotion is performed, otherwise the transition fails.

Example

In this example, if an entity undergoes the ApproveForDeployment transition, it is promoted to the Development environment. If the promotion fails, however, the entity undergoes the Repair transition.

<transitions>
  <transition
    name="http://www.ibm.com/xmlns/prod/serviceregistry/6/1/GovernanceProfileLifecycle#ApproveForDeployment">
    <target-environments>
      <name>http://www.ibm.com/xmlns/prod/serviceregistry/6/1/GovernanceProfileTaxonomy#Development</name>
    </target-environments>
    <transition-action>
      <failure>http://www.ibm.com/xmlns/prod/serviceregistry/6/1/GovernanceProfileLifecycle#Repair</failure>
    </transition-action>
  </transition>
</transitions>