Tutoriel : comment mapper un champ produit natif EBP sur un champ non natif WooCommerce ?

Cet article est un tutoriel, pas à pas, pour montrer un exemple avancé d'utilisation du SDK E-connecteur pour personnaliser les données traitées dans le flux produit.

Voici le contexte de ce tutoriel : vous utilisez la gestion commerciale EBP dont la fiche article contient le code barre du produit. WooCommerce n'ayant pas de champ natif pour un code barre, E-connecteur ne synchronise pas nativement cette information et vous ne pouvez pas simplement cocher une case dans l'assistant de configuration pour activer l'envoi.

Pour ce tutoriel, votre agence web a ajouté un module qui permet de gérer le code barre dans WooCommerce, et celui-ci a ajouté dans l'API REST WooCommece un champ "ean" directement à la racine de l'objet product.

Ce tutoriel ne traite pas le cas des variations produit, ni de l'ajout des champs dans WooCommerce avec le module WordPress ACF, qui est géré de manière spécifique (voir cet article : Est-ce qu'E-connecteur supporte l'extension WordPress ACF ?).

Pour mettre en œuvre ce tutoriel, vous devez avoir les connaissances de base suivantes :

• trouver le nom d'une colonne dans une table SQL Server EBP, et savoir faire un SELECT basique,
• faire une requête en lecture sur la méthode product de l'API REST WooCommerce, avec votre outil préféré (Postman, Insomnia, etc.).

Cet exemple est applicable sur toutes les éditions E-connecteur, sauf les anciennes éditions commerciales Standard et Pro. Si vous avez besoin d'assistance, comme tous les développements basés sur le SDK E-connecteur est possible si vous disposez d'un contrat au temps passé "CTP", le temps d'assistance étant décompté de ce contrat.

Etape 1 : trouver le nom de la variable WooCommerce

Avec votre client REST habituel (Postman, Insomnia, ...), ou bien dans la documentation du module utilisé, identifiez le nom de la variable de la méthode product de l'API REST WooCommerce.

Dans notre cas, ce champ s'appelle "ean".

Etape 2 : trouver le nom de la colonne EBP

Il est nécessaire de trouver, dans la table Item d'EBP la colonne SQL souhaitée, dans notre cas, il s'agit de la colonne "BarCode". 

Etape 3 : compléter la requête SQL E-connecteur avec le mappage

Dans la configuration E-connecteur, onglet "SDK" puis "Sélection complémentaire : extra_sql_select", il faut renseigner "i.BarCode as xx_ean" :

• "i." permet de spécifier la table EBP Item, sans risque d'ambiguïté sur le nom de la colonne,
• "BarCode" permet de spécifier le nom de la colonne SQL EBP à utiliser,
• "xx_" permet à E-connecteur de détecter que le champ doit être traité comme un champ personnalisé,
• "ean" permet d'inidquer le nom du champ côté WooCommerce.