地址格式配置

一、功能概述与应用场景

• 适配中国、中国港澳台及海外各国（如美国、英国、东南亚国家等）地址字段差异
• 控制前端新建 / 编辑地址时显示哪些字段、是否必填、是否换行展示
• 自动拼接生成统一格式的 “格式化地址” 文本，便于展示和导出
• 为不同国家 / 地区设置专属默认地址格式，提升录入效率

二、主要操作步骤

步骤 1：进入地址格式页面

1. 进入系统，打开【企业设置】
2. 在【国家地区管理】菜单下，点击【地址格式】进入列表页

• 按名称搜索地址格式
• 按编码、国家 / 地区、状态等字段筛选
• 执行新建、启用 / 禁用、删除操作（删除需先禁用）

步骤 2：新建地址格式（基础信息配置）

1. 点击列表页【新建】按钮
2. 填写基础信息：编码：手动填写唯一标识名称：自定义地址格式名称API Name：系统自动生成，可临时修改，保存后不可修改国家和地区：选择适用的国家 / 地区，支持多选默认格式：选择 “是 / 否”，同一国家 / 地区只能设置一个默认格式，重复设置会触发冲突提示
3. 编码：手动填写唯一标识
4. 名称：自定义地址格式名称
5. API Name：系统自动生成，可临时修改，保存后不可修改
6. 国家和地区：选择适用的国家 / 地区，支持多选
7. 默认格式：选择 “是 / 否”，同一国家 / 地区只能设置一个默认格式，重复设置会触发冲突提示
8. 确认无误后保存基础配置

步骤 3：配置表单格式（控制前端显示样式）

1. 在地址格式编辑页，进入【表单格式】配置页签
2. 从可选地址字段中（不含【国家和地区】、【格式化地址】）进行设置：显示：勾选后字段才会在前端展示必填：勾选后该字段为必填项，提交时校验另起一行：勾选后该字段自动换行展示自定义显示名称：可修改字段名称（如将 “省” 改为 “州”），支持多语翻译长度：选择 “通栏” 占满整行，或 “多栏” 按页面列数自适应
3. 显示：勾选后字段才会在前端展示，勾选后才可以编辑【必填】属性
4. 必填：勾选后该字段为必填项，提交时需校验
5. 另起一行：勾选后该字段自动换行展示。勾选后会有提示“勾选后，该字段将另起一行展示”
6. 自定义显示名称：可修改字段名称（如将 “省” 改为 “州”），支持多语翻译
7. 长度：选择 “通栏” 占满整行，或 “多栏” 按页面列数自适应
8. 使用【预览】功能，可模拟新建编辑页和详情页布局中的显示效果，切换 1/2/3/4 列布局，实时查看配置效果。显示的字段名称为地址格式规则中定义的显示名称，例如：：地址格式中定义了在美国地区“省” 显示名称为 “州”，当国家选择中国时，显示省，选择美国时，显示州

配置表单格式

表单格式预览

步骤 4：配置文本拼接格式（生成格式化地址）

1. 进入【文本拼接格式】配置页签
2. 对各地址字段设置：是否包含：是否参与拼接另起一行：拼接后是否换行使用属性替代：可选择国家 / 地区编码、名称、二字码等，省市区可选用行政区划编码前缀 / 后缀：添加固定文字空格分隔符：勾选后字段间自动加空格
3. 是否包含：是否参与拼接
4. 另起一行：拼接后是否换行
5. 使用属性替代：可选择国家 / 地区编码、名称、二字码等，省市区可选用行政区划编码
6. 前缀 / 后缀：添加固定文字
7. 空格分隔符：勾选后字段间自动加空格
8. 通过【预览】查看最终拼接效果
9. 保存时系统会提示：编辑文本格式仅对新数据生效，历史数据可通过函数处理

文本拼接预览

在详情页显示地址拼接格式

步骤 5：启用、禁用与删除

• 启用 / 禁用：直接在列表页对单条地址格式切换状态
• 删除：需先将地址格式设置为禁用，才可执行删除

三、重要规则说明

1. 同一国家 / 地区仅允许一个默认地址格式，重复设置会报错
2. 修改地址格式不影响历史地址数据，仅对新录入 / 新编辑数据生效
3. 若隐藏已有值的地址字段，历史数据原值保留，再次编辑时不展示该字段但不会清空原值
4. 新增或修改必填字段后，再次编辑历史数据时会触发必填校验
5. 系统已预置中国及港澳台、国际标准地址格式，可直接使用或基于其修改