Verbinding maken met FTP-servers vanuit werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

In dit artikel wordt beschreven hoe u toegang hebt tot uw FTP-server (File Transfer Protocol) vanuit een werkstroom in Azure Logic Apps met de FTP-connector. U kunt geautomatiseerde werkstromen maken die worden uitgevoerd wanneer ze worden geactiveerd door gebeurtenissen op uw FTP-server of in andere systemen en acties uitvoeren om bestanden op uw FTP-server te beheren.

Uw werkstroom kan bijvoorbeeld beginnen met een FTP-trigger die gebeurtenissen op uw FTP-server bewaakt en erop reageert. De trigger maakt de uitvoer beschikbaar voor acties in uw werkstroom. Uw werkstroom kan FTP-acties uitvoeren die bestanden maken, verzenden, ontvangen en beheren via uw FTP-serveraccount met behulp van de volgende specifieke taken:

• Controleren wanneer bestanden worden toegevoegd of gewijzigd.
• Bestanden maken, kopiëren, verwijderen, vermelden en bijwerken.
• Bestandsmetagegevens en -inhoud ophalen.
• Mappen beheren.

Raadpleeg de volgende documentatie als u geen gebruik hebt gemaakt van Azure Logic Apps:

• Wat is Azure Logic Apps?
• Snelstart: Een voorbeeldwerkstroom voor een logische verbruiksapp maken

Technische referentie voor connectoren

De FTP-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Beperkingen

• Capaciteit en doorvoer

  • Ingebouwde connector voor Standaardwerkstromen:

    FTP-acties kunnen standaard bestanden lezen of schrijven die 200 MB of kleiner zijn. Momenteel biedt de ingebouwde FTP-connector geen ondersteuning voor segmentering.

  • Beheerde connector voor verbruiks- en standaardwerkstromen

    FTP-acties kunnen standaard bestanden lezen of schrijven die 50 MB of kleiner zijn. Ftp-acties ondersteunen berichtsegmenten voor het verwerken van bestanden die groter zijn dan 50 MB. De actie Bestandsinhoud ophalen maakt impliciet gebruik van segmenten.

• Triggers voor de door FTP beheerde of door Azure gehoste connector kunnen ontbrekende, onvolledige of vertraagde resultaten ervaren wanneer de laatst gewijzigde tijdstempel behouden blijft. Aan de andere kant heeft de ingebouwde FTP-connectortrigger in standaardwerkstromen voor logische apps deze beperking niet. Zie de beperkingen van de FTP-connector voor meer informatie.

• De door FTP beheerde connector kan een beperkt aantal verbindingen met de FTP-server maken. De limiet is gebaseerd op de verbindingscapaciteit in de Azure-regio waar uw logische app-resource bestaat. Als deze limiet een probleem vormt in een werkstroom voor logische verbruiks-apps, maakt u een standaardwerkstroom voor logische apps die gebruikmaakt van de ingebouwde FTP-connector.

• Zowel de ingebouwde als de beheerde FTP-connector ondersteunen alleen expliciet FTP via FTPS. Dit is een uitbreiding van TLS. Geen van beide connectorversies ondersteunt impliciete FTPS.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.

• De werkstroom van de Logic App waarin u toegang wilt tot uw FTP-account. Als u uw werkstroom wilt starten met een FTP-trigger, moet u beginnen met een lege werkstroom. Als u een FTP-actie wilt gebruiken, begint u uw workflow met een andere trigger, zoals de trigger Herhaling.

• Zie de naslaginformatie voor de door FTP beheerde connector - Vereisten voor meer vereisten die van toepassing zijn op zowel de door FTP beheerde connector als de ingebouwde connector.

Toegang tot App Service-sitebestanden met FTPS

Je kunt de FTP-connector gebruiken om toegang te krijgen tot sitebestanden voor een Standard Logic App, Function App of App Service App die FTP/S-implementatie ondersteunt. Voordat je de FTP-verbinding aanmaakt, voltooi je de volgende taken voor de app die de bestanden bevat:

