Utilisation de Zoho Inventory avec l' IBM App Connect Enterprise

Zoho Inventory est un logiciel de gestion des stocks basé sur l'informatique en nuage qui aide les entreprises à créer et à gérer les commandes d'achat et de vente, ainsi qu'à assurer le suivi des stocks.

Les étapes suivantes vous montrent comment vous connecter à un compte Zoho Inventory et configurer un nœud de demande Zoho Inventory en utilisant la découverte de connecteur.

1. Dans la boîte à outils d' IBM App Connect Enterprise, créez un flux contenant un nœud « Demande Zoho Inventory ».
2. Sélectionnez le nœud Zoho Inventory Request dans le flux pour afficher les propriétés du nœud dans l'éditeur.
3. Dans l'onglet Base, cliquez sur Lancer la découverte du connecteur.
   Un panneau s'affiche, dans lequel vous indiquez le nom du projet de stratégie et les détails du coffre-fort à utiliser lors de la découverte des connecteurs.
4. Spécifiez les détails du projet de politique et de l'espace de stockage à utiliser lors de la découverte des connecteurs :
   1. Dans le champ Projet de stratégie, indiquez le projet de stratégie utilisé pour stocker les stratégies créées lors de la découverte des connecteurs.
      Vous pouvez également créer un nouveau projet de politique en cliquant sur Nouveau, puis en spécifiant le nom du nouveau projet de politique. Cliquez ensuite sur Terminer.
   2. Spécifier le coffre-fort à utiliser lors de la découverte du connecteur. Par défaut, les informations d'identification utilisées lors de la découverte des connecteurs sont stockées dans un répertoire externe, qui est un répertoire App Connect Enterprise pouvant être utilisé par n'importe quel serveur d'intégration. Vous pouvez également stocker les informations d'identification dans un coffre-fort de serveur d'intégration, qui est créé dans le répertoire de travail du serveur d'intégration et ne peut être utilisé que par ce serveur d'intégration spécifique.
      Pour spécifier le coffre-fort à utiliser pour stocker les informations d'identification, suivez les étapes de la section Utilisation de l'assistant de découverte de connecteur de l 'une des rubriques suivantes :

      • Configuration d'un coffre-fort de répertoire externe
      • Configuration d'une chambre forte de serveur d'intégration
   3. Dans le champ " Clé de voûte, saisissez la clé du coffre-fort qui est utilisée pour accéder aux informations d'identification stockées dans le coffre-fort. La clé de voûte doit comporter au moins 8 caractères.
   4. Facultatif : 'Par défaut, l'emplacement et la clé du coffre spécifiés sont enregistrés en tant que préférences dans la boîte à outils, de sorte que les valeurs sont prédéfinies lorsque vous lancez Connector Discovery. Si vous ne souhaitez pas que les préférences soient enregistrées, désélectionnez l'option Enregistrer dans les préférences de la chambre forte.
