Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

download

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

sObjectIdID

Yes

ID of the approval context object.

sObjectTypeString

Yes

Type the approval context object.

commentsSubmissionComments

Yes

The comment to add.

Response Parameter

Name

Type

Description

resultBoolean

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>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>