Ansluta till FTP-servrar från arbetsflöden i Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

Den här artikeln visar hur du kommer åt FTP-servern (File Transfer Protocol) från ett arbetsflöde i Azure Logic Apps med FTP-anslutningsappen. Du kan skapa automatiserade arbetsflöden som körs när de utlöses av händelser på FTP-servern eller i andra system och köra åtgärder för att hantera filer på FTP-servern.

Arbetsflödet kan till exempel börja med en FTP-utlösare som övervakar och svarar på händelser på FTP-servern. Utlösaren gör utdata tillgängliga för åtgärder i arbetsflödet. Arbetsflödet kan köra FTP-åtgärder som skapar, skickar, tar emot och hanterar filer via ditt FTP-serverkonto med hjälp av följande specifika uppgifter:

• Övervaka när filer läggs till eller ändras.
• Skapa, kopiera, ta bort, lista och uppdatera filer.
• Hämta filmetadata och innehåll.
• Hantera mappar.

Om du inte har använt Azure Logic Apps tidigare kan du läsa följande dokumentation:

• Vad är Azure Logic Apps?
• Snabbstart: Skapa ett exempelarbetsflöde för en logikapp för Förbrukning

Teknisk referens för anslutningar

FTP-anslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.

Begränsningar

• Kapacitet och dataflöde

  • Inbyggd anslutning för standardarbetsflöden:

    Som standard kan FTP-åtgärder läsa eller skriva filer som är 200 MB eller mindre. För närvarande stöder inte den inbyggda FTP-anslutningsappen segmentering.

  • Hanterad koppling för förbruknings- och standardarbetsflöden

    Som standard kan FTP-åtgärder läsa eller skriva filer som är 50 MB eller mindre. För att hantera filer som är större än 50 MB stöder FTP-åtgärder segmentering av meddelanden. Åtgärden Hämta filinnehåll använder implicit segmentering.

• Utlösare för FTP-hanterad eller Azure-värdbaserad anslutning kan uppleva saknade, ofullständiga eller fördröjda resultat när den senast ändrade tidsstämpeln bevaras. Å andra sidan har den inbyggda FTP-anslutningsutlösaren i Standard Logic App-arbetsflöden inte den här begränsningen. Mer information finns i BEGRÄNSNINGAR för FTP-anslutningsappen.

• FTP-hanterad kopplingspunkt kan etablera ett begränsat antal anslutningar till FTP-servern. Gränsen baseras på anslutningskapaciteten i den Azure-region där logikappresursen finns. Om den här gränsen utgör ett problem i ett arbetsflöde för förbrukningslogikapp skapar du ett standardarbetsflöde för logikappar som använder den inbyggda FTP-anslutningsappen.

• Både den inbyggda och hanterade FTP-anslutningsappen stöder endast explicit FTP via FTPS, vilket är ett tillägg för TLS. Ingen av anslutningsversionerna stöder implicit FTPS.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.

• Arbetsflödet för logikappen där du vill komma åt ditt FTP-konto. Om du vill starta arbetsflödet med en FTP-utlösare måste du börja med ett tomt arbetsflöde. Om du vill använda en FTP-åtgärd startar du arbetsflödet med en annan utlösare, till exempel upprepningsutlösaren.

• Fler krav som gäller för både FTP-hanterad anslutningsapp och inbyggd anslutningsapp finns i referensen för FTP-hanterad anslutningsapp – Krav.

Åtkomst till App Service-webbplatsfiler med FTPS

Du kan använda FTP-anslutningen för att komma åt webbplatsfiler för en Standard Logic-app, funktionsapp eller App Service-app som stödjer FTP/S-distribution. Innan du skapar FTP-anslutningen, gör följande uppgifter för appen som innehåller filerna:

1. Aktivera både SCM Basic Auth-publiceringsautentiseringsuppgifter och FTP Basic Auth-publiceringsautentiseringsuppgifter. Grundläggande autentisering är inaktiverad som standard för nya appar.

   För mer information, se Hantera distributionsuppgifter för Azure App Service.

2. Ställ in appens FTP-tillstånd till endast FTPS och framställ TLS 1.2 eller senare.

   För mer information, se Enforce FTPS in Azure App Service.

3. Från appens distributionscenter hämtar du FTP/S-endpointen och applikations- eller användaromfångsutplaceringsuppgifter.

När du skapar FTP-anslutningen, använd följande värden:

