Fx.object

Fx.object:和对象操作有关的API

1、创建业务对象-create

  • 普通新建:Fx.object.create(<String apiName>,<Map objectData>)

    参数说明:

参数 说明
apiName 对象的api名称
objectData 对象数据即字段值

     data返回值类型:Map

     举例:

def(Boolean error,Map data,String errorMessage) = Fx.object.create("AccountObj",["name":"客户"])

  • 对象创建同时新建从对象:Fx.object.create(<String apiName>,<Map<String,Map> objectData>,<Map details>,<boolean withBizLogic>)

    参数说明:

参数 说明
apiName 对象的api名称
objectData 主对象数据即字段值
details 从对象数据
withBizLogic 和上面普通新建的标识性属性,默认为true

     data返回值类型:Map

     举例:

 def(Boolean error,Map data,String errorMessage) = Fx.object.create("object_2fJ1o__c",["name":"主从同时新建 主1"],["object_Ssm46__c":[["name":"张三1"]]],true)

    注:对象创建同时新建从对象走新建对象业务逻辑(判断权限、触发审批流工作流等)


2、批量新建-batchCreate

  • 普通新建:Fx.object.batchCreate(<String apiName>,<List<Map> objectData>)

    参数说明:

参数 说明
apiName 对象的api名称
objectData 对象数据即字段值

     data返回值类型:List

     举例:

 def(Boolean error,List data,String errorMessage) = Fx.object.batchCreate("AccountObj",[["name":"客户1"],["name":"客户2"]])

     注:batch类函数不会触发审批流


3、更新业务对象-update

  • 定义:Fx.object.update(<String apiName>,<String objectDataId>,<Map objectData>)

  • 参数说明

参数 说明
apiName 对象的api名称
objectDataId 对象实例的ID
objectData 对象数据即字段值

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) =  Fx.object.update("AccountObj","id123456",["name":"纷享销客"])

4、批量更新业务对象-batchUpdate

  • 定义:Fx.object.batchUpdate(<String apiName>,<Map<String,Map> objectData>)

  • 参数说明

参数 说明
apiName 对象的api名称
objectData 对象数据即字段值(key值为对象ID)

     data返回值类型:List

  • 举例:
def (Boolean error,List data,String errorMessage) =  object.batchUpdate("AccountObj",["e6a338ae8a944cdfb2bae737db1aa12f":["name":"客户1"],"4cd5a9f902af4f66a34df35a53630237":["name":"客户2"]])

     注:batch类函数不会触发审批流


5、按业务对象Id查询业务对象数据象-findById

  • 定义:Fx.object.findById(<String apiName>,<String objectDataId>)
  • 参数说明
参数 说明
apiName 对象的api名称
objectDataId 对象实例的ID

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) =  Fx.object.findById("AccountObj","e6a338ae8a944cdfb2bae737db1aa12f") 

6、批量按业务对象Id查询业务对象数据-findByIds

  • 定义:Fx.object.findByIds(<String apiName>,<List objectDataIds>)
  • 参数说明
参数 说明
apiName 对象的api名称
objectDataIds 对象实例的ID的List

     data返回值类型:List

  • 举例:
def (Boolean error,List data,String errorMessage) =  Fx.object.findByIds("AccountObj",["e6a338ae8a944cdfb2bae737db1aa12f","4cd5a9f902af4f66a34df35a53630237"]) 

7、按查询条件查询业务对象-find

  • 普通查询:Fx.object.find(<String apiName>,<List<Map> criteria>,<BigDecimal limit>,<BigDecimal skip>) 参数说明:
参数 说明
apiName 对象的api名称
criteria 查询条件
limit 限制查询条数,最大200条,如超过返回200条
skip 分页页数

     data返回值类型:QueryResult

     举例:

def (Boolean error,QueryResult data,String errorMessage) =  Fx.object.find("AccountObj",[["name":"纷享销客"],["create_time": GT(19000000)]],10,1); 
  • 查询并排序:Fx.object.find(<String apiName>,<List<Map> criteria>,<Map orderBy>,<BigDecimal limit>,<BigDecimal skip>) 参数说明:
参数 说明
apiName 对象的api名称
criteria 查询条件
limit 限制查询条数,最大200条,如超过返回200条
orderBy 排序规则 key:按哪个字段排序,字段名称 ;value:1 - 升序,-1 - 降序
skip 分页页数

     data返回值类型:QueryResult

     举例:

def (Boolean error,QueryResult data,String errorMessage) =  Fx.object.find("AccountObj",[["name":"分享逍客"],["create_time": GT(19000000)]],["name":1],10,1);

Fx.object.find方法中的条件语句如下:

说明 代码格式
判断相等 EQ(<Object str>)
判断不相等 NE(<Object str>)
判断大于 GT(<Object str>)
判断小于 LT(<Object str>)
判断大于等于 GTE(<Object str>)
判断小于等于 LTE(<Object str>)
判断是否包含 LIKE(<String str>)
判断不包含 NLIKE(<String str>)
判断属于其中一个 IN(<List str>)
判断不属于其中 NIN(<List list>)
判断字段是否有值 EXISTS(<boolean ex>)

