标签：tag rsa logs xxxx rom 收件人 不用 操作方法 而不是
经过之前的操作，对Docusign的基本功能有了一个比较全面的认识，那么这篇博客将教你如何调用Docusign的SOAP API 接口来实现电子签名的功能
首先在Docusign提供的官方文档中找到SOAP API文档，Docusign有两个SOAP API的服务端点：API.ASMX和DSAPI.ASMX
Docusign官方建议使用DSAPI.ASMX端点集成，其主要优点是它使用X-DocuSign-Authentication标准，而不是WSE3 Username Token执行认证，与之相比，X-DocuSign-Authentication对调用方法而言更容易实现
那么在打开https://demo.docusign.net/api/3.0/dsapi.asmx后，这是一个XML的文件，将这个XML通过WSDL的方式生成Salesforce中的Apex类（操作方法可以参考我的博客：Salesforce SOAP 接口集成服务）, 直接导入会遇到一个ERROR信息：
这是因为daspi.XML这个文件的最后有这样两行
<wsdl:port name="DSAPIServiceSoap" binding="tns:DSAPIServiceSoap"> <soap:address location="https://demo.docusign.net/api/3.0/dsapi.asmx" /> </wsdl:port> <wsdl:port name="DSAPIServiceSoap12" binding="tns:DSAPIServiceSoap12"> <soap12:address location="https://demo.docusign.net/api/3.0/dsapi.asmx" /> </wsdl:port>
以及与这两个Port对应的Bing
<wsdl:binding name="DSAPIServiceSoap" type="tns:DSAPIServiceSoap"> <wsdl:binding name="DSAPIServiceSoap12" type="tns:DSAPIServiceSoap">
删除其中之一，即可重新导入，这里我们删除后面的DSAPIServiceSoap12, 记得将生成的Apex命名为： DocusignApi
OK, 完成这一步之后，我们需要准备Docusign账号的信息，包括
其中 IntegratoryKey 的值需要在Docusign中申请, Docusign Admin → INTEGRATIONS → API and Keys
Tips: 在API and Key 里，你也可以找到自己账户的UserId和AccountId
准备好上述内容后，我们上传一个需要电子签名的模板到Docusign中
首先进入Salesforce → Docusign eSignature → Docusign Admin → custom tag，新建一个签名的tag:SignName，然后在准备上传的DOC模板加上这个Tag
选择Template页签，新建模板， 上传完成演示模板后，将模板的Id取出来保存：TemplateId
我们创建一个class: DocusignDemo
/** * @Author:Ricardo * @funtion:test docusign soap Api * @time:2020-04-16 * */ public without sharing class DocusignDemo { public static String USERID = ‘XXXX‘; public static String ACCOUNTID = ‘XXXXX‘; public static String PASSWORD = ‘XXXXX‘; public static String INTEGRATORKEY = ‘XXXXXX‘; public static String ENDPOINT = ‘https://demo.docusign.net/api/3.0/dsapi.asmx‘; @future(callout=true) public static void sendWithDocusign(String recordId){ Contract con = [SELECT id FROM Contract WHERE Id=:recordId]; DocusignApi.DSAPIServiceSoap dsApi = new DocusignApi.DSAPIServiceSoap(); dsApi.endpoint_x = ENDPOINT; //Set Authentication String auth = ‘<DocuSignCredentials>‘ + ‘<Username>‘+ USERID + ‘</Username>‘ + ‘<Password>‘ + PASSWORD + ‘</Password>‘ + ‘<IntegratorKey>‘ + INTEGRATORKEY + ‘</IntegratorKey>‘ + ‘</DocuSignCredentials>‘; System.debug(‘Setting authentication to: ‘ + auth); dsApi.inputHttpHeaders_x = new Map<String, String>(); dsApi.inputHttpHeaders_x.put(‘X-DocuSign-Authentication‘, auth); // 发送Docusign中的模板 DocuSignAPI.TemplateReference templateReference = new DocuSignAPI.TemplateReference(); templateReference.Template = ‘templateId‘;// 传入模板ID templateReference.TemplateLocation = ‘Server‘; DocusignApi.ArrayOfTemplateReference templateReferences = new DocusignApi.ArrayOfTemplateReference(); templateReferences.TemplateReference = new DocusignApi.TemplateReference[]{templateReference}; // 第一个签字 DocusignApi.Recipient firstSigner = new DocusignApi.Recipient(); firstSigner.ID = 1; firstSigner.Type_x = ‘Signer‘;// 收件人类型 - Signer表示需要签字 firstSigner.RoutingOrder = 1;// 签字顺序 firstSigner.Email = ‘test@docusign.com‘; firstSigner.UserName = ‘第一个签字‘; firstSigner.RequireIDLookup = false; // 第二个签字 DocusignApi.Recipient secondSigner = new DocusignApi.Recipient(); secondSigner.ID = 2; secondSigner.Type_x = ‘Signer‘; secondSigner.RoutingOrder = 2; secondSigner.Email = ‘test@salesforce.com‘; secondSigner.UserName = ‘第二个签字‘; secondSigner.RequireIDLookup = false; // 第三个收件人 DocusignApi.Recipient ccCopy = new DocusignApi.Recipient(); ccCopy.ID = 3; ccCopy.Type_x = ‘CarbonCopy‘;// 抄送给这个收件人，并不需要其签字 ccCopy.RoutingOrder = 3; ccCopy.Email = ‘copy@file.com‘; ccCopy.UserName = ‘不用签字‘; ccCopy.RequireIDLookup = false; DocusignApi.ArrayOfRecipient1 recipients = new DocusignApi.ArrayOfRecipient1(); recipients.Recipient = new DocusignApi.Recipient[]{firstSigner,secondSigner,ccCopy}; DocusignApi.EnvelopeInformation envelopeInfo = new DocusignApi.EnvelopeInformation(); envelopeInfo.AccountId = ACCOUNTID; envelopeInfo.Subject = ‘email subject‘;// Max 100 characters envelopeInfo.EmailBlurb = ‘email message.‘;// Max 10000 characters DocusignApi.CustomField platformName = new DocusignApi.CustomField (); platformName.Name = ‘PlatformName‘; platformName.Value = ‘Salesforce‘; platformName.Show = ‘False‘; DocusignApi.CustomField appName = new DocusignApi.CustomField (); appName.Name = ‘AppName‘; appName.Value = ‘DocuSignForSalesforce‘; appName.Show = ‘False‘; DocusignApi.CustomField SFContract = new DocusignApi.CustomField (); SFContract.Name = ‘##SFContract‘; SFContract.Value = recordId; SFContract.Show = ‘False‘; DocusignApi.CustomField DSFSSourceObjectId = new DocusignApi.CustomField (); DSFSSourceObjectId.Name = ‘DSFSSourceObjectId‘; DSFSSourceObjectId.Value = recordId + ‘~Contract‘; DSFSSourceObjectId.Show = ‘False‘; DocusignApi.ArrayOfCustomField arrayOfCustomFields = new DocusignApi.ArrayOfCustomField(); arrayOfCustomFields.CustomField = new list<DocusignApi.CustomField>(); arrayOfCustomFields.CustomField.add(platformName); arrayOfCustomFields.CustomField.add(appName); arrayOfCustomFields.CustomField.add(SFContract); arrayOfCustomFields.CustomField.add(DSFSSourceObjectId); System.debug(‘*** arrayOfCustomFields:‘ + arrayOfCustomFields); envelopeInfo.CustomFields = arrayOfCustomFields; try { DocusignApi.EnvelopeStatus es = dsApi.CreateEnvelopeFromTemplates(templateReferences,recipients,envelopeInfo,true); String envelopeId = es.EnvelopeID; System.debug(LoggingLevel.INFO, ‘*** EnvelopeID:‘ + es.EnvelopeID); System.debug(LoggingLevel.INFO, ‘*** Status:‘ + es.Status); } catch ( CalloutException e) { System.debug(‘Exception - ‘ + e ); } } }
最后，在Salesforce的Console控制台中，执行一段代码：
DocusignDemo.sendWithDocusign(‘8002w000000HXkJ‘);
在设定的邮件中可以查看到需要签字的邮件，签字的文档显示如下：
以上，是关于在Salesforce中使用SOPA API的方式调用Docusign的演示demo，如有问题，欢迎留言交流
Docusign系列（三） - SOAP 方式调用Docusign
标签：tag rsa logs xxxx rom 收件人 不用 操作方法 而不是
原文地址：https://www.cnblogs.com/luqinghua/p/12716655.html
