ApproveEx

Approves a process unit, and optionally approves all other process units that consist of the specified Scenario, Year, Entity, and Value dimension members and the other base Period dimension members.

To attach documents when approving, use Approve2.

Syntax

<HsvProcessFlow>.ApproveEx lScenario, lYear, lPeriod, lEntity, lParent, lValue, vbUseAllValueMembers, vbApplyToAllPeriods, bstrAnnotation, psNewProcessState

Argument	Description
lScenario	Long (ByVal). The member ID of the process unit's Scenario dimension member.
lYear	Long (ByVal). The member ID of the process unit's Year dimension member.
lPeriod	Long (ByVal). The member ID of the process unit's Period dimension member.
lEntity	Long (ByVal). The member ID of the process unit's child Entity dimension member.
lParent	Long (ByVal). The member ID of the process unit's parent Entity dimension member.
lValue	Long (ByVal). The member ID of the process unit's Value dimension member.
vbUseAllValueMembers	Boolean (ByVal). Specifies whether process units for Value dimension members related to the lValue member are approved. Pass TRUE to approve related process units, FALSE to approve only the process unit for the lValue member.
vbApplyToAllPeriods	Boolean (ByVal). Specifies whether to approve the process units that consist of the specified Scenario, Year, Entity, and Value dimension members and the other base Period dimension members. Pass TRUE to approve these process units, FALSE otherwise. If you specify TRUE and an error occurs for a period, Financial Management will attempt to approve the other periods. Note: Specifying FALSE is the same as calling Approve.
bstrAnnotation	String (ByVal). The comment for the approval.
psNewProcessState	Integer. Returns PROCESS_FLOW_STATE_APPROVED, which is the level constant for the Approved level. This value applies to the Period and Value dimension members passed in the lPeriod and lValue arguments.

Example

This example approves the specified process unit and the process units that consist of the base Period dimension members and the specified members of the other dimensions. The calls to the user-defined GetMemberID function get the process unit’s member IDs; for information on GetMemberID, see the Examples for GetItemID. These member IDs are then passed to ApproveEx.

Dim lScen As Long, lYear As Long, lPer As Long
Dim lEnt As Long, lPar As Long, lVal As Long, iState As Integer
Dim cHsvProcessFlow As HsvProcessFlow, lRights As Long
lScen = GetMemberID(DIMENSIONSCENARIO, "Budget")
lYear = GetMemberID(DIMENSIONYEAR, "2001")
lPer = GetMemberID(DIMENSIONPERIOD, "September")
lEnt = GetMemberID(DIMENSIONENTITY, "Connecticut")
lPar = GetMemberID(DIMENSIONENTITY, "UnitedStates")
lVal = GetMemberID(DIMENSIONVALUE, "USD")
'g_cSession is an HsvSession object reference
Set cHsvProcessFlow = g_cSession.ProcessFlow
cHsvProcessFlow.ApproveEx lScen, lYear, lPer, lEnt, lPar, lVal, _ 
  False, True, "Approving base periods", iState