Intégrer des applications basées sur l’écran 3270 sur des mainframes IBM avec Azure à l’aide d’Azure Logic Apps et du connecteur IBM 3270

  • Article

S’applique à : Azure Logic Apps (Consommation + Standard)

Pour accéder et exécuter des applications mainframe IBM, que vous exécutez généralement en parcourant les écrans de l’émulateur 3270, à partir de flux de travail Consommation et Standard dans Azure Logic Apps, vous pouvez utiliser le connecteur IBM 3270 . De cette façon, vous pouvez intégrer vos applications mainframe IBM avec Azure, Microsoft et d’autres applications, services et systèmes en créant des workflows automatisés avec Azure Logic Apps. Le connecteur communique avec les mainframes IBM à l’aide du protocole TN3270. Le connecteur IBM 3270 est disponible dans toutes les régions Azure Logic Apps, à l’exception d’Azure Government et de Microsoft Azure gérés par 21Vianet.

Ce guide pratique décrit les aspects suivants sur le connecteur IBM 3270 :

  • Pourquoi utiliser le connecteur IBM 3270 dans Azure Logic Apps

  • Comment le connecteur IBM 3270 exécute-t-il des applications basées sur l’écran 3270

  • Prérequis et configuration pour l’utilisation du connecteur IBM 3270

  • Étapes d’ajout d’actions de connecteur IBM 3270 à votre flux de travail

Pourquoi utiliser ce connecteur

Pour accéder aux applications sur des mainframes IBM, vous utilisez généralement un émulateur de terminal 3270, souvent appelé « écran vert ». Cette méthode est un moyen éprouvé mais qui a des limitations. Bien que HIS (Host Integration Server) vous permette de travailler directement avec ces applications, il n’est parfois pas possible de séparer l’écran et la logique métier. Ou il se peut que vous n’ayez plus d’informations sur le fonctionnement des applications hôtes.

Pour étendre ces scénarios, le connecteur IBM 3270 dans Azure Logic Apps fonctionne avec l’outil de conception 3270, que vous utilisez pour enregistrer ou « capturer », les écrans hôtes utilisés pour une tâche spécifique, définissent le flux de navigation de cette tâche via votre application mainframe et définissent les méthodes avec des paramètres d’entrée et de sortie pour cette tâche. L’outil de conception convertit ces informations en métadonnées que le connecteur 3270 utilise lors de l’exécution d’une action dans votre flux de travail.

Après avoir généré le fichier de métadonnées à partir de l’outil de conception 3270, vous ajoutez ce fichier en tant qu’artefact de mappage à votre ressource d’application logique Standard ou à votre compte d’intégration lié pour une application logique Consommation dans Azure Logic Apps. Ainsi, votre workflow peut accéder aux métadonnées de votre application lorsque vous ajoutez une action de connecteur IBM 3270 . Le connecteur lit le fichier de métadonnées à partir de votre ressource d’application logique (Standard) ou de votre compte d’intégration (Consommation), gère la navigation dans les écrans 3270 et présente dynamiquement les paramètres à utiliser avec le connecteur 3270 dans votre flux de travail. Vous pouvez ensuite fournir des données à l’application hôte, et le connecteur retourne les résultats à votre flux de travail. Par conséquent, vous pouvez intégrer vos applications héritées à Azure, Microsoft et d’autres applications, services et systèmes pris en charge par Azure Logic Apps.

Référence technique du connecteur

Le connecteur IBM 3270 a différentes versions, en fonction du type d’application logique et de l’environnement hôte.

Application logique Environnement Version de connexion
Consommation Azure Logic Apps multilocataire Connecteur managé, qui s’affiche dans le concepteur sous l’étiquette Entreprise. Ce connecteur fournit uniquement une seule action et aucun déclencheur. Pour plus d’informations, consultez la référence du connecteur managé IBM 3270.
Standard Azure Logic Apps à locataire unique et App Service Environment v3 (ASE v3 avec des plans Windows uniquement) Connecteur managé, qui apparaît dans la galerie de connecteurs sous Runtime>Shared et le connecteur intégré, basé sur un fournisseur de services, qui apparaît dans la galerie de connecteurs sous Runtime>In-App. La version intégrée diffère de la manière suivante :

- Le connecteur intégré nécessite que vous chargez votre fichier HIDX dans votre ressource d’application logique Standard, et non dans un compte d’intégration.

- Le connecteur intégré peut se connecter directement à un serveur 3270 et accéder aux réseaux virtuels Azure à l’aide d’un chaîne de connexion.

