Delen via

3270 schermgestuurde apps integreren op IBM-mainframes met werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

IBM mainframe-apps worden meestal uitgevoerd via een 3270-emulator. Gebruik de IBM 3270-connector om IBM mainframe-apps te openen en uit te voeren vanuit Verbruiks- en Standard-werkstromen in Azure Logic Apps. U kunt geautomatiseerde werkstromen maken die uw IBM-mainframe-apps integreren met Azure, Microsoft en andere apps, services en systemen. De connector communiceert met IBM mainframes met behulp van het TN3270-protocol. De IBM 3270-connector is beschikbaar in alle Azure Logic Apps-regio's, met uitzondering van Azure Government en Microsoft Azure beheerd door 21Vianet.

In deze instructiegids worden de volgende aspecten van de IBM 3270-connector beschreven:

  • Waarom de IBM 3270-connector gebruiken in Azure Logic Apps
  • Hoe de IBM 3270-connector 3270 schermgestuurde apps uitvoert
  • Vereisten en installatie voor het gebruik van de IBM 3270-connector
  • Stappen voor het toevoegen van IBM 3270-connectoracties aan uw werkstroom

Waarom deze connector gebruiken?

Voor toegang tot apps op IBM mainframes gebruikt u doorgaans een 3270 terminalemulator, ook wel een groen scherm genoemd. Deze methode is een op tijd geteste manier, maar heeft beperkingen. Hoewel Host Integration Server (HIS) u helpt om rechtstreeks met deze apps te werken, kunt u het scherm en de bedrijfslogica soms niet scheiden. Of misschien hebt u geen informatie meer over de werking van de hosttoepassingen.

Om deze scenario's uit te breiden, werkt de IBM 3270-connector in Azure Logic Apps met het 3270-ontwerpprogramma. Gebruik het ontwerpprogramma om de hostschermen voor een specifieke taak op te nemen of vast te leggen, de navigatiestroom voor die taak via uw mainframe-app te bepalen, en de methoden met invoer- en uitvoerparameters voor die taak te definiëren. Het ontwerpprogramma converteert die informatie naar metagegevens die door de 3270-connector worden gebruikt wanneer er een actie in uw werkstroom wordt uitgevoerd.

Genereer eerst het metagegevensbestand uit het ontwerpprogramma 3270. Voeg dat bestand vervolgens toe als een kaartartefact aan de resource van uw standaard logische app of aan uw gekoppelde integratieaccount voor een Consumption-logische app. Op die manier heeft uw werkstroom toegang tot de metagegevens van uw app wanneer u een IBM 3270-connectoractie toevoegt.

De connector leest het metagegevensbestand uit uw logische app-resource (Standard) of uw integratieaccount (Verbruik), verwerkt navigatie via de 3270-schermen en geeft dynamisch de parameters weer die moeten worden gebruikt met de 3270-connector in uw werkstroom. Vervolgens kunt u gegevens opgeven voor de hosttoepassing. De connector retourneert de resultaten naar uw werkstroom. Als gevolg hiervan kunt u uw verouderde apps integreren met Azure, Microsoft en andere apps, services en systemen die door Azure Logic Apps worden ondersteund.

Technische naslaggids voor connector

De IBM 3270-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Logic-app Milieu Verbindingsversie
Verbruik Multitenant Azure Logic Apps Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Enterprise . Deze connector biedt slechts één actie en geen triggers. Zie de referentie voor IBM 3270 Managed Connector voor meer informatie.
Standaard Azure Logic Apps voor één enkele tenant en App Service Environment v3 (ASE v3 met alleen Windows-abonnementen) Beheerde connector, die wordt weergegeven in de galerie met connectors onder het gedeelde filter en de ingebouwde, op serviceproviders gebaseerde connector, die wordt weergegeven in de galerie met connectors onder het ingebouwde filter. De ingebouwde versie verschilt op de volgende manieren:

- Voor de ingebouwde connector moet u uw HIDX-bestand uploaden naar uw standaardlogische app-resource, niet naar een integratieaccount.

- De ingebouwde connector kan rechtstreeks verbinding maken met een 3270-server en toegang krijgen tot virtuele Azure-netwerken met behulp van een verbindingsreeks.

- De ingebouwde versie ondersteunt serververificatie met TLS-versleuteling voor gegevens die worden verzonden, berichtcodering voor de werking en integratie van virtuele Azure-netwerken.

