Performs a promote action on the specified process unit and optionally attaches documents.
<HFMwManageProcess>.Promote2 (bstrScenario, bstrYear, bstrPeriod, bstrEntity, bstrParent, bstrValue, bstrComment, lProcessStateToPromoteTo, varabstrPaths, varabstrFiles)The label of the parent of the entity specified in the bstrEntity argument. | |
A user comment for the action, or an empty string if there is no comment. | |
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. | |
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. | |
An array of strings containing the file names of the documents to attach. Files must be loaded in the folder specified by the corresponding item in the varabstrPaths argument’s array, otherwise an error will be thrown. |
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.
You can obtain a string that represents the review level by passing the return value to MapReviewLevelToString. |
The following example promotes the specified process unit to review level 7 and attaches two documents.
Dim iState, saPaths(1), saNames(1)
saPaths(0) = "docs"
saPaths(1) = "docs"
saNames(0) = "Audit.txt"
saNames(1) = "Comments.txt"
'cHFMProcMan is an HFMwManageProcess object reference
iState = cHFMProcMan.Promote2("Budget", "2004", "August", "NewYork", _
"UnitedStates","<EntityCurrency>", "see attachments", _
PROCESS_FLOW_STATE_REVIEW7, saPaths, saNames)