Efter att du skapat anslutningen, använd /site/wwwroot som mappväg för att komma åt appens webbplatsfiler. För ett komplett exempel, se Kom åt webbplatsfiler för Logic Apps och App Services med FTPS med hjälp av Logic Apps.

Kända problem

Som standard har utlösare som accepterar och returnerar matriser vanligtvis en delningsinställning som redan är aktiverad. Utlösaren diskuterar automatiskt en matris genom att internt skapa en separat arbetsflödesinstans för att bearbeta varje matrisobjekt. Alla arbetsflödesinstanser körs parallellt så att matrisobjekten bearbetas samtidigt.

När inställningen Dela på är aktiverad returnerar hanterade anslutningsutlösare utdata för alla objekt i matrisen som listor. Alla efterföljande åtgärder som refererar till dessa utdata måste först hantera dessa utdata som listor. Om du vill hantera varje matrisobjekt individuellt kan du lägga till extra åtgärder. Om du till exempel vill iterera genom dessa matrisobjekt kan du använda en För varje loop. För utlösare som endast returnerar metadata eller egenskaper använder du en åtgärd som hämtar matrisobjektets metadata först och sedan använder en åtgärd för att hämta objektinnehållet.

Du måste endast använda den här metoden för hanterade anslutningsutlösare, inte för inbyggda anslutningsutlösare som returnerar utdata för ett matrisobjekt i taget när inställningen Dela på är aktiverad.

Anta till exempel att du har en utlösare för hanterad anslutning med namnet När en fil läggs till eller ändras (endast egenskaper) som returnerar metadata eller egenskaper för de nya eller uppdaterade filerna i form av matriser. Om du vill hämta metadata separat för varje fil kan du använda en För varje loop som itererar genom matrisen. I den här slingan använder du följande åtgärder för hanterade anslutningar i den angivna ordningen:

1. Använd Hämta filmetadata för att hämta metadata för varje fil.

2. Åtgärden Hämta filinnehåll för att hämta innehållet i varje fil.

Lägga till en FTP-utlösare

Ett arbetsflöde i en logikapp av typen Consumption kan bara använda den hanterade FTP-anslutningsappen. Ett Standard-arbetsflöde för Logic Apps kan dock använda den hanterade FTP-kopplingen och den inbyggda FTP-kopplingen.

Den FTP-hanterade anslutningen och den inbyggda anslutningen har var och en bara en tillgänglig utlösare:

• Utlösare för hanterad anslutning: FTP-utlösaren med namnet När en fil läggs till eller ändras (endast egenskaper) kör ett arbetsflöde i en Logic App av typen Consumption eller Standard när en eller flera filer läggs till eller ändras i en mapp på FTP-servern. Den här utlösaren hämtar endast filegenskaperna eller metadata, inte filinnehållet. För att hämta filinnehållet kan arbetsflödet följa den här utlösaren med andra FTP-åtgärder.

  Mer information finns i När en fil läggs till eller ändras (endast egenskaper).

• Inbyggd anslutningsutlösare: FTP-utlösaren med namnet När en fil läggs till eller uppdateras kör ett standardarbetsflöde för logikappar när en eller flera filer läggs till eller ändras i en mapp på FTP-servern. Den här utlösaren hämtar endast filegenskaperna eller metadata, inte filinnehållet. För att hämta innehållet kan arbetsflödet följa den här utlösaren med andra FTP-åtgärder. Mer information finns i När en fil läggs till eller uppdateras.

Följande procedurer använder Azure-portalen. Med motsvarande tillägg för Azure Logic Apps för Förbrukning eller Standard kan du istället använda följande verktyg för att skapa och redigera logikappens arbetsflöden.

• Logikapparbetsflöden för Consumption: Visual Studio Code
• Standardarbetsflöden i Visual Studio Code för Logic Apps

Det här avsnittet visar stegen för följande FTP-anslutningsutlösare:

• Inbyggd utlösare med namnet När en fil läggs till eller uppdateras

  Om du använder den här inbyggda FTP-utlösaren kan du hämta filinnehållet med hjälp av den inbyggda FTP-åtgärden Hämta filinnehåll utan att först använda åtgärden Hämta filmetadata , till skillnad från när du använder den FTP-hanterade utlösaren. Mer information om inbyggda FTP-anslutningsåtgärder finns i INBYGGDA FTP-anslutningsåtgärder.

  Den här inbyggda FTP-utlösaren är inte tillgänglig för arbetsflöden för förbrukningslogikappar.

