组织字段用于保存一个选中的组织。当记录需要标识公司、分支、法人主体或其他组织单元时，可以使用组织字段。
如果字段值应该来自租户的组织结构，建议使用组织字段，而不是通用的关联搜索字段。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签，必填；名称应清楚表达这个组织的角色 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填 |
| 必填 | 保存记录前必须选择一个组织 |
| 只读 | 展示已选择的组织，但不允许用户修改 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存所选组织，但不在常规表单页面展示 |
组织字段配置
| 配置项 | 说明 |
|---|
| 占位提示 | 用户选择组织前显示在字段中的提示文案 |
| 显示搜索 | 允许用户在选择组织时搜索 |
| 仅启用组织 | 只展示启用中的组织作为可选项；已选中的停用组织仍然保持有效 |
| 校验时机 | 控制什么时候执行组织校验：值变更时、失焦时或提交记录时 |
| 输入状态 | 给字段添加警告或错误等视觉状态 |
| 无效组织提示 | 所选组织无效或不可用时显示的自定义提示 |
| 颜色 | 设置字段展示颜色 |
| 帮助文案 | 展示在字段附近的辅助说明；可用于说明应该选择哪个组织 |
常见示例
| 场景 | 字段含义 |
|---|
| 合同主体 | 合同关联的组织 |
| 所属组织 | 拥有这条记录的组织 |
| 结算组织 | 用于账务或结算的组织 |
| 统计组织 | 报表统计使用的组织 |
配置建议
| 建议 | 说明 |
|---|
| 使用具体名称 | 例如所属组织、结算组织，比只写组织更清楚 |
| 大组织结构开启搜索 | 搜索能帮助用户快速找到正确组织 |
| 常规场景保持仅启用 | 避免用户为新记录选择已经停用的组织 |