ProcessICTransactions

Deletes, posts, unposts, or unmatches the specified intercompany transactions for a given scenario, year, and period. Transactions are identified by arrays of the transactions’ sequence IDs and the Entity, Intercompany Partner, Account, and Custom dimension member IDs. These arrays must have a one-to-one correspondence.

Tip:	To process all transactions for a given scenario, year, and period, use ProcessAllICTrans.

Syntax

<HsvICM>.ProcessICTransactions(lICAction, lScenario, lYear, lPeriod, varalSeqIDs, varalEntities, varalICPs, varalAccounts, varalC1s, varalC2s, varalC3s, varalC4s)

Argument	Description
lICAction	Long (ByVal). A flag that specifies the processing to perform. Pass one of the following constants, which are members of the HFMConstants type library enumeration tagICMTRANSPROCESSACTION: ICM_POSTTRANS ICM_UNPOSTTRANS ICM_DELETETRANS ICM_MANUALMATCHTRANS ICM_UNMATCHTRANS For descriptions of these constants, see Processing Action Constants.
lScenario	Long (ByVal). The member ID of the transactions’ Scenario dimension members.
lYear	Long (ByVal). The member ID of the transactions’ Year dimension members.
lPeriod	Long (ByVal). The member ID of the transactions’ Period dimension members.
varalSeqIDs	Long array (ByVal). The transactions’ sequence IDs. Sequence IDs are internal unique identifiers of transactions. You can get a transaction’s sequence ID with the HsvICTransactionsData method GetICTransactionData.
varalEntities	Long array (ByVal). The member IDs of the cells’ Entity dimension members.
varalICPs	Long array (ByVal). The member IDs of the cells’ Intercompany Partner dimension members.
varalAccounts	Long array (ByVal). The member IDs of the cells’ Account dimension members.
varalC1s	Long array (ByVal). The member IDs of the cells’ Custom 1 dimension members.
varalC2s	Long array (ByVal). The member IDs of the cells’ Custom 2 dimension members.
varalC3s	Long array (ByVal). The member IDs of the cells’ Custom 3 dimension members.
varalC4s	Long array (ByVal). The member IDs of the cells’ Custom 4 dimension members.

Return Value

String. Returns an XML string, with the format varying depending upon the type of processing performed:

For posting, unposting, and deleting, the XML structure is as follows, with the <ictransactions> tag containing one <transaction> tag for each transaction that ProcessICTransactions could not process. Each <transaction> tag contains information about the transaction, along with an HRESULT that indicates why the transaction could not be processed:
<?xml version="1.0" ?><ictransactions><transaction><entity /> <partner /><account /><transid /><transsubid /> <hresult /></transaction></ictransactions>
For matching and unmatching, the XML structure is as follows, with the status attribute containing an HRESULT that indicates why the transaction could not be processed:
<processtransactionsresponse status="HRESULT"> </processtransactionsresponse>
Tip:
To get the description of an HRESULT, pass the HRESULT to the HsvResourceManager method GetResourceStringFromHR.