- La version intégrée prend en charge l’authentification du serveur avec le chiffrement TLS (SSL) pour les données en transit, l’encodage des messages pour son opération et l’intégration du réseau virtuel Azure.

Pour plus d’informations, consultez la documentation suivante :

- Informations de référence sur le connecteur managé IBM 3270
- Informations de référence sur le connecteur intégré IBM 3270

Informations de référence sur le connecteur intégré

La section suivante décrit les opérations pour le connecteur IBM 3270, qui inclut actuellement uniquement l’action suivante :

Exécuter un plan de navigation

Paramètre Obligatoire Type Description
Nom HIDX Oui Chaîne Sélectionnez le fichier HIDX 3270 à utiliser.
Nom de la méthode Oui Chaîne Sélectionnez la méthode dans le fichier HIDX à utiliser.
Paramètres avancés Non Variable Cette liste s’affiche après avoir sélectionné une méthode pour pouvoir ajouter d’autres paramètres à utiliser avec la méthode sélectionnée. Les paramètres disponibles varient en fonction de votre fichier HIDX et de la méthode que vous sélectionnez.

Cette opération inclut également des paramètres avancés, qui apparaissent après avoir sélectionné une méthode, pour vous permettre de sélectionner et d’utiliser avec la méthode sélectionnée. Ces paramètres varient en fonction de votre fichier HIDX et de la méthode que vous sélectionnez.

Prérequis

  • Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.

  • Accès au serveur TN3270 qui héberge votre application pilotée par l’écran 3270

  • Fichier HIDX (Host Integration Designer) qui fournit les métadonnées nécessaires au connecteur IBM 3270 pour exécuter votre application basée sur l’écran 3270.

    Pour créer ce fichier HIDX, téléchargez et installez l’outil de conception 3270. Le seul prérequis est Microsoft .NET Framework 4.8.

    Cet outil vous permet d’enregistrer les écrans, les chemins de navigation, les méthodes et les paramètres pour les tâches dans votre application que vous ajoutez et exécutez en tant qu’actions du connecteur 3270. L’outil génère un fichier HIDX (Host Integration Designer XML) qui fournit les métadonnées nécessaires pour que le connecteur exécute votre application basée sur l’écran 3270.

    Après avoir téléchargé et installé cet outil, procédez comme suit pour vous connecter à votre serveur hôte TN3270, concevoir l’artefact de métadonnées requis et générer le fichier HIDX.

  • Ressource et flux de travail d’application logique Standard ou Consommation dans lesquels vous souhaitez exécuter votre application pilotée par l’écran 3270

    Le connecteur IBM 3270 n’a pas de déclencheurs. Utilisez donc n’importe quel déclencheur pour démarrer votre flux de travail, tel que le déclencheur périodicité ou le déclencheur de requête. Vous pouvez ensuite ajouter les actions du connecteur 3270.

  • Un compte d’intégration, qui est requis en fonction de la version du connecteur 3270 que vous utilisez et est une ressource Azure dans laquelle vous pouvez stocker de manière centralisée des artefacts B2B tels que des partenaires commerciaux, des contrats, des cartes, des schémas et des certificats à utiliser avec des actions de flux de travail spécifiques.

    Workflow Description
    Standard - Connecteur intégré 3270 : chargez le fichier HIDX dans la ressource d’application logique Standard.

    - Connecteur managé 3270 : chargez le fichier HIDX dans votre ressource d’application logique Standard ou votre compte d’intégration lié.
    Consommation Connecteur managé 3270 : chargez le fichier HIDX dans votre compte d’intégration lié.

    Pour plus d’informations, consultez Charger le fichier HIDX.

Charger le fichier HIDX

Pour que votre flux de travail utilise le fichier HIDX, procédez comme suit :

  1. Accédez au dossier dans lequel vous avez enregistré votre fichier HIDX, puis copiez le fichier.

  2. Dans le Portail Azure, choisissez les étapes suivantes, en fonction de la version du connecteur :

  3. À présent, ajoutez une action IBM 3270 à votre flux de travail.

Plus loin dans ce guide, lorsque vous ajoutez une action de connecteur IBM 3270 à votre flux de travail pour la première fois, vous êtes invité à créer une connexion entre votre flux de travail et le système mainframe. Une fois que vous avez créé la connexion, vous pouvez sélectionner votre fichier HIDX précédemment ajouté, la méthode à exécuter et les paramètres à utiliser.

Ajouter une action IBM 3270