• Hanterad utlösare med namnet När en fil läggs till eller ändras (endast egenskaper)

  Om du använder den här FTP-hanterade utlösaren måste du använda åtgärden Hämta filmetadata för att hämta ett enskilt matrisobjekt innan du använder någon annan åtgärd på filen som har lagts till eller ändrats. Den här lösningen beror på det kända problemet kring inställningen Dela på som beskrevs tidigare i den här artikeln.

Lägga till inbyggd anslutningsutlösare

Så här lägger du till en inbyggd anslutningsutlösare i ett Standard-arbetsflöde:

1. Öppna logikappresursen i Azure Portal.

2. På menyn på resurspanelen går du till Arbetsflöden, väljer Arbetsflöden och sedan ditt tomma arbetsflöde som öppnas i designern.

3. I designern väljer du Lägg till en utlösare.

4. Följ de allmänna stegen för att lägga till FTP-utlösaren När en fil läggs till eller uppdateras (förhandsversion).

5. Ange information för anslutningen. När du är klar väljer du Skapa ny.

   

   Kommentar

   Som standard överför den här anslutningsappen filer i textformat. Om du vill överföra filer i binärt format, till exempel var och när kodning används, väljer du alternativet binär transport.

6. När fönstret utlösarinformation visas anger du sökvägen till den mapp som du vill övervaka i rutan Mappsökväg .

   

7. Spara arbetsflödet när du är klar.

När du sparar arbetsflödet publicerar Azure dina uppdateringar till din distribuerade och aktiva logikapp i Azure. Med bara en utlösare kontrollerar arbetsflödet bara FTP-servern baserat på ditt angivna schema. Du måste lägga till en åtgärd som svarar på utlösaren och gör något med utlösarens utdata, enligt beskrivningen i senare avsnitt.

Lägg till utlösare för hanterad anslutning

Så här lägger du till en händelseutlösare för hanterad anslutning i ett arbetsflöde för förbrukning eller standard:

1. Leta upp och öppna logikappresursen i Azure-portalen.

2. Baserat på om du har en konsumtions- eller standardlogikapp:

   • Förbrukning: På menyn på resurspanelen går du till Utvecklingsverktyg och väljer designern för att öppna arbetsflödet.

   • Standard: Välj Arbetsflöden under Arbetsflöden på menyn på resurspanelen. Välj det tomma arbetsflödet som öppnas i designern.

3. I arbetsflödesdesignern väljer du Lägg till en utlösare.

4. Följ de allmänna stegen för att lägga till FTP-triggern när en fil läggs till eller ändras (endast egenskaper).

5. Ange information för anslutningen. När du är klar väljer du Skapa ny.

   

   Kommentar

   Som standard överför den här anslutningsappen filer i textformat. Om du vill överföra filer i binärt format, till exempel var och när kodning används, väljer du alternativet binär transport.

6. När informationsfönstret för utlösaren öppnas letar du reda på den mapp som du vill övervaka för nya eller redigerade filer.

   1. I rutan Mapp väljer du mappikonen för att visa mappkatalogen.

   2. Välj högerpilen (>). Bläddra till den mapp som du vill använda och välj sedan mappen.

   

   Den valda mappen visas i rutan Mapp .

   

7. Spara arbetsflödet när du är klar.

När du sparar arbetsflödet publicerar Azure dina uppdateringar till din distribuerade och aktiva logikapp. Med bara en utlösare kontrollerar arbetsflödet bara FTP-servern baserat på ditt angivna schema. Du måste lägga till en åtgärd som svarar på utlösaren och gör något med utlösarens utdata, enligt beskrivningen i senare avsnitt.

Lägga till en FTP-åtgärd

Ett arbetsflöde i en logikapp av typen Consumption kan bara använda den hanterade FTP-anslutningsappen. Ett standardarbetsflöde för logikappar kan använda den FTP-hanterade anslutningsappen och den inbyggda FTP-anslutningsappen. Varje version har flera åtgärder. Till exempel har både hanterade och inbyggda anslutningsversioner sina egna åtgärder för att hämta filmetadata och hämta filinnehåll.

• Inbyggda anslutningsåtgärder: Dessa åtgärder körs endast i ett standardarbetsflöde för logikappar.
• Åtgärder för hanterade anslutningsprogram: Dessa åtgärder körs i ett arbetsflöde för logikappar av typen Consumption eller Standard.

