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ände utvecklare 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. Du kan göra filen tillgänglig via FTP, "Azure Blob Storage", värdintegrationsserver 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 :

• Scenarier för att använda IBM Host File Connector 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 Host File-kopplingen i ditt standardarbetsflöde för logikappar

Granska scenarier för användning av kontakter

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 specifika typer av filer, inklusive inmatningssekvenserade datamängder, nyckelsekvenserade datamängder och relativa postdatauppsättningar.

Den aktuella marknaden erbjuder 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) erbjuder en hanterad adapter för värdfiler och kräver inte installation av någon programvara på stordatorn. HIS kräver dock att du aktiverar undersystemet IBM Distributed File Manager (DFM), som kräver LU-protokollet (Logical Unit) protokoll 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 här alternativet ä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 lösningens komplexitet 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 i sina stordatormiljöer, till exempel SQL Server eller Azure Cosmos DB, ger IBM Host File-anslutningsappen möjlighet att generera värdfiler i JSON-format. Med den här metoden kan du använda värdfilerna i valfri molndatabas och skicka tillbaka data som en värdfil till din stordator eller mellanlagringsmiljöer.

Följande diagram visar hur IBM Host File Connector i Azure Logic Apps interagerar med andra system för att läsa, parsa och generera värdfilinnehåll:

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 data till metadata som IBM Host File Connector använder för att köra åtgärder 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. Med den här metoden 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.

Teknisk referens för anslutningar

I det här avsnittet beskrivs tillgängliga åtgärder för IBM Host File-anslutningsappen . För närvarande stöds två åtgärder: Parsa innehållet i värdfilen och Generera värdfilinnehåll.

Åtgärden för att parsa värdfileninnehåll

I följande tabell sammanfattas parametrarna för åtgärden Parsa värdfilinnehåll :

Åtgärden Generera värdfilinnehåll

