Udostępnij za pośrednictwem


Integrowanie aplikacji opartych na ekranie 3270 na komputerach mainframe IBM z platformą Azure przy użyciu usługi Azure Logic Apps i łącznika IBM 3270

Dotyczy: Azure Logic Apps (Consumption + Standard)

Aby uzyskać dostęp i uruchomić aplikacje mainframe IBM, które zwykle obsługujesz, przechodząc przez ekrany emulatora 3270, w przepływach pracy Zużycie i Standardowa usługi Azure Logic Apps, możesz użyć łącznika IBM 3270. Dzięki temu możesz zintegrować aplikacje mainframe IBM z platformą Azure, firmą Microsoft i innymi aplikacjami, usługami i systemami, tworząc zautomatyzowane przepływy pracy za pomocą usługi Azure Logic Apps. Łącznik komunikuje się z komputerami mainframe IBM przy użyciu protokołu TN3270. Łącznik IBM 3270 jest dostępny we wszystkich regionach usługi Azure Logic Apps, z wyjątkiem platformy Azure Government i platformy Microsoft Azure obsługiwanej przez firmę 21Vianet.

W tym przewodniku z instrukcjami opisano następujące aspekty dotyczące łącznika IBM 3270 :

  • Dlaczego warto używać łącznika IBM 3270 w usłudze Azure Logic Apps

  • Jak łącznik IBM 3270 uruchamia aplikacje oparte na ekranie 3270

  • Wymagania wstępne i konfiguracja korzystania z łącznika IBM 3270

  • Kroki dodawania akcji łącznika IBM 3270 do przepływu pracy

Dlaczego warto używać tego łącznika?

Aby uzyskać dostęp do aplikacji na komputerach mainframe IBM, zazwyczaj używasz emulatora terminalu 3270, często nazywanego "zielonym ekranem". Ta metoda jest sprawdzonym sposobem, ale ma ograniczenia. Mimo że serwer integracji hostów (HIS) ułatwia bezpośrednią pracę z tymi aplikacjami, czasami oddzielenie ekranu i logiki biznesowej może nie być możliwe. A może nie masz już informacji o sposobie działania aplikacji hosta.

Aby rozszerzyć te scenariusze, łącznik IBM 3270 w Azure Logic Apps współpracuje z 3270 Design Tool, którego używasz do rejestrowania lub "przechwytywania" ekranów hosta używanych w konkretnym zadaniu, definiowania przepływu nawigacji dla tego zadania w aplikacji mainframe oraz definiowania metod z parametrami wejściowymi i wyjściowymi dla tego zadania. Narzędzie projektowe konwertuje te informacje na metadane używane przez łącznik 3270 podczas uruchamiania akcji w przepływie pracy.

Po wygenerowaniu pliku metadanych z narzędzia 3270 Design Tool należy dodać ten plik jako artefakt mapy do zasobu standardowej aplikacji logiki lub połączonego konta integracji dla aplikacji logiki typu Consumption w usłudze Azure Logic Apps. W ten sposób przepływ pracy może uzyskiwać dostęp do metadanych aplikacji, gdy dodajesz akcję łącznika IBM 3270. Łącznik odczytuje plik metadanych z zasobu aplikacji logiki (Standard) lub konta integracji (Zużycie), obsługuje nawigację przez ekrany 3270 i dynamicznie przedstawia parametry do użycia z łącznikiem 3270 w przepływie pracy. Możesz następnie przekazać dane aplikacji hosta, a łącznik zwraca wyniki do twojego przepływu pracy. W związku z tym możesz zintegrować starsze aplikacje z platformą Azure, firmą Microsoft i innymi aplikacjami, usługami i systemami, które obsługuje usługa Azure Logic Apps.

Dokumentacja techniczna łącznika

Łącznik IBM 3270 ma różne wersje oparte na typie aplikacji logiki i środowisku hosta.

Aplikacja logiki Środowisko Wersja połączenia
Zużycie Wielotenancyjna usługa Azure Logic Apps Łącznik zarządzany, który pojawia się w projektancie pod etykietą Enterprise. Ten łącznik zapewnia tylko jedną akcję i brak wyzwalaczy. Aby uzyskać więcej informacji, odnieś się do referencja łącznika zarządzanego IBM 3270.
Norma Usługa Azure Logic Apps i środowisko App Service Environment w wersji 3 z jedną dzierżawą (środowisko ASE w wersji 3 tylko z planami systemu Windows) Łącznik zarządzany, który wyświetla się w galerii łączników pod filtrem Shared, oraz wbudowany, oparty na dostawcy usług łącznik, który wyświetla się w galerii łączników pod filtrem Built-in. Wbudowana wersja różni się w następujący sposób: -

— Wbudowany łącznik wymaga przesłania pliku HIDX do zasobu Standardowej aplikacji logiki, a nie konta integracji.

