Parsa och generera värdfiler från IBM-stordatorer för Standard-arbetsflöden i Azure Logic Apps
Gäller för: Azure Logic Apps (Standard)
Om du vill parsa och generera nya IBM-värdfiler och fysiska i Series-filer från Standard-arbetsflöden i Azure Logic Apps kan du använda den inbyggda, tjänstleverantörsbaserade anslutningsappen IBM Host File . Sedan införandet av stordatorsystem används allestädes närvarande värdfiler för att lagra rikliga data för verksamhetskritiska system. Även om den här anslutningsappen inte kräver åtkomst till en IBM-stordator eller mellanregistersystem måste du göra värdfilen tillgänglig för ett Standard-arbetsflöde med hjälp av andra mekanismer som FTP, bloblagring, värdintegreringsserver eller en partnerprogramvara. IBM Host File-anslutningsappen är tillgänglig i alla Azure Logic Apps-regioner förutom Azure Government och Microsoft Azure som drivs av 21Vianet.
Den här instruktionsguiden beskriver följande aspekter av IBM Host File-anslutningsappen:
Varför använda IBM Host File-anslutningsappen i Azure Logic Apps
Krav och installation för att använda IBM Host File-anslutningsappen
Steg för att lägga till ÅTGÄRDER för IBM-värdfilsanslutning i ditt standardarbetsflöde för logikappar
Varför ska du använda den här anslutningsappen?
På IBM-stordatorer hanterar åtkomstmetoder, som är särskilda komponenter i operativsystemet, filbearbetning. På 1970-talet byggdes Virtual Storage Access Method (VSAM) och blev den mest använda åtkomstmetoden på IBM-stordatorer. VSAM tillhandahåller följande typer av filer: postsekvenserade datauppsättningar, nyckelsekvenserade datamängder och relativa postdatauppsättningar.
Idag har marknaden flera lösningar som ansluter direkt till värdfiler och kör dataåtgärder. Många lösningar kräver att du installerar programvara på stordatorsystemet. Även om det här alternativet fungerar bra för vissa kunder vill andra undvika att öka fotavtrycket i sina stordatorsystem.
Microsoft Host Integration Server (HIS) tillhandahåller ett hanterat kort för värdfiler och kräver inte installation av programvara på stordatorn. HIS kräver dock att du aktiverar undersystemet IBM Distributed File Manager (DFM), som kräver LU 6.2. Den här hanterade providern kräver också att du konfigurerar en SNA-gateway (HIS System Network Architecture) som ger åtkomst till DFM.
På de flesta sätt fungerar den hanterade providern som en vanlig dataprovider. Du kan ansluta till ett värdfilsystem, köra kommandon och hämta data. Även om det är ett bra alternativ för vissa kunder kräver IBM Host File Connector att du gör IBM-värdfiler tillgängliga i binärt format till Standard-arbetsflöden i Azure Logic Apps. Det här kravet minskar komplexiteten i den här lösningen och gör att du kan använda ditt val av verktyg för att komma åt och hantera data i värdfiler. När du har tillgängliggörat värdfilen på en plats där Standard-arbetsflödet kan använda en utlösare för att läsa filen, kan IBM Host File Connector-åtgärden parsa filen.
För kunder som är intresserade av att komma åt och använda databaser, till exempel SQL Server eller Cosmos DB, i sina stordatormiljöer, ger IBM Host File Connector möjlighet att generera värdfiler i JSON-format. På så sätt kan du använda dessa värdfiler i valfri molndatabas och skicka tillbaka data som en värdfil till din stordator eller mellanregistermiljöer.
Följande diagram visar hur IBM Host File-anslutningsappen i Azure Logic Apps interagerar med andra system:
För att utöka hybridmolnscenarier fungerar IBM Host File-anslutningsappen med HIS Designer for Logic Apps, som du kan använda för att skapa en datadefinition eller datakarta över stordatorns värdfil. För den här uppgiften konverterar HIS-designern dessa data till metadata som IBM Host File-anslutningsappen använder när du kör en åtgärd i arbetsflödet. Anslutningsappen utför datatypskonverteringar, som krävs för att ta emot indata från föregående arbetsflödesåtgärder och för att skicka utdata för användning av efterföljande arbetsflödesåtgärder. Anslutningsappen innehåller även tabelldatadefinition och kodsideöversättning.
När du har genererat metadatafilen som en HIDX-fil (Host Integration Designer) från HIS Designer kan du lägga till den filen som en kartartefakt i din standardlogikappresurs. På så sätt kan arbetsflödet komma åt appens metadata när du lägger till en IBM Host File Connector-åtgärd . Anslutningsappen läser metadatafilen från logikappens resurs och presenterar dynamiskt den binära filens struktur som ska användas med IBM Host File Connector-åtgärderna i arbetsflödet.
Anslut eller teknisk referens
I följande avsnitt beskrivs åtgärderna för IBM Host File-anslutningsappen, som för närvarande endast innehåller följande åtgärder:
Parsa åtgärden Värdfilinnehåll
| Parameter | Obligatoriskt | Type | Description |
|---|---|---|---|
| HIDX-namn | Ja | String | Välj den HIDX-fil för stordator som du vill använda. |
| Schemanamn | Ja | String | Välj värdfilschemat i HIDX-filen som du vill använda. |
| Binärt innehåll | Ja | Binära | Välj binära data med en post med fast längd som extraherats från stordatorn. |
Åtgärden Generera värdfilinnehåll
| Parameter | Obligatoriskt | Type | Description |
|---|---|---|---|
| HIDX-namn | Ja | String | Välj den HIDX-fil för stordator som du vill använda. |
| Schemanamn | Ja | String | Välj värdfilschemat i HIDX-filen som du vill använda. |
| Rader | Ja | JSON | Välj matrisen eller enskilda rader. Om du vill ange ett helt dataobjekt i JSON-format kan du välja alternativet Växla till indata för hela matrisen . |
Begränsningar
För närvarande kräver den här anslutningsappen att du laddar upp DIN HIDX-fil direkt till standardlogikappresursen, inte till ett integrationskonto.
Förutsättningar
Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.
FILEN HOST Integration Designer XML (HIDX) som tillhandahåller nödvändiga metadata för IBM Host File-anslutningsappen för att identifiera värdfilsdatastrukturen.
Om du vill skapa den här HIDX-filen laddar du ned och installerar HIS Designer för Azure Logic Apps. Det enda kravet är Microsoft .NET Framework 4.8.
För att effektivt parsa och generera värdfiler måste arbetsflödet förstå värdens filmetadata. Men som en viktig skillnad mellan en värdfil och en databastabell har värdfilen inte de metadata som beskriver datastrukturen. Om du vill skapa dessa metadata använder du HIS Designer för Logic Apps. Med det här verktyget kan du manuellt skapa den värdfilstruktur som arbetsflödet använder. Du kan också importera COBOL-definitioner (copybooks) som tillhandahåller dessa datastrukturer.
Verktyget genererar en HIDX-fil (Host Integration Designer) som tillhandahåller nödvändiga metadata för att anslutningsappen ska kunna identifiera värdfilsdatastrukturen. Om du använder HIS kan du använda TI Designer för att skapa HIDX-filen.
Arbetsflödet för standardlogikappen där du vill parsa eller generera värdfilen.
IBM Host File-anslutningsappen har inga utlösare, så använd någon utlösare för att starta arbetsflödet, till exempel upprepningsutlösaren eller Azure Blob Storage-utlösaren. Du kan sedan lägga till åtgärderna för IBM Host File Connector . Kom igång genom att skapa ett tomt arbetsflöde i standardlogikappresursen.
Definiera och generera metadata
När du har laddat ned och installerat HIS Designer för Azure Logic Apps följer du de här stegen för att generera HIDX-filen från metadataartefakten.
Ladda upp HIDX-filen
Följ dessa steg för att arbetsflödet ska använda HIDX-filen:
Gå till mappen där du sparade HIDX-filen och kopiera filen.
I Azure-portalen laddar du upp HIDX-filen som en karta till din standardlogikappresurs.
Senare i den här guiden uppmanas du att skapa en anslutning när du lägger till åtgärden Parsa värdfilinnehåll i arbetsflödet för första gången. När du har skapat anslutningen kan du välja din tidigare tillagda HIDX-fil, schemat och de parametrar som ska användas.
Lägg till åtgärden Parsa värdfilinnehåll
Öppna din standardlogikappresurs och ditt arbetsflöde i designern i Azure-portalen.
Om du inte redan har lagt till en utlösare för att starta arbetsflödet följer du de här allmänna stegen för att lägga till den utlösare som du vill använda.
Det här exemplet fortsätter med den inbyggda, tjänstleverantörsbaserade utlösaren Azure Blob Storage med namnet När en blob läggs till eller uppdateras.
Om du vill hämta innehållet från den tillagda eller uppdaterade bloben följer du de här allmänna stegen för att lägga till den inbyggda anslutningsåtgärden För Azure Blob Storage med namnet Läs blobinnehåll.
När fönstret med anslutningsinformation visas anger du följande information:
Parameter Obligatoriskt Värde Description Anslutningsnamn Ja <anslutningsnamn> Namnet på anslutningen Kodsida Inga <kodsida> Det kodsidenummer som ska användas för att konvertera text Från iSeries Inga <mf-iseries> Om filen kommer från en i Series-server Till exempel:
När du är klar väljer du Skapa ny.
När åtgärdsinformationsfönstret visas anger du nödvändig information i avsnittet Parametrar :
Parameter Obligatoriskt Värde Description HIDX-namn Ja <HIDX-file-name> Välj den HIDX-fil för stordator som du vill använda. Schemanamn Ja <schemanamn> Välj schemat i HIDX-filen som du vill använda. Binärt innehåll Ja <binärt innehåll> Välj binära data med en post med fast längd som extraherats från värden. Följande bild visar till exempel Visual Studio med en HIDX-exempelfil med en CUSTOMER-tabell och CUSTOMER_RECORD schema i HIS Designer for Logic Apps:
Ange HIDX-fil och -schema
Välj binära data att läsa från blob
När du är klar ser åtgärden Parsa värdfilinnehåll ut som i följande exempel med en efterföljande åtgärd som skapar en fil på en SFTP-server:
Spara arbetsflödet när du är klar. I designerverktygsfältet väljer du Spara.
Lägg till åtgärden Generera värdfilinnehåll
Öppna din standardlogikappresurs och ditt arbetsflöde i designern i Azure-portalen.
Om du inte redan har lagt till en utlösare för att starta arbetsflödet följer du de här allmänna stegen för att lägga till den utlösare som du vill använda.
Det här exemplet fortsätter med den inbyggda, tjänstleverantörsbaserade utlösaren Azure Blob Storage med namnet När en blob läggs till eller uppdateras.
Om du vill hämta innehållet från den tillagda eller uppdaterade bloben följer du de här allmänna stegen för att lägga till den inbyggda anslutningsåtgärden För Azure Blob Storage med namnet Läs blobinnehåll.
När fönstret med anslutningsinformation visas anger du följande information:
Parameter Obligatoriskt Värde Description Anslutningsnamn Ja <anslutningsnamn> Namnet på anslutningen Kodsida Inga <kodsida> Det kodsidenummer som ska användas för att konvertera text Från iSeries Inga <mf-iseries> Om filen kommer från en i Series-server Till exempel:
När du är klar väljer du Skapa ny.
När åtgärdsinformationsfönstret visas anger du nödvändig information i avsnittet Parametrar :
Parameter Obligatoriskt Värde Description HIDX-namn Ja <HIDX-file-name> Ange namnet på den HIDX-fil för stordatorns värdfil som du vill använda. Schemanamn Ja <schemanamn> Ange namnet på schemat i HIDX-filen som du vill använda. Rader Ja <Rader> Ange en matris med poster som ska konverteras till IBM-format. Följ dessa steg för att välja utdata från en föregående arbetsflödesåtgärd:
1. Välj i rutan Rader och välj sedan alternativet dynamiskt innehåll (blixt).
2. I listan med dynamiskt innehåll väljer du utdata från en föregående åtgärd. I avsnittet Läsa blobinnehåll väljer du till exempel Svar från läsblobåtgärden Innehåll.
Tips: Om du vill ange ett helt dataobjekt i JSON-format väljer du alternativet Växla till indata för hela matrisen .Följande bild visar till exempel Visual Studio med en HIDX-exempelfil i HIS Designer for Logic Apps:
Ange HIDX-fil och -schema
Välj rader från blob för att läsa och konvertera
När du är klar ser åtgärden Generera värdfilinnehåll ut som i följande exempel med en efterföljande åtgärd som skapar en fil på en SFTP-server:
Spara arbetsflödet när du är klar. I designerverktygsfältet väljer du Spara.
Testa arbetsflödet
Om du vill köra arbetsflödet går du till arbetsflödesmenyn och väljer Översikt. I verktygsfältet Översikt väljer du Kör>kör.
När arbetsflödet har körts visas arbetsflödets körningshistorik. Lyckade steg visar bockmarkeringar, medan misslyckade steg visar ett utropstecken (!).
Om du vill granska indata och utdata för varje steg expanderar du det steget.
Om du vill granska utdata väljer du Visa råutdata.
Nästa steg
- Övervaka status för arbetsflödeskörning, granska körningshistorik för utlösare och arbetsflöden och konfigurera aviseringar i Azure Logic Apps
- Visa mått för arbetsflödets hälsa och prestanda i Azure Logic Apps
- Övervaka och samla in diagnostikdata för arbetsflöden i Azure Logic Apps
- Aktivera och visa förbättrad telemetri i Application Insights för Standard-arbetsflöden i Azure Logic Apps