Approve

Performs a approve action on the specified process units. The vbApplyToAllPeriods argument determines whether the action applies to one or to multiple process units.

To attach documents while approving process units, use Approve2.

Syntax

<HFMwManageProcess>.Approve (bstrScenario, bstrYear, bstrPeriod, bstrEntity, bstrParent, bstrValue, vbApplyToAllPeriods, bstrComment)

Argument

Description

bstrScenario

The label of the Scenario dimension member for the process units.

Input argument. String subtype.

bstrYear

The label of the Year dimension member for the process units.

Input argument. String subtype.

bstrPeriod

The label of the Period dimension member for the process units.

Input argument. String subtype.

bstrEntity

The label of the Entity dimension member for the process units.

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 Value dimension member for the process units.

Input argument. String subtype.

vbApplyToAllPeriods

Specifies whether the action should be applied to process units for all input periods that intersect the other specified dimension members. Pass TRUE to apply the action to all these process units, FALSE to apply the action to only the specified process unit.

Input argument.

bstrComment

A user comment for the action, or an empty string if there is no comment.

Input argument. String subtype.

Return Value

Returns a number that represents the process units’ review level. 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 approves the specified process unit and prints the resulting review level.

Dim cHFMProcMan, lLevel
Set cHFMProcMan = _ 
Server.CreateObject("Hyperion.HFMwManageProcess")
' cHFMSession is a previously set HFMwSession object
cHFMProcMan.SetWebSession cHFMSession
lLevel = cHFMProcMan.Approve("Budget", "2003", "April", _ 
"Connecticut", "UnitedStates", "<Entity Currency>", FALSE, _ 
"")
Response.Write "<p>Review level: " & _ 
cHFMProcMan.MapReviewLevelToString(lLevel) & "</p>"