salesforce零基础学习(八十六)Ajax Toolkit (VF页面中使用及javascript action使用)
Posted zero.zhang
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了salesforce零基础学习(八十六)Ajax Toolkit (VF页面中使用及javascript action使用)相关的知识,希望对你有一定的参考价值。
Ajax Toolkit 参考文档:https://resources.docs.salesforce.com/212/latest/en-us/sfdc/pdf/apex_ajax.pdf
在项目中,我们有时会在自定义button或者action上使用javascript进行一些SOQL或者DML操作处理;有时会在VF页面中获取相关数据进行逻辑处理,或者进行简单的DML操作,这时候就会使用到Ajax Toolkit。
因为Ajax Toolkit操作数据信息是在浏览器端的,进行复杂的逻辑或者对大量数据处理会影响前端的性能,所以不是所有的场景都适合使用ajax toolkit。可以在以下情景(不仅限于以下)下使用:
- 展示或者更新单条数据
- 在一些数据中展示一两列信息
- 执行简单的业务逻辑
因为使用在浏览器端,所以保证数据量越少,业务逻辑越少,是最好的。以下从两个方面进行Ajax Toolkit介绍:VF / JavaScript Action
Ajax Toolkit 可以分成三步走:链接Ajax Toolkit API,嵌入API Call,对结果进行处理。接下来会将后两步揉成一步进行处理。
一.链接到Ajax Toolkit API
VF:在页面中引入js,其中42.0代表version,这个值代表着当前connection.js的版本号。你也可以设置成41.0,40.0等等。
<script src="../../soap/ajax/42.0/connection.js" type="text/javascript"></script> <script> sforce.connection.sessionId=\'{!GETSESSIONID()}\'; //TODO </script>
onclick javascript:引用{!requireScript("/soap/ajax/42.0/connection.js")}
当引入的javascript执行后,toolkit便会被加载并创建了一个全局的对象sforce.connection,你可以通过这个对象访问所有的API call以及ajax toolkit toolkit的方法。toolkit支持所有的SOAP API calls.
可用的核心API介绍链接:https://developer.salesforce.com/docs/atlas.en-us.212.0.api.meta/api/sforce_api_calls_list.htm
二.在javascript中嵌入API Call并进行结果处理
Ajax Toolkit 支持同步和异步两种调用。
同步调用和异步调用的区别为:同步调用为当向服务器端发送请求后,需要一直等到服务器端返回结果,并针对结果进行后期的处理;异步调用为当向服务器发送请求后,可以继续进行其他的处理,当服务器有调用返回结果后,再进行结果处理。异步调用需要在API call中添加一个参数用来做call back的函数处理。
同步调用格式:
sforce.connection.method("argument1","argument2",...);
异步调用格式:
sforce.connection.method("argument1","argument2",...,"callback_function");
因为调用有可能出现异常,同步和异步的异常处理如下:
同步异常处理为在调用处使用try catch 来捕获异常
异步异常处理为异步的callback result提供了一个onFailure配置,当出现异常后,会执行onFailure配置的方法,成功会执行onsuccess方法
因为异步调用为结果什么时候返回,客户端什么时候处理,当后台处理特别慢的情况下,前端等待时间太长会很不友好,异步调用提供了一个timeout配置属性,用来设置异步调用最长时间,单位是以毫秒为单位,最小值为1
完整异步调用格式
var callback = {onSuccess: handleSuccess, onFailure: handleFailure,timeout:1000};
function handleSuccess(result) {}
function handleFailure(error) {}
sforce.connection.query("Select name from Account", callback);
ajax toolkit call 不论当前搜索的数据字段在表结构中是什么类型,使用ajax toolkit query返回的数据类型均为string类型,如果搜索的字段在数据库中存储的value为null,则获取到的值为null,如果当前没有搜索此字段,但是在前台js中有引用到,则值为undefined.
除了针对数据的CRUD外,ajax toolkit 还支持很多操作,比如 提交审批 / 通过Schema获取sObject以及Field的相关元数据信息 / 发送邮件等功能
同步调用举例:
https://developer.salesforce.com/docs/atlas.en-us.ajax.meta/ajax/sforce_api_ajax_more_samples.htm
异步调用举例:
我们有时还需要调用相关类的方法。如果需要调用apex 相关类的方法,需要引入apex.js
VF写法:<script src="/soap/ajax/41.0/apex.js" type="text/javascript"></script>
action写法:{!requireScript("/soap/ajax/41.0/apex.js")}
调用的类的方法必须声明称webservice,方法的参数需要为 基本数据类型,sObject类型或者是两者数据类型的List
js端调用结构为(如果有结果返回,则接收;如果无结果返回,则不需要接收)
var result = sforce.apex.execute("className","methodName","{param1Key:param1Value,param2Key:param2Value}");
如果调用的方法没有参数,则调用结构为
var reuslt = sforce.apex.execute("className","methodName","{}");
三.举例
需求:客户上面有多个联系人,如果没有选择联系人,则提示需要选择至少一个联系人。选择的联系人要求联系人的邮箱必须都不能为空。点击按钮后更新联系人Is_Checked__c设置为true。
1.Contact上创建字段Is_Checked__c
2.创建webservice类,参数为ContactList,将参数中所有的Contact的Is_Checked__c更新为true
global without sharing class ContactController { static webservice Boolean changeContactsStatus(List<Contact> contactList) { List<Contact> updateContactList = new List<Contact>(); for(Contact c : contactList) { Contact tempContact = new Contact(); tempContact.Id = c.Id; tempContact.Is_Checked__c = true; updateContactList.add(tempContact); } try { if(updateContactList.size() > 0) { update updateContactList; } return true; } catch(Exception e) { return false; } } }
3.Contact创建custom action,设置类型为List Button,勾选Display Checkboxes,Behavor选择为execute javascript
对应的javascript代码如下(函数描述:https://help.salesforce.com/articleView?err=1&id=customize_functions.htm&type=5)
{!requireScript("/soap/ajax/41.0/connection.js")} {!requireScript("/soap/ajax/41.0/apex.js")} var selectedIds = {!GETRECORDIDS($ObjectType.Contact)}; var contactIds = \'\'; if(selectedIds.length == 0) { alert(\'You have to choose at least one item\'); } else { selectedIds.forEach(function(item,index){ contactIds += \'\\\'\' + item + \'\\\'\'; if(index != selectedIds.length-1) { contactIds += \',\'; } }); var contactQuery = "SELECT ID,Name,Email,LastModifiedDate,CreatedDate FROM Contact WHERE ID in (" + contactIds + ")"; result = sforce.connection.query(contactQuery); records = result.getArray("records"); var isSuccess = true; records.forEach(function(item,index){ if(item.Email == null || item.Email == \'\') { isSuccess = false; } }) if(isSuccess) { var executeResult = sforce.apex.execute("ContactController","changeContactsStatus",{contactList:records}); if(executeResult) { alert(\'Operate Success!\'); } else { alert(\'Operate Failed!\'); } } else { alert(\'The Items you selected have empty email.please check it again\'); } }
4.将Test Action设置在Account的Related List(Contact List)设置
效果展示:
1.不选情况下
2.正常操作
总结:针对Ajax Toolkit,如果数据量不多并且需要在前台处理情况下,可以考虑使用此种方式。不过lightning不支持action使用javascript,所以此种方式只支持classic的action 方式的javascript。
以上是关于salesforce零基础学习(八十六)Ajax Toolkit (VF页面中使用及javascript action使用)的主要内容,如果未能解决你的问题,请参考以下文章
salesforce零基础学习(八十四)配置篇: 自定义你的home page layout
salesforce零基础学习(八十一)更改标准字段的label名称(Admin)
salesforce零基础学习(八十三)analytics:reportChart实现Dashboard(仪表盘)功能效果
salesforce零基础学习(八十五)streaming api 简单使用(接近实时获取你需要跟踪的数据的更新消息状态)
salesforce零基础学习(八十二)审批邮件获取最终审批人和审批意见
salesforce零基础学习(八十七)Apex 中Picklist类型通过Control 字段值获取Dependent List 值