在Salesforce中创建Web Service供外部系统调用

电玩女神 2021-11-26 17:20 361阅读 0赞

在Salesforce中可以创建Web Service供外部系统调用，并且可以以SOAP或者REST方式向外提供调用接口，接下来的内容将详细讲述一下用SOAP的方式创建Web Service并且用Asp.net的程序进行简单的调用。

**1）：**在Salesforce中创建如下Class

【注：要想使其成为web service，那么class一定要定义成global的，具体的方法要用 webService static 修饰】

【代码中省略了GenerateAccountFromXmlInfo方法的具体实现，细节请看：[http://www.cnblogs.com/mingmingruyuedlut/p/3497646.html][http_www.cnblogs.com_mingmingruyuedlut_p_3497646.html] 】

global class SFAccountWebService {
        
        webService static string UpsertAccount(String accountXmlInfo) {
            Account currentAcc = GenerateAccountFromXmlInfo(accountXmlInfo);
            try
            {
                Account acc = [Select Id From Account a Where AccountNumber =: currentAcc.AccountNumber];
                if(acc != null){
                    currentAcc.Id = acc.Id;
                }
                upsert currentAcc;
                return 'true';
            }
            catch(exception ex){
                return 'false';    
            }
        }
        
        
        private static Account GenerateAccountFromXmlInfo(String accountXmlInfo){
            Account currentAcc = new Account();
            // Parse the xml info to generate the Account Object
            return currentAcc;
        }
        
    }

**2）：**在保存好上述的class之后，我们到setup --> build --> develop --> apex classes 中找到刚刚保存的class，我们会发现在对应的Action中有WSDL这个选项，此选项就是Salesforce默认所提供的将Web Service的class转化成WSDL文件。如下图所示

![30143945-ad5f07b6ad6e4ec98b4e3e96090223d7.png][]

**3）：**点击上图的WSDL按钮，会看到如下界面，这里显示的是生成的WSDL文件的详细信息，我们点击鼠标右键，将此文件保存到本地，这里姑且取名为SFAccountWebService.wsdl

![30143959-095b0bf013e746f2a46d932bed88ffa7.png][]

**4）：**我们可以简单的创建一个WebApplication的project，如下图所示，点击Reference后进行Add Web Reference

![30144012-2b73451f52664c198183a1293696c00e.png][]

**5）：**接上图，在URL的输入框中选择我们刚刚生成的WSDL文件，填写好右下角的Web Service Name，然后点击Add Reference按钮，这样我们就已经应用到了我们所刚刚生成的Web Service，是不是很简单呢~~

![30144027-113896fe97294e2ab2076a2dcd49ae89.png][]

**6）：**由于我们是通过外部系统去访问Salesforce内部的资源，那么不可逃避的首先便是认证，也就是说，我们必须首先通过Salesforce的认证，获取登陆用户的SessionId，然后此SessionId将作为此后每次访问Salesforce内部资源的认证标识，只有这样我们才能顺利调用到我们对外开放的Web Service。

如何在外部系统进行登陆认证获取对应的SessionId呢？这就涉及到了Salesforce默认提供的另外一个Web Service，如下图所示：

【setup --> build --> develop --> api --> partner wsdl --> generate partner wsdl】

![30144059-967b27eec7e24adc92d34cdab331dbd3.png][]

**7）：**将此WSDL文件以相同的方式保存到本地，这里姑且取名为 SFCommonService.wsdl

![30144113-79642c15ee9a43198f5c8298855e8088.png][]

**8）：**在对应Web Application的project中以相同的方式引用此文件

![30144125-04be494b6215483f98c2b14cbb166861.png][]

**9）：**可以简单的看一下最终的引用状态，如下图所示

![30144144-70505c3e4d414241b05d4d3619089e99.png][]

**10）：**如何进行调用对应的Web Service呢？ 请看如下代码

【login方法的两个参数是：用户名和密码。注：这里的密码是 用户密码 + 所对应的token】

using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Web;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    
    using TestSFWebServiceApplication.SFCommonWebService;
    using TestSFWebServiceApplication.SFAccountWebService;
    
    namespace TestSFWebServiceApplication
    {
        public partial class _Default : System.Web.UI.Page
        {
            protected void Page_Load(object sender, EventArgs e)
            {
                //Call login function to get the session id
                SforceService sfService = new SforceService();
                LoginResult result = sfService.login(@"******************", @"***********************");
                string currentSessionId = result.sessionId;
                
                //Call our web service function
                string accountXmlInfo = "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Accounts><Account><AccountName>WebServiceTest001</AccountName><AccountNumber>AAA000-009</AccountNumber></Account></Accounts>";
                SFAccountWebServiceService sfAccountService = new SFAccountWebServiceService();
                SFAccountWebService.SessionHeader sfAccountHeader = new SFAccountWebService.SessionHeader();
                sfAccountHeader.sessionId = currentSessionId;
                sfAccountService.SessionHeaderValue = sfAccountHeader;
                string upsertResult = sfAccountService.UpsertAccount(accountXmlInfo);
            }
        }
    }

**11）：**那么在Salesforce中如何引用外部系统所提供的Web Service呢？请看下图，将外部的WSDL文件生成Salesforce中所对应的Class

![30144707-fa165e8d49b546939f5b91349218e6ea.png][]

之后的具体调用这里就不详细列举了，请看如下链接：[http://www.cnblogs.com/mingmingruyuedlut/p/3512262.html][http_www.cnblogs.com_mingmingruyuedlut_p_3512262.html]

更多内容请看如下链接：

[http://shivasoft.in/blog/salesforce/consume-salesforce-web-service-in-c-net-application/][http_shivasoft.in_blog_salesforce_consume-salesforce-web-service-in-c-net-application]

[http://shivasoft.in/blog/salesforce/create-a-custom-web-service-in-salesforce-and-consume-it-in-c-net-application/][http_shivasoft.in_blog_salesforce_create-a-custom-web-service-in-salesforce-and-consume-it-in-c-net-application]

12）：当然了我们可以创建对应的Rest Service供外部系统调用

12.1）：在Salesforce中创建对应的Class，代码如下所示

@RestResource(urlMapping='/SFEricSunTestRestService')
    global class SFEricSunTestRestService {
    
        @HttpGet
        global static string GetTestRestInfo(){
            string testInfo = 'Hello Rest Service.';
            return testInfo;
        }
    }

这里的标识为 @RestResource(urlMapping='/.....') 这样所形成的Rest Service Uri 格式为 https://cs5.salesforce.com/services/apexrest/SFEricSunTestRestService

Http 的 GET 和 DELETE 方法不支持传递参数

12.2）：在外部系统调用上面的Rest Service（Get 方法），代码如下所示

private void TestSFRestService()
            {
                SforceService sfService = new SforceService();
                LoginResult result = sfService.login(@"......", @"......");
                string currentSessionId = result.sessionId;
    
                string restServiceURI = @"https://cs5.salesforce.com/services/apexrest/SFEricSunTestRestService";
    
                WebRequest request = WebRequest.Create(restServiceURI);
                request.Method = "GET";
                //request.ContentType = "application/xml";
                request.Headers.Add("Authorization:Bearer " + currentSessionId);
    
                WebResponse response = request.GetResponse();
    
                if (response != null)
                {
                    StreamReader reader = new StreamReader(response.GetResponseStream());
                    string msg = reader.ReadToEnd();
                }
    
            }

12.3）：也可以进一步扩展，代码如下

@RestResource(urlMapping='/SFEricSunTestRestService/*')
    global class SFEricSunTestRestService {
        
        @HttpDelete
        global static string doDelete() {
            RestRequest req = RestContext.request;
            String name = req.requestURI.substring(req.requestURI.lastIndexOf('/')+1);
            return 'Delete ' + name;
        }
      
        @HttpGet
        global static string doGet() {
            RestRequest req = RestContext.request;
            String name = req.requestURI.substring(req.requestURI.lastIndexOf('/')+1);
            return 'Get ' + name;
        }
      
        @HttpPost
        global static String doPost(String name, String age) {
            return 'Post' + name + ' ' + age;
        }
        
    }

12.4）：在外部系统调用上面的Rest Service，代码如下所示

private void TestSFRestService()
            {
                SforceService sfService = new SforceService();
                LoginResult result = sfService.login(@"....", @"....");
                string currentSessionId = result.sessionId;
    
                string restServiceURI = @"https://cs5.salesforce.com/services/apexrest/SFEricSunTestRestService/MyName";
    
                WebRequest request = WebRequest.Create(restServiceURI);
                request.Method = "GET";
                //request.ContentType = "application/xml";
                request.Headers.Add("Authorization:Bearer " + currentSessionId);
    
                WebResponse response = request.GetResponse();
    
                if (response != null)
                {
                    StreamReader reader = new StreamReader(response.GetResponseStream());
                    string msg = reader.ReadToEnd();
                }
    
            }

这是对GET方法的调用，我们将Name放在了Url的最后面传递给Service中，如果想调用Delete的方法，那么将request.Method = "GET";修改成为request.Method = "DELETE";

这里的Post方法有些特殊，需要传递name和age参数（实质是就是将实参加入到request的body中一起发到目的端去请求），调用代码如下所示

这里提供了SOUP UI的截图如下所示：

![091414346864333.png][]

12.5）：如果我们想在Salesforce内部去调用对应的Rest Service，那么可以用如下方式

https://developer.salesforce.com/forums/\#!/feedtype=SINGLE\_QUESTION\_SEARCH\_RESULT&id=906F000000099zbIAA

更加详细的信息请看如下链接：

http://www.salesforce.com/us/developer/docs/apexcode/index\_Left.htm\#CSHID=apex\_web\_services\_methods.htm|StartTopic=Content%2Fapex\_web\_services\_methods.htm|SkinName=webhelp

https://developer.salesforce.com/page/Creating\_REST\_APIs\_using\_Apex\_REST

转载于:https://www.cnblogs.com/mingmingruyuedlut/p/3493791.html

[http_www.cnblogs.com_mingmingruyuedlut_p_3497646.html]: http://www.cnblogs.com/mingmingruyuedlut/p/3497646.html
[30143945-ad5f07b6ad6e4ec98b4e3e96090223d7.png]: /images/20211126/5eb4eff6422147a487d3954849a875e9.png
[30143959-095b0bf013e746f2a46d932bed88ffa7.png]: /images/20211126/fbf213c92a504e9bbdd63a4c835c4fc8.png
[30144012-2b73451f52664c198183a1293696c00e.png]: /images/20211126/33049d5e07e843a795ed9db4d60e4b87.png
[30144027-113896fe97294e2ab2076a2dcd49ae89.png]: /images/20211126/c26cd23f5fea4df597c6aabe206f970b.png
[30144059-967b27eec7e24adc92d34cdab331dbd3.png]: /images/20211126/0c2bf35f2230400a82c0312be56113e4.png
[30144113-79642c15ee9a43198f5c8298855e8088.png]: /images/20211126/bb4c3a6ced9a4b5296f6dad183f47774.png
[30144125-04be494b6215483f98c2b14cbb166861.png]: /images/20211126/49de209c6847403291e719b88302104f.png
[30144144-70505c3e4d414241b05d4d3619089e99.png]: /images/20211126/8ee0e172a59047848cfdd146b0b204cb.png
[30144707-fa165e8d49b546939f5b91349218e6ea.png]: /images/20211126/2de8135ebea74a83ab95a0d0c120f609.png
[http_www.cnblogs.com_mingmingruyuedlut_p_3512262.html]: http://www.cnblogs.com/mingmingruyuedlut/p/3512262.html
[http_shivasoft.in_blog_salesforce_consume-salesforce-web-service-in-c-net-application]: http://shivasoft.in/blog/salesforce/consume-salesforce-web-service-in-c-net-application/
[http_shivasoft.in_blog_salesforce_create-a-custom-web-service-in-salesforce-and-consume-it-in-c-net-application]: http://shivasoft.in/blog/salesforce/create-a-custom-web-service-in-salesforce-and-consume-it-in-c-net-application/
[091414346864333.png]: /images/20211126/e1c31b9841c348359e51c6b612c2fba6.png