5. Cliquez sur Lancer la découverte pour lancer l'assistant de découverte de connecteur pour le connecteur Zoho Inventory.
   La fenêtre de découverte du connecteur s'affiche. Si des connexions (comptes) Zoho Inventory sont disponibles, une liste de ces connexions est affichée. S'il n'y a pas de connexions existantes, le statut du connecteur Zoho Inventory est affiché comme " Not connected.
   • Si une ou plusieurs connexions (comptes) Zoho Inventory sont disponibles, suivez les étapes suivantes :
     1. Sélectionnez la connexion (compte) que vous souhaitez utiliser en cliquant dessus.
     2. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur l'objet. Par exemple, pour récupérer des contacts dans Zoho Inventory, cliquez sur Contacts, puis sur Récupérer les contacts.
   • S'il n'y a pas de connexions existantes (comptes), effectuez les étapes suivantes :
     1. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur cet objet. Par exemple, pour récupérer des contacts dans Zoho Inventory, cliquez sur Contacts, puis sur Récupérer les contacts.
     2. Cliquez sur Connexion.
        Une fenêtre s'affiche dans laquelle vous entrez les détails de connexion de votre compte Zoho Inventory. Saisissez les informations suivantes dans l'assistant de connexion :

        • Serveur URL : Indiquez l'adresse URL du serveur API qui effectue les appels d'exécution.
        • Base du jeton URL : Valeur du jeton URL par rapport au serveur URL. Sélectionnez un serveur URL qui servira de base au jeton URL.
        • ID de l'organisation: Indiquez l'ID de votre organisation. Dans Zoho Inventory, votre entreprise est considérée comme une organisation. Vous pouvez obtenir l'identifiant de l'organisation à partir de la page Gérer les organisations de la console d'administration.
        • ID du client de l'application: Indiquez l'identifiant unique du client à utiliser pour l'authentification.
        • Secret du client de l'application: spécifiez le secret du client à utiliser pour l'authentification.
        • Jeton d'accès: Le code d'accès utilisé pour accéder aux API de Zoho Inventory.
        • Jeton de rafraîchissement: Indiquez le jeton de rafraîchissement généré à partir de l'identifiant et du secret du client de l'application.
        • Autoriser les certificats auto-signés: Sélectionnez True ou False dans le menu déroulant.
        • Remplacer le serveur URL : Requis si vous voulez vous connecter à un point d'extrémité dans un réseau privé en utilisant le client de réseau privé, ou si vous voulez remplacer le serveur URL. Spécifiez une valeur de remplacement pour l'hôte et le port du connecteur au format " <http or https>://<host_name>:<port>. Si vous n'utilisez pas le client de réseau privé ou si vous n'avez pas besoin d'une dérogation, laissez ce champ vide.
        • Nom du proxy : sélectionnez ou indiquez le nom du proxy que vous souhaitez qu' App Connect utilise pour acheminer les appels du connecteur. Ce champ n'est obligatoire que si les appels doivent passer par un proxy. Lorsque vous utilisez la boîte à outils « IBM App Connect Enterprise », le nom du proxy doit être indiqué sous la forme suivante : {PolicyProjectName}:HTTPProxyPolicyName
     3. Cliquez sur Connexion.

     Pour plus d'informations sur la manière d'identifier ces informations de connexion, consultez la section « Comment utiliser IBM App Connect avec Zoho Inventory » dans la documentation sur la livraison continue (CD) de IBM App Connect in containers.

6. Définissez les propriétés requises du connecteur dans l'assistant.
   Vous pouvez également définir des propriétés qui précisent le nombre maximal d'enregistrements à extraire et l'action à entreprendre si cette limite est dépassée.
7. Lorsque vous avez fini de spécifier les propriétés dans l'assistant de découverte de connecteur, cliquez sur Enregistrer.
   Les identifiants utilisés pour se connecter à Zoho Inventory sont stockés dans le coffre-fort, tandis que les autres informations de connexion sont enregistrées dans la stratégie Zoho Inventory. Les valeurs des propriétés que vous définissez dans l'assistant sont renvoyées au nœud « Zoho Inventory Request » dans la boîte à outils « IBM App Connect Enterprise ».
8. Lorsque vous avez terminé la découverte et enregistré les valeurs des propriétés, quittez l'assistant de découverte de connecteur en cliquant sur le X dans le coin supérieur droit de la fenêtre ou en appuyant sur Alt+F4
9. Revenir à la modification du nœud « Demande de Zoho Inventory » dans la boîte à outils « IBM App Connect Enterprise ».
   Les propriétés du connecteur qui ont été définies dans l'assistant de découverte du connecteur (à l'étape 6) sont maintenant visibles sur le nœud Zoho Inventory Request dans l'éditeur de propriétés. L'onglet Basique affiche les valeurs des propriétés Action et Objet que vous avez définies dans l'assistant. Par exemple, si vous avez sélectionné « Interlocuteurs » > « Récupérer les interlocuteurs » dans l'assistant, les propriétés suivantes s'affichent dans l'onglet « Général » du nœud :

   • Action - " RETRIEVEALL
   • Objet - " getContactsContactpersons_model

   Les valeurs des propriétés Action et Objet sont affichées en lecture seule. Si vous souhaitez modifier ces valeurs, vous pouvez le faire en cliquant à nouveau sur Lancer la découverte du connecteur et en définissant de nouvelles valeurs dans l'assistant de découverte du connecteur.

   La propriété Schema base name spécifie le nom de base des fichiers de schéma qui décrivent le format des messages de demande et de réponse envoyés et reçus par le connecteur Zoho Inventory. Le nom de base du schéma est défini automatiquement la première fois que vous exécutez la recherche pour le nœud, et il est basé sur le nom du flux et le nom du nœud actuels. Si vous définissez cette propriété manuellement avant de lancer la découverte pour la première fois, c'est la valeur que vous avez définie qui est utilisée. Si vous renommez les schémas après la découverte, vous devez modifier cette propriété afin qu'elle corresponde au nom de base du schéma utilisé par les schémas renommés dans le projet. Si vous modifiez cette propriété après la recherche, vous devez soit renommer les noms des schémas pour qu'ils correspondent, soit relancer la recherche.

   En fonction de l'action sélectionnée lors de la découverte, l'assistant de découverte de connecteur génère soit un schéma de demande et un schéma de réponse, soit un schéma de réponse uniquement. Un schéma de demande n'est généré que si l'action et l'objet sélectionnés nécessitent un message de demande. Le schéma de demande généré est utilisé pour la validation du message de demande. Si l'action était " RETRIEVE ou " DELETE, seul le schéma de réponse est renvoyé par le connecteur.

   Les fichiers de schéma générés sont ajoutés au projet et peuvent être utilisés par un nœud de mise en correspondance pour transformer les données d'entrée ou de sortie. Le nom de fichier complet du schéma est dérivé du nom de base du schéma (tel que " gen/zohoinventory.Zoho_Inventory_Request), suivi de " response.schema.json ou " request.schema.json. Vous pouvez ouvrir le schéma en cliquant sur Ouvrir le schéma de demande ou Ouvrir le schéma de réponse.