1. Schakel zowel SCM Basic Auth Publishing Credentials als FTP Basic Auth Publishing Credentials in. Basisauthenticatie is standaard uitgeschakeld voor nieuwe apps.

   Voor meer informatie, zie Beheer deploymentsgegevens voor Azure App Service.

2. Stel de FTP-status van de app in op alleen FTPS en handhaaf TLS 1.2 of hoger.

   Voor meer informatie, zie Enforce FTPS in Azure App Service.

3. Haal in het Deployment Center van de app het FTP/S-eindpunt en de implementatiereferenties voor het toepassingsbereik of gebruikersbereik op.

Wanneer je de FTP-connectorverbinding aanmaakt, gebruik dan de volgende waarden:

Nadat je de verbinding hebt gemaakt, gebruik je /site/wwwroot als mappad om toegang te krijgen tot de sitebestanden van de app. Raadpleeg voor een volledig voorbeeld Toegang tot sitebestanden van Logic Apps en App Services via FTPS met Logic Apps.

Bekende problemen

Triggers die arrays accepteren en retourneren, hebben standaard de Split on-instelling die al is ingeschakeld. nl-NL: Met de trigger wordt automatisch een array opgedeeld door intern een afzonderlijk werkstroomexemplaar te maken om elk array-item te verwerken. Alle workflowinstanties worden parallel uitgevoerd, zodat de array-elementen tegelijkertijd worden verwerkt.

Als de instelling Splitsen is ingeschakeld, retourneren beheerde connectortriggers de uitvoer voor alle matrixitems als lijsten. Alle volgende acties die naar deze uitvoer verwijzen, moeten deze uitvoer eerst als lijsten verwerken. Als u elk item in de array afzonderlijk wilt afhandelen, kunt u extra acties toevoegen. Als u bijvoorbeeld door deze array-elementen wilt itereren, kunt u een For each-lus gebruiken. Voor triggers die alleen metagegevens of eigenschappen retourneren, gebruikt u een actie die eerst de metagegevens van het matrixitem ophaalt en gebruikt u vervolgens een actie om de inhoud van de items op te halen.

U moet deze methode alleen toepassen voor triggers van beheerde connectors, niet voor ingebouwde connectortriggers die uitvoer voor één matrixitem tegelijk retourneren met de instelling Splitsen ingeschakeld.

Stel dat u een beheerde connectortrigger hebt met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) die de metagegevens of eigenschappen voor de nieuwe of bijgewerkte bestanden als matrices retourneert. Als u de metagegevens voor elk bestand afzonderlijk wilt ophalen, kunt u een For-lus gebruiken die door de matrix wordt herhaald. Gebruik in deze lus de volgende beheerde connectoracties in de opgegeven volgorde:

1. Haal bestandsmetagegevens op om de metagegevens van elk bestand op te halen.

2. Actie Bestandsinhoud ophalen om de inhoud van elk bestand op te halen.

Een FTP-trigger toevoegen

Een werkstroom van een Consumption-logische app kan alleen de beheerde FTP-connector gebruiken. Een werkstroom voor een standaard logische app kan echter gebruikmaken van de door FTP beheerde connector en de ingebouwde FTP-connector.

De door FTP beheerde connector en ingebouwde connector hebben elk slechts één trigger beschikbaar:

• Trigger van beheerde connector: de FTP-trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) voert een Consumption- of Standard-workflow van een logische app uit wanneer een of meer bestanden worden toegevoegd of gewijzigd in een map op de FTP-server. Deze trigger haalt alleen de bestandseigenschappen of metagegevens op, niet de bestandsinhoud. Als u de bestandsinhoud wilt ophalen, kan uw werkstroom deze trigger volgen met andere FTP-acties.

  Zie Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) voor meer informatie.