Följande procedurer använder Azure-portalen. Med motsvarande Azure Logic Apps-tillägg för Consumption eller Standard kan du istället använda följande verktyg för att skapa och redigera logikappsarbetsflöden:

• Förbrukningsarbetsflöden: Visual Studio Code
• Standardarbetsflöden: Visual Studio Code

Innan du kan använda en FTP-åtgärd måste arbetsflödet redan börja med en utlösare, vilket kan vara vilken typ du vill. Du kan till exempel använda den inbyggda utlösaren för allmän upprepning för att starta arbetsflödet enligt ett visst schema.

Stegen för att lägga till och använda en FTP-åtgärd skiljer sig beroende på om arbetsflödet använder den inbyggda anslutningsappen eller den hanterade anslutningsappen.

• Inbyggda utlösararbetsflöden: Beskriver stegen för att lägga till en inbyggd åtgärd i ett arbetsflöde som börjar med en inbyggd utlösare.

  Om du använde den inbyggda FTP-utlösaren och vill ha innehållet från en nyligen tillagd eller uppdaterad fil kan du använda en For each-loop för att iterera via matrisen som returneras av utlösaren. Du kan sedan bara använda åtgärden Hämta filinnehåll utan några andra mellanliggande åtgärder. Mer information om inbyggda FTP-anslutningsåtgärder finns i INBYGGDA FTP-anslutningsåtgärder.

• Arbetsflöden för hanterade utlösare: Beskriver stegen för att lägga till en hanterad åtgärd i ett arbetsflöde som börjar med en hanterad utlösare.

  Om du använde utlösaren för FTP-hanterad anslutningsprogram och vill ha innehållet från en nyligen tillagd eller ändrad fil, kan du använda en For each-loop för att iterera genom arrayen som returneras av utlösaren. Sedan måste du använda mellanliggande åtgärder, till exempel FTP-åtgärden Get file metadata (Hämta filmetadata ) innan du använder åtgärden Hämta filinnehåll .

Arbetsflöden med en inbyggd utlösare

Så här lägger du till åtgärder i ett Standard-arbetsflöde som börjar med en inbyggd anslutningsutlösare:

1. Leta upp och öppna logikappresursen i Azure-portalen.

2. På menyn på resurspanelen går du till Arbetsflöden och väljer Arbetsflöden. Välj arbetsflödet med den inbyggda FTP-utlösaren.

3. I designern följer du de här allmänna stegen för att lägga till FTP-åtgärden Get file content to your workflow ( Hämta filinnehåll i arbetsflödet).

4. Om det behövs anger du informationen för anslutningen. När du är klar väljer du Skapa ny.

   

   Kommentar

   Som standard överför den här anslutningsappen filer i textformat. Om du vill överföra filer i binärt format, till exempel var och när kodning används, väljer du alternativet binär transport.

5. I åtgärdsinformationsfönstret som öppnas väljer du i filsökvägen för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll.

   Nu kan du välja utdata från föregående utlösare.

6. I listan med dynamiskt innehåll går du till När en fil läggs till eller uppdateras väljer du Filsökväg.

   

   Egenskapen Filsökväg refererar nu till utdata från utlösaren Filsökväg.

   

7. Lägg till andra åtgärder som ditt arbetsflöde behöver.

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

Arbetsflöden med en hanterad utlösare

Lägg till åtgärder i ett konsumtions- eller standardarbetsflöde som börjar med en hanterad anslutningsutlösare:

1. Leta upp och öppna logikappresursen i Azure-portalen.

2. Baserat på om du har en konsumtions- eller standardlogikapp:

   • Förbrukning: På menyn på resurspanelen går du till Utvecklingsverktyg och väljer designern för att öppna arbetsflödet.

   • Standard: Välj Arbetsflöden under Arbetsflöden på menyn på resurspanelen. Välj det arbetsflöde som börjar med utlösaren med FTP-hanterad anslutning. I menyn för arbetsflödets sidofält väljer du designern för att öppna arbetsflödet.

3. I designern följer du de här allmänna stegen för att lägga till FTP-åtgärden Hämta filmetadata till ditt arbetsflöde.

4. Om det behövs anger du informationen för anslutningen. När du är klar väljer du Skapa ny.

   

   Kommentar

   Som standard överför den här anslutningsappen filer i textformat. Om du vill överföra filer i binärt format, till exempel var och när kodning används, väljer du alternativet binär transport.

5. I åtgärdsinformationsfönstret som öppnas väljer du i Arkiv för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll.

   Nu kan du välja utdata från föregående utlösare.

