Fx.tag

Fx.tag:处理标签函数

1. findTagDefine 查询tag定义

Fx.tag.findTagDefine(<String objectApiName>)

参数说明

参数 类型 说明
objectApiName String 对象API名称

返回值类型

APIResult

返回值说明

返回的数据类型: queryResult 返回标签信息:标签id,标签名称,标签API名称,标签描述,标签分组,标签分组apiName

Java举例

APIResult ret  = Fx.tag.findTagDefine("object_76is3__c");
log.info(ret.getData());

Groovy举例

def (Boolean error,QueryResult data,String errorMessage)  = Fx.tag.findTagDefine("object_76is3__c")
log.info(data)

2. findTagById 查找某条数据上的所有标签

Fx.tag.findTagById(<String objectApiName>, <String dataId>)

参数说明

参数 类型 说明
objectApiName String 对象API名称
dataId String 更新标签的数据id

返回值类型

APIResult

返回值说明

返回的数据类型: queryResult 返回标签信息:标签id,标签名称

Java举例

APIResult ret = Fx.tag.findTagById( "NewOpportunityObj", "5f62c3f577187e0001d4a845");
log.info(ret.getData());

Groovy举例

def (Boolean error,List data,String errorMessage) = Fx.tag.findTagById( "NewOpportunityObj", "5f62c3f577187e0001d4a845")
log.info(data)

3. update 更新数据的标签

Fx.tag.update(<String objectApiName>, <String dataId>, <List tagIdList>)

参数说明

参数 类型 说明
objectApiName String 对象API名称
dataId String 更新标签的数据id
tagIdList List 更新到数据的标签id(覆盖更新)

返回值类型

APIResult

返回值说明

返回的数据类型: map(成功后data返回加标签成功的数据id)

Java举例

APIResult ret = Fx.tag.update("object_76is3__c", "5f4dc0100c0ab60001724e74", Lists.newArrayList("5eb4ce6378c8c000018f67a3"));
log.info(ret.getData());

Groovy举例

def (Boolean error,String data,String errorMessage) = Fx.tag.update("object_76is3__c", "5f4dc0100c0ab60001724e74", ["5eb4ce6378c8c000018f67a3"])
log.info(data)

4. createTag 创建标签

Fx.tag.createTag(<TagArg tagArg>)

参数说明

参数 类型 说明
tagArg TagArg 详见以下tag参数说明

返回值类型

APIResult

返回值说明

Java举例

final TagArg arg = TagArg.builder()
        .groupId("5ea3b0e5e1a70b0001e2f65b")
        .tagApiName("tag_scDwW__c")
        .tagName("函数创建标签1-fj")
        .description("test001")
        .build();
final APIResult result = Fx.tag.createTag(arg);

Groovy举例

def arg = TagArg.builder()
        .groupId("5ea3b0e5e1a70b0001e2f65b")
        .tagApiName("tag_scDwW__c")
        .tagName("函数创建标签1-fj")
        .description("test001")
        .build();
def result = Fx.tag.createTag(arg)

(1).参考TagArg


5. updateTag 更新标签

Fx.tag.updateTag(<TagArg tagArg>)

参数说明

参数 类型 说明
tagArg TagArg 详见以下tag参数说明

返回值类型

APIResult

返回值说明

Java举例

TagArg arg = TagArg.builder()
       .tagId("61b950f0fb62ec0001772c63")
       .groupId("5ec78e7f520f4000019ac54a")
       .tagName("函数创建标签03-fj")
       .description("更新标签3")
       .build();
APIResult result = Fx.tag.updateTag(arg);

Groovy举例

def arg = TagArg.builder()
       .tagId("61b950f0fb62ec0001772c63")
       .groupId("5ec78e7f520f4000019ac54a")
       .tagName("函数创建标签03-fj")
       .description("更新标签3")
       .build()
def result = Fx.tag.updateTag(arg)

(1).参考TagArg


6. createTagGroup 创建标签分组

Fx.tag.createTagGroup(<List describe_api_names>, <String api_name>, <Boolean is_applied_to_all>, <String tag_group_name>)

参数说明

