扩展地址显示

您可以通过添加或修改地址显示模板来扩展 Sterling Store Engagement 的地址显示功能。

注：有关实现地址显示功能的更多信息，请参阅《实现地址捕获与显示》。

添加新的地址显示模板

使用以下过程来添加新的地址显示模板:

在 SCREEN_EXTENSIONS_HOME 下创建以下文件夹结构（如果还没有）： SCREEN_EXTENSIONS_HOME/app-common/address/address-display
将 address-extension.module.ts 从 <WORKSPACE>/store-frontend/src/app/app-common/address 复制到 <WORKSPACE>/store-frontend/store-extensions-src/app/app-common/address 文件夹。
此文件中声明了定制地址显示模板组件和提供程序。

如果 address-extension.module.ts 已存在，那么请勿复制该文件。
要创建新的地址显示模板，请执行以下步骤:
1. 运行以下命令：
```
ng g c app-common/address/address-display/components/<componentName> 
--project=store-extensions --skip-import
```
2. 更新 address-extension.module.ts中 @NgModule 修饰符的声明和导出属性中的地址显示模板组件类名。

在地址显示配置 (IAddressDisplayConfig) 文件中注册新的地址显示模板。在 store-customization-impl.ts 文件中，使用 JSON 规范更新 extensionAddressConfigList 属性，如以下示例中所示:

static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              displayComponent: USDisplayComponent
          }
]

下表列出了 IAddressDisplayConfig 属性文件中的属性:

表 1. 配置文件属性和说明
属性	描述
`countryCode {string}`	必需。地址显示模板的类型和唯一标识。
`tid {string}`	必需。用于测试地址显示模板的唯一标识。
`displayComponent {component}`	可选。要为地址显示模板呈现的组件的引用。
`isDefaultComponent {boolean}`	可选。指示如果特定国家或地区 code.If ，那么缺省情况下将采用 US。

修改地址显示模板

您可以通过在 IAddressDisplayConfig 文件的 component 属性中提供新组件来覆盖现成地址显示模板组件。

您可以将新的定制地址显示模板组件 CustomDisplayComponent用于具有 JSON 规范的现有地址显示模板，如以下示例中所示:

static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              displayComponent: CustomDisplayComponent
          }
]

注：

您必须确保将相应的地址显示组件类导入到 address-extension.module.ts 文件中。
您必须确保是从 store-extensions-src 文件夹导入，而不是从 store-app-build 文件夹导入。

将现成地址显示模板设置为缺省值

您可以通过在 IAddressDisplayConfig 文件中将 isDefaultComponent 属性设置为 true ，将现成可用的地址显示模板设置为缺省值。

以下示例中显示了用于将地址显示模板设置为缺省值的 JSON 规范:

static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              displayComponent: USDisplayComponent,
              isDefaultComponent: true
          }
]

在现成地址显示模板上添加或除去以及更改验证

您可以通过替换 store-extensions-src中的特定地址显示模板组件文件夹，在现成可用的地址显示模板上添加或除去以及更改验证。