This API enables you to submit approvals for a context object with comments using the adhoc approval specification for that object. This API accepts the context object type and id, along with the submission comments structure as input parameters and returns true if the submit is successful.

The SubmissionComments structure is same as from previous API docs.

APISignature
submitForAdhocApprovalsWithCommentswebService static Boolean submitForAdhocApprovalsWithComments(String sObjectType, Id sObjectId, Apttus_Approval.SubmissionComments comments)
Request Parameters
NameTypeRequired?Description

sObjectId

IDYesID of the approval context object.
sObjectTypeStringYesType the approval context object.
commentsSubmissionCommentsYesThe comment to add.
Response Parameter
NameTypeDescription
resultBooleanReturns true if the approval request is submitted successfully.

Integration Details

Use the following information in your integrations with Apttus Intelligent Workflow Approvals API. Refer to Integrating Apttus with External Systems for information on how to get started.

API Prerequisites

None.

Response/Request XML

Example Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:app="http://soap.sforce.com/schemas/class/Apttus_Approval/ApprovalsWebService" xmlns:sub="http://soap.sforce.com/schemas/class/Apttus_Approval/SubmissionComments">
   <soapenv:Header>
      <app:SessionHeader>
         <app:sessionId>00DR0000001nyVR!ARYAQOruA8X3nIS2hgZgZxEZkUDHDMlzIfBNGDey8s_.AcTbbEghNGUnMEh5oGcG5mkmrVuHp1F9gHzfIfYAvzuRDU6zg7kO</app:sessionId>
      </app:SessionHeader>
   </soapenv:Header>
   <soapenv:Body>
      <app:submitForApprovalsWithComments>
         <app:sObjectType>Apttus__APTS_Agreement__c</app:sObjectType>
         <app:sObjectId>a07R000000AiYQXIA3</app:sObjectId>
         <app:comments>
            <sub:commentsCount>1</sub:commentsCount>
            <sub:commentsLevel>Process</sub:commentsLevel>
            <sub:processComment>Here is my comment</sub:processComment>
            <sub:processCommentLabel>ProcessLabel</sub:processCommentLabel>
            <sub:processCommentMandatory>false</sub:processCommentMandatory>
            <sub:processName>ProcessName</sub:processName>
         </app:comments>
      </app:submitForApprovalsWithComments>
   </soapenv:Body>
</soapenv:Envelope>
XML

Example Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://soap.sforce.com/schemas/class/Apttus_Approval/ApprovalsWebService">
   <soapenv:Body>
      <submitForApprovalsWithCommentsResponse>
         <result>true</result>
      </submitForApprovalsWithCommentsResponse>
   </soapenv:Body>
</soapenv:Envelope>
XML