Troubleshooting
Refer to this topic for descriptions of API error messages thrown by Salesforce and suggested actions to take. An exception is an error caused during code execution. There are a number of built-in Apex exceptions as well as custom exceptions provided by Conga.
The following exceptions thrown by Salesforce that can be handled by Conga and converted to custom error messages:
- System.Exception: Exception thrown under most circumstances.
- System.CalloutException: Exception thrown when communicating with external systems.
- DMLException: Exception thrown when performing CRUD ('Create', 'Read', 'Update', 'Delete') actions.
Refer to the following table for a list of custom error messages provided by Conga for some SOAP APIs, included suggested actions to take to resolve the exception.
API | Error Message | Suggested Action |
|---|---|---|
Apttus_Proposal.MergeWebService.convertWordDocToPDF | Invalid attachment docId. | Ensure that you have provided the correct docId of the attachment. |
Apttus_Proposal.MergeWebService.mergeDocsToPDF | Invalid Merge Webservice Endpoint. | Ensure that you have provided the correct endpoint in the Merge Webservice Endpoint comply system property. |
Apttus.AgreementWebService.activateAgreement | No attachment(s) selected for activation. | Ensure that you have provided the correct docId of the attachment. |
You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. | |
No document or attachment found. This agreement must have a document or attachment to continue | Ensure that you have provided the correct docId of the attachment. | |
Invalid attachment {0} | Ensure that you have provided the correct docId of the attachment. | |
Apttus.AgreementWebService.publishToExternalRepository | External repository is not enabled. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.AgreementWebService.publishToChatterRepository | Chatter repository is not enabled. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.AgreementWebService.publishToDocumentRepository | Document repository is not enabled. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.AgreementWebService.selectFirstTemplateIdForAgreement | You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0}) | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.MergeWebService.convertWordDoc | Invalid attachment {0} | Ensure that you have provided the correct docId of the attachment. |
Apttus.MergeWebService.convertWordDocToPDF | Invalid attachment {0} | Ensure that you have provided the correct docId of the attachment. |
Apttus.MergeWebService.convertWordDocToPDF2 | Invalid attachment {0} | Ensure that you have provided the correct docId of the attachment. |
Apttus.MergeWebService.generateCustomDoc | Insufficient Privileges. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.MergeWebService.submitGenerateCustomDoc | Insufficient Privileges. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.AuthorWebService.getWordDocumentInfosForParentWithFiles | You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.AgreementWebService.sendForSignature | Maximum of 150 Recipients can be added. | Ensure that you do not add more than 150 email addresses of recipients. |
Duplicate email address identified. | Review the email addresses you have entered and remove any duplicate email addresses. | |
Please specify at least one recipient. | Ensure that you have provided at least one valid email address of a recipient. | |
Invalid email address found. Kindly verify and provide valid email address separated by ; | Ensure that you have provided valid email addresses of the recipients separated by a semicolon. | |
Missing Template ID: The send for signature email can't be triggered as the email template Id is missing. | Ensure that you have provided an email template Id. | |
Missing Agreement ID: The send for signature email can't be triggered as the agreement Id is missing. | Ensure that you have provided an agreement Id. | |
Missing Attachments: The send for signature email can't be triggered as there are no documents attached. | Ensure that at least one reviewed document is available in the agreement. | |
Apttus.AuthorWebService.subscribeToDocumentLock | You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0}) | Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions. |
Apttus.MergeWebService.mergeDocuments | Merge operation is only applicable for doc, docx and pdf file types. | Ensure that the documents you are trying to merge are in DOC, DOCX, or PDF format. |
Selected documents cannot be merged as the combined file size of the documents exceeds 25 MB. | Ensure that the file size of the documents you are trying to merge is less than 25 MB. |
The following are standard Salesforce exceptions that cannot be handled or changed:
- LimitException
- UnexpectedException
- AssertException
- NoAccessException
- NoDataFoundException
- SerializationException
- VisualforceException
You can learn more about these exceptions and recommended actions to take by consulting Salesforce documentation. For additional guidance, please refer to the article.