根据对象ID添加字段 - AddField

Object_id

是

String

参数解释：

对象的ID值，可通过调用查询所有自定义对象 - QueryCustomObject接口查看（响应消息中的“id”）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

新增字段的名称。

约束限制：

创建后不可修改。

取值范围：

必须以英文字母开头，只能由英文字母，数字和单下划线组成，不允许下划线结尾，且长度不能超过63个字符。

默认取值：

不涉及。

label

是

String

参数解释：

新增字段的标签。

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

inlineHelpText

否

String

参数解释：

新增字段的帮助说明。

约束限制：

不涉及。

取值范围：

1~255个字符。

默认取值：

不涉及。

dataLength

是

Int

参数解释：

新增字段的长度。

约束限制：

不涉及。

取值范围：

1~64个字符。

默认取值：

不涉及。

dataType

是

String

参数解释：

新增字段的类型。

约束限制：

创建后不可修改。

取值范围：

• 文本（text）：允许用户输入任何字母和数字的组合，最多可输入255个字符。
• 密文（encryptedtext）：允许用户输入任何字母和数字的组合，并且以加密格式存储，最多可输入111个字符。
• 文本区（textarea）：允许用户输入多行文本，最多可输入1,048,576字符。
• 数字（number）：允许用户输入任何数字，会删除前置零。
• 百分比（percent）：允许用户输入百分比数字（例如"10"），并自动向数字添加百分号。
• 电话（phone）：允许用户输入任何电话号码，系统会自动将其转换为电话号码格式。
• 币种金额（currency）：允许用户输入其他币种金额，并将字段自动转换为币种金额格式。此功能在将数据导出到Excel或其它电子表格时非常有用。
• 日期（date）：允许用户输入日期或从弹出式日历中选择日期。
• 日期/时间（datetime）：允许用户输入日期和时间，或从弹出式日历中选择日期。当用户单击弹出式日历中的某个日期后，该日期和当前时间将输入到“日期/时间”字段。
• 电子邮件（email）：允许用户输入电子邮件地址，对其进行验证以确保格式正确。如果对一个联系人和潜在客户指定了此字段，则用户单击“发送电子邮件”时可以选择地址。自定义电子邮件地址无法用于批量电子邮件。
• 复选框（checkbox）：允许用户选择“真”（选取）或“假”（不选取）值。
• 选项列表（singleselect）：允许用户从定义的列表中选择值。
• 选项列表（多项选择 multiselect）：允许用户从定义的列表中选择多个值。
• URL（url）：允许用户输入任何有效的网址。当用户单击该字段时，该 URL 将在单独的浏览器窗口中打开。
• 查找关系（lookup）：创建一个将此对象连接到另一对象的关系。
• 自动编号（autonumber）：使用用户定义的格式生成序列编号。该编号对于每条新记录会自动递增。
• 公式（formula）：使用用户定义的公式表达式生成只读字段。任何表达式中使用的源字段有所更改，本字段值将更新。
• 主从关系类型（masterdetail）：在一个对象和另一个对象之间创建一种特殊类型的父子关系。详细记录的所有权是由主记录决定的。当用户删除主记录时，所有详细记录都将被删除。
• 多语言（multilanguage）：允许用户从自定义资源表中选择多种语言内容。
• 附件（attachment）：允许用户保存多个上传文件的地址，支持图片、文档等类型。

默认取值：

不涉及。

description

否

String

参数解释：

新增字段的描述信息。

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

defaultValue

否

String

参数解释：

新增字段的默认值。

约束限制：

格式需符合字段类型（dataType）中所配置类型的规则。

取值范围：

不涉及。

默认取值：

不涉及。

caseSensitive

否

Boolean

参数解释：

大小写是否敏感，例如，“ABC”和“abc”为相同值，表示大小写不敏感，“ABC”和“abc”为不同值，则表示大小写敏感。

约束限制：

不涉及。

取值范围：

• true：表示大小写敏感。
• false：表示大小写不敏感。

默认取值：

false。

isRequired

否

Boolean

参数解释：

字段是否必填。

约束限制：

不涉及。

取值范围：

• true：表示字段必填。
• false：表示字段不必填。

默认取值：

false。

isUnique

否

Boolean

参数解释：

字段中数据是否允许重复。

约束限制：

不涉及。

取值范围：

• true：表示字段唯一。
• false：表示字段不唯一。

默认取值：

false。

profiles

否

Array

参数解释：

权限分配。字段级安全配置，配置每个权限对该字段是否可见/可编辑。

约束限制：

不涉及。

layouts

否

Array

参数解释：

对象字段布局页面的名称。

约束限制：

不涉及。

view

否

Object

参数解释：

每项为一个String数组，名为包含该字段的Layout，内容为该Layout包含的字段。

约束限制：

不涉及。

isSearchable

否

Boolean

参数解释：

是否支持使用search语句搜索该字段。

约束限制：

不涉及。

取值范围：

• true：表示字段可搜。
• false：表示字段不可搜索。

默认取值：

false。

resCode

String

参数解释：

返回码。

取值范围：

如果返回“0”代表请求成功，其他错误码说明请参考错误码（数据面）。

resMsg

String

参数解释：

返回消息。

取值范围：

成功返回“成功”，其他情况会返回具体的错误信息。

result

string

参数解释：

成功返回会返回Object的一个ID值。

取值范围：

不涉及。