WorkflowAction

Dovico.TrackITAPI.CSubmit.WorkflowAction(System.String,Dovico.TrackITAPI.CStateInfo)

Function Overview:

Call this method to perform rejections, approvals, approve by exceptions, and rejections of approved information. The xml should be in the format workflowaction.xsd. You will need the Action (Approve = CONSTANTS.APPROVE_APPROVE, Reject = CONSTANTS.APPROVE_REJECT_SHEET, Approve By Exception = CONSTANTS.APPROVE_BY_EXCEPTION, Reject Approved Entries = CONSTANTS.APPROVE_REJECT_ENTRIES), Object Type (CONSTANTS.SHEET_TYPE_TEMPTRANS or CONSTANTS.SHEET_TYPE_TEMPACTEXP), SHEET (needed for approve, reject, and approve by exception), TITLE (needed for reject approved);

Parameter List:

sXml - string - xml for what to submit in the format workflowaction.xsd

siState - CStateInfo - State Information needed to process the transaction

Returns

An empty string unless approve by exception functionality is called in which case it returns the GUID of the new sheet that holds the rejected entries.

Example:

// build up xml to perform an approval workflow action on an expense sheet

// with a guid of 00000000-FFFF-AAAA-DDDD-000000000000

string sXml = "<WorkflowAction:WORKFLOWACTION xmlns:WorkflowAction=\"http://www.dovico.com/schemas/workflowaction.xsd\" ";

sXml += "ACTION=\"A\" TYPE=\"E\" SHEET=\"00000000-FFFF-AAAA-DDDD-000000000000\"/>";

// call the method to approve the expense sheet

wsapi.MethodInvoke("SubmitWorkflowAction", sXml, stToken);