一、返回类型为QueryTemplate
QueryTemplate作为关联查询的条件的返回结果,更加高效。
除非QueryTemplate的查询方式不能满足需求,否则优先推荐用使用QueryTemplate返回类型函数,用此方法返回的范围数据没有上限,并且执行效率高。
1.1 函数编写模板:
Groovy:
QueryTemplate template1 = QueryTemplate.AND(
["name":Operator.LIKE("测试")],
["field_g7Zeh__c":Operator.LTE("测试单行文本")]
)
QueryTemplate template2 = QueryTemplate.AND(
["owner":Operator.LIKE("1000")],
["record_type":Operator.EQ("default__c")]
)
//QueryTemplate使用OR条件需要单独开通,请联系销售人员下订单开通产品:【对象列表筛选支持或者】
QueryTemplate template3 = QueryTemplate.OR(template1,template2)
return template3
//查询条件支持
// product_id 为查找关联字段,查询模版支持筛选查找关联对象下的name字段符合某种条件的结果
QueryTemplate template = QueryTemplate.AND(
["product_id.name":Operator.EQ("测试")]
)
return template
Java:
import java.util.List;
import java.util.Map;
public class RangeTemplate implements IQueryTemplateAction {
/**
* 范围规则函数(QueryTemplate)的运行方法
*/
@Override
public QueryTemplate execute(FunctionContext context, Map<String, Object> args) {
//构造查询条件
QueryTemplate template1 = QueryTemplate.AND(
Maps.of("name", QueryOperator.EQ("测试")),
Maps.of("field_g7Zeh__c", QueryOperator.EQ("测试单行文本"))
);
QueryTemplate template2 = QueryTemplate.AND(
Maps.of("owner", QueryOperator.LIKE("1000")),
Maps.of("record_type", QueryOperator.EQ("default__c"))
);
//QueryTemplate使用OR条件需要单独开通,请联系销售人员下订单开通产品:【对象列表筛选支持或者】
QueryTemplate template3 = QueryTemplate.OR(template1,template2);
return template3;
}
}
二、返回类型为集合(List)
不推荐使用List返回类型函数,用此方法返回的数据有上限500条,并且查询和使用id作为返回值的执行效率较低。
2.1 函数编写模板:
//定义id List
List objectIds = []
...
//写函数逻辑,并将可选择数据Id添加到objectIds里
objectIds.add()
//最后返回的数据结果为 List<String> 里面包含满足条件的数据id
return objectIds
实际场景:报价单明细按产品分类限制可选择产品范围,不同业务类型的报价单明细选择不同分类的产品数据。
根据以上实际场景的模板案例:
Groovy:
//获取当前操作对象实例的字段值
String product = context.data.field_wPnHu__c
//根据条件查找数据,根据需要的业务逻辑查询出需要的数据
def ret = Fx.object.find("查找关联字段所对应的对象ApiName",[["field_1tG48__c":product]],100,0)
//如果查询错误直接return返回
if( ret[0] ){
Fx.log.info("查询异常")
return []
}
//定义id List
List objectIds = []
QueryResult result = ret[1] as QueryResult
//遍历查询结果,将所有Id添加到objectIds中
result.dataList.each{ item ->
Map map = item as Map
objectIds.add(map._id)
}
//最后返回objectIds
return objectIds
Java:
import java.util.List;
import java.util.Map;
public class RangeList implements IQueryListAction {
/**
* 范围规则函数(List)的运行方法
*/
@Override
public List execute(FunctionContext context, Map<String, Object> args) {
//获取当前操作对象实例的字段值
String name = context.getData().get("name").toString();
Fx.log.info(name);
List<Object> list = Lists.newArrayList();
list.add(Maps.of("name", QueryOperator.EQ(name)));
//根据条件查找数据,根据需要的业务逻辑查询出需要的数据
APIResult ret = Fx.object.find("AccountObj",list,100,0);
QueryResult result = (QueryResult)ret.getData();
List dataList = (List) result.getDataList();
if(dataList==null) {
Fx.log.info("查询异常");
}
List idList = Lists.newArrayList();
//遍历查询结果,将所有Id添加到objectIds中
for (int i=0;i<dataList.size();i++) {
Map map =(Map<String, Object>)(dataList.get(i));
Fx.log.info(map.get("name").toString());
idList.add(map.get("_id").toString());
}
Fx.log.info(idList);
//返回id
return idList;
}
/**
* 函数的调试方法
* @param context 函数上下文
* @param args 函数参数
*/
public void debug(FunctionContext context, Map<String, Object> args) {
execute(context, args);
}
}
三、返回类型为RangeRule
选择和新建查找关联字段时指定默认业务类型。
3.1 函数编写模板:
Groovy:
QueryTemplate template = QueryTemplate.AND(
["name":Operator.LIKE("测试")]
)
RangeRule rangeRule = RangeRule.builder()
.queryTemplate(template)
.recordType("record_cbxZ8__c") // 查找关联新建时默认用该业务类型
.build()
return rangeRule
Java:
import java.util.List;
import java.util.Map;
public class RangeRuleCode implements IRangeRuleAction {
/**
* 范围规则函数(rangeRule)函数的运行方法
*/
@Override
public RangeRule execute(FunctionContext context, Map<String, Object> args) {
//构造QueryTemplate
QueryTemplate template1 = QueryTemplate.AND(
Maps.of("name", QueryOperator.EQ("测试")),
Maps.of("field_g7Zeh__c", QueryOperator.EQ("测试单行文本"))
);
//构造RangeRule
RangeRule rangeRule = RangeRule.builder()
.queryTemplate(template1)
.recordType("record_cbxZ8__c") // 查找关联新建时默认用该业务类型
.build();
return rangeRule;
}
}