参数 类型 说明
describe_api_names List 该标签分组适用的对象列表
api_name String 分组apiName
is_applied_to_all Boolean 是否适用全部对象
tag_group_name String 分组名称

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def (String message,Map data,Boolean error) = Fx.tag.createTagGroup(["AccountObj"],"group_ceshi11__c",false,"测试分组名称123")

7. updateTagGroup 修改标签分组

Fx.tag.updateTagGroup(<String api_name>, <String id>, <List describe_api_names>, <Boolean is_applied_to_all>, <String tag_group_name>)

参数说明

参数 类型 说明
api_name String 分组apiName
id String 标签分组id
describe_api_names List 该标签分组适用的对象列表
is_applied_to_all Boolean 是否适用全部对象
tag_group_name String 分组名称

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def(String message,Map data,Boolean error) = Fx.tag.updateTagGroup("group_ceshi11__c","624272c1babe24000101d2e5",[],true,"更改测试名")

8. deleteTagGroup 删除标签分组

Fx.tag.deleteTagGroup(<String id>)

参数说明

参数 类型 说明
id String 标签分组id

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def(String message,Map data,Boolean error) = Fx.tag.deleteTagGroup("624272c1babe24000101d2e5")

9. enableTag 启用标签

Fx.tag.enableTag(<String tag_api_name>, <String tag_group_api_name>, <String tag_group_id>, <String tag_id>)

参数说明

参数 类型 说明
tag_api_name String 标签apiName
tag_group_api_name String 标签分组apiName
tag_group_id String 标签分组id
tag_id String 标签id

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def result = Fx.tag.enableTag("tag_scDwW__c","group_ceshi11__c","62427820babe24000101d80d","6242784d06e1bf00015f33ec")

10. disableTag 禁用标签

Fx.tag.disableTag(<String tag_api_name>, <String tag_group_api_name>, <String tag_group_id>, <String tag_id>)

参数说明

参数 类型 说明
tag_api_name String 标签apiName
tag_group_api_name String 标签分组apiName
tag_group_id String 标签分组id
tag_id String 标签id

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def result = Fx.tag.disableTag("tag_scDwW__c","group_ceshi11__c","62427820babe24000101d80d","6242784d06e1bf00015f33ec")

11. deleteTag 删除标签

Fx.tag.deleteTag(<String tag_api_name>, <String tag_group_api_name>, <String tag_group_id>, <String tag_id>)

参数说明

参数 类型 说明
tag_api_name String 标签apiName
tag_group_api_name String 标签分组apiName
tag_group_id String 标签分组id
tag_id String 标签id

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def result = Fx.tag.deleteTag("tag_scDwW__c","group_ceshi11__c","62427820babe24000101d80d","6242784d06e1bf00015f33ec")

12. findTagGroup 根据apiName查找标签分组及其适用对象

Fx.tag.findTagGroup(<String group_api_name>)

参数说明

参数 类型 说明
group_api_name String 分组标签apiName

返回值类型

APIResult

返回值说明

返回的数据类型: Map

Groovy举例

def (String message,Map data ,Boolean error) = Fx.tag.findTagGroup("group_ceshi11__c")

13. findTagByTagIds 根据标签id批量查询标签描述

Fx.tag.findTagByTagIds(<List tagIds>)

参数说明

参数 类型 说明
tagIds List 标签id列表

返回值类型

APIResult

返回值说明

List

Java举例

List tagIds = Lists.newArrayList("5fc1dd990680680001fc1903", "64182307b0308f0001ef1164");
APIResult ret = Fx.tag.findTagByTagIds(tagIds);
log.info(ret);
if (ret.isError()) {
  log.info(ret.message());
} else{
  log.info(ret.getData());
}

Groovy举例

List tagIds = ["5fc1dd990680680001fc1903", "64182307b0308f0001ef1164"]
def(Boolean error, Map data, String message) = Fx.tag.findTagByTagIds(tagIds)
if (error) {
    log.info("error:" + message)
}
log.info(data)

参考类 com.fxiaoke.functions.model.TagArg

字段说明

参数 类型 说明
groupId String 标签组id
groupApiName String 可选参数,
tagName String 标签名称
tagApiName String 标签apiName
tagId String 标签id
description String 描述
2024-09-15
0 1