• Ingebouwde connectortrigger: De FTP-trigger met de naam Wanneer een bestand wordt toegevoegd of bijgewerkt , voert een standaardwerkstroom voor logische apps uit wanneer een of meer bestanden worden toegevoegd of gewijzigd in een map op de FTP-server. Deze trigger haalt alleen de bestandseigenschappen of metagegevens op, niet de bestandsinhoud. Als u de inhoud wilt ophalen, kan uw werkstroom deze trigger volgen met andere FTP-acties. Zie Wanneer een bestand wordt toegevoegd of bijgewerkt voor meer informatie.

In de volgende procedures wordt Azure Portal gebruikt. Met de bijbehorende Azure Logic Apps-extensie voor verbruiks- of Standard-logische apps kunt u in plaats daarvan de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken en te bewerken:

• Werkstromen voor logische apps voor verbruik: Visual Studio Code
• Standaardwerkstromen voor logische apps: Visual Studio Code

In deze sectie ziet u de stappen voor de volgende FTP-connectortriggers:

• Ingebouwde trigger met de naam Wanneer een bestand wordt toegevoegd of bijgewerkt

  Als u deze ingebouwde FTP-trigger gebruikt, kunt u de bestandsinhoud ophalen met behulp van de ingebouwde FTP-actie Bestandsinhoud ophalen zonder eerst de actie Bestandsmetagegevens ophalen te gebruiken, in tegenstelling tot wanneer u de door FTP beheerde trigger gebruikt. Zie de ingebouwde FTP-connectorbewerkingen voor meer informatie over ingebouwde FTP-connectorbewerkingen.

  Deze ingebouwde FTP-trigger is niet beschikbaar voor werkstromen van logische apps voor verbruik.

• Beheerde trigger genaamd Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen)

  Als u deze door FTP beheerde trigger gebruikt, moet u de actie Bestandsmetagegevens ophalen gebruiken om één matrixitem op te halen voordat u een andere actie gebruikt voor het bestand dat is toegevoegd of gewijzigd. Deze tijdelijke oplossing is het gevolg van het bekende probleem rond de instelling Splitsen op die eerder in dit artikel is beschreven.

Ingebouwde trigger voor de connector toevoegen

Een ingebouwde connectortrigger toevoegen aan een standaardwerkstroom:

1. Open uw logische app-resource in Azure Portal.

2. Selecteer in het zijbalkmenu van de resource onder Werkstromen de optie Werkstromen en selecteer vervolgens uw lege werkstroom, die wordt geopend in de ontwerpfunctie.

3. Selecteer in de ontwerper Een trigger toevoegen.

4. Volg de algemene stappen om de FTP-trigger toe te voegen wanneer een bestand wordt toegevoegd of bijgewerkt (preview).

5. Geef de informatie op voor uw verbinding. Wanneer u klaar bent, selecteert u Nieuwe maken.

   

   Notitie

   Deze connector draagt standaard bestanden over in tekstindeling. Als u bestanden wilt overdragen in binaire indeling, bijvoorbeeld waar en wanneer codering wordt gebruikt, selecteert u de optie binair transport.

6. Nadat het deelvenster met triggerinformatie wordt weergegeven, geeft u in het vak Mappad het pad op naar de map die u wilt bewaken.

   

7. Sla uw workflow op als u klaar bent.

Wanneer u uw werkstroom opslaat, publiceert Azure uw updates op uw geïmplementeerde en live logic app in Azure. Met slechts een trigger controleert uw werkstroom alleen de FTP-server op basis van uw opgegeven planning. U moet een actie toevoegen die reageert op de trigger en iets doet met de triggeruitvoer, zoals beschreven in latere secties.

Trigger voor beheerde connector toevoegen

Een trigger van een beheerde connector toevoegen aan een Verbruik- of Standaard-workflow:

1. Zoek en open uw logische app-resource in Azure Portal.

2. Op basis van of u een logische app voor Verbruik of Standard hebt:

   • Verbruik: Selecteer in het zijbalkmenu van de resource onder Ontwikkelhulpprogramma's de ontwerpfunctie om de werkstroom te openen.

   • Standaard: Selecteer werkstromen in het zijbalkmenu van de resource onder Werkstromen. Selecteer de lege werkstroom die in de ontwerper wordt geopend.

