Skip to main content
Version: 2.2.3

executeAction

This method enables executing an action from an action plan. To use it, it is necessary to follow the standard documented below:

Java class
Requestweb/wwwroot/ws/java/timecontrol/ExecuteActionRequestType.java
Returnweb/wwwroot/ws/java/timecontrol/ExecuteActionResponseType.java

Request:

ID #RequiredDescription
ActionPlanIDXID # of the action plan to which the action belongs.
ActionIDXAction ID #.
UserIDXID of the user that will be used to execute the action.
ExecStartDtActual start date (When?) in the YYYY-MM-DD format.
ExecStartTmActual start time (When?) in the HH:MM format.
ExecEndDtActual end date (When?) in the YYYY-MM-DD format.
ExecEndTmActual end time (When?) in the HH:MM format.
ExecCostVlExecuted cost (How much?), in the 10000.00 format, where the "." is the decimal separator. Thousandth separator is not used.
ResultDsResult. Note: The Result field may be mandatory depending on the configuration of the action plan category

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:timecontrol">
<soapenv:Header/>
<soapenv:Body>
<urn:executeAction>
<!--You may enter the following 9 items in any order-->
<urn:ActionPlanID>?</urn:ActionPlanID>
<urn:ActionID>?</urn:ActionID>
<urn:UserID>?</urn:UserID>
<urn:ExecStartDt>?</urn:ExecStartDt>
<urn:ExecStartTm>?</urn:ExecStartTm>
<urn:ExecEndDt>?</urn:ExecEndDt>
<urn:ExecEndTm>?</urn:ExecEndTm>
<urn:ExecCostVl>?</urn:ExecCostVl>
<urn:ResultDs>?</urn:ResultDs>
</urn:executeAction>
</soapenv:Body>
</soapenv:Envelope>

Return:

ID #RequiredDescription
ActionPlanIDXID # of the action plan to which the action belongs.
ActionIDXAction ID #.
UserIDXID of the user that will be used to execute the action.
ExecStartDtActual start date (When?) in the YYYY-MM-DD format.
ExecStartTmActual start time (When?) in the HH:MM format.
ExecEndDtActual end date (When?) in the YYYY-MM-DD format.
ExecEndTmActual end time (When?) in the HH:MM format.
ExecCostVlExecuted cost (How much?), in the 10000.00 format, where the "." is the decimal separator. Thousandth separator is not used.
ResultDsResult. Note: The Result field may be mandatory depending on the configuration of the action plan category

Return structure:

<executeActionResponse>
<Status>?</Status>
<Code>?</Code>
<Detail>?</Detail>
</executeActionResponse>