输出

配置Data Service输出与SOAP服务的返回参数的映射关系。系统会根据连接器信息自动生成输出参数，一般用户可不做修改。

SOAP结果

调用SOAP服务后的返回信息。

result

配置响应结果参数。

sla

SLA是DS引擎执行的结果监控信息。

inTimes

输入参数构造耗时，单位毫秒

outTimes

输出数据构造耗时，单位毫秒

totalTimes

总耗时，单位毫秒

修改参数

可以修改参数标题和描述信息。

Data Service输出

Data Service输出是 SOAP DS引擎执行后的返回参数配置。返回值信息同SOAP结果。

添加/修改/删除参数

配置DS引擎执行后的输出参数。一般建议参数名和参数类型与响应结果中一致。

添加

在右侧Data Service输出，支持根节点result 和 参数类型为Object的节点添加子节点 。在添加参数窗口中填写相关属性后，点击保存按钮进行添加。

数据清洗

数据清洗是指为输出数据项进行处理。例如：字典翻译（如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日创建标签:炎黄盈动
    }
}

错误规则

由于服务端接口返回信息多样性，用户自定义返回错误规则。如果不配置， 响应状态码为200， result为ok时，errorcode为0，表示DS请求正常。点击错误规则按钮，弹出对话框中自定义错误规则。

• 错误条件，配置自定义表示出错的条件，默认为httpResponseCode 不等于200，用户可根据接口实际的返回值自定义。多个条件之间为或者的关系。
• 错误码，自定义返回结果中errorcode的值。
• 错误信息，自定义返回结果中msg的值。错误码和错误信息可以写一个固定的值，也可以选择一个输出参数，动态返回参数值