Comment utiliser App Connect avec Magento
Les informations suivantes décrivent comment utiliser App Connect pour connecter Magento à vos autres applications.
Versions du produit et de l'API prises en charge
Pour connaître les versions de produit et d'API prises en charge par ce connecteur, consultez la section Configuration système requise détaillée sur la page Assistance d' IBM.
Se connecter à Magento
Pour connecter App Connect à un compte Magento il faut fournir les détails de connexion suivants.
- Magasin URL
- Spécifiez le Magento le magasin URL, qui est la base URL avec ou sans barre oblique finale (/); par exemple,
http://example.com/magento/. - Nom d'utilisateur
- Indiquez le nom d'utilisateur d'un utilisateur ayant des privilèges d'administrateur pour votre compte Magento compte.
- Mot de passe
- Indiquez le mot de passe de votre Magento compte.
- Connexion à un réseau privé
Sélectionnez le nom d'un agent de réseau privé qui App Connect utilise pour se connecter à votre réseau privé. Cette liste est alimentée par les noms des agents de réseaux privés créés sur la page Réseaux privés. Pour plus d'informations, voir Connexion à un réseau privé.
Pour vous connecter à un Magento point de terminaison à partir de la page (Connecter > Applications et API) (anciennement Catalog (Catalogue)) de App Connect Designer pour la première fois, développez Magento, puis cliquez sur Connect (Connecter). Pour plus d'informations, voir Gestion des comptes.
Avant d'utiliser le compte créé dans App Connect dans un flux, renommez le compte en quelque chose de significatif qui vous aidera à l'identifier. Pour renommer le compte sur la page Applications et API, sélectionnez le compte, ouvrez son menu d'options (⋮), puis cliquez sur Renommer le compte.
Ce qu'il faut prendre en compte en premier lieu
Avant d'utiliser App Connect avec Magento il faut tenir compte des considérations suivantes.
- (Considération générale) Vous pouvez consulter les listes des événements déclencheurs et des actions disponibles sur la page Applications et API du concepteur App Connect.
Pour certaines applications, les événements et les actions dépendent de l'environnement et de la prise en charge par le connecteur des événements configurables et de la découverte dynamique des actions. Si l'application prend en charge les événements configurables, un lien Afficher plus d'événements configurables apparaît sous la liste des événements. Si l'application prend en charge la découverte dynamique des actions, un lien Afficher plus apparaît sous la liste des actions.
- (Considération générale) Si vous utilisez plusieurs comptes pour une application, l'ensemble des champs affichés lorsque vous sélectionnez une action pour cette application peut varier d'un compte à l'autre. Dans l'éditeur de flux, certaines applications fournissent toujours un ensemble de champs statiques pour une action. D'autres applications utilisent la découverte dynamique pour récupérer l'ensemble des champs configurés sur l'instance à laquelle vous êtes connecté. Par exemple, si vous avez deux comptes pour deux instances d'une application, le premier compte peut utiliser des paramètres prêts à être utilisés immédiatement. Cependant, le deuxième compte peut être configuré avec des champs personnalisés supplémentaires.
- Le connecteur Magento a été développé et vérifié avec Magento Open Source 2.2.5.
- Si vous souhaitez qu'un événement dans Magento déclenche des flux dans App Connect configurez et activez un webhook dans Magento. Un rappel de webhook URL qui est fourni sur le nœud d'événement Magento nœud d'événement dans un App Connect flux. Pour plus d'informations, consultez la section Magento Personnalisation de la prise en charge des webhooks ou Qu'est-ce que les webhooks dans Magento?Note : Un webhook URL est associé à un compte. Par conséquent, tous les flux qui utilisent ce compte ont le même webhook URL et sont déclenchés lorsqu'un événement se produit.
L'exemple suivant montre un rappel de webhook URL dans App Connect.
https://des-01-quickstart-ma-designer-webhook-appconnect.dev.apps.appconnect.5loc.p2.openshiftapps.com/webhooks/magento/newcart/uoXVy1CbfVfgvMb87DkKq9eMeeUUSwFks-xBzVpVeAE- des-01-quickstart-ma-designer-webhook-appconnect-dev.apps.appconnect.5loc.p2.openshiftapps.com est la base URL
- magento est le nom de l'application
- newcart est l'événement
- uoXVy1CbfVfgvMb87DkKq9eMeeUUSwFks-xBzVpVeAE est le suffixe du webhook URL
- Dans un App Connect vous pouvez utiliser les actions Magento pour créer ou mettre à jour les objets suivants avec des attributs personnalisés :
- Category (Catégorie)
- Client
- Produit
Les noms et les types d'attributs personnalisés n'ont pas besoin d'être configurés dans Magento avant l'exécution du flux.
- Dans un App Connect vous pouvez utiliser les actions Magento pour créer ou mettre à jour les objets suivants avec des attributs d'extension :
- Category (Catégorie)
- Groupe de clients
- Note de crédit sur les ventes
- Facture de vente
- Bon de commande
- Règle de vente
- Coupon de la règle de vente
- Expédition des ventes
Les noms et types d'attributs d'extension doivent être configurés dans le point d'arrivée avant l'exécution du flux Magento avant l'exécution du flux.
Événements et actions
Magento événements
Ces événements concernent les modifications apportées à l'application qui déclenchent l'exécution des actions prévues dans le flux.
| Objet | Evénement | Descriptif |
|---|---|---|
| Paniers | Panier supprimé | Se déclenche lorsqu'un panier est supprimé dans Magento |
| Nouveau panier | Se déclenche lorsqu'un panier est créé dans Magento | |
| Panier mis à jour | Se déclenche lorsqu'un panier est modifié dans l' Magento | |
| Catégories | Catégorie supprimée | Se déclenche lorsqu'une catégorie est supprimée dans Magento |
| Nouvelle catégorie | Se déclenche lorsqu'une nouvelle catégorie est créée dans Magento | |
| Catégorie mise à jour | Se déclenche lorsqu'une catégorie est modifiée dans l' Magento | |
| Clients | Client supprimé | Se déclenche lorsqu'un client est supprimé dans l' Magento |
| New Customer (nouveau client) | Se déclenche lorsqu'un nouveau client est créé dans Magento | |
| Client mis à jour | Se déclenche lorsqu'un client est modifié dans l' Magento | |
| Produits | Produit supprimé | Se déclenche lorsqu'un produit est supprimé dans l' Magento |
| Nouveau produit | Se déclenche lorsqu'un nouveau produit est créé dans Magento | |
| Produit mis à jour | Se déclenche lorsqu'un produit est modifié dans l' Magento | |
| Avis de crédit commercial | Avoir commercial supprimé | Se déclenche lorsqu'un avoir commercial est supprimé dans l' Magento |
| Nouvelle note de crédit commerciale | Se déclenche lorsqu'un nouvel avoir commercial est créé dans l' Magento | |
| Note de crédit de vente mise à jour | Se déclenche lorsqu'un avoir commercial est modifié dans l' Magento | |
| Factures de vente | Facture de vente supprimée | Se déclenche lorsqu'une facture de vente est supprimée dans l' Magento |
| Nouvelle facture de vente | Se déclenche lorsqu'une nouvelle facture de vente est créée dans l' Magento | |
| Facture de vente mise à jour | Se déclenche lorsqu'une facture de vente est modifiée dans l' Magento | |
| Commandes | Commande client supprimée | Se déclenche lorsqu'une commande client est supprimée dans l' Magento |
| Nouvelle commande | Se déclenche lorsqu'une nouvelle commande client est créée dans l' Magento | |
| Commande client mise à jour | Se déclenche lorsqu'une commande client est modifiée dans l' Magento | |
| Expéditions commerciales | Expédition de vente supprimée | Se déclenche lorsqu'une expédition commerciale est supprimée dans l' Magento |
| Nouvelle expédition commerciale | Se déclenche lorsqu'une nouvelle expédition commerciale est créée dans l' Magento | |
| Expédition des ventes mise à jour | Se déclenche lorsqu'une expédition commerciale est modifiée dans l' Magento |
Magento actions
Votre flux accomplit ces actions sur cette application.
| Objet | Opération | Descriptif |
|---|---|---|
| Ensembles d'attributs | Récupérer les ensembles d'attributs | Récupère un ensemble d'attributs à partir d' Magento |
| Paniers | Créer un panier | Crée un panier vide et un devis pour un client spécifié si celui-ci n'a pas encore de panier. |
| Récupérer les paniers | Récupère les chariots | |
| Catégories | Créer une catégorie | Crée une catégorie dans Magento |
| Supprimer la catégorie | Supprime une catégorie d' Magento | |
| Récupérer les catégories | Récupère une catégorie à partir de Magento en utilisant son identifiant | |
| Mettre à jour la catégorie | Mise à jour d'une catégorie dans Magento | |
| Groupes de clients | Créer un groupe de clients | Crée un groupe de clients |
| Supprimer un groupe de clients | Supprime un groupe de clients par ID. | |
| Récupérer les groupes de clients | Récupère les groupes de clients | |
| Mettre à jour le groupe de clients | Mise à jour des noms des groupes de clients | |
| Clients | Créer un client | Crée un client dans l' Magento |
| Supprimer un client | Supprime un client d' Magento | |
| Récupérer les clients | Récupère un client à partir de Magento | |
| Mettre à jour un client | Mise à jour d'un client dans l' Magento | |
| Produits | Créer un produit | Crée un produit avec un ensemble d'attributs dans l' Magento |
| Supprimer le produit | Supprime un produit d' Magento | |
| Récupérer les produits | Récupère un produit à partir de Magento | |
| Mettre à jour ou créer un produit | Mise à jour d'un produit s'il existe dans Magento, ou création d'un nouveau produit | |
| Avis de crédit commercial | Créer une note de crédit commerciale | Crée une note de crédit commerciale dans l' Magento |
| Récupérer les notes de crédit commerciales | Récupère un avoir commercial à partir d' Magento | |
| Factures de vente | Créer une facture de vente | Crée une facture de vente dans l' Magento |
| Récupérer les factures de vente | Récupère une facture de vente à partir d' Magento | |
| Commandes | Récupérer les commandes clients | Récupère une commande à partir de Magento |
| Mettre à jour la commande client | Mise à jour d'une commande dans l' Magento | |
| Règles de vente des coupons | Créer un coupon de règle de vente | Crée un coupon de règle de vente. |
| Supprimer le coupon de règle de vente | Supprime le coupon de règle de vente | |
| Récupérer les coupons liés aux règles commerciales | Récupère les coupons liés aux règles de vente | |
| Mettre à jour la règle de vente du coupon | Mises à jour des règles de vente des coupons | |
| Règles de vente | Créer une règle de vente | Crée une règle de vente. |
| Supprimer la règle de vente | Supprime la règle par ID. | |
| Récupérer les règles de vente | Récupère les règles de vente | |
| Mettre à jour la règle de vente | Mises à jour des règles de vente | |
| Expéditions commerciales | Récupérer les expéditions commerciales | Récupère une expédition commerciale à partir d' Magento |
Exemples
Utilisez des modèles pour créer rapidement des flux pour Magento
Apprenez à utiliser des App Connect pour créer rapidement des flux qui accomplissent des actions sur Magento. Par exemple, rendez-vous sur la page Découvrir et recherchez Magento.