Parsování a generování hostitelských souborů z mainframů IBM pro standardní pracovní postupy v Azure Logic Apps
Platí pro: Azure Logic Apps (Standard)
K parsování a generování nových hostitelských souborů IBM a fyzických souborů řady i Series z pracovních postupů Standard v Azure Logic Apps můžete použít integrovaný konektor založený na poskytovateli služeb IBM Host File . Vzhledem k tomu, že zavedení sálových systémů, všudypřítomné hostitelské soubory se používají k ukládání hojných dat pro klíčové systémy. I když tento konektor nevyžaduje přístup k sálovým nebo střednímu systému IBM, musíte soubor hostitele zpřístupnit standardnímu pracovnímu postupu pomocí jiných mechanismů, jako je FTP, blob storage, Host Integration Server nebo partnerské softwarové zařízení. Konektor IBM Host File je k dispozici ve všech oblastech Azure Logic Apps s výjimkou Azure Government a Microsoft Azure provozovaného společností 21Vianet.
Tento návod popisuje následující aspekty konektoru IBM Host File :
Proč používat konektor IBM Host File v Azure Logic Apps
Požadavky a nastavení pro použití konektoru IBM Host File
Postup přidání akcí konektoru IBM Host File do pracovního postupu standardní aplikace logiky
Proč používat tento konektor?
V sálových počítačích IBM zpracovávají metody přístupu, které jsou speciálními součástmi operačního systému, zpracování souborů. V roce 1970s byla vytvořena metoda přístupu k virtuálnímu úložišti (VSAM) a stala se nejčastěji používanou metodou přístupu v sálových počítačích IBM. VSAM poskytuje následující typy souborů: datové sady sekvencovanými položkami, datové sady s posloupností klíčů a relativní datové sady záznamů.
Dnes má trh více řešení, která se přímo připojují k hostitelským souborům a spouštějí datové operace. Řada řešení vyžaduje instalaci softwaru do systému sálových počítačů. I když tato možnost funguje dobře pro některé zákazníky, jiní chtějí zabránit růstu nároků v jejich sálových systémech.
Microsoft Host Integration Server (HIS) poskytuje spravovaný adaptér pro soubory hostitelů a nevyžaduje instalaci softwaru do sálového počítače. HIS ale vyžaduje, abyste povolili subsystém mainfram (DFM) IBM Distributed File Manager, který vyžaduje LU 6.2. Tento spravovaný poskytovatel také vyžaduje, abyste nakonfigurovali bránu SNA (HIS System Network Architecture), která poskytuje přístup k DFM.
Ve většině případů funguje spravovaný poskytovatel jako normální zprostředkovatel dat. Můžete se připojit k hostitelskému systému souborů, spustit příkazy a načíst data. I když se jedná o skvělou alternativu pro některé zákazníky, konektor IBM Host File vyžaduje, abyste v Azure Logic Apps zpřístupnit soubory hostitelů IBM v binárním formátu ve standardních pracovních postupech. Tento požadavek snižuje složitost tohoto řešení a umožňuje používat nástroje pro přístup k datům v souborech hostitelů a jejich správu. Jakmile soubor hostitele zpřístupníte na místě, kde může pracovní postup Standard použít trigger ke čtení souboru, může operace konektoru IBM Host File parsovat tento soubor.
Pro zákazníky, kteří mají zájem o přístup k databázím, jako je SQL Server nebo Cosmos DB, ve svých sálových prostředích poskytuje konektor IBM Host File možnost generovat hostitelské soubory ve formátu JSON. Díky tomu můžete tyto hostitelské soubory použít ve zvolené cloudové databázi a odeslat data zpět jako soubor hostitele do sálového nebo středního uspořádání prostředí.
Následující diagram znázorňuje, jak konektor IBM Host File v Azure Logic Apps komunikuje s jinými systémy:
Pokud chcete rozšířit hybridní cloudové scénáře, konektor IBM Host File spolupracuje s HIS Designerem pro Logic Apps, který můžete použít k vytvoření definice dat nebo mapování dat souboru hostitele sálového počítače. Pro tuto úlohu nástroj HIS Designer převede tato data na metadata, která konektor IBM Host File používá při spuštění akce ve vašem pracovním postupu. Konektor provádí převody datových typů, které jsou nutné k příjmu vstupu z předchozích operací pracovního postupu a k odesílání výstupu pro použití následnými akcemi pracovního postupu. Konektor také poskytuje definici tabulkových dat a překlad znakové stránky.
Po vygenerování souboru metadat jako souboru XML návrháře integrace hostitele (HIDX) z HIS Designeru můžete tento soubor přidat jako artefakt mapy do prostředku aplikace logiky Standard. Pracovní postup tak může při přidání akce konektoru IBM Host File přistupovat k metadatům aplikace. Konektor načte soubor metadat z prostředku aplikace logiky a dynamicky prezentuje strukturu binárního souboru, která se použije s akcemi konektoru IBM Host File ve vašem pracovním postupu.
Připojení otechnické referenční informace
Následující část popisuje operace pro konektor IBM Host File , který aktuálně obsahuje pouze následující akce:
Akce Analyzovat obsah souboru hostitele
| Parametr | Požaduje se | Typ | Popis |
|---|---|---|---|
| Název HIDX | Ano | Řetězec | Vyberte soubor hostitele sálového počítače HIDX, který chcete použít. |
| Název schématu | Ano | Řetězec | Vyberte schéma souboru hostitele v souboru HIDX, který chcete použít. |
| Binární obsah | Ano | Binární | Vyberte binární data s záznamem s pevnou délkou extrahovaným z sálového počítače. |
Akce Generovat obsah souboru hostitele
| Parametr | Požaduje se | Typ | Popis |
|---|---|---|---|
| Název HIDX | Ano | Řetězec | Vyberte soubor hostitele sálového počítače HIDX, který chcete použít. |
| Název schématu | Ano | Řetězec | Vyberte schéma souboru hostitele v souboru HIDX, který chcete použít. |
| Řádky | Ano | JSON | Vyberte pole nebo jednotlivé řádky. Pokud chcete zadat celý datový objekt ve formátu JSON, můžete vybrat možnost Přepnout na vstup celé pole . |
Omezení
Tento konektor v současné době vyžaduje, abyste soubor HIDX nahráli přímo do prostředku aplikace logiky Standard, ne do účtu integrace.
Předpoklady
Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.
Soubor XML (HIDX) návrháře integrace hostitelů, který poskytuje potřebná metadata pro konektor IBM Host File pro rozpoznávání datové struktury souboru hostitele.
Pokud chcete vytvořit tento soubor HIDX, stáhněte a nainstalujte HIS Designer pro Azure Logic Apps. Jediným předpokladem je microsoft .NET Framework 4.8.
Abyste mohli efektivně analyzovat a generovat hostitelské soubory, musí váš pracovní postup porozumět metadatům souboru hostitele. Jako klíčový rozdíl mezi hostitelským souborem a tabulkou databáze ale soubor hostitele neobsahuje metadata popisující datovou strukturu. K vytvoření těchto metadat použijte HIS Designer pro Logic Apps. Pomocí tohoto nástroje můžete ručně vytvořit strukturu souborů hostitele, kterou pracovní postup používá. Můžete také importovat definice COBOL (copybooky), které poskytují tyto datové struktury.
Nástroj vygeneruje soubor XML (HIDX) návrháře integrace hostitelů, který konektoru poskytuje potřebná metadata pro rozpoznávání datové struktury souboru hostitele. Pokud používáte HIS, můžete pomocí Návrháře TI vytvořit soubor HIDX.
Pracovní postup standardní aplikace logiky, ve kterém chcete analyzovat nebo generovat soubor hostitele.
Konektor IBM Host File nemá triggery, takže ke spuštění pracovního postupu použijte žádný trigger, například trigger opakování nebo trigger služby Azure Blob Storage. Pak můžete přidat akce konektoru IBM Host File . Začněte vytvořením prázdného pracovního postupu v prostředku aplikace logiky Standard.
Definování a generování metadat
Po stažení a instalaci HIS Designeru pro Azure Logic Apps pomocí následujícího postupu vygenerujte soubor HIDX z artefaktu metadat.
Nahrání souboru HIDX
Aby váš pracovní postup používal soubor HIDX, postupujte takto:
Přejděte do složky, do které jste uložili soubor HIDX, a zkopírujte soubor.
Na webu Azure Portal nahrajte soubor HIDX jako mapu k prostředku aplikace logiky Standard.
Teď do pracovního postupu přidejte akci IBM Host File.
Když později v této příručce přidáte do pracovního postupu akci Analyzovat obsah souboru hostitele poprvé, zobrazí se výzva k vytvoření připojení. Po vytvoření připojení můžete vybrat dříve přidaný soubor HIDX, schéma a parametry, které se mají použít.
Přidání akce Analyzovat obsah souboru hostitele
Na webu Azure Portal otevřete prostředek aplikace logiky Standard a pracovní postup v návrháři.
Pokud jste ještě nepřidali trigger pro spuštění pracovního postupu, přidejte požadovanou aktivační událost podle těchto obecných kroků.
Tento příklad pokračuje s integrovanou aktivační událostí založenou na poskytovateli služeb Azure Blob Storage s názvem Při přidání nebo aktualizaci objektu blob.
Pokud chcete získat obsah z přidaného nebo aktualizovaného objektu blob, postupujte podle těchto obecných kroků a přidejte akci integrovaného konektoru služby Azure Blob Storage s názvem Čtení obsahu objektu blob.
Po zobrazení podokna podrobností o připojení zadejte následující informace:
Parametr Požaduje se Hodnota Popis Název připojení Ano <název připojení> Název připojení Znaková stránka No <code-page> Číslo znakové stránky, které se má použít pro převod textu Pochází z iSeries No <mf-iseries> Zda soubor pochází ze serveru i Series Příklad:
Až budete hotovi, vyberte Vytvořit nový.
Po zobrazení podokna podrobností akce zadejte v části Parametry požadované informace:
Parametr Požaduje se Hodnota Popis Název HIDX Ano <Název souboru HIDX> Vyberte soubor hostitele sálového počítače HIDX, který chcete použít. Název schématu Ano <název schématu> Vyberte schéma v souboru HIDX, který chcete použít. Binární obsah Ano <binární obsah> Vyberte binární data s záznamem s pevnou délkou extrahovaným z hostitele. Například následující obrázek ukazuje Visual Studio s ukázkovým souborem hostitele HIDX s tabulkou CUSTOMER a schématem CUSTOMER_RECORD v HIS Designeru pro Logic Apps:
Zadání souboru a schématu HIDX
Výběr binárních dat pro čtení z objektu blob
Po dokončení bude akce Analyzovat obsah souboru hostitele vypadat jako v následujícím příkladu s následnou akcí, která vytvoří soubor na serveru SFTP:
Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.
Přidání akce Generovat obsah souboru hostitele
Na webu Azure Portal otevřete prostředek aplikace logiky Standard a pracovní postup v návrháři.
Pokud jste ještě nepřidali trigger pro spuštění pracovního postupu, přidejte požadovanou aktivační událost podle těchto obecných kroků.
Tento příklad pokračuje s integrovanou aktivační událostí založenou na poskytovateli služeb Azure Blob Storage s názvem Při přidání nebo aktualizaci objektu blob.
Pokud chcete získat obsah z přidaného nebo aktualizovaného objektu blob, postupujte podle těchto obecných kroků a přidejte akci integrovaného konektoru služby Azure Blob Storage s názvem Čtení obsahu objektu blob.
Pomocí těchto obecných kroků přidejte integrovanou akci konektoru IBM Host File s názvem Generovat obsah souboru hostitele.
Po zobrazení podokna podrobností o připojení zadejte následující informace:
Parametr Požaduje se Hodnota Popis Název připojení Ano <název připojení> Název připojení Znaková stránka No <code-page> Číslo znakové stránky, které se má použít pro převod textu Pochází z iSeries No <mf-iseries> Zda soubor pochází ze serveru i Series Příklad:
Až budete hotovi, vyberte Vytvořit nový.
Po zobrazení podokna podrobností akce zadejte v části Parametry požadované informace:
Parametr Požaduje se Hodnota Popis Název HIDX Ano <Název souboru HIDX> Zadejte název souboru hostitele sálového počítače HIDX, který chcete použít. Název schématu Ano <název schématu> Zadejte název schématu v souboru HIDX, který chcete použít. Řádky Ano <Řádky> Zadejte pole záznamů, které chcete převést na formát IBM. Pokud chcete vybrat výstup z předchozí operace pracovního postupu, postupujte takto:
1. Vyberte uvnitř pole Řádky a pak vyberte možnost dynamického obsahu (blesk).
2. Ze seznamu dynamického obsahu vyberte výstup z předchozí akce. Například v části Čtení obsahu objektu blob vyberte Odpověď z akce Čtení objektu blob Obsah.
Tip: Pokud chcete zadat celý datový objekt ve formátu JSON, vyberte možnost Přepnout na celé pole .Například následující obrázek ukazuje Visual Studio s ukázkovým souborem HIDX v HIS Designeru pro Logic Apps:
Zadání souboru a schématu HIDX
Výběr řádků z objektu blob pro čtení a převod
Po dokončení bude akce Generovat obsah souboru hostitele vypadat jako v následujícím příkladu s následnou akcí, která vytvoří soubor na serveru SFTP:
Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.
Otestování pracovního postupu
Pokud chcete pracovní postup spustit, v nabídce pracovního postupu vyberte Přehled. Na panelu nástrojů Přehled vyberte Spustit>spuštění.
Po dokončení spuštění pracovního postupu se zobrazí historie spuštění pracovního postupu. Úspěšné kroky zobrazují značky zaškrtnutí, zatímco neúspěšné kroky zobrazují vykřičník (!).
Pokud chcete zkontrolovat vstupy a výstupy pro každý krok, rozbalte tento krok.
Pokud chcete zkontrolovat výstupy, vyberte Zobrazit nezpracované výstupy.
Další kroky
- Monitorování stavu spuštění pracovního postupu, kontrola historie spuštění triggeru a pracovního postupu a nastavení upozornění v Azure Logic Apps
- Zobrazení metrik stavu a výkonu pracovního postupu v Azure Logic Apps
- Monitorování a shromažďování diagnostických dat pro pracovní postupy v Azure Logic Apps
- Povolení a zobrazení rozšířené telemetrie v Přehledy aplikací pro standardní pracovní postupy v Azure Logic Apps