8、作废业务对象-remove

  • 定义:Fx.object.remove(<String apiName>,<String objectDataId>)
  • 参数说明
参数 说明
apiName 对象的api名称
objectDataId 对象实例的ID

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) =  Fx.object.remove("AccountObj","ed47841898054749a2ec9be9e6e5d728")

9、更换负责人-changeOwner

  • 定义:Fx.object.changeOwner(<String ObjectAPIName>,<String ObjectDataId>,<String OwnerId>)
  • 参数说明
参数 说明
apiName 对象的api名称
objectDataId 对象实例的ID
OwnerId 要变更的负责人的用户ID

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.changeOwner("AccountObj","ed47841898054749a2ec9be9e6e5d728","1001")

10、添加团队成员-addTeamMember

  • 定义:Fx.object.addTeamMember(<String ObjectAPIName>,<String ObjectDataId>,<List UserIdList>,<Integer Role>,<Integer Permission>)
  • 参数说明
参数 说明
ObjectAPIName 对象的api名称
ObjectDataId 对象实例的ID
UserIdList 添加的团队成员的用户ID的List
Role 添加的团队成员的角色:1-负责人,2-联合跟进人,3-售后服务人员,4-普通成员
Permission 添加的团队成员的权限:1-只读,2-读写

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.addTeamMember("AccountObj","83cf73d957924284a96e9c44ebb333ec",["1001"],4,1)

     注:不能添加负责人;如果添加的成员包括负责人,则不会修改负责人数据;如果添加的成员在原系统中有重复的则更新该成员


11、删除团队成员-deleteTeamMember

  • 定义:Fx.object.deleteTeamMember(<String ObjectAPIName>,<String ObjectDataId>,<List UserIdList>)
  • 参数说明
参数 说明
ObjectAPIName 对象的api名称
ObjectDataId 对象实例的ID
UserIdList 删除的团队成员的用户ID的List

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.deleteTeamMember("AccountObj","83cf73d957924284a96e9c44ebb333ec",["1001"]) 

12、编辑团队成员-editTeamMember

  • 定义:Fx.object.editTeamMember(<String ObjectAPIName>,<String ObjectDataId>,<List<Map> TeamMemberList>)

  • 参数说明

参数 说明
ObjectAPIName 对象的api名称
ObjectDataId 对象实例的ID
TeamMemberList 要编辑团队成员的信息的List(key值包括:userID:用户ID;role:用户角色;permisson:用户权限,具体参考7)

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.editTeamMember("AccountObj","36fd270a986842529445bf3d252cca9b",[["userId":"1058","role":4,"permission":1],["userId":"1057","role":3,"permission":2]]) 

13、获取团队成员-getTeamMember

  • 定义:Fx.object.getTeamMember(<String objectAPIName>,<String objectId>)
  • 参数说明
参数 说明
objectAPIName 对象的api名称
objectId 对象实例的ID

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.getTeamMember("AccountObj","83cf73d957924284a96e9c44ebb333ec")

14、获取单选/多选业务名称/选项名称-getOptionName

  • 定义:Fx.object.getOptionName(<String objectAPIName>,<String filedAPIName>,<String value>)
  • 参数说明
参数 说明
objectAPIName 对象的api名称
filedAPIName 字段的api名称
value 单选/多选的值

     data返回值类型:Map

  • 举例:
def (Boolean error,Map data,String errorMessage) = Fx.object.getOptionName("AccountObj","lock_status","0")

15、根据映射规则创建数据-copyByRule

  • 根据映射规则新建(不能添加额外的字段):Fx.object.copyByRule(<String sourceApiName>,<String sourceId>,<String ruleApiName>)

      参数说明:

参数 说明
sourceApiName 被映射的对象Api Name
sourceId 被映射的对象实例的ID
ruleApiName 映射规则API Name

     data返回值类型:Map

     举例:

def (Boolean error,Map data,String errorMessage) = Fx.object.copyByRule('object_ejyW2__c','5d308dc0b5a2bf0001b0bfc2','map_btp50__c')
  • 根据映射规则直新建(同时新建从对象):Fx.object.copyByRule(<String sourceApiName>,<String sourceId>,<String ruleApiName>,<Map plus>, <Map detailPlus>)

      参数说明:

参数 说明
sourceApiName 被映射的对象Api Name
sourceId 被映射的对象实例的ID
ruleApiName 映射规则API Name
plus 主对象数据参数
detailPlus 从对象数据参数

     data返回值类型:Map

     举例:

Map plus = ["field_ZszsO__c": "18800154471"];
Map detailValues1 = ["field_z5AI0__c": "data1填充内容"]; 
Map detailValues2 = ["field_z5AI0__c": "data2填充内容"];
List  detailFillValueList= [];
detailFillValueList.add( detailValues1);
detailFillValueList.add( detailValues2);
Map detailPlus = ["object_6hN1i__c": detailFillValueList]
def (Boolean error,Map data,String errorMessage) = Fx.object.copyByRule('object_ob2G0__c','5cedf0137cfed9b33b75ddaa','map_797K4__c',plus,detailPlus)

results matching ""

    No results matching ""