1 简介 

1.1 功能介绍 

苍穹平台为支持复杂的国际化地址应用场景，提供了专业的地址管理特性，包括地址格式配置，支持各种地址格式录入和查看的“地址控件”，以及结构化集中存储的地址基础资料。

基于地址格式配置，地址控件可以支持各种格式的地址信息录入和查看（关于如何配置地址格式，请参考用户手册: 地址格式）。通过地址控件录入的地址信息将会以结构化的方式集中存储于地址库，也可以根据业务需求拼接成不同的地址文本输出，用于支持跨境电商、物流、税务和供应链等领域的国际化业务应用。

在苍穹“地址”控件内还可以使用地图组件，通过搜索、联想、点选、自动填充的界面交互，大幅加快地址修改和录入效率。

使用前提：需要系统管理员提前注册第三方地图接口、配置接口信息。详情请参考：地址管理设置

1.2 应用场景 

在业务领域中，地址是很重要的数据和信息。例如，客户和供应商地址、组织注册地址、物流和订单收货地址等。这些地址数据需要准确维护，否则可能会导致不利的业务影响，例如货物发错地址、由于地址错误而没有正确识别出应该缴纳的当地税种。由于不同国家或地区地址格式的差异性，可以设置不同的地址格式来帮助录入正确的地址信息，避免因为没有遵循正确的国家地址格式，从而导致地址错误的问题。其次，地址格式支持引用行政区划基础资料作为地址的组成部分，如果配置地址格式时选择引用行政区划，可以在一定程度上避免手工录入错误数据的。

通过地址控件录入的地址信息支持以结构化方式存储，而地址的本质决定了这些结构化的字段通常是层次化的。层次化的结构经常会与业务管理维度密切相关，使用地址控件，可以支持在列表中使用这些层级化的字段来筛选和查看业务数据：全球总部需要按国家查看业务数据；中国总部需要按省查看业务数据；省级机构需要按市查看数据。

当用户录入地址时，可以通过地图功能搜索目的地。苍穹地图接口通过对接这些第三方地图接口，实现在系统内快速搜索地址，将结构化的地址数据解析后自动填入对应的字段（例如：省、市、县、详细地址、经纬度等），无需用户逐个字段手工选择录入，以提升地址录入效率。

注：地址控件同时支持PC端和移动端单据。

1.3 字段/按钮说明 

2 主要操作 

2.1  在单据上录入和查看地址数据 

1. 首先通过设计器在单据上添加地址控件（具体操作请参考开发指引：如何在单据上添加地址控件），并且预先配置好地址格式，如“亚马逊地址格式-日本”（具体操作请参考用户手册：地址格式）；

2. 点击单据上的地址控件，可以在弹窗内录入地址信息。依次选择“国家或地区”和“地址格式”后，弹窗将加载符合“亚马逊地址格式-日本”格式的地址字段。 

用户还可以通过地图组件录入地址，具体参考章节 2.3。

注：地址控件中的经度、纬度字段暂时不支持录入0值。

3. 地址信息录入后，点击“确定”关闭弹窗，可以在国际化地址字段上完整的以日本地址格式显示的地址信息。

2.2 在列表中查看地址数据

1. 地址控件中所有字段都可以添加至列表显示，包括所有地址字段和根据文本格式拼接的地址文本（具体操作请参考开发指引：如何在单据上添加地址控件），可以支持筛选结构化的字段查看业务数据的需求，比如销售部门查看不同省、市、县的销售数据、跨国公司查看不同国家或地区的业务数据等等。 

2.3 使用地图组件录入地址

1. 点击单据上的国际地址控件，打开地址信息录入窗口。在地址字段下部的地图组件内用关键字搜索想要录入的地址信息，如“金蝶”，搜索框将显示与关键字相关的地址，点击选中想要录入或更新的地址。 

2. 选中的地址将显示在地图中，并自动填充地址字段。用户可以在地图上确认地址是否为预期结果，根据需要修改地址信息。

2.4 使用地址输入提示录入地址

在地址控件上输入地址关键字，控件将根据关键字检索苍穹地址库基础资料中已有的地址和第三方地址数据（通过预先设置的地图接口）;在检索结果中选中地址后，地址数据将结构化填充至地址控件。

注意：可以通过展现格式区分已有地址和第三方地址数据：

• 地址库已有的地址按照用户定义的地址格式呈现，如： “xx省+xx市+xx县+详细地址”

• 第三方地址数据格式为：目标地址+所在省市县

更多地址控件使用技巧，参考视频介绍：国际化地址控件介绍

2.5 移动端单据录入地址数据

移动端单据也可以使用地址控件，地址录入操作与PC端类似。