# 管理自定义字段元数据
Udf 是 User Defined Field(用户自定义字段) 的简称。Authing 的数据实体(如用户、角色、分组、组织机构等)可以添加自定义字段,你可以配置 Authing 默认不自带的字段,比如你需要创建以一个学校相关的应用,就可以添加一个自定义 `school` 字段。 同时你可以在用户注册完成之后要求用户补充此字段的信息,详细文档请见 https://docs.authing.co/extensibility/user/extend-register-fields.html 。
# 设置自定义字段元数据
UdfManagementClient().set(targetType, key, dataType, label)
设置自定义字段元数据,如果该字段不存在会自动创建。
# 参数
targetType
<UdfTargetType> 自定义字段目标类型, USER 表示用户、ROLE 表示角色。key
<string> 字段 keydataType
<UdfDataType> 数据类型,目前共支持五种数据类型。STRING 为字符串、NUMBER 为数字、DATETIME 为日期、BOOLEAN 为 boolean 值、OBJECT 为对象。label
<string> 字段 Label,一般是一个 Human Readable 字符串。
# 示例
UserDefinedField udf = managementClient.udf().set(UdfTargetType.USER, "key", UdfDataType.STRING, "label").execute();
# 删除自定义字段
UdfManagementClient().remove(targetType, key)
删除自定义字段
# 参数
targetType
<UdfTargetType> 自定义字段目标类型, USER 表示用户、ROLE 表示角色。key
<string> 字段 key
# 示例
CommonMessage message = managementClient.udf().remove(UdfTargetType.USER, "key").execute();
# 获取自定义字段定义
UdfManagementClient().list(targetType)
查询用户池定义的自定义字段
# 参数
targetType
<UdfTargetType> 自定义字段目标类型, USER 表示用户、ROLE 表示角色。
# 示例
List<UserDefinedField> list = managementClient.udf().list(UdfTargetType.USER).execute();