Ampliación de la captura de direcciones

Puede ampliar las capacidades de captura de direcciones en Sterling Store Engagement añadiendo o modificando plantillas de captura de direcciones.

Nota: Para obtener más información sobre la implementación de la función de captura de direcciones, consulte Implementación de la captura y visualización de direcciones.

Adición de una nueva plantilla de captura de dirección

Utilice el procedimiento siguiente para añadir una nueva plantilla de captura de dirección:

Cree la siguiente estructura de carpetas en SCREEN_EXTENSIONS_HOME, si no está ya presente:SCREEN_EXTENSIONS_HOME/app-common/address/address-capture
Copie address-extension.module.ts de <WORKSPACE>/store-frontend/src/app/app-common/address en la carpeta <WORKSPACE>/store-frontend/store-extensions-src/app/app-common/address .
Los componentes y proveedores de la plantilla de captura de dirección personalizada se declaran en este archivo.

Si address-extension.module.ts ya está presente, no copie el archivo.
Para crear una nueva plantilla de captura de dirección, realice los pasos siguientes:
1. Ejecute el mandato siguiente:
```
ng g c app-common/address/address-capture/components/<componentName> --project=store-extensions --skip-import
```
2. Actualice el nombre de clase de componente de plantilla de captura de dirección en la propiedad de declaraciones y exportaciones del decorador @NgModule en address-extension.module.ts.
Registre la nueva plantilla de captura de dirección en el archivo de configuración de captura de dirección (IAddressCaptureConfig). En el archivo store-customization-impl.ts , actualice la propiedad extensionAddressConfigList con la especificación JSON tal como se muestra en el ejemplo siguiente:
```
static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              captureComponent: USCaptureComponent
          }
]
```

En la tabla siguiente se listan las propiedades del archivo IAddressCaptureConfig .

Tabla 1. Propiedades y descripciones de los archivos de configuración
Propiedad	Descripción
`countryCode {string}`	Obligatorio. Tipo e identificador exclusivo para la plantilla de captura de dirección.
`tid {string}`	Obligatorio. Identificador exclusivo para probar la plantilla de captura de dirección.
`captureComponent {component}`	Opcional. Referencia del componente que se representará para la plantilla de captura de dirección.
`isDefaultComponent {boolean}`	Opcional. Indica que esto debe cargarse como el componente predeterminado si el componente no existe para un código code.If , toma US de forma predeterminada.

Modificación de plantillas de captura de dirección

Puede alterar temporalmente el componente de plantilla de captura de direcciones listo para usar proporcionando un nuevo componente en la propiedad component en el archivo IAddressCaptureConfig .

Puede utilizar un nuevo componente de plantilla de captura de dirección personalizada, CustomCaptureComponent, para la plantilla de captura de dirección existente con la especificación JSON tal como se muestra en el ejemplo siguiente:

static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              captureComponent: CustomCaptureComponent
          }
]

Nota:

Debe asegurarse de importar la clase de componente de captura de dirección correspondiente en el archivo address-extension.module.ts .
Debe asegurarse de que está importando desde la carpeta store-extensions-src y no desde la carpeta store-app-build .

Establecimiento de la plantilla de captura de dirección predeterminada como predeterminada

Puede establecer la plantilla de captura de direcciones predeterminada estableciendo la propiedad isDefaultComponent como true en el archivo IAddressCaptureConfig .

La especificación JSON para establecer una plantilla de captura de dirección como valor predeterminado se muestra en el ejemplo siguiente:

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

Añadir o eliminar y cambiar validaciones en las plantillas de captura de direcciones listas para usar

Puede añadir o eliminar y cambiar validaciones en las plantillas de captura de dirección listas para usar sustituyendo la carpeta de componentes de plantilla de captura de dirección específica en store-extensions-src.