— Wbudowany łącznik może łączyć się bezpośrednio z serwerem 3270 i uzyskiwać dostęp do sieci wirtualnych platformy Azure przy użyciu parametrów połączenia.

— Wbudowana wersja obsługuje uwierzytelnianie serwera za pomocą szyfrowania TLS (SSL) na potrzeby przesyłania danych, kodowanie komunikatów dla operacji i integrację sieci wirtualnej platformy Azure.

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Referencja zarządzanego łącznika IBM 3270
- Dokumentacja wbudowanego łącznika IBM 3270

Dokumentacja referencyjna wbudowanego łącznika

W poniższej sekcji opisano operacje łącznika IBM 3270, które obecnie obejmują tylko następujące działania:

Wykonywanie planu nawigacji

Parametr Wymagane Typ Opis
Nazwa HIDX Tak Sznurek Wybierz plik HIDX 3270, którego chcesz użyć.
Nazwa metody Tak Sznurek Wybierz metodę w pliku HIDX, którego chcesz użyć.
Parametry zaawansowane Nie. Różni się Ta lista zostanie wyświetlona po wybraniu metody, aby można było dodać inne parametry do użycia z wybraną metodą. Dostępne parametry różnią się w zależności od pliku HIDX i wybranej metody.

Ta operacja obejmuje również zaawansowane parametry, które są wyświetlane po wybraniu metody, aby można było je wybrać i stosować z tą metodą. Te parametry różnią się w zależności od pliku HIDX i wybranej metody.

Wymagania wstępne

  • Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.

  • Dostęp do serwera TN3270, który hostuje aplikację opartą na ekranie 3270

  • Plik XML (HIDX) Projektant Integracji Hostów, który udostępnia metadane niezbędne dla łącznika IBM 3270 do uruchomienia aplikacji sterowanej ekranem 3270.

    Aby utworzyć ten plik HIDX, pobierz i zainstaluj narzędzie projektowe 3270. Jedynym wymaganiem wstępnym jest program Microsoft .NET Framework 4.8.

    To narzędzie ułatwia rejestrowanie ekranów, ścieżek nawigacji, metod i parametrów zadań w aplikacji, które dodajesz i uruchamiasz jako akcje łącznika 3270. Narzędzie generuje plik XML projektanta Host Integration Designer (HIDX), który dostarcza niezbędne metadane dla łącznika do uruchomienia aplikacji napędzanej ekranem 3270.

    Po pobraniu i zainstalowaniu tego narzędzia wykonaj następujące kroki, aby nawiązać połączenie z serwerem hosta TN3270, zaprojektować wymagany artefakt metadanych i wygenerować plik HIDX.

  • Zasób aplikacji logiki w warstwie Standardowa lub Zużycie oraz przepływ pracy, w którym chcesz uruchomić aplikację opartą na ekranie 3270

    Łącznik IBM 3270 nie ma wyzwalaczy, dlatego użyj dowolnego wyzwalacza, aby uruchomić przepływ pracy, na przykład wyzwalacz cykliczny lub wyzwalacz żądania. Następnie możesz dodać akcje łącznika 3270.

  • Konto integracji, które jest wymagane na podstawie używanej wersji łącznika 3270 i jest zasobem platformy Azure, w którym można centralnie przechowywać artefakty B2B, takie jak partnerzy handlowi, umowy, mapy, schematy i certyfikaty do użycia z określonymi akcjami przepływu pracy.

    Przepływ pracy Opis
    Standardowy - 3270 wbudowany łącznik: przekazanie pliku HIDX do zasobu standardowej aplikacji Logic Apps.

    — Łącznik zarządzany 3270: przekaż plik HIDX do zasobu aplikacji logicznej typu Standard lub połączonego konta integracji.
    Konsumpcja Łącznik zarządzany 3270: Przesłać plik HIDX do połączonego konta integracji.

    Aby uzyskać więcej informacji, zobacz Przekazywanie pliku HIDX.

Przekazanie pliku HIDX

Aby przepływ pracy używał pliku HIDX, wykonaj następujące kroki:

  1. Przejdź do folderu, w którym zapisano plik HIDX, i skopiuj plik.

  2. W witrynie Azure Portal wybierz następujące kroki na podstawie wersji łącznika:

  3. Teraz dodaj akcję IBM 3270 do przepływu pracy.

W dalszej części tego przewodnika, gdy po raz pierwszy dodajesz akcję łącznika IBM 3270 do swojego przepływu pracy, zostaniesz poproszony o utworzenie połączenia między przepływem pracy a systemem mainframe. Po utworzeniu połączenia możesz wybrać wcześniej dodany plik HIDX, metodę do uruchomienia i parametry do użycia.

Dodaj akcję IBM 3270

