Promote

Performs a promote action on the specified process unit.

To attach documents when promoting, use Promote2.

Syntax

<HFMwManageProcess>.Promote (bstrScenario, bstrYear, bstrPeriod, bstrEntity, bstrParent, bstrValue, bstrComment, lProcessStateToPromoteTo)

Argument	Description
bstrScenario	The label of the process unit's Scenario dimension member. Input argument. String subtype.
bstrYear	The label of the process unit's Year dimension member. Input argument. String subtype.
bstrPeriod	The label of the process unit's Period dimension member. Input argument. String subtype.
bstrEntity	The label of the process unit's Entity dimension member. Input argument. String subtype.
bstrParent	The label of the parent of the entity specified in the bstrEntity argument. Input argument. String subtype.
bstrValue	The label of the process unit's Value dimension member. Input argument. String subtype.
bstrComment	A user comment for the action, or an empty string if there is no comment. Input argument. String subtype.
lProcessStateToPromoteTo	The review level to which the process unit is being promoted. Valid values are represented by the constants listed in Process Management Review Level Constants. Input argument. Long subtype.

Return Value

Returns a number that represents the review level to which the process unit was promoted. Valid values are represented by the constants listed in Process Management Review Level Constants. Long subtype.

Tip:	You can obtain a string that represents the review level by passing the return value to MapReviewLevelToString.

Example

The following example promotes the specified process unit to review level 8.

Dim cHFMProcMan, lLevel
Set cHFMProcMan = _ 
Server.CreateObject("Hyperion.HFMwManageProcess")
' cHFMSession is a previously set HFMwSession object
cHFMProcMan.SetWebSession cHFMSession
lLevel = cHFMProcMan.Promote ("Budget", "2003", "April", _ 
"Connecticut", "UnitedStates", "<Entity Currency>", _
  "", PROCESS_FLOW_STATE_REVIEW8)