Ansluta till lokala filsystem från arbetsflöden i Azure Logic Apps
Gäller för: Azure Logic Apps (Förbrukning + Standard)
Den här instruktionsguiden visar hur du får åtkomst till en lokal filresurs från ett arbetsflöde i Azure Logic Apps med hjälp av anslutningsappen för filsystem. Du kan sedan skapa automatiserade arbetsflöden som körs när de utlöses av händelser i filresursen eller i andra system och köra åtgärder för att hantera dina filer. Anslutningsappen innehåller följande funktioner:
- Skapa, hämta, lägga till, uppdatera och ta bort filer.
- Visa en lista över filer i mappar eller rotmappar.
- Hämta filinnehåll och metadata.
I den här instruktionsguiden visar exempelscenarierna följande uppgifter:
- Utlös ett arbetsflöde när en fil skapas eller läggs till i en filresurs och skicka sedan ett e-postmeddelande.
- Utlös ett arbetsflöde när du kopierar en fil från ett Dropbox-konto till en filresurs och skicka sedan ett e-postmeddelande.
Begränsningar och kända problem
- Filsystemanslutningsappen stöder för närvarande endast Windows-filsystem på Windows-operativsystem.
- Mappade nätverksenheter stöds inte.
Teknisk referens för anslutningsprogram
Filsystemanslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.
| Logikapp | Environment | Anslutningsversion |
|---|---|---|
| Förbrukning | Azure Logic Apps med flera klientorganisationer | Hanterad anslutningsapp, som visas i anslutningsgalleriet under Runtime>Shared. Mer information finns i följande dokumentation: - Referens för filsystemhanterad anslutningsapp - Hanterade anslutningsappar i Azure Logic Apps |
| Standard | Azure Logic Apps för en klientorganisation och App Service-miljön v3 (endast Windows-abonnemang) | Hanterad anslutningsapp, som visas i anslutningsgalleriet under Runtime>Shared och inbyggd anslutningsapp, som visas i anslutningsgalleriet under Runtime>In-App och är tjänstleverantörsbaserad. Den inbyggda anslutningsappen skiljer sig åt på följande sätt: – Den inbyggda anslutningsappen stöder endast standardlogikappar som körs i en App Service-miljön v3 med endast Windows-planer. – Den inbyggda versionen kan ansluta direkt till en filresurs och komma åt virtuella Azure-nätverk med hjälp av en anslutningssträng utan en lokal datagateway. Mer information finns i följande dokumentation: - Referens för filsystemhanterad anslutningsapp - Referens för filsystemets inbyggda anslutningsapp - Inbyggda anslutningsappar i Azure Logic Apps |
Förutsättningar
Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.
För att ansluta till filresursen gäller olika krav, baserat på logikappen och värdmiljön:
Arbetsflöden för förbrukningslogikapp
I Azure Logic Apps för flera klientorganisationer måste du uppfylla följande krav, om du inte redan har gjort det:
Installera den lokala datagatewayen på en lokal dator.
Den hanterade anslutningsappen för filsystemet kräver att gatewayinstallationen och filsystemservern måste finnas i samma Windows-domän.
När du har lagt till en utlösare eller åtgärd för filsystemhanterad anslutningsapp i arbetsflödet väljer du den datagatewayresurs som du skapade tidigare så att du kan ansluta till filsystemet.
Standardarbetsflöden för logikappar
Du kan använda den inbyggda anslutningsappen för filsystemet eller den hanterade anslutningsappen.
Om du vill använda den hanterade anslutningsappen för filsystem följer du samma krav som ett arbetsflöde för förbrukningslogikappen i Azure Logic Apps med flera klientorganisationer.
Om du vill använda den inbyggda anslutningsappen för filsystemet måste arbetsflödet för standardlogikappen köras i App Service-miljön v3, men kräver inte datagatewayresursen.
Åtkomst till den dator som har det filsystem som du vill använda. Om du till exempel installerar datagatewayen på samma dator som filsystemet behöver du autentiseringsuppgifterna för den datorn.
Om du vill följa exempelscenariot i den här instruktionsguiden behöver du ett e-postkonto från en provider som stöds av Azure Logic Apps, till exempel Office 365 Outlook, Outlook.com eller Gmail. För andra leverantörer kan du läsa andra e-postanslutningar som stöds. I det här exemplet används Office 365 Outlook-anslutningsappen med ett arbets- eller skolkonto. Om du använder något annat e-postkonto är de övergripande stegen desamma, men användargränssnittet kan skilja sig något.
Viktigt!
Om du vill använda Gmail-anslutningsappen kan endast G-Suite-företagskonton använda den här anslutningsappen utan begränsning i logikappar. Om du har ett Gmail-konsumentkonto kan du använda den här anslutningsappen med endast specifika Google-godkända tjänster, eller så kan du skapa en Google-klientapp som ska användas för autentisering med gmail-anslutningsappen. Mer information finns i Datasäkerhets- och sekretessprinciper för Google-anslutningsappar i Azure Logic Apps.
I exempelscenariot filsystem behöver du ett Dropbox-konto som du kan registrera dig kostnadsfritt.
Arbetsflödet för logikappen där du vill komma åt filresursen. Om du vill starta arbetsflödet med en filsystemutlösare måste du börja med ett tomt arbetsflöde. Om du vill lägga till en filsystemåtgärd startar du arbetsflödet med valfri utlösare.
Lägga till en filsystemutlösare
Öppna arbetsflödet för den tomma logikappen i designern i Azure Portal.
I designern följer du de här allmänna stegen för att lägga till den filsystemutlösare som du vill använda i arbetsflödet.
Mer information finns i Filsystemutlösare. Det här exemplet fortsätter med utlösaren med namnet När en fil skapas.
Ange följande information efter behov i rutan anslutningsinformation:
Property Obligatoriskt Värde beskrivning Anslutningens namn Ja <anslutningsnamn> Namnet som ska användas för anslutningen Rotmapp Ja <root-folder-name> Rotmappen för filsystemet, som vanligtvis är den överordnade huvudmappen och är den mapp som används för de relativa sökvägarna med alla utlösare som fungerar på filer.
Om du till exempel har installerat den lokala datagatewayen använder du den lokala mappen på datorn med installationen av datagatewayen. Du kan också använda mappen för nätverksresursen där datorn kan komma åt mappen, till exempel\\PublicShare\\MyFileSystem.Autentiseringstyp Nej <auth-type> Den typ av autentisering som filsystemservern använder, vilket är Windows Användarnamn Ja <domän och användarnamn> Domänen och användarnamnet för den dator där du har filsystemet.
För den hanterade filsystemanslutningen använder du något av följande värden med omvänt snedstreck (\):
- <domain>\<username>
- <local-computer>\<username>
Om din filsystemmapp till exempel finns på samma dator som den lokala datagatewayinstallationen kan du använda <local-computer>\<username.>Lösenord Ja <lösenord> Lösenordet för den dator där du har filsystemet port Nej – <Azure-prenumeration>
– <gateway-resource-name>Det här avsnittet gäller endast för den hanterade filsystemanslutningen:
- Prenumeration: Den Azure-prenumeration som är associerad med datagatewayresursen
- Anslutningsgateway: DatagatewayresursenI följande exempel visas anslutningsinformationen för utlösaren för filsystemhanterad anslutningsapp:
Välj Skapa när du är klar.
Azure Logic Apps skapar och testar anslutningen och ser till att anslutningen fungerar korrekt. Om anslutningen är korrekt konfigurerad visas konfigurationsalternativen för den valda utlösaren.
Fortsätt att skapa arbetsflödet.
Ange nödvändig information för utlösaren.
I det här exemplet väljer du mappsökvägen på filsystemservern för att söka efter en nyligen skapad fil. Ange hur många filer som ska returneras och hur ofta du vill kontrollera.
Om du vill testa arbetsflödet lägger du till en Outlook-åtgärd som skickar ett e-postmeddelande när en fil skapas i filsystemet i den angivna mappen. Ange e-postmottagare, ämne och brödtext. För testning kan du använda din egen e-postadress.
Dricks
Om du vill lägga till utdata från föregående steg i arbetsflödet väljer du i utlösarens redigeringsrutor. När listan med dynamiskt innehåll visas väljer du från de tillgängliga utdata.
Spara arbetsflödet när du är klar.
Om du vill testa arbetsflödet laddar du upp en fil som utlöser arbetsflödet.
Om det lyckas skickar arbetsflödet ett e-postmeddelande om den nya filen.
Lägga till en filsystemåtgärd
Exempelarbetsflödet för logikappen börjar med Dropbox-utlösaren, men du kan använda valfri utlösare som du vill.
Öppna arbetsflödet för logikappen i designern i Azure Portal.
I designern följer du de här allmänna stegen för att lägga till den filsystemåtgärd som du vill använda i arbetsflödet.
Mer information finns i Filsystemutlösare. Det här exemplet fortsätter med åtgärden Skapa fil.
Ange följande information efter behov i rutan anslutningsinformation:
Property Obligatoriskt Värde beskrivning Anslutningens namn Ja <anslutningsnamn> Namnet som ska användas för anslutningen Rotmapp Ja <root-folder-name> Rotmappen för filsystemet, som vanligtvis är den överordnade huvudmappen och är den mapp som används för de relativa sökvägarna med alla utlösare som fungerar på filer.
Om du till exempel har installerat den lokala datagatewayen använder du den lokala mappen på datorn med installationen av datagatewayen. Du kan också använda mappen för nätverksresursen där datorn kan komma åt mappen, till exempel\\PublicShare\\MyFileSystem.Autentiseringstyp Nej <auth-type> Den typ av autentisering som filsystemservern använder, vilket är Windows Användarnamn Ja <domän och användarnamn> Domänen och användarnamnet för den dator där du har filsystemet.
För den hanterade filsystemanslutningen använder du något av följande värden med omvänt snedstreck (\):
- <domain>\<username>
- <local-computer>\<username>
Om din filsystemmapp till exempel finns på samma dator som den lokala datagatewayinstallationen kan du använda <local-computer>\<username.>Lösenord Ja <lösenord> Lösenordet för den dator där du har filsystemet port Nej – <Azure-prenumeration>
– <gateway-resource-name>Det här avsnittet gäller endast för den hanterade filsystemanslutningen:
- Prenumeration: Den Azure-prenumeration som är associerad med datagatewayresursen
- Anslutningsgateway: DatagatewayresursenI följande exempel visas anslutningsinformationen för åtgärden Hanterad anslutningsapp för filsystem:
Välj Skapa när du är klar.
Azure Logic Apps skapar och testar anslutningen och ser till att anslutningen fungerar korrekt. Om anslutningen är korrekt konfigurerad visas konfigurationsalternativen för den valda åtgärden.
Fortsätt att skapa arbetsflödet.
Ange nödvändig information för din åtgärd.
I det här exemplet väljer du den mappsökväg på filsystemservern som ska användas, som är rotmappen här. Ange filnamnet och innehållet baserat på filen som laddats upp till Dropbox.
Dricks
Om du vill lägga till utdata från föregående steg i arbetsflödet väljer du i åtgärdens redigeringsrutor. När listan med dynamiskt innehåll visas väljer du från de tillgängliga utdata.
Om du vill testa arbetsflödet lägger du till en Outlook-åtgärd som skickar ett e-postmeddelande när filsystemåtgärden skapar en fil. Ange e-postmottagare, ämne och brödtext. För testning kan du använda din egen e-postadress.
Spara arbetsflödet när du är klar.
Om du vill testa arbetsflödet laddar du upp en fil som utlöser arbetsflödet.
Om det lyckas skapar arbetsflödet en fil på filsystemservern, baserat på den uppladdade filen i DropBox, och skickar ett e-postmeddelande om den skapade filen.
