Utilisation d'Anaplan avec l' IBM App Connect Enterprise

Anaplan offre des solutions de modélisation et de planification basées sur le cloud pour les ventes, les opérations et les finances avec lesquelles les utilisateurs peuvent collaborer pour de meilleures décisions, aligner les opérations et exécuter les processus sur une plateforme unique. IBM® App Connect Enterprise fournit un nœud « Anaplan Request », qui vous permet de vous connecter à Anaplan et d'envoyer des requêtes pour exécuter, mettre à jour, récupérer, charger et télécharger des objets, notamment des données de cellule, le contenu de fichiers et des éléments de liste.

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

      • Configuration d'un coffre-fort de répertoire externe
      • Configuration d'un coffre de serveur d'intégration
   3. Dans la zone Clé de coffre , entrez la clé de coffre qui est utilisée pour accéder aux données d'identification stockées dans le coffre. La clé de coffre doit comporter au moins 8 caractères.
   4. Facultatif: Par défaut, l'emplacement de coffre et la clé de coffre spécifiés sont sauvegardés en tant que préférences dans le kit d'outils de sorte que les valeurs soient prédéfinies lorsque vous lancez la reconnaissance de connecteur. Si vous ne souhaitez pas que les préférences soient sauvegardées, désélectionnez Sauvegarder dans les préférences de coffre.
5. Cliquez sur Lancer la reconnaissance pour démarrer l'assistant de reconnaissance de connecteur pour le connecteur Anaplan .
   La fenêtre Connector Discovery s'affiche. Si des connexions Anaplan existantes (comptes) sont disponibles, une liste de ces connexions s'affiche. S'il n'existe aucune connexion, le statut du connecteur Anaplan est Not connected.
   • Si une ou plusieurs connexions (comptes) Anaplan sont disponibles, procédez comme suit:
     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 que vous souhaitez effectuer sur l'objet. Par exemple, pour extraire des éléments de liste de Anaplan, cliquez sur Elément de liste , puis sur Extraire un élément de liste.
   • S'il n'existe aucune connexion (compte), procédez comme suit:
     1. Cliquez sur le type d'objet requis, puis sélectionnez l'action que vous souhaitez effectuer sur cet objet. Par exemple, pour exécuter des actions dans Anaplan, cliquez sur Elément de liste , puis sur Extraire l'élément de liste.
     2. Cliquez sur Connexion pour afficher un menu dans lequel vous devez sélectionner l'une des méthodes d'autorisation suivantes:
        • Indiquez les données d'identification à utiliser par App Connect (BASIC OAUTH)
        • Indiquez les données d'identification à utiliser par App Connect (BASIC)
     3. Sélectionnez une méthode d'autorisation et cliquez sur Continuer. Une fenêtre dans laquelle vous entrez les détails de votre compte s'affiche.
     4. Cliquez sur Connecter pour créer une nouvelle connexion. Une fenêtre dans laquelle vous entrez les détails de votre compte s'affiche.
     5. Si vous avez sélectionné BASIC comme méthode d'autorisation, entrez les détails suivants:
        1. Dans la zone Nom d'utilisateur , entrez l'ID utilisateur ou l'adresse électronique du compte utilisateur Anaplan enregistré.
        2. Dans la zone Mot de passe , entrez le mot de passe correspondant au nom d'utilisateur spécifié.
        3. 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
     6. Si vous avez sélectionné BASIC OAUTH comme méthode d'autorisation, entrez les détails suivants:
        1. Dans la zone Jeton d'accès , entrez le jeton d'accès généré à partir de l'ID client d'application et de la valeur confidentielle du client d'application.
        2. Dans la zone Jeton d'actualisation , entrez le jeton d'actualisation généré à partir de l'ID client d'application et de la valeur confidentielle du client d'application.
        3. Dans la zone ID client , entrez l'identificateur unique de l'application créée dans la console Anaplan .
        4. Dans la zone Valeur confidentielle du client , entrez la valeur confidentielle du client d'application pour l'ID client d'application unique créé dans Anaplan.
        5. 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
     7. Cliquez sur Connexion.

     Pour plus d'informations sur la connexion à Anaplan, consultez la section « Comment utiliser IBM App Connect avec Anaplan » dans la documentation sur la livraison continue (CD) d' IBM App Connect in containers.

6. Définissez les propriétés de connecteur requises dans l'assistant.
   Vous pouvez ajouter des conditions pour l'extraction des données en cliquant sur Ajouter une condition , puis en sélectionnant la propriété à filtrer. Par exemple, pour récupérer un élément de la liste dans un format donné, sélectionnez cette option application/json > , > texte/csv > , ou > Personnalisé dans le menu. Vous pouvez également définir des propriétés qui spécifient le nombre maximal de documents à extraire et l'action à effectuer si cette limite est dépassée.
