Submit for Approvals with Comments Using an Ad Hoc Approval Specification
This API enables you to submit approvals for a context object with comments using the ad hoc 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.
Note:
The SubmissionComments structure is same as from previous API docs.
|
API |
Signature |
|---|---|
| submitForAdhocApprovalsWithComments |
webService static Boolean submitForAdhocApprovalsWithComments(String sObjectType, Id sObjectId, Apttus_Approval.SubmissionComments comments) |
|
Request Parameters | |||
|---|---|---|---|
|
Name |
Type |
Required? |
Description |
| sObjectId | ID |
Yes |
ID of the approval context object. |
| sObjectType | String |
Yes |
Type the approval context object. |
| comments | SubmissionComments |
Yes |
The comment to add. |
|
Response Parameter | ||
|---|---|---|
|
Name |
Type |
Description |
| result | Boolean |
Returns true if the approval request is submitted successfully. |
Integration Details
Use the following information in your integrations with Conga Approvals API. Refer to Integrating Conga with External Systems 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><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>