Extension de la capture d'adresse

Vous pouvez étendre les capacités de capture d'adresses dans Sterling Store Engagement en ajoutant ou en modifiant des modèles de capture d'adresses.

Note : Pour plus d'informations sur la mise en œuvre de la capacité de capture d'adresses, voir Mise en œuvre de la capture et de l'affichage d'adresses.

Ajout d'un nouveau modèle de capture d'adresse

Utilisez la procédure suivante pour ajouter un nouveau modèle de capture d'adresse:

Créez la structure de dossier suivante sous SCREEN_EXTENSIONS_HOME, si elle n'existe pas déjà :SCREEN_EXTENSIONS_HOME/app-common/address/address-capture
Copiez address-extension.module.ts depuis <WORKSPACE>/store-frontend/src/app/app-common/address dans le dossier <WORKSPACE>/store-frontend/store-extensions-src/app/app-common/address .
Les composants et les fournisseurs de modèles de capture d'adresse personnalisés sont déclarés dans ce fichier.

Si address-extension.module.ts est déjà présent, ne copiez pas le fichier.
Pour créer un nouveau modèle de capture d'adresse, procédez comme suit:
1. Exécutez la commande suivante :
```
ng g c app-common/address/address-capture/components/<componentName> --project=store-extensions --skip-import
```
2. Mettez à jour le nom de classe de composant du modèle de capture d'adresse dans les déclarations et la propriété d'exportation du décorateur @NgModule dans address-extension.module.ts.
Enregistrez le nouveau modèle de capture d'adresse dans le fichier de configuration de capture d'adresse (IAddressCaptureConfig). Dans le fichier store-customization-impl.ts , mettez à jour la propriété extensionAddressConfigList avec la spécification JSON, comme illustré dans l'exemple suivant:
```
static extensionAddressConfigList: IAddressConfig[] =  [
          {
              countryCode: 'US',
              tid: 'US',
              captureComponent: USCaptureComponent
          }
]
```

Le tableau suivant répertorie les propriétés du fichier IAddressCaptureConfig .

Tableau 1. Propriétés et descriptions des fichiers de configuration
Propriété	Descriptif
`countryCode {string}`	Obligatoire. Type et identificateur unique du modèle de capture d'adresse.
`tid {string}`	Obligatoire. Identificateur unique pour tester le modèle de capture d'adresse.
`captureComponent {component}`	Facultatif. Référence du composant à afficher pour le modèle de capture d'adresse.
`isDefaultComponent {boolean}`	Facultatif. Indique que ce composant doit être chargé en tant que composant par défaut s'il n'existe pas de composant pour un code code.If n'est pas fourni, il prend les Etats-Unis par défaut.

Modification des modèles de capture d'adresse

Vous pouvez remplacer le composant de modèle de capture d'adresse prêt à l'emploi en fournissant un nouveau composant dans la propriété component du fichier IAddressCaptureConfig .

Vous pouvez utiliser un nouveau composant de modèle de capture d'adresse personnalisé, CustomCaptureComponent, pour un modèle de capture d'adresse existant avec la spécification JSON, comme illustré dans l'exemple suivant:

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

Remarque :

Vous devez vous assurer d'importer la classe de composant de capture d'adresse correspondante dans le fichier address-extension.module.ts .
Vous devez vous assurer que vous effectuez l'importation à partir du dossier store-extensions-src et non à partir du dossier store-app-build .

Définition du modèle de capture d'adresse prêt à l'emploi comme modèle par défaut

Vous pouvez définir le modèle de capture d'adresse prêt à l'emploi comme modèle par défaut en définissant la propriété isDefaultComponent sur true dans le fichier IAddressCaptureConfig .

La spécification JSON permettant de définir un modèle de capture d'adresse comme modèle par défaut est illustrée dans l'exemple suivant:

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

Ajouter ou supprimer et modifier des validations sur les modèles de capture d'adresse prêts à l'emploi

Vous pouvez ajouter ou supprimer et modifier des validations sur les modèles de capture d'adresse prêts à l'emploi en remplaçant le dossier de composant de modèle de capture d'adresse spécifique dans store-extensions-src.