Vous êtes ici :
Gestion des erreurs d’importation/exportation dans B2C Commerce
Tous les processus d'importation, d'exportation et de validation journalisent les événements. Les journaux des événements sont accessibles via WebDAV sur le partage d'importation et d'exportation de votre cartridge. Cette rubrique concerne B2C Commerce.
Exemple :
https://<instance>/on/demandware.servlet/webdav/<organization>/ Impex/log.
Gestionnaire des transferts de fichiers est requis pour accéder à ce partage. Cliquez sur . Sélectionnez WebDAV_Transfert_Fichier.
Il est possible de consulter les journaux des événements se rapportant à des processus déclenchés via Business Manager.
Cliquez sur . Dans la section Accès WebDAV, cliquez sur le lien Journaux des événements pour accéder aux journaux système et personnalisés généraux et sur le lien Importer/exporter pour accéder aux journaux se rapportant aux processus d'importation et d'exportation.
Pour les processus d'importation et d'exportation, il est important de distinguer les erreurs de traitement des erreurs de données.
Résumé des enregistrements
B2C Commerce consigne un message Starting Import pour tous les processus d’importation. Pour les importations de catalogues, elle inscrit aussi un message Phase 1 - Items et Phase 2 - Relations. Pour chaque type d'élément, le message suivant s'imprime :
Processed N <type name> elements successfullyoù :
-
N - est le nombre d'éléments traités
- <type name>
- est le nom du type de données (produit, catalogue, etc.)
Est également communiqué le nombre total d'éléments :
Processed N total elements Erreurs de traitement
Des erreurs de traitement peuvent se produire au cours des processus d'importation et d'exportation. Exemples : paramètres de traitement manquants ou incorrects, problèmes pendant les verrouillages, flux XML mal formés et erreurs système générales. Les erreurs de traitement peuvent empêcher le démarrage du processus d'importation ou d'exportation, ou provoquer son interruption immédiate en cours d'exécution.
Erreurs de données
Les erreurs et les avertissements de données sont provoqués par les flux et se produisent uniquement lors d'une importation. Ils sont locaux et se rapportent toujours à un élément du flux. En cas d'erreur ou d'avertissement de données, le processus d'importation n'est pas interrompu ; l'élément incorrect est simplement ignoré. Par conséquent, un processus d'importation peut se terminer sans erreur de traitement mais avec une erreur de données. Les problèmes liés aux données sont classés dans deux catégories DATAERROR ou DATAWARNING. Les détails concernant l'emplacement et l'origine de l'erreur ou de l'avertissement sont fournis dans le journal des événements.
| Type d'erreur | Description |
|---|---|
| DATAERROR | Consignée lorsqu'un élément du flux (une catégorie ou un produit, par exemple) n'a pas pu être traité du tout. Par exemple, il manquait un attribut ID obligatoire dans l'élément. Il ne peut y avoir qu'une seule erreur de type DATAERROR consignée par élément dans un flux d'importation. |
| DATAWARNING | Indique d'un élément a été traité, mais partiellement seulement. Par exemple, un élément du flux se présente avec un attribut personnalisé, mais cet attribut n'est pas défini dans le système. Dans ce cas, l'attribut personnalisé est ignoré. Autre exemple, un produit fait référence à une catégorie de classification qui n'existe pas. Dans ce cas, aucune catégorie de classification n'est définie pour le produit. Il peut y avoir plusieurs erreurs de type DATAWARNING par élément dans un flux d'importation. L'emploi d'éléments ou de sous-éléments obsolètes est consigné comme DATAWARNING. |
Grâce à l'objet Status, il est facile de connaître le nombre d'erreurs de type DATAERROR et DATAWARNING dans les pipelets d'importation.
Dans l'exemple suivant, un script utilise l'objet status pour compter les erreurs.
var dataErrors : Number = status.details.DataErrorCount; var dataWarnings : Number = status.details.DataWarningCount;
Pour vérifier la réussite d'un processus d'importation automatisé, mieux vaut commencer par rechercher les erreurs de traitement, puis les erreurs DATAERROR, comme l'indique le code de script suivant.
var success : boolean = (status.code == 'IMPEX-0') && (status.details.DataErrorCount == 0);
Le code ne doit pas traiter l'occurrence d'erreurs DATAWARNING comme une erreur inattendue, car un flux qui ne provoque pas d'erreurs DATAWARNING aujourd'hui pourrait en provoquer dans une version ultérieure de B2C Commerce (par exemple, un élément peut devenir obsolète ou une règle peut être mise à jour).