I följande tabell sammanfattas parametrarna för åtgärden Generera värdfilinnehåll :

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 ditt arbetsflöde förstå värdfilsmetadata. 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 HIS Transaction Integrator (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 IBM Host File Connector-åtgärder. För att komma igång skapar du ett tomt arbetsflöde i din Standard Logic App-resurs.

Begränsningar

För tillfället kräver den här anslutningen att du laddar upp din HIDX-fil direkt till standard-logikappresursen, inte till ett integrationskonto.

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:

1. Gå till mappen där du sparade HIDX-filen och kopiera filen.

2. I Azure-portalenladdar du upp HIDX-filen som en karta till din standardlogikappresurs.

3. Fortsätt till nästa avsnitt för att lägga till en IBM-värdfil åtgärd till ditt arbetsflöde.

Senare i den här guiden, när du lägger till åtgärden Parsa värdfilinnehåll i arbetsflödet för första gången, uppmanas du att skapa en anslutning. 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

Följ de här stegen för att lägga till åtgärden Parsa värdfilinnehåll:

1. I Azure-portalen öppnar du din standardlogikappresurs och arbetsflöde i designern.

2. Om du inte har någon 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:

   

3. Om du vill hämta innehållet från den tillagda eller uppdaterade bloben lägger du till den inbyggda anslutningsåtgärden Azure Blob Storage med namnet Läs blobinnehåll genom att följa dessa allmänna steg.

4. Lägg till den inbyggda anslutningsåtgärden IBM-värdfil med namnet Parsa värdfilinnehåll genom att följa dessa allmänna steg.

5. När fönstret med anslutningsinformation visas anger du följande information:

   Parameter	Krävs	Värde	Beskrivning
   Anslutningsnamn	Ja	< anslutningsnamn>	Namnet på anslutningen.
   Kodsida	Nej	< kodsida>	Det kodsidenummer som ska användas för att konvertera text.
   Från iSeries	Nej	< mf-iseries>	Ange om filen kommer från en i Series-server.

   Till exempel:

   

6. När du är klar väljer du Skapa ny.

7. När åtgärdsinformationsfönstret visas anger du nödvändig information i avsnittet Parametrar :

   Parameter	Krävs	Värde	Beskrivning
   HIDX-namn	Ja	< HIDX-file-name>	Välj den HIDX-fil för värddator 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 ett exempel på en värdfil (HIDX) som innehåller en CUSTOMER-tabell och CUSTOMER_RECORD schema i HIS Designer för Logic Apps.

   

   1. Konfigurera HIDX-namnet och schemanamnet med värden från HIDX-filen:

      

   2. För Binärt innehåll väljer du listan med dynamiskt innehåll (blixtikon) och väljer alternativet Svar från läsblobåtgärden Innehåll :

      

      Den fullständiga åtgärden Parsa värdfilinnehåll ser ut som i följande exempel:

      

   3. Lägg nu till en annan åtgärd för att hantera resultatet:

      Det här exemplet lägger till en åtgärd för att skapa en fil på en FTP-server (File Transfer Protocol) genom att följa dessa allmänna steg:

      

8. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

Testa arbetsflödet

Följ dessa steg för att bekräfta att arbetsflödet körs som förväntat:

1. Om du vill köra arbetsflödet väljer du Kör>kör i designerverktygsfältet.

   När arbetsflödet har körts klart visas historiken för arbetsflödeskörningen. Lyckade steg visar bockmarkeringar, medan misslyckade steg visar ett utropstecken (!).

2. Om du vill granska indata och utdata för varje steg expanderar du det steget.

3. Om du vill granska utdata väljer du Visa råutdata.

Lägg till åtgärden Generera värdfilinnehåll

Följ dessa steg för att lägga till åtgärden Generera värdfilinnehåll:

1. I Azure-portalen öppnar du din standardlogikappresurs och arbetsflöde i designern.

2. Om du inte har någon 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:

   

3. Om du vill hämta innehållet från den tillagda eller uppdaterade bloben lägger du till den inbyggda anslutningsåtgärden Azure Blob Storage med namnet Läs blobinnehåll genom att följa dessa allmänna steg.

4. Lägg till den inbyggda anslutningsåtgärden IBM-värdfil med namnet Generera värdfilinnehåll genom att följa dessa allmänna steg.

5. När fönstret med anslutningsinformation visas anger du följande information:

   Parameter	Krävs	Värde	Beskrivning
   Anslutningsnamn	Ja	< anslutningsnamn>	Namnet på anslutningen.
   Kodsida	Nej	< kodsida>	Det kodsidenummer som ska användas för att konvertera text.
   Från iSeries	Nej	< mf-iseries>	Ange om filen kommer från en i Series-server.

   Till exempel:

   

6. När du är klar väljer du Skapa ny.

7. När åtgärdsinformationsfönstret visas anger du nödvändig information i avsnittet Parametrar :

   Parameter	Krävs	Värde	Beskrivning
   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 lista med poster att konvertera 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 inuti rutan Rader och välj sedan alternativet för 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:

   

   1. Konfigurera HIDX-namnet och schemanamnet med värden från HIDX-filen:

      

   2. För fältet Rader>radobjekt – 1 väljer du listan med dynamiskt innehåll (blixtikonen) och väljer alternativet Svar från läsblobåtgärden Innehåll :

      

      Åtgärden Generera värdfilinnehåll ser ut som i följande exempel:

      

   3. Lägg nu till ytterligare en åtgärd för att hantera resultatet.

      Det här exemplet lägger till en åtgärd för att skapa en fil på en FTP-server (File Transfer Protocol) genom att följa dessa allmänna steg:

      

8. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

Testa arbetsflödet

Följ dessa steg för att bekräfta att arbetsflödet körs som förväntat:

1. Om du vill köra arbetsflödet väljer du Kör>kör i designerverktygsfältet.

   När arbetsflödet har körts klart visas historiken för arbetsflödeskörningen. Lyckade steg visar bockmarkeringar, medan misslyckade steg visar ett utropstecken (!).

2. Om du vill granska indata och utdata för varje steg expanderar du det steget.

3. Om du vill granska utdata väljer du Visa råutdata.

Relaterat innehåll

• Kontrollera arbetsflödesstatus, visa körningshistorik 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