3. Selecteer een trigger toevoegen in de werkstroomontwerper.

4. Volg de algemene stappen om de FTP-trigger toe te voegen wanneer een bestand wordt toegevoegd of aangepast (alleen eigenschappen).

5. Geef de informatie op voor uw verbinding. Wanneer u klaar bent, selecteert u Nieuwe maken.

   

   Notitie

   Deze connector draagt standaard bestanden over in tekstindeling. Als u bestanden wilt overdragen in binaire indeling, bijvoorbeeld waar en wanneer codering wordt gebruikt, selecteert u de optie binair transport.

6. Wanneer het deelvenster met triggerinformatie wordt geopend, zoekt u de map die u wilt controleren op nieuwe of bewerkte bestanden.

   1. Selecteer in het Map-vak het mappictogram om de mapstructuur weer te geven.

   2. Selecteer > de rechter pijl. Blader naar de gewenste map en selecteer de map.

   

   De geselecteerde map wordt weergegeven in het vak Map .

   

7. Sla uw workflow op als u klaar bent.

Wanneer u uw werkproces opslaat, publiceert Azure uw updates naar uw geïmplementeerde en live logische app. Met slechts een trigger controleert uw werkstroom alleen de FTP-server op basis van uw opgegeven planning. U moet een actie toevoegen die reageert op de trigger en iets doet met de triggeruitvoer, zoals beschreven in latere secties.

Een FTP-actie toevoegen

Een werkstroom van een Consumption-logische app kan alleen de beheerde FTP-connector gebruiken. Een standaardwerkstroom voor logische apps kan gebruikmaken van de door FTP beheerde connector en de ingebouwde FTP-connector. Elke versie heeft meerdere acties. Zowel beheerde als ingebouwde connectorversies hebben bijvoorbeeld hun eigen acties om metagegevens van bestanden op te halen en bestandsinhoud op te halen.

• Ingebouwde connectoracties: deze acties worden alleen uitgevoerd in een standaardwerkstroom voor logische apps.
• Acties van beheerde connectors: deze acties worden uitgevoerd in een Consumption- of Standard-werkstroom van een logische app.

In de volgende procedures wordt Azure Portal gebruikt. Met de bijbehorende Azure Logic Apps-extensie voor Verbruik of Standard kunt u in plaats daarvan de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken en te bewerken:

• Werkstromen voor verbruik: Visual Studio Code
• Standaardwerkstromen: Visual Studio Code

Voordat u een FTP-actie kunt gebruiken, moet uw werkstroom al beginnen met een trigger. Dit kan elk type zijn dat u kiest. U kunt bijvoorbeeld de algemene ingebouwde trigger Recurrence gebruiken om uw workflow volgens een bepaald schema te starten.

De stappen voor het toevoegen en gebruiken van een FTP-actie verschillen afhankelijk van of uw werkstroom gebruikmaakt van de ingebouwde connector of de beheerde connector.

• Ingebouwde triggerwerkstromen: beschrijft de stappen voor het toevoegen van een ingebouwde actie aan een werkstroom die begint met een ingebouwde trigger.

  Als u de ingebouwde FTP-trigger hebt gebruikt en u de inhoud van een nieuw toegevoegd of bijgewerkt bestand wilt, kunt u een Voor Elk-lus gebruiken om door de array te itereren die door de trigger wordt geretourneerd. U kunt vervolgens alleen de actie Bestandsinhoud ophalen gebruiken zonder andere tussenliggende acties. Zie de ingebouwde FTP-connectorbewerkingen voor meer informatie over ingebouwde FTP-connectorbewerkingen.

• Werkstromen voor beheerde triggers: beschrijft de stappen voor het toevoegen van een beheerde actie aan een werkstroom die begint met een beheerde trigger.

  Als u de trigger voor de door FTP beheerde connector hebt gebruikt en de inhoud van een nieuw toegevoegd of gewijzigd bestand wilt gebruiken, kunt u een Voor elke lus gebruiken om de matrix te herhalen die door de trigger wordt geretourneerd. Vervolgens moet u tussenliggende acties gebruiken, zoals de FTP-actie Bestandsmetagegevens ophalen voordat u de actie Bestandsinhoud ophalen gebruikt.