Un workflow d’application logique standard peut utiliser le connecteur managé IBM 3270 et le connecteur intégré IBM 3270. Toutefois, un flux de travail d’application logique Consommation peut utiliser uniquement le connecteur managé IBM 3270. Chaque version a des actions différentes. Selon que vous disposez d’un flux de travail consommation ou d’application logique standard, suivez les étapes correspondantes :

  1. Dans le Portail Azure, ouvrez votre ressource d’application logique standard et votre flux de travail où vous avez déjà ajouté un déclencheur.

  2. Si vous n’avez pas encore ajouté de déclencheur, suivez ces étapes générales pour ajouter le déclencheur que vous souhaitez à votre flux de travail.

    Cet exemple continue avec le déclencheur de requête nommé Lorsqu’une requête HTTP est reçue.

  3. Suivez ces étapes générales pour ajouter l’action de connecteur intégré IBM 3270 nommée Exécuter un plan de navigation.

  4. Lorsque la zone d’informations de connexion s’affiche, fournissez les valeurs de paramètre nécessaires suivantes :

    Propriété Obligatoire Value Description
    Nom de connexion Oui <connection-name> Nom de votre connexion
    Page de codes Non <page de codes> Numéro de page de codes de l’hôte à utiliser pour convertir du texte. Si ce champ est vide, le connecteur utilise 37 comme valeur par défaut.
    Type d’appareil Non <IBM-terminal-model> Numéro ou nom de modèle du terminal IBM à émuler. Si ce champ est vide, le connecteur utilise les valeurs par défaut.
    Écrans d’exception de journal Non Vrai ou faux Journaliser l’écran de l’hôte si une erreur se produit pendant la navigation à l’écran.
    Nom d’unité logique Non <logical-unit-name> Nom d’unité logique spécifique à demander à partir de l’hôte
    Numéro de port Non <TN3270-server-port> Port utilisé par votre serveur TN3270. Si ce champ est vide, le connecteur utilise 23 comme valeur par défaut.
    Serveur Oui <TN3270-server-name> Nom du serveur pour votre service TN3270
    Délai d'expiration Non <délai d’expiration en secondes> Durée du délai d’expiration en secondes pendant l’attente des écrans
    Utiliser TLS Non Activé ou désactivé Activez ou désactivez le chiffrement TLS.
    Valider le certificat de serveur TN3270 Non Activé ou désactivé Activez ou désactivez la validation du certificat du serveur.

    Par exemple :

    Screenshot shows Azure portal, Standard workflow designer, and IBM 3270 connection properties.

  5. Lorsque vous avez terminé, sélectionnez Créer nouveau.

  6. Lorsque la zone d’informations d’action s’affiche, fournissez les valeurs de paramètre nécessaires :

    Propriété Obligatoire Value Description
    Nom HIDX Oui <HIDX-file-name> Sélectionnez le fichier HIDX 3270 à utiliser.
    Nom de la méthode Oui <method-name> Sélectionnez la méthode dans le fichier HIDX à utiliser. Une fois que vous sélectionnez une méthode, la liste Add new parameter (Ajouter un nouveau paramètre) s’affiche et vous pouvez alors sélectionner les paramètres à utiliser avec cette méthode.
    Paramètres avancés Non Variable Cette liste s’affiche après avoir sélectionné une méthode pour pouvoir ajouter d’autres paramètres à utiliser avec la méthode sélectionnée. Les paramètres disponibles varient en fonction de votre fichier HIDX et de la méthode que vous sélectionnez.

    Par exemple :

    Sélectionner le fichier HIDX

    Screenshot shows Standard workflow designer, 3270 action, and selected HIDX file.

    Sélectionner la méthode

    Screenshot shows Standard workflow designer, 3270 action, and selected method.

    Sélectionner les paramètres

    Screenshot shows Standard workflow designer, 3270 action, and more parameters.

  7. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du concepteur, sélectionnez Enregistrer.

Tester votre workflow

  1. Pour exécuter votre flux de travail, dans le concepteur, sélectionnez menu Flux de travail, sélectionnez Vue d’ensemble. Dans la barre d’outils Vue d’ensemble, sélectionnez Exécuter >Exécuter.

    Une fois votre flux de travail terminé, l’historique des exécutions de votre flux de travail s’affiche. Les étapes réussies montrent case activée marques, tandis que les étapes infructueuses affichent un point d’exclamation ( !).

  2. Pour réviser les entrées et les sorties de chaque étape, développez l’étape à vérifier.

  3. Pour réviser les sorties, sélectionnez See raw outputs (Afficher les sorties brutes).

  4. Pour réviser les entrées et les sorties de chaque étape, développez l’étape à vérifier.

  5. Pour réviser les sorties, sélectionnez See raw outputs (Afficher les sorties brutes).

Étapes suivantes