Zie de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde IBM 3270-connectors
- Referentie voor ingebouwde IBM 3270-connector

Ingebouwde connector referentie

In de volgende sectie worden de bewerkingen voor de IBM 3270-connector beschreven, die momenteel alleen de volgende actie omvat:

Een navigatieplan uitvoeren

Kenmerk Verplicht Typologie Beschrijving
HIDX-naam Ja Snaar / Touwtje Selecteer het 3270 HIDX-bestand dat u wilt gebruiken.
Methodenaam Ja Snaar / Touwtje Selecteer de methode in het HIDX-bestand dat u wilt gebruiken.
Geavanceerde parameters Nee. Varieert Deze lijst wordt weergegeven nadat u een methode hebt geselecteerd, zodat u andere parameters kunt toevoegen die u met de geselecteerde methode kunt gebruiken. De beschikbare parameters variëren op basis van uw HIDX-bestand en de methode die u selecteert.

Deze bewerking bevat ook geavanceerde parameters, die worden weergegeven nadat u een methode hebt geselecteerd, zodat u deze kunt selecteren en gebruiken met de geselecteerde methode. Deze parameters variëren op basis van uw HIDX-bestand en de methode die u selecteert.

Vereiste voorwaarden

  • Een Azure-account en -abonnement. Ontvang een gratis Azure-account.

  • Toegang tot de TN3270-server die als host fungeert voor uw 3270-schermgestuurde app.

  • Het HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de IBM 3270-connector om uw 3270-schermgestuurde app uit te voeren.

    Als u dit HIDX-bestand wilt maken, downloadt en installeert u het 3270-ontwerpprogramma. De enige vereiste is Microsoft .NET Framework 4.8.

    Met dit hulpprogramma kunt u de schermen, navigatiepaden, methoden en parameters vastleggen voor de taken in uw app die u toevoegt en uitvoert als 3270 connectoracties. Het hulpprogramma genereert een HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de connector om uw 3270-schermgestuurde app uit te voeren.

    Nadat u dit hulpprogramma hebt gedownload en geïnstalleerd, maakt u verbinding met uw TN3270-hostserver, ontwerpt u het vereiste metagegevensartefact en genereert u het HIDX-bestand. Zie Metagegevensartefacten ontwerpen voor 3270-toepassingen voor meer informatie.

  • De resource en werkstroom van de logische app Standard of Consumption waar u uw 3270-schermgestuurde app wilt uitvoeren.

    De IBM 3270-connector heeft geen triggers, dus gebruik een trigger om uw werkstroom te starten, zoals de terugkeertrigger of aanvraagtrigger . Vervolgens kunt u de 3270 connector acties toevoegen.

  • Een integratieaccount dat is vereist op basis van de 3270-connectorversie die u gebruikt. U gebruikt deze Azure-resource om B2B-artefacten centraal op te slaan. Voorbeelden hiervan zijn handelspartners, overeenkomsten, kaarten, schema's en certificaten voor gebruik met specifieke werkstroomacties.

    Werkproces Beschrijving
    Standaard - 3270 ingebouwde connector: Upload een HIDX-bestand naar een standaard logische app-resource.

    - 3270 beheerde connector: Upload het HIDX-bestand naar de resource van uw standaard logische app of uw gekoppelde integratieaccount.
    Consumptie 3270 beheerde connector: Verstuur het HIDX-bestand naar uw gekoppelde integratieaccount.

    Zie Het HIDX-bestand uploaden voor meer informatie.

Het HIDX-bestand uploaden

Volg deze stappen om het HIDX-bestand in uw werkstroom te gebruiken:

  1. Ga naar de map waarin u het HIDX-bestand hebt opgeslagen en kopieer het bestand.

  2. Kies in Azure Portal de volgende stappen op basis van de connectorversie:

  3. Voeg nu een IBM 3270-actie toe aan uw werkstroom.

Verderop in deze handleiding, wanneer u voor het eerst een IBM 3270-connectoractie aan uw werkstroom toevoegt, wordt u gevraagd een verbinding te maken tussen uw werkstroom en het mainframesysteem. Nadat u de verbinding hebt gemaakt, kunt u het eerder toegevoegde HIDX-bestand selecteren, de methode die moet worden uitgevoerd en de parameters die u wilt gebruiken.

Een IBM 3270-actie toevoegen