Werkstromen met een ingebouwde trigger

Acties toevoegen aan een standaardworkflow die begint met een ingebouwde connectortrigger

1. Zoek en open uw logische app-resource in Azure Portal.

2. Selecteer Werkstromen in het zijbalkmenu van de resource onder Werkstromen. Selecteer de werkstroom met de ingebouwde FTP-trigger.

3. Volg deze algemene stappen in de ontwerpfunctie om de FTP-actie met de naam Bestandsinhoud ophalen toe te voegen aan uw werkstroom.

4. Geef indien nodig de informatie voor uw verbinding op. Wanneer u klaar bent, selecteert u Nieuwe maken.

   

   Notitie

   Deze connector draagt standaard bestanden over in tekstindeling. Als u bestanden wilt overdragen in binaire indeling, bijvoorbeeld waar en wanneer codering wordt gebruikt, selecteert u de optie binair transport.

5. Selecteer in het geopende actiegegevensvenster in het bestandspad om de invoeropties weer te geven. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen.

   U kunt nu uitvoer van de voorgaande trigger selecteren.

6. Selecteer in de lijst met dynamische inhoud, onder Wanneer een bestand wordt toegevoegd of bijgewerkt, het bestandspad.

   

   De eigenschap Bestandspad verwijst nu naar de triggeruitvoer van Bestandspad.

   

7. Voeg eventuele andere acties toe die uw werkstroom nodig heeft.

8. Sla uw workflow op als u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

Werkstromen met een beheerde trigger

Acties toevoegen aan een Verbruiks- of Standaardwerkstroom die begint met een beheerde connector-trigger:

1. Zoek en open uw logische app-resource in Azure Portal.

2. Op basis van of u een logische app voor Verbruik of Standard hebt:

   • Verbruik: Selecteer in het zijbalkmenu van de resource onder Ontwikkelhulpprogramma's de ontwerpfunctie om de werkstroom te openen.

   • Standaard: Selecteer werkstromen in het zijbalkmenu van de resource onder Werkstromen. Selecteer de werkstroom die begint met de trigger voor de door FTP beheerde connector. Selecteer in het zijbalkmenu van de werkstroom de ontwerper om de werkstroom te openen.

3. Volg deze algemene stappen in de ontwerpfunctie om de FTP-actie met de naam Bestandsmetagegevens ophalen toe te voegen aan uw werkstroom.

4. Geef indien nodig de informatie voor uw verbinding op. Wanneer u klaar bent, selecteert u Nieuwe maken.

   

   Notitie

   Deze connector draagt standaard bestanden over in tekstindeling. Als u bestanden wilt overdragen in binaire indeling, bijvoorbeeld waar en wanneer codering wordt gebruikt, selecteert u de optie binair transport.

5. Selecteer in het deelvenster met actiegegevens dat wordt geopend de optie Bestand om de invoeropties weer te geven. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen.

   U kunt nu uitvoer van de voorgaande trigger selecteren.

6. Selecteer in de lijst met dynamische inhoud onder Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) de lijst met bestands-id's.

   

   De eigenschap File verwijst nu naar de triggeruitvoer van List of Files Id.

   

7. Volg deze algemene stappen in de ontwerpfunctie om de FTP-actie met de naam Bestandsinhoud ophalen toe te voegen aan uw werkstroom.

8. Selecteer binnen in het actie-informatiepaneel dat verschijnt, Bestand om de invoeropties weer te geven. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen.

   U kunt nu uitvoer van de voorgaande trigger of acties selecteren.

9. Selecteer Id in de lijst met dynamische inhoud, onder Metagegevens van bestand ophalen.

   

   De eigenschap Bestand verwijst nu naar de uitvoer van de Id-actie.

   