7. Lorsque vous avez fini de spécifier les propriétés dans l'assistant de reconnaissance des connecteurs, cliquez sur Sauvegarder.

   Les données d'identification utilisées pour la connexion à Anaplan sont stockées dans le coffre, et les autres détails de connexion, y compris les détails du format spécifié (le cas échéant), sont sauvegardés dans la politique Anaplan . Les valeurs des propriétés que vous définissez dans l'assistant sont transmises au nœud « Anaplan Request » dans l' IBM App Connect Enterprise Toolkit.

8. Lorsque vous avez terminé la reconnaissance et sauvegardé les valeurs de propriété, quittez l'assistant de reconnaissance des connecteurs en cliquant sur le X dans l'angle supérieur droit de la fenêtre ou en appuyant sur Alt+F4.
9. Revenir à la modification du nœud « Anaplan Request » dans la boîte à outils « IBM App Connect Enterprise ».
   Les propriétés de connecteur qui ont été définies dans l'assistant de reconnaissance de connecteur (à l'étape 6) sont désormais visibles sur le noeud Demande Anaplan . L'onglet De base 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é Éléments de liste > Récupérer un élément de liste dans l'assistant, les propriétés suivantes s'affichent dans l'onglet « Basic » du nœud :

   • Action - RETRIEVEALL
   • Objet - listitem

   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 reconnaissance de connecteur et en définissant de nouvelles valeurs dans l'assistant de reconnaissance de connecteur.

   La propriété Nom de base du schéma indique 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 du connecteur Anaplan. Le nom de base du schéma est défini automatiquement la première fois que vous exécutez la reconnaissance pour le noeud et il est basé sur le nom de flux et le nom de noeud en cours. Si vous définissez cette propriété manuellement avant d'exécuter la reconnaissance pour la première fois, la valeur que vous définissez est utilisée. Si vous renommez les schémas après la reconnaissance, vous devez éditer cette propriété pour qu'elle corresponde au nom de base de schéma utilisé par les schémas renommés dans le projet. Si vous modifiez cette propriété après la reconnaissance, vous devez soit renommer les noms de schéma pour qu'ils correspondent, soit exécuter à nouveau la reconnaissance.

   En fonction de l'action sélectionnée lors de la reconnaissance, l'assistant de reconnaissance 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 est généré uniquement 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 est 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 noeud Mappage pour la transformation des 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/MyMessageFlow.Anaplan_Request), suffixé avec response.schema.json ou request.schema.json. Vous pouvez ouvrir le schéma en cliquant sur Ouvrir le schéma de demande ou sur Ouvrir le schéma de réponse.

10. Vérifiez que les paramètres de propriété du noeud Demande Anaplan sont corrects, puis sauvegardez le flux de messages.
11. Sur l'onglet Connexion du noeud Demande Anaplan , la propriété Règle affiche le nom de la règle qui contient les détails de l'identité de sécurité à utiliser pour la connexion. Le type de la règle est Anaplan.
    Pour plus d'informations, consultez la politique d'Anaplan.
12. Facultatif: Définissez la propriété Délai d'attente sur l'onglet Connexion pour indiquer la durée (en secondes) pendant laquelle le noeud attend que Anaplan traite l'opération.
13. L'onglet Filtrer du noeud Demande Anaplan contient des propriétés qui contrôlent la façon dont le flux de messages sélectionne les données. Les valeurs initiales de ces propriétés sont extraites des valeurs de propriété qui ont été définies pour le connecteur Anaplan dans l'assistant de reconnaissance des connecteurs, y compris les propriétés des options de filtrage et toutes les conditions qui ont été spécifiées (comme décrit à l'étape 6). Si vous revenez ensuite à l'assistant de reconnaissance des connecteurs 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 noeud.

    Les propriétés Options de filtrage contrôlent les objets à utiliser lors de l'exécution du noeud Anaplan Request . Les propriétés Limite de filtre contrôlent le nombre maximal d'éléments à extraire et l'action à effectuer si la limite est dépassée.

    Vous pouvez modifier les valeurs en cliquant sur Editer en regard de la valeur à modifier dans la section Options de filtrage et en modifiant les valeurs de propriété qui ont été définies dans la section Limite de filtrage .

    Les valeurs de propriété peuvent être des valeurs de texte ou des expressions ESQL ou XPATH qui sont résolues à partir du contenu du message transmis au noeud Anaplan Request lors de son exécution.

14. Sur l'onglet Demande , définissez la propriété Emplacement des données pour spécifier l'emplacement dans l'arborescence de messages entrants qui contient les données d'objet à créer dans Anaplan. Ces données forment la demande envoyée du noeud Anaplan Request au système Anaplan .
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 de messages de sortie qui contient les données de l'enregistrement créé dans Anaplan.
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 reconnaissance du connecteur. Vous pouvez désactiver la validation des demandes ou modifier les paramètres de validation à l'aide des propriétés Validation du noeud Demande Anaplan .
17. Sauvegardez le flux de messages.