Przepływ pracy w standardowej aplikacji logicznej może używać zarządzanego łącznika IBM 3270 oraz wbudowanego łącznika IBM 3270. Jednak przepływ pracy aplikacji logiki Zużycie może używać tylko łącznika zarządzanego IBM 3270. Każda wersja ma różne akcje. W zależności od tego, czy masz przepływ pracy aplikacji logiki typu Zużycie, czy Standardowa, wykonaj odpowiednie kroki:

  1. W witrynie Azure Portal otwórz zasób aplikacji logiki w warstwie Standardowa i przepływ pracy, w którym został już dodany wyzwalacz.

  2. Jeśli nie dodałeś jeszcze wyzwalacza, wykonaj następujące ogólne kroki, aby dodać wyzwalacz, który chcesz do swojego przepływu pracy.

    W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

  3. Wykonaj następujące ogólne kroki, aby dodać wbudowaną akcję łącznika IBM 3270 o nazwie Wykonaj plan nawigacji.

  4. Po wyświetleniu pola informacji o połączeniu podaj następujące niezbędne wartości parametrów:

    Majątek Wymagane Wartość Opis
    Nazwa połączenia Tak < nazwa połączenia> Nazwa połączenia
    Strona kodowa Nie. < strona kodowa> Numer strony kodowej hosta do użycia do konwertowania tekstu. Jeśli pole pozostanie puste, łącznik będzie używać 37 jako wartości domyślnej.
    typ urządzenia Nie. < IBM-terminal-model> Nazwa modelu lub numer terminalu IBM do emulacji. Jeśli pole pozostanie puste, łącznik używa wartości domyślnych.
    Ekrany wyjątków w logach Nie. Prawda lub fałsz Zaloguj ekran hosta, jeśli wystąpi błąd podczas poruszania się po ekranie.
    Nazwa jednostki logicznej Nie. < nazwa jednostki logicznej> Określona nazwa jednostki logicznej, którą należy żądać od hosta.
    Numer portu Nie. < Port serwera TN3270> Port używany przez serwer TN3270. Jeśli pole pozostanie puste, łącznik będzie używać 23 jako wartości domyślnej.
    Serwer Tak < Nazwa serwera TN3270> Nazwa serwera usługi TN3270
    Limit czasu Nie. < limit czasu w sekundach> Limit czasu w sekundach podczas oczekiwania na ekrany
    Korzystanie z protokołu TLS Nie. Włączone lub wyłączone Włącz lub wyłącz szyfrowanie TLS.
    Weryfikowanie certyfikatu serwera TN3270 Nie. Włączone lub wyłączone Włącz lub wyłącz walidację certyfikatu serwera.

    Przykład:

    Zrzut ekranu pokazuje portal Azure, projektanta przepływu pracy Standardowego oraz właściwości połączenia IBM 3270.

  5. Po zakończeniu wybierz pozycję Utwórz nowy.

  6. Po wyświetleniu pola informacji o akcji podaj niezbędne wartości parametrów:

    Majątek Wymagane Wartość Opis
    Nazwa HIDX Tak < HIDX-file-name> Wybierz plik HIDX 3270, którego chcesz użyć.
    Nazwa metody Tak < nazwa-metody> Wybierz metodę w pliku HIDX, którego chcesz użyć. Po wybraniu metody zostanie wyświetlona lista Dodaj nowy parametr , aby można było wybrać parametry do użycia z tą metodą.
    Parametry zaawansowane Nie. Różni się Ta lista zostanie wyświetlona po wybraniu metody, aby można było dodać inne parametry do użycia z wybraną metodą. Dostępne parametry różnią się w zależności od pliku HIDX i wybranej metody.

    Przykład:

    Wybierz plik HIDX

    Zrzut ekranu przedstawiający projektanta przepływu pracy Standard, akcję 3270 oraz wybrany plik HIDX.

    Wybierz metodę

    Zrzut ekranu przedstawiający standardowego projektanta przepływu pracy, akcję 3270 i wybraną metodę.

    Wybieranie parametrów

    Zrzut ekranu pokazuje projektanta standardowego przepływu pracy, akcję 3270 i inne parametry.

  7. Gdy wszystko będzie gotowe, zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Testowanie przepływu pracy

  1. Aby uruchomić przepływ pracy, w projektancie wybierz menu przepływu pracy, wybierz pozycję Przegląd. Na pasku narzędzi Przegląd wybierz pozycję Uruchom>Uruchom.

    Po zakończeniu działania przepływu pracy zostanie wyświetlona historia uruchamiania przepływu pracy. Pomyślne kroki pokazują znaki kontrolne, a kroki zakończone niepowodzeniem wykrzyknik (!).

  2. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, rozwiń ten krok.

  3. Aby przejrzeć dane wyjściowe, wybierz pozycję Zobacz nieprzetworzone dane wyjściowe.

  4. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, rozwiń ten krok.

  5. Aby przejrzeć dane wyjściowe, wybierz pozycję Zobacz nieprzetworzone dane wyjściowe.

Dalsze kroki