CentraSite Documentation : CentraSite Developer’s Guide : Built-In Design/Change-Time Actions Reference : Built-In Actions for Design/Change-Time Policies : Promote Asset
Promote Asset
This policy action allows you to promote an asset instance to a different CentraSite stage. The action can be executed on a lifecycle pre-state change, post-state change or on an OnTrigger event. The configurations cover the following options:
*Specify a stage to promote to
This can be either the name of a lifecycle stage or the URL of the target registry.
*Specify optional user credentials for the target stage
The credentials specify a user name and password of a user defined on the target registry. This user should have the required permissions to create the asset on the target registry.
*Include referenced objects in the promotion set
Assets that are referenced by the asset being promoted can be included in the promotion process.
*Keep the asset owner unchanged
You can specify that the owner of the asset in the source registry will also be the owner in the target registry. If this user does not exist in the target registry, the owner will be the user specified in the optional user credentials described above.
This user should be able to create assets in the target organization, which can be any of the following, depending on the input parameters you specify:
*The organization mentioned in the Target Organization parameter.
*The organization to which the user in the target registry belongs.
*The organization to which the triggering user or the user in the Username parameter belongs.
*Replace existing registry objects in the target stage
If an asset already exists on the target stage, it may be replaced by the asset being promoted.
*Specify a target organization name
When the asset is promoted, it will belong to the organization specified.
*Keep the lifecycle state
You can specify a lifecycle state for the promoted asset on the target registry. If you do not specify a state, the promoted asset will be placed in the initial state of the lifecycle model on the target registry.
Event Scope
PreStateChange
PostStateChange
OnTrigger
Object Scope
Asset
Input Parameters
The following table lists the input parameters for the policy action.
Target Stage
String The name of the target stage to which the asset will be promoted. This assumes that you have already defined the stage, as described in the section about lifecycle management in the CentraSite Administrator’s Guide .
If a value is specified for the parameter Target Stage URL, the value of Target Stage is used instead of the value of the parameter Target Stage URL. At least one of the parameters Target Stage or Target Stage URL must be specified, i.e. they cannot both be empty.
Target Stage URL
String The URL of the target CentraSite registry.
If a value is specified for the parameter Target Stage URL, the value of Target Stage is used instead of the value of the parameter Target Stage URL. At least one of the parameters Target Stage or Target Stage URL must be specified, i.e. they cannot both be empty.
Username
String (optional) The user name and password are used as authentication credentials for the target stage. The assets will be created in the target by this user.
If the user name and password are not supplied, the user name and password of the triggering user on the source stage will be used. If this user is not defined on the target stage, the promotion will fail.
Password
String (optional) The user name and password are used as authentication credentials for the target stage. The assets will be created in the target by this user.
If the user name and password are not supplied, the user name and password of the triggering user on the source stage will be used. If this user is not defined on the target stage, the promotion will fail.
Include Referenced Assets
Boolean (optional) Specifies whether the referenced assets (referenced via associations) of the applied asset will be included for the promotion.
A value of yes means that the references assets will also be promoted. A value of no means that only the specified asset will be promoted.
The default value is yes.
Keep Owner
Boolean (optional) Specifies if the current owner will also be the owner in the target registry. This can only happen if the owner also exists as a user on the target registry and has the permissions required to create assets.
A value of yes means that the asset owner on the target stage will be the same owner as on the source stage. A value of no means that the owner will be the specified user from the User Name parameter.
The default value is no.
Replace Existing Assets
Boolean (optional) Specifies if an asset that already exists on the target stage may be replaced by the asset being promoted.
A value of yes means that an asset on the target stage can be replaced. A value of no means that an existing asset on the target stage cannot be replaced.
The default value is no.
Keep Lifecycle State
Boolean (optional) Specifies if the promoted asset should keep the lifecycle state that it has on the source stage. This can only happen if the lifecycle model used on the source stage is also defined and active on the target stage.
A value of yes means that an asset on the target stage will have the same state as on the source stage. A value of no means that the promoted asset will be set to a lifecycle state according to the combinations as shown in the table below.
The default value is no.
Target Organization
String (optional) Specifies the owning organization of the asset on the target stage. This can only happen if the specified organization exists on the target.
As noted in the table, some of the promotion operations are only possible if the target stage contains users, organizations and lifecycle models that are compatible with those defined on the source stage. The possible combinations are listed in the following tables.
Note:  
During the promotion process, CentraSite copies the metadata of an asset from the source instance to the target instance. However, if the action is to be executed during a prestatechange event, the changes due to the other actions in the source instance are not reflected in the target instance. You will need to explicitly update the asset if you want that change reflected in the target instance, too.
Important:  
Before you activate a policy that includes the Promote Asset action, ensure that the target's specified target stage URL or target stage is active and the user credentials of target registry are valid. To check this, click the Check Connection button. If the connection is not active and valid, activate the target specified in Target Stage or Target Stage URL and modify the user credentials as required.
Target Organization and Target Owner
When the asset is promoted to the target registry, it will belong to a specific organization and will be owned by a specific user. The organization and owner on the target registry are not necessarily the same organization and owner as on the source registry.
The owner on the target registry can be one of the following:
*the same owner as on the source registry (called "User A" in the following description)
*the user specified in the Username parameter (called "User B" in the following description)
*the triggering user, i.e. the user who activates the asset promotion (called "User C" in the following description)
The organization on the target registry can be one of the following:
*the organization specified in the Target Organization parameter (called "Organization P" in the following description)
*the organization of the user supplied in the Username parameter (called "Organization Q" in the following description)
*the organization of the triggering user (called "Organization R" in the following description)
Target Owner:
This user will be the owner …
... under these circumstances
User A
If Keep Owner is specified, and User A has permission to create assets in Organization P or Q or R.
User B
If User A does not meet the requirements described in the previous row, and User B is defined.
User C
If User B not meet the requirements described in the previous row.
Target Organization
This organization will be the owning organization …
... under these circumstances
Organization P
If Target Organization is specified and the target owner defined in the above table has permission to create assets in this organization.
Organization Q
If Organization P does not meet the requirements described in the previous row, and User B is defined.
Organization R
If Organization Q does not meet the requirements described in the previous row.
CentraSite attempts to create the asset on the target registry using the resulting combination of target owner and target organization. If the given user does not have permission to create assets in the given organization, the promotion will fail.
Keep Lifecycle State
Keep LCM State
Availability of the same LCM in the target stage
Does target have its own LCM
Result state of the promoted asset
yes
yes
n/a
Same state as in the source.
yes
no
yes
Initial state of the LCM in the target.
yes
no
no
No state assigned.
no
n/a
yes
Initial state of the LCM in the target.
no
n/a
no
No state assigned.
Copyright © Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback