ChangeProcessManagementStateForMultipleEntities2

Performs a given process management action for the specified process units and optionally attaches documents.

Syntax

<HFMwManageProcess>.ChangeProcessManagementStateForMultipleEntities2 (bstrScenario, bstrYear, bstrPeriod, varabstrEntity, varabstrParent, bstrValue, bstrComment, lAction, vbUseAllValueMembers, vbApplyToAllPeriods, sProcessStateToPromoteTo, varabstrPaths, varabstrFiles)

Argument

Description

bstrScenario

The label containing the process units’ Scenario dimension member.

Input argument. String subtype.

bstrYear

The label containing the process units’ Year dimension member.

Input argument. String subtype.

bstrPeriod

The label containing the process units’ Period dimension member.

Input argument. String subtype.

varabstrEntity

An array containing the labels of the process units’ child Entity dimension members.

Input argument.

varabstrParent

An array containing the labels of the process units’ parent Entity dimension members.

Note:

The varabstrEntity and varabstrParent arguments’ arrays have a one-to-one correspondence.

Input argument.

bstrValue

The label containing the process units’ 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.

lAction

The action to perform for the process units. Valid values are represented by the HFMConstants type library constants listed in Process Management Action Constants.

Input argument. Long subtype.

vbUseAllValueMembers

A flag that determines whether the action applies to process units for all Value dimension members related to the bstrValue argument’s member. Pass TRUE to apply the action to the related process units, FALSE to apply the action to only the process unit for the bstrValue member

Input argument. Boolean subtype.

vbApplyToAllPeriods

A flag that determines whether the action applies to process units for all Period dimension members that intersect the other specified dimension members. Pass TRUE to apply the action to intersecting process units, FALSE to apply the action to only the process unit for the period specified in the bstrPeriod argument.

Input argument. Boolean subtype.

sProcessStateToPromoteTo

The review level to which to promote the process unit. Valid values are represented by the HFMConstants type library constants listed in Process Management Review Level Constants.

Input argument. Integer subtype.

varabstrPaths

An array of strings containing the paths in which the documents to be attached have been loaded. Folders in paths are delimited by backslashes ( \ ).

This array has a one-to-one correspondence with the varabstrFiles argument’s array of filenames.

Input argument.

varabstrFiles

An array of strings containing the file names of the documents to attach.

Note:

Files must be loaded in the folder specified by the corresponding item in the varabstrPaths argument’s array, otherwise an error will be thrown.

Input argument.

Return Value

Returns the resulting review level for the specified process units. Valid values are represented by the HFMConstants type library constants listed in Process Management Review Level Constants.