10. Voeg eventuele andere acties toe die uw werkstroom nodig heeft.

11. Sla uw workflow op als u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

Uw werkstroom testen

Als u wilt controleren of uw werkstroom de verwachte inhoud retourneert, voegt u een andere actie toe waarmee u de inhoud uit het toegevoegde of bijgewerkte bestand verzendt. In dit voorbeeld wordt de Actie Office 365 Outlook met de naam Een e-mailbericht verzenden gebruikt.

Werkstroom met ingebouwde trigger en acties

Een Office 365 Outlook-actie toevoegen aan uw Standaardwerkstroom:

1. Volg in de ontwerpfunctie, onder de actie Bestandsinhoud ophalen , deze algemene stappen om de actie met de naam Een e-mailbericht verzenden toe te voegen aan uw werkstroom.

   Als u in plaats daarvan een Outlook.com-account hebt, voegt u de Outlook.com een e-mailactie verzenden toe.

2. Meld u indien nodig aan bij uw e-mailaccount.

3. Geef in het deelvenster met actiegegevens de vereiste waarden op en neem eventuele andere parameters of eigenschappen op die u wilt testen.

   U kunt bijvoorbeeld de uitvoer Bestandsinhoud uit de actie Bestandsinhoud ophalen opnemen. Volg deze stappen om deze uitvoer te vinden:

   1. Selecteer in de actie Bestandsinhoud ophalen in de hoofdtekst om de invoeropties weer te geven. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen. Selecteer in deze lijst onder Bestandsinhoud ophalen de optie Bestandsinhoud.

      

   2. Selecteer In de lijst met dynamische inhoud onder Bestandsinhoud ophalen de optie Bestandsinhoud.

      De eigenschap Hoofdtekst bevat nu de uitvoer van de actie Bestandsinhoud .

      

4. Sla uw workflow op.

Voer de volgende stappen uit om de werkstroom uit te voeren en te activeren:

1. Selecteer Uitvoeren>Uitvoeren op de ontwerperwerkbalk.

2. Voeg een bestand toe aan de FTP-map die door uw werkstroom wordt bewaakt.

Werkstroom met beheerde trigger en acties

Een Office 365 Outlook-actie toevoegen aan uw Verbruiks- of Standaard-werkstroom:

1. Volg in de ontwerpfunctie, onder de actie Bestandsinhoud ophalen , deze algemene stappen om de actie met de naam Een e-mailbericht verzenden toe te voegen aan uw werkstroom.

   Als u in plaats daarvan een Outlook.com-account hebt, voegt u de Outlook.com een e-mailactie verzenden toe.

2. Meld u indien nodig aan bij uw e-mailaccount.

3. Geef in het informatievak van de actie de vereiste waarden op en neem eventuele andere parameters of eigenschappen op die u wilt testen.

   U kunt bijvoorbeeld de uitvoer Bestandsinhoud van de actie Bestandsinhoud ophalen opnemen. Volg deze stappen om deze uitvoer te vinden:

   1. Selecteer in de actie Bestandsinhoud ophalen in het vak Hoofdtekst om de invoeropties weer te geven. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen. Selecteer in deze lijst onder Bestandsinhoud ophalen de optie Bestandsinhoud.

      

   2. Selecteer In de lijst met dynamische inhoud onder Bestandsinhoud ophalen de optie Bestandsinhoud.

      De eigenschap Hoofdtekst bevat nu de uitvoer van de actie Bestandsinhoud .

      

4. Sla de werkstroom van uw logische app op.

Voer de volgende stappen uit om de werkstroom uit te voeren en te activeren:

1. Selecteer Uitvoeren>Uitvoeren op de ontwerperwerkbalk.

2. Voeg een bestand toe aan de FTP-map die door uw werkstroom wordt bewaakt.

Verwante inhoud

• Beheerde connectors voor Azure Logic Apps
• Ingebouwde connectors voor Azure Logic Apps
• Wat zijn connectors in Azure Logic Apps?