10. Vérifiez que les paramètres de propriété du nœud Zoho Inventory Request sont corrects, puis enregistrez le flux de messages.
11. Dans l'onglet " Connexion du nœud " Demande d'inventaire Zoho, la propriété " Politique indique le nom de la politique qui contient les détails de l'identité de sécurité à utiliser pour la connexion. La police a un type de " Zoho Inventory.
    Pour plus d'informations, consultez la politique de Zoho Inventory.
12. Facultatif : Définissez la propriété Timeout dans l'onglet Connection pour spécifier le temps (en secondes) pendant lequel le nœud attend que Zoho Inventory traite l'opération.
13. L'onglet " Filtre du nœud " Demande d'inventaire Zoho contient des propriétés qui contrôlent la manière dont le flux de messages sélectionne les données. Les valeurs initiales de ces propriétés proviennent des valeurs des propriétés définies pour le connecteur Zoho Inventory dans l'assistant de découverte du connecteur, y compris les propriétés des options de filtrage et toutes les conditions spécifiées (comme décrit à l'étape 6). Ensuite, si vous revenez à l'assistant de découverte de connecteur et que vous modifiez les valeurs des propriétés (en ajoutant de nouvelles conditions, par exemple), ces mises à jour sont reflétées dans les propriétés définies sur le nœud.

    Les propriétés des options de filtrage déterminent les objets qui seront utilisés lors de l'exécution du nœud de demande d'inventaire de Zoho. Les propriétés Limite du filtre contrôlent le nombre maximum d'éléments à extraire et l'action à entreprendre si la limite est dépassée.

    Vous pouvez modifier les valeurs en cliquant sur Modifier à côté de la valeur que vous souhaitez modifier dans la section Options du filtre, et en changeant les valeurs des propriétés qui ont été définies dans la section Limite du filtre.

    Les valeurs des propriétés peuvent être des valeurs textuelles ou des expressions ESQL ou XPATH qui sont résolues à partir du contenu du message transmis au nœud de demande d'inventaire Zoho lors de son exécution.

14. Dans l'onglet " Demande, définissez la propriété " Localisation des données pour spécifier l'emplacement dans l'arbre des messages entrants qui contient les données de l'objet à créer dans " Zoho Inventory. Ces données forment la demande envoyée par le nœud de demande de Zoho Inventory au système Zoho Inventory.
15. Dans l'onglet Résultat, définissez la propriété Emplacement des données de sortie pour spécifier l'emplacement dans l'arborescence des messages de sortie qui contiendra les données de l'enregistrement créé dans Zoho Inventory.
16. Par défaut, les messages de demande sont validés par rapport au schéma de demande qui a été généré lors de la découverte du connecteur. Vous pouvez désactiver la validation de la demande ou modifier les paramètres de validation en utilisant les propriétés de validation du nœud Zoho Inventory Request.
17. Sauvegarder le flux de messages.