SAP Connector

数据

对已连通的SAP连接器，通过其RFC函数解析读取、转换相关数据，为AWS PaaS平台上层场景提供服务。

创建

在数据页签，点击左上角新建按钮，打开窗口中选择应用名称和SAP(连接SAP RFC服务)，点击确定按钮。选择的应用名称建议与创建连接器时选择的应用名称一致。

连接器

选择数据服务需要使用的SAP连接器，并配置RFC函数，然后点击解析函数，系统会自动完成输入输出的配置及映射。

此处连接器列表仅显示当前应用及关联应用的SAP连接器。

RFC函数名

函数名支持手动输入，也可以通过搜索进行选择。

点击RFC函数名旁的搜索按钮，打开搜索窗口，输入函数名、组名进行搜索，在列表中选择需要使用的函数，确定即可。

输入

配置输入参数，系统通过FRC函数会自动生成输入参数及配置。

修改参数

属性项	说明
参数名	参数名，建意不要修改
标题	简要标题，便于理解参数含义
描述	简要描述
类型	参数类型，建意不要修改
来源	调用方给定，该参数在DS引擎执行时，参数值由调用者传入。系统给定，参数来源为系统给定时，默认值必填。指该参数在DS引擎执行时，不会使用由调用者传入的值，DS引擎自动以配置的默认值执行。
必填	调用该模型时，参数值是否允许为空
默认值	参数默认值。来源为系统给定时，必填

支持分页查询

当RFC函数请求参数包含分页信息时，可在Data Service输入开启支持分页查询，开启后

1. 会在输入页签Data Service输入列表增加page.size 和page.index参数，可直接与右侧请求参数列表中表示分页信息的参数进行连线映射
2.  会在输出页签Data Service输出列表中增加result.page.total参数

输出

配置输出参数，系统通过FRC函数会自动生成输出参数及配置。

属性项	说明
参数名	参数名，建意不要修改
标题	简要标题，便于理解参数含义
描述	简要描述
类型	参数类型，建意不要修改
数据清洗	对返回的输出数据项进行处理，例如：将返回的0,1等状态值，显示为男，女

数据清选

数据清洗是指为输出数据项进行处理。例如：字典翻译（如1代表男，0代表女）、值转换（如将long的Timestamp值转换成日期）、复杂值处理（如脱敏手机号，只保留前后3位）、去重（如将无效记录剔除）等。

清洗方式支持公式和Java程序两种。

公式

通过@公式对输出数据进行处理。

1. 仅支持简单类@公式
2. 取普通字段值$[result.object1.key1]
3. 取数组字段值$[result.object1.array1[index].key1]

Java程序

通过Java事件对输出数据进行处理。事件需要实现com.actionsoft.bpms.cc.ds.ValueFunction接口。

示例：


import java.text.SimpleDateFormat;
import java.util.Date;

import com.actionsoft.bpms.cc.ds.ValueFunction;
import com.actionsoft.messaging.MessageContext;

public class DataConvertDemo implements ValueFunction {
     /**
     * 示例：对时间戳进行格式化，并追加其他字段值进行一句话描述
     *
     * @param obj 当前字段值，对应类型的Java Object
     * @param ctx 当前引擎上下文，使用ctx.getProperty(JSONPath语法)获取其他字段值
     * @param indexes 数组场景时，表示当前值在数组中的下标，indexes下标值对应相应层级的数组，非数组场景时为null
     * @return 转换后的值
     */
    @Override
    public Object process(Object obj, MessageContext ctx, int... indexes) {
         Long createTime = (Long) obj; //1635418181000
         Date date = new Date(createTime);
         SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy年MM月dd日");
         String formatDate = dateFormat.format(date); //2021年10月28日18时49分
         String tagName = ctx.getProperty("result.data.moduleList[" + indexes[0] + "].pageList[" + indexes[1] + "].tagName", String.class); //炎黄盈动
         return "于" + formatDate + "创建标签:" + tagName; //于2021年10月28日创建标签:炎黄盈动
    }
}