Een standaardwerkstroom voor logische apps kan gebruikmaken van de beheerde IBM 3270-connector en de ingebouwde IBM 3270-connector. Een werkstroom voor logische apps verbruik kan alleen gebruikmaken van de beheerde IBM 3270-connector. Elke versie heeft verschillende acties. Volg de bijbehorende stappen op basis van of u een werkstroom voor logicapps hebt die op verbruik of standaard is gebaseerd.

  1. Open in Azure Portal de resource en werkstroom van uw logische standaard-app.

  2. Als uw werkstroom geen trigger heeft, volgt u de algemene stappen om de trigger toe te voegen die geschikt is voor uw scenario.

    Dit voorbeeld wordt voortgezet met de aanvraagtrigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

  3. Volg de algemene stappen om de ingebouwde connectoractie IBM 3270 toe te voegen met de naam Een navigatieplan uitvoeren.

  4. Nadat het verbindingsvenster wordt weergegeven, voert u de volgende parameterwaarden in:

    Kenmerk Verplicht Waarde Beschrijving
    Verbindingsnaam Ja < verbindingsnaam> Een naam voor uw verbinding.
    Codepagina Nee. < codepagina> Het codepaginanummer dat door de host moet worden gebruikt voor het converteren van tekst. Als u deze waarde leeg laat, gebruikt de connector 37 als de standaardwaarde.
    Apparaattype Nee. < IBM-terminal-model> De modelnaam of het nummer voor de IBM-terminal die moet worden geëmuleren. Als u deze waarde leeg laat, gebruikt de connector standaardwaarden.
    Log Uitzonderingsschermen Nee. Waar of onwaar Registreer het host-scherm als er een fout optreedt tijdens de schermnavigatie.
    Naam logische eenheid Nee. < naam logische eenheid> De naam van de specifieke logische eenheid die moet worden aangevraagd bij de host.
    Poortnummer Nee. < TN3270-serverpoort> De poort die wordt gebruikt door uw TN3270-server. Als u deze waarde leeg laat, gebruikt de connector 23 als de standaardwaarde.
    Server Ja < TN3270-servernaam> De servernaam voor uw TN3270-service.
    Timeout Nee. < time-out-seconden> De time-outduur in seconden tijdens het wachten op schermen.
    TLS gebruiken Nee. In- of uitschakelen SCHAKEL TLS-versleuteling in of uit.
    TN3270-servercertificaat valideren Nee. In- of uitschakelen Schakel validatie voor het certificaat van de server in of uit.

    Voorbeeld:

    Schermopname van Azure Portal, Standard-werkstroomontwerper en IBM 3270-verbindingseigenschappen.

  5. Wanneer u klaar bent, selecteert u Nieuwe maken.

  6. Wanneer het informatievak van de actie wordt weergegeven, voert u de benodigde parameterwaarden in:

    Kenmerk Verplicht Waarde Beschrijving
    HIDX-naam Ja < HIDX-bestandsnaam> Selecteer het 3270 HIDX-bestand dat u wilt gebruiken.
    Methodenaam Ja < method-name> Selecteer de methode in het HIDX-bestand dat u wilt gebruiken. Nadat u een methode hebt geselecteerd, wordt de lijst Nieuwe parameters toevoegen weergegeven, zodat u parameters kunt selecteren die u met die methode wilt gebruiken.

    Voorbeeld:

    Het HIDX-bestand selecteren

    Schermopname van de standaardwerkstroomontwerper, de actie 3270 en het geselecteerde HIDX-bestand.

    Selecteer de methode

    Schermopname van de standaardwerkstroomontwerper, de actie 3270 en de geselecteerde methode.

  7. Sla uw workflow op. Selecteer Opslaan op de werkbalk van de ontwerpfunctie.

Uw werkstroom testen

  1. Als u uw workflow handmatig wilt uitvoeren, selecteert u op de werkbalk van de ontwerpfunctie in het menu Run de optie Uitvoeren.

    Nadat je werkstroom is afgerond, verschijnt de uitvoeringsgeschiedenis. Geslaagde bewerkingen tonen vinkjes, terwijl mislukte bewerkingen een uitroepteken (!) weergeven.

  2. Als u de invoer en uitvoer voor elke bewerking wilt weergeven, selecteert u die bewerking.

  3. Als u de onbewerkte invoer wilt bekijken, selecteert u Onbewerkte invoer weergeven.

  4. Als u de onbewerkte uitvoer wilt bekijken, selecteert u Onbewerkte uitvoer weergeven.

Verwante inhoud

  • Last updated on