使用 empApi 组件实现 Change Data Capture 功能

Change Data Capture 功能是从 Winter ’19 版本开始正式启用的功能。

它是基于“发布-订阅”模式设计,可以将 Salesforce 中记录的改变自动推送给订阅者所在的系统,比如 Salesforce 内部的功能模块或外部的数据库。

在 Lightning 框架中,lightning:empApi 组件可以实现“订阅者”的角色。在本文中,我们将演示如何使用 lightning:empApi 组件来实时得到记录的更新信息。

启用 Change Data Capture 功能

Change Data Capture 功能是基于对象的,所以我们首先要设置想要订阅的对象类型。

在“设置”界面中搜索“更改数据捕获”,可以进入 Change Data Capture 的设置界面。我们可以设定哪些对象的更新会被记录。

设置 Change Data Capture

建立 Lightning 组件

新建 Lightning 组件,命名为 CDCDemo.cmp,代码如下:

<aura:component implements="flexipage:availableForRecordHome,force:hasRecordId,force:hasSObjectName">
    <aura:attribute name="recordId" type="String" />
    <aura:attribute name="sObjectName" type="String" />
    <aura:attribute name="changeList" type="Object[]" description="存储更新信息,显示在用户界面中" />
    
    <aura:handler name="init" value="{!this}" action="{!c.doInit}"/>

    <lightning:empApi aura:id="empApi"/>
    
    <lightning:card footer="" title="更新记录">
        <aura:iteration items="{!v.changeList}" var="item">
            <p class="slds-p-horizontal_large">
                <a href="#"><span onclick="{!c.gotoUser}" data-user-id="{!item.userId}">用户</span></a>于 {!item.modifiedDate} 更新了此记录。
            </p>
        </aura:iteration>
    </lightning:card>
    
</aura:component>

其 JavaScript 控制器代码如下:

({
    doInit : function(component, event, helper) {
        var empApi = component.find("empApi");

        // 设定 channel 值。Change Data Capture 功能使用 channel 值来追踪数据更新
        var channel = '/data/';

        // 得到 SObject 对象类型,从而补全 channel 值。标准对象和自定义对象的 channel 值构建方法不同
        var sObjectName = component.get('v.sObjectName');
        if (sObjectName.endsWith('__c')) {
            channel = channel + sObjectName.substring('0', sObjectName.length - 3) + '__ChangeEvent';
        } else {
            channel = channel + sObjectName + 'ChangeEvent';
        }
        
        // 设定 replayId 为-1,表示得到最新的更新事件
        var replayId = '-1';
        
        // 设定数据改变之后的 callback 逻辑,message 中包含了数据更新的详细信息
        var callback = function (message) {
            var modifiedRecords = message.data.payload.ChangeEventHeader.recordIds; // 得到更新的数据的 Id 值
            var commitUser = message.data.payload.ChangeEventHeader.commitUser; // 得到进行更新的用户的 Id 值
            
            var currentRecordId = component.get('v.recordId');
            var userId = $A.get("$SObjectType.CurrentUser.Id");

            // 如果当前记录被更改,并且更改的用户不是当前用户,则将更改的信息放入 changeList 属性中,显示在用户界面上
            if (modifiedRecords.includes(currentRecordId) && commitUser != userId) {
                var changeList = component.get('v.changeList');
                
                var changeItem = {};
                changeItem.userId = commitUser;
                var modifiedDate = new Date(message.data.payload.LastModifiedDate);
                changeItem.modifiedDate = modifiedDate.toString();
                
                changeList.push(changeItem);

                component.set('v.changeList', changeList);
            }
        }.bind(this);

        // 开始订阅
        empApi.subscribe(channel, replayId, callback).then(function(value) {
            // 订阅成功,可以在这里显示成功信息
        });
        
        // 错误处理
        var errorHandler = function (message) {
            // 显示错误信息
        }.bind(this);

        // 将错误处理函数连接到 empApi 组件中
        empApi.onError(errorHandler);
    },
    
    gotoUser : function(component, event, helper) {
        var userId = event.currentTarget.dataset.userId;
        
        // 重定向到用户界面
        var navEvt = $A.get("e.force:navigateToSObject");
        navEvt.setParams({
            "recordId": userId
        });
        navEvt.fire();
    },
})

在“客户”页面上使用组件

在“客户”的页面上,进入“编辑页面”界面。然后,将刚才建立的 CDCDemo 组件拖动到页面的“活动”部分。

将组件拖到页面中

然后,如果在我们浏览“客户”记录页面的同时,其他用户修改了此条记录,在“活动”部分会动态地给出通知。

组件效果

小结

在这个示例中,我们主要使用了 Lightning 中的 empApi 组件来动态订阅数据的更新,然后自动推送到用户界面中。

使用其他的工具(比如 Salesforce 推荐的 EMP-Connector)可以将数据的订阅推送到其他的系统中,实现系统的整合和同步。

转载于:https://www.cnblogs.com/chengcheng0148/p/change_data_capture_with_empapi.html

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

表情包
插入表情
评论将由博主筛选后显示,对所有人可见 | 还能输入1000个字符
相关推荐
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值