6. I listan med dynamiskt innehåll under När en fil läggs till eller ändras (endast egenskaper) väljer du Lista över fil-ID.

   Skärmbilden visar arbetsflödesdesignern med dynamisk innehållslista för åtgärden Hämta filmetadata öppnad, och Fil-ID-lista markerad.

   Egenskapen Fil refererar nu till utdata från utlösaren Lista över fil-ID:n.

   

7. I designern följer du de här allmänna stegen för att lägga till FTP-åtgärden Get file content to your workflow ( Hämta filinnehåll i arbetsflödet).

8. I åtgärdsinformationsfönstret som visas väljer du i Arkiv för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll.

   Nu kan du välja utdata från föregående utlösare eller åtgärder.

9. I listan med dynamiskt innehåll går du till Hämta filmetadata och väljer ID.

   

   Egenskapen Fil refererar nu till utdata från åtgärden Id.

   

10. Lägg till andra åtgärder som ditt arbetsflöde behöver.

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

Testa arbetsflödet

Om du vill kontrollera att arbetsflödet returnerar det innehåll som du förväntar dig lägger du till en annan åtgärd som skickar dig innehållet från den tillagda eller uppdaterade filen. I det här exemplet används office 365 Outlook-åtgärden med namnet Skicka ett e-postmeddelande.

Arbetsflöde med inbyggd utlösare och åtgärder

Så här lägger du till en Office 365 Outlook-åtgärd i standardarbetsflödet:

1. Under åtgärden Hämta filinnehåll i designern följer du de här allmänna stegen för att lägga till åtgärden Skicka ett e-postmeddelande till arbetsflödet.

   Om du har ett Outlook.com konto i stället lägger du till åtgärden Outlook.com Skicka ett e-postmeddelande .

2. Om det behövs loggar du in på ditt e-postkonto.

3. I åtgärdsinformationsfönstret anger du de värden som krävs och inkluderar eventuella andra parametrar eller egenskaper som du vill testa.

   Du kan till exempel inkludera filinnehållsutdata från åtgärden Hämta filinnehåll . Följ dessa steg för att hitta dessa utdata:

   1. I åtgärden Hämta filinnehåll väljer du i brödtexten för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll. I den här listan går du till Hämta filinnehåll och väljer Filinnehåll.

      

   2. I listan med dynamiskt innehåll går du till Hämta filinnehåll och väljer Filinnehåll.

      Egenskapen Body innehåller nu utdata för åtgärden Filinnehåll .

      

4. Spara arbetsflödet.

Följ dessa steg för att köra och utlösa arbetsflödet:

1. Välj Kör>kör i designerverktygsfältet.

2. Lägg till en fil i FTP-mappen som arbetsflödet övervakar.

Arbetsflöde med hanterad utlösare och åtgärder

Så här lägger du till en Office 365 Outlook-åtgärd i ditt förbruknings- eller standardarbetsflöde:

1. Under åtgärden Hämta filinnehåll i designern följer du de här allmänna stegen för att lägga till åtgärden Skicka ett e-postmeddelande till arbetsflödet.

   Om du har ett Outlook.com konto i stället lägger du till åtgärden Outlook.com Skicka ett e-postmeddelande .

2. Om det behövs loggar du in på ditt e-postkonto.

3. I åtgärdsinformationsrutan anger du de värden som krävs och inkluderar alla andra parametrar eller egenskaper som du vill testa.

   Du kan till exempel inkludera filinnehållsutdata från åtgärden Hämta filinnehåll . Följ dessa steg för att hitta dessa utdata:

   1. I åtgärden Hämta filinnehåll väljer du i rutan Brödtext för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll. I den här listan går du till Hämta filinnehåll och väljer Filinnehåll.

      

   2. I listan med dynamiskt innehåll går du till Hämta filinnehåll och väljer Filinnehåll.

      Egenskapen Body innehåller nu utdata för åtgärden Filinnehåll .

      

4. Spara arbetsflödet för logikappen.

Följ dessa steg för att köra och utlösa arbetsflödet:

1. Välj Kör>kör i designerverktygsfältet.

2. Lägg till en fil i FTP-mappen som arbetsflödet övervakar.

Relaterat innehåll

• Hanterade anslutningsprogram för Azure Logic Apps
• Inbyggda kopplingar för Azure Logic Apps
• Vad är kopplingar i Azure Logic Apps