为目标国家或地区配置动态地址字段的表单格式和文本拼接格式。
开始之前
- 已在国家地区管理中准备目标国家或地区及所需行政区划。
- 当前账号能够访问 管理后台 > 企业设置 > 地址格式，并能够配置目标对象。
- 业务对象使用 动态地址 类型字段；普通地区定位字段不会套用地址格式。
新建地址格式
- 进入 管理后台 > 企业设置 > 地址格式，点击新建。
- 填写地址格式名称和
apiName。 - 选择适用的一个或多个国家或地区。
- 确认是否设为默认格式。同一国家或地区可以有多套格式，但只能有一套默认格式。
- 完成表单格式和文本拼接格式后保存。
配置表单格式
表单格式控制动态地址字段在新建、编辑和详情页中的结构：
- 勾选需要显示的地址子字段。
- 根据业务规则设置必填；新增必填项会在历史记录再次编辑时触发校验。
- 调整显示名称。不同国家可把同一字段显示为“省”“州”等，显示名称支持多语言。
- 设置是否另起一行、显示宽度，并拖动调整顺序。
- 点击 表单格式预览，检查目标页面效果。
配置文本拼接格式
文本拼接格式用于生成列表、打印、导出或接口中需要的格式化地址：
- 选择参与拼接的字段。
- 设置字段顺序、换行、空格以及前缀或后缀。
- 对选项字段按需要启用“使用属性替代”，例如用国家代码替代国家名称。
- 查看文本拼接预览，确认空字段、邮编和多行地址的结果。
- 保存并启用地址格式。
在业务对象中使用
- 为目标对象创建一个 动态地址 类型字段，并加入新建编辑、详情和列表布局。
- 使用普通员工账号新建记录，选择目标国家或地区。
- 确认系统采用该国家的默认格式，并允许在存在多套启用格式时切换。
- 填写地址并保存，检查结构化子字段和格式化地址。
- 再次编辑、查看列表并导出，核对展示和拼接结果。
历史数据和停用规则
- 修改地址格式不会批量改写历史地址；新录入或再次编辑时才使用最新规则。
- 隐藏已有值的子字段不会清空历史值，但再次编辑时不再展示该字段。
- 禁用地址格式后，新填写地址时不能再选择；删除前必须先禁用。
- 一个对象最多只能创建一个动态地址字段，已禁用字段也计入数量限制。
[!WARNING]
地址格式可能被打印、物流、清关、支付校验和外部接口使用。修改字段顺序或拼接规则前，应回归这些下游场景。
排查
- 新建记录时没有套用预期格式：确认所选国家或地区已关联该格式、格式已启用，并且该国家存在且只存在一套默认格式。
- 页面仍显示普通地址控件：确认对象字段类型是 动态地址，而不是普通地区定位字段，并检查字段已加入相应布局。
- 修改格式后历史记录没有变化：这是正常行为；历史地址不会被批量改写，应新建测试记录或重新编辑历史记录验证。
- 列表、打印或导出结果与表单不同：分别检查 表单格式 和 文本拼接格式，并核对字段顺序、空格、换行、前后缀和“使用属性替代”。
- 无法删除格式：先确认格式已禁用且没有仍在使用的约束；生产删除前保留配置和影响对象清单。