Avancé : gestion des entités
Configurer les entités
Les entités représentent les tables présentent dans Prestashop et qui sont synchronisées avec Business Central.
Pour accéder à la liste des entités, recherchez la page Entités.
Dans le cadre d'un usage avancé, vous pouvez venir modifier les paramètres associés aux entités.
Vous trouverez tout d'abord des options qui permettent de gérer le comportement à l'import des données depuis Prestashop :
Ainsi, le Mode de récupération est utilisé lors de l'import de données venant de Prestashop. Certains entités ont leur modification horodatée et, dans ce cas, CAP Online - Webshop va récupérer uniquement les modifications apportées depuis la dernière synchronisation. Ce mode est celui préféré sur les entités lorsque vous choisissez l'option Par défaut. Vous pouvez aussi basculer sur l'option Complète auquel cas tous les éléments sont récupérés à chaque synchronisation. Certaines entités utilisent de toute façon ce mode mais vous pourriez vouloir l'activer ponctuellement même pour des entités qui supporte la synchronisation différentielle.
La Requête de récupération permet de filtrer les éléments lues depuis Prestashop. Elle vient s'ajouter au Mode de récupération. Pour plus d'information sur la construction de cette requête, référez-vous au paragraphe Filtrer les éléments récupérés de Prestashop.
Conseil
Pour éditer plus facilement la requête de récupération, utilisez le bouton ... et posez vos filtres individuellement sur chaque champ de l'entité.
Le champ Gestion des messages entrants spécifie un objet de développement qui est en charge de traiter l'entité Prestashop pour la ramener dans Business Central.
Vous trouverez tout d'abord des options qui permettent de gérer le comportement à l'export des données vers Prestashop :
Le champ Gestion des messages sortants spécifie un objet de développement qui est en charge de traiter un enregistrement Business Central pour l'envoyer à Prestashop.
Les options Synchroniser à l'insertion, Synchroniser à la modification, Synchroniser à la suppression, spécifient si lors de ces événements dans Business Central un message sortant doit être émis à Prestashop. Vous pourriez par exemple, ne pas souhaitez que la suppression d'un élément dans Business Central vienne le supprimer dans Prestashop. Auquel cas, décochez Synchroniser à la suppression.
L'option Synchronisation synchrone envoie immédiatement le message de mise à jour à Prestashop au lieu de le faire traiter en arrière-plan par la file des messages sortants. Cette option est pratique pour identifiant un problème de synchronisation mais ralenti les interactions utilisateurs et est donc déconseillée en production.
Associer les entités manuellement avec Business Central
Les entités correspondent aux tables de la base de données de Prestashop. Les données de ces tables sont synchronisées avec Business Central. Toutefois, certains entités ne sont pas disponibles en tant que services web et, lors de la première synchronisation, vous pourriez avoir les mêmes données dans Business Central et dans Prestashop que vous ne voudriez pas voir être recréées.
Ainsi, avant de réaliser les premières synchronisations automatiques, vous pourriez vouloir faire correspondre des enregistrements de Business Central avec les identifiants de Prestashop.
Pour créer une correspondance manuelle,
- Recherchez la page Entités.
- Sélectionnez l'entité (par exemple Genre).
- Dans la barre d'actions, choisissez Enregistrements d'intégrations.
- Pour chaque élément à faire correspondre,
- dans le champ ID entité indiquez l'identifiant de l'élément dans Prestashop.
- cliquez dans le champ Enregistrement et sélectionnez l'élément correspond dans Business Central.
Important
Vous devrez créer une correspondance manuelle pour l'entité Genre car elle n'est pas proposée en tant que service web par Prestashop.
Configuration avancée
Pour les utilisateurs avancés, vous pouvez définir des paramètres permettant de régler finement le comportement de l'interface avec Prestashop. Ce paragraphe détaille quelques exemples d'utilisation.
Filtrer les éléments récupérés de Prestashop
Vous pouvez filtrer les enregistrements récupérés de Prestashop. Par exemple, pour ne récupérer que les commandes à partir d'une certaine date. Pour ce faire,
- Ouvrez la page des Entités.
- Affichez la colonne Requête de récupération.
- Adaptez le filtre selon la syntaxe décrite dans la documentation de Prestashop.
Exemples de filtres
La requête ci-dessous s'applique aux commandes et limite la synchronisation aux commandes créées entre le 1er janvier 2019 et le 1er janvier 2119.
filter[date_add]=[2019-01-01 00:00:00,2119-01-01 00:00:00]&date=1
La requête ci-dessous s'applique aux commandes et limite la synchronisation aux commandes dont l'ID est compris entre 50000 et 999999999.
filter[id]=[50000,999999999]