Verbinding maken naar een FTP-server 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. Vervolgens kunt u 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 volgende 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 om aan de slag te gaan als u geen toegang hebt tot Azure Logic Apps:

Verbinding maken of technische naslaginformatie

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

Type logische app (plan) Omgeving Verbinding maken orversie
Verbruik Azure Logic Apps met meerdere tenants Beheerde connector (Standard-klasse). Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde FTP-connector
- Beheerde connectors in Azure Logic Apps
Verbruik Integratieserviceomgeving (ISE) Beheerde connector (Standard-klasse) en ISE-versie, die andere berichtlimieten heeft dan de Standard-klasse. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde FTP-connector
- ISE-berichtlimieten
- Beheerde connectors in Azure Logic Apps
Standaard Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) Beheerde connector (door Azure gehost) en ingebouwde connector, die is gebaseerd op serviceproviders. De ingebouwde connector heeft rechtstreeks toegang tot virtuele Azure-netwerken met een verbindingsreeks. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde FTP-connector
- Sectie met ingebouwde FTP-connectorbewerkingen verderop in dit artikel
- Beheerde connectors in Azure Logic Apps
- Ingebouwde connectors in Azure Logic Apps

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 of door Azure gehoste 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 tijdstempel 'laatst gewijzigd' behouden blijft. Aan de andere kant heeft de ingebouwde FTP-connectortrigger in standaardwerkstromen voor logische apps deze beperking niet. Raadpleeg de sectie Beperkingen van de FTP-connector voor meer informatie.

  • De door FTP beheerde of door Azure gehoste connector kan een beperkt aantal verbindingen met de FTP-server maken op basis van 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, kunt u overwegen om een standaardwerkstroom voor logische apps te maken en in plaats daarvan de ingebouwde FTP-connector te gebruiken.

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 logische app waar u toegang wilt krijgen 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, start u de werkstroom met een andere trigger, zoals de trigger Terugkeerpatroon .

  • Raadpleeg 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.

Bekende problemen

Triggers die een matrix retourneren, hebben standaard een instelling Splitsen op die al is ingeschakeld. Als deze instelling is ingeschakeld, wordt met de trigger de matrix automatisch gedebatteerd door intern een afzonderlijk werkstroomexemplaren te maken om elk matrixitem te verwerken. Alle werkstroomexemplaren worden parallel uitgevoerd, zodat de matrixitems tegelijkertijd worden verwerkt.

Wanneer de instelling Splitsen op is ingeschakeld, retourneert de beheerde connector echter 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 matrixitem afzonderlijk wilt afhandelen, kunt u extra acties toevoegen. Als u bijvoorbeeld deze matrixitems wilt herhalen, kunt u een voor elke 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 benadering alleen toepassen voor triggers van beheerde connectors, niet voor ingebouwde connectortriggers die uitvoer retourneren voor één matrixitem tegelijk wanneer de instelling Splitsen op is 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. Haal de actie bestandsinhoud op om de inhoud van elk bestand op te halen.

Een FTP-trigger toevoegen

Een werkstroom voor logische apps verbruik kan alleen gebruikmaken van de door FTP beheerde connector. Een werkstroom voor een standaard logische app kan echter gebruikmaken van de door FTP beheerde connector en de ingebouwde FTP-connector. In een standaardwerkstroom voor logische apps worden beheerde connectors ook gelabeld als Azure-connectors .

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

  • Trigger voor beheerde connector: de FTP-trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) voert een werkstroom voor de logische app Verbruik of Standard 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 echter de bestandsinhoud wilt ophalen, kan uw werkstroom deze trigger volgen met andere FTP-acties.

    Raadpleeg wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) voor meer informatie over deze trigger.

  • 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 echter volgen met andere FTP-acties. Raadpleeg wanneer een bestand wordt toegevoegd of bijgewerkt voor meer informatie over deze trigger.

In de volgende stappen wordt Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken en te bewerken:

  1. Open in Azure Portal uw lege werkstroom voor logische apps in de ontwerpfunctie.

  2. Selecteer Standard in de ontwerpfunctie onder het zoekvak. Voer ftp in het zoekvak in.

  3. Selecteer in de lijst met triggers de trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen).

    Screenshot shows Azure portal, Consumption workflow designer, and FTP trigger selected.

  4. Geef de informatie op voor uw verbinding. Selecteer Maken als u klaar bent.

    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.

    Screenshot shows Consumption workflow designer and FTP connection profile.

  5. Nadat het triggerinformatievak wordt weergegeven, zoekt u de map die u wilt controleren op nieuwe of bewerkte bestanden.

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

    2. Selecteer de pijl met de rechterhoek (>). Blader naar de gewenste map en selecteer de map.

    Screenshot shows Consumption workflow designer, FTP trigger, and

    De geselecteerde map wordt weergegeven in het vak Map .

    Screenshot shows Consumption workflow designer, FTP trigger, and

  6. Sla uw werkstroom op wanneer u klaar bent.

Wanneer u uw werkstroom opslaat, publiceert deze stap automatisch uw updates naar uw geïmplementeerde logische app, die live is 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 uitvoer van de trigger.

Een FTP-actie toevoegen

Een werkstroom voor logische apps verbruik kan alleen gebruikmaken van de door FTP beheerde connector. Een werkstroom voor een standaard logische app kan echter 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.

  • Acties voor beheerde connectors: deze acties worden uitgevoerd in een werkstroom voor de logische app Verbruik of Standard.

  • Ingebouwde connectoracties: deze acties worden alleen uitgevoerd in een standaardwerkstroom voor logische apps.

In de volgende stappen wordt Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken en te bewerken:

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 ingebouwde trigger terugkeerpatroon gebruiken om uw werkstroom volgens een specifiek schema te starten.

  1. Open uw werkstroom voor logische apps in Azure Portal in de ontwerpfunctie.

  2. Zoek en selecteer de FTP-actie die u wilt gebruiken.

    In dit voorbeeld wordt de actie Bestandsmetagegevens ophalen voortgezet, zodat u de metagegevens voor één matrixitem kunt ophalen.

    1. Selecteer nieuwe stap in de ontwerpfunctie onder de trigger of andere acties.

    2. Selecteer Standard onder het zoekvak Een bewerking kiezen.

    3. Voer in het zoekvak ftp get file metadata in.

    4. Selecteer in de lijst met acties de actie met de naam Metagegevens van bestand ophalen.

    Screenshot shows the Azure portal, Consumption workflow designer, search box with

  3. Geef indien nodig de informatie voor uw verbinding op. Selecteer Maken als u klaar bent.

    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.

    Screenshot shows Consumption workflow designer and FTP connection profile for an action.

  4. Nadat het vak Actie-informatie over metagegevens van bestand ophalen wordt weergegeven, klikt u in het vak Bestand , zodat de lijst met dynamische inhoud wordt geopend.

    U kunt nu uitvoer van de voorgaande trigger selecteren.

  5. Selecteer in de lijst met dynamische inhoud onder Wanneer een bestand wordt toegevoegd of gewijzigd de lijst met bestands-id's.

    Screenshot shows Consumption workflow designer,

    De eigenschap Bestand verwijst nu naar de uitvoer van de trigger List of Files Id .

  6. Selecteer in de ontwerpfunctie onder de actie Bestandmetagegevens ophalen de optie Nieuwe stap.

  7. Selecteer Standard onder het zoekvak Een bewerking kiezen.

  8. Voer in het zoekvak ftp-bestandsinhoud op.

  9. Selecteer in de lijst met acties de actie Get file content.

    Screenshot shows the Azure portal, Consumption workflow designer, search box with

  10. Nadat het vak Actie-informatie over bestandsinhoud ophalen is weergegeven, klikt u in het vak Bestand , zodat de lijst met dynamische inhoud wordt geopend.

    U kunt nu uitvoer van de voorgaande trigger en eventuele andere acties selecteren.

  11. Selecteer in de lijst met dynamische inhoud onder Metagegevens van bestand ophalen de id, die verwijst naar het bestand dat is toegevoegd of bijgewerkt.

    Screenshot shows Consumption workflow designer,

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

    Screenshot shows Consumption workflow designer,

  12. Sla uw werkstroom op wanneer 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.

  1. Voeg onder de actie Bestandsinhoud ophalen de Outlook-actie Office 365 toe met de naam Een e-mailbericht verzenden. Als u in plaats daarvan een Outlook.com-account hebt, voegt u de Outlook.com een e-mailactie toe en past u de volgende stappen dienovereenkomstig aan.

    1. Selecteer in de ontwerpfunctie onder de actie Bestandsinhoud ophalen de optie Nieuwe stap.

    2. Selecteer Standard onder het zoekvak Een bewerking kiezen.

    3. Voer in het zoekvak office 365 outlook in om een e-mailbericht te verzenden. Selecteer in de lijst met acties de actie Office 365 Outlook met de naam Een e-mailbericht verzenden.

    Screenshot shows Consumption workflow designer and

  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 van bestandsinhoud van de actie Bestandsinhoud ophalen opnemen. Volg deze stappen om deze uitvoer te vinden:

    1. Klik in de actie Bestandsinhoud ophalen in het vak Hoofdtekst , zodat de lijst met dynamische inhoud wordt geopend.

    2. Selecteer in de lijst met dynamische inhoud naast Bestandsinhoud ophalen de optie Meer informatie.

      Screenshot shows Consumption workflow designer,

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

      De eigenschap Hoofdtekst verwijst nu naar de uitvoer van de actie Bestandsinhoud .

      Screenshot shows Consumption workflow designer,

  4. Sla uw werkstroom voor logische apps op.

  5. Als u de werkstroom wilt uitvoeren en activeren, selecteert u Uitvoeren van trigger>uitvoeren op de werkbalk van de ontwerpfunctie. Voeg een bestand toe aan de FTP-map die door uw werkstroom wordt bewaakt.

Ingebouwde FTP-connectorbewerkingen

De ingebouwde FTP-connector is alleen beschikbaar voor standaardwerkstromen voor logische apps en biedt de volgende bewerkingen:

Trigger Omschrijving
Wanneer een bestand wordt toegevoegd of bijgewerkt Start een werkstroom voor logische apps wanneer een bestand wordt toegevoegd of bijgewerkt in de opgegeven map op de FTP-server.

Opmerking: deze trigger haalt alleen de metagegevens of eigenschappen van het bestand op, niet de bestandsinhoud. Als u de inhoud wilt ophalen, kan uw werkstroom deze trigger echter volgen met de actie Bestandsinhoud ophalen.

Actie Beschrijving
Bestand maken Maak een bestand met behulp van het opgegeven bestandspad en bestandsinhoud.
Bestand verwijderen Verwijder een bestand met behulp van het opgegeven bestandspad.
Bestandsinhoud ophalen Haal de inhoud van een bestand op met behulp van het opgegeven bestandspad.
Metagegevens van bestand ophalen Haal de metagegevens of eigenschappen van een bestand op met behulp van het opgegeven bestandspad.
Bestanden en submappen in een map weergeven Haal een lijst met bestanden en submappen op in de opgegeven map.
Bestand bijwerken Werk een bestand bij met behulp van het opgegeven bestandspad en de bestandsinhoud.

Wanneer een bestand wordt toegevoegd of bijgewerkt

Bewerkings-id: whenFtpFilesAreAddedOrModified

Met deze trigger wordt een werkstroom voor logische apps gestart wanneer een bestand wordt toegevoegd of bijgewerkt in de opgegeven map op de FTP-server. De trigger haalt alleen de metagegevens of eigenschappen van het bestand op, geen bestandsinhoud. Als u de inhoud wilt ophalen, kan uw werkstroom deze trigger echter volgen met de actie Bestandsinhoud ophalen.

Parameters

Naam Sleutel Vereist Type Omschrijving
Mappad folderPath Waar string Het mappad, ten opzichte van de hoofdmap.
Aantal te retourneren bestanden maxFileCount Onwaar integer Het maximum aantal bestanden dat moet worden geretourneerd vanuit één triggeruitvoering. Geldige waarden variëren van 1 tot 100.

Opmerking: de instelling Splitsen op is standaard ingeschakeld en dwingt deze trigger af om elk bestand afzonderlijk parallel te verwerken.
Tijdstempel knippen om oudere bestanden te negeren oldFileCutOffTimestamp Onwaar dateTime De afsluittijd die moet worden gebruikt voor het negeren van oudere bestanden. Gebruik de tijdstempelindeling YYYY-MM-DDTHH:MM:SS. Als u deze functie wilt uitschakelen, laat u deze eigenschap leeg.

Retouren

Wanneer de instelling Splitsen op van de trigger is ingeschakeld, retourneert de trigger de metagegevens of eigenschappen voor één bestand tegelijk. Anders retourneert de trigger een matrix die de metagegevens van elk bestand bevat.

Naam Type
Lijst met bestanden BlobMetadata

Bestand maken

Bewerkings-id: createFile

Met deze actie maakt u een bestand met behulp van het opgegeven bestandspad en de bestandsinhoud. Als het bestand al bestaat, overschrijft deze actie dat bestand.

Belangrijk

Als u een bestand op de FTP-server onmiddellijk na het maken in dezelfde werkstroom verwijdert of hernoemt, kan de bewerking een HTTP 404-fout retourneren. Dit is standaard. U kunt dit probleem voorkomen door een vertraging van 1 minuut op te nemen voordat u de zojuist gemaakte bestanden verwijdert of de naam ervan wijzigt. U kunt de actie Vertraging gebruiken om deze vertraging toe te voegen aan uw werkstroom.

Parameters

Naam Sleutel Vereist Type Omschrijving
Bestandspad filePath Waar string Het bestandspad, inclusief de bestandsextensie, indien van toepassing, ten opzichte van de hoofdmap.
Bestandsinhoud fileContent Waar string De bestandsinhoud.

Retouren

Met deze actie wordt een BlobMetadata-object met de naam Hoofdtekst geretourneerd.

Naam Type
Bestandsnaam van bestandsmetagegevens string
Bestandspad met metagegevens string
Bestandsgrootte bestandsmetagegevens string
Bestandsmetagegevens BlobMetadata

Bestand verwijderen

Bewerkings-id: deleteFtpFile

Met deze actie wordt een bestand verwijderd met behulp van het opgegeven bestandspad.

Parameters

Naam Sleutel Vereist Type Omschrijving
Bestandspad filePath Waar string Het bestandspad, inclusief de bestandsextensie, indien van toepassing, ten opzichte van de hoofdmap.

Retouren

Geen

Bestandsinhoud ophalen

Bewerkings-id: getFtpFileContent

Met deze actie haalt u de inhoud van een bestand op met behulp van het opgegeven bestandspad.

Parameters

Naam Sleutel Vereist Type Omschrijving
Bestandspad path Waar string Het bestandspad, inclusief de bestandsextensie, indien van toepassing, ten opzichte van de hoofdmap.

Retouren

Met deze actie wordt de inhoud van een bestand geretourneerd als een binaire waarde met de naam Bestandsinhoud.

Naam Type
Bestandsinhoud Binary

Metagegevens van bestand ophalen

Bewerkings-id: getFileMetadata

Met deze actie worden de metagegevens of eigenschappen van een bestand ophaalt met behulp van het opgegeven bestandspad.

Parameters

Naam Sleutel Vereist Type Omschrijving
Bestandspad path Waar string Het bestandspad, inclusief de bestandsextensie, indien van toepassing, ten opzichte van de hoofdmap.

Retouren

Met deze actie worden de volgende uitvoer geretourneerd:

Naam Type
Bestandsnaam string
Bestandspad string
Bestandsgrootte string
Laatst bijgewerkt tijdstip string
Bestandsmetagegevens BlobMetadata

Bestanden en submappen in een map weergeven

Bewerkings-id: listFilesInFolder

Met deze actie wordt een lijst met bestanden en submappen opgehaald in de opgegeven map.

Parameters

Naam Sleutel Vereist Type Omschrijving
Mappad folderPath Waar string Het mappad, ten opzichte van de hoofdmap.
Bestandsinhoud fileContent Waar string De inhoud voor het bestand

Retouren

Deze actie retourneert een matrix met de naam Response en bevat BlobMetadata-objecten .

Naam Type
Respons Matrix met BlobMetadata-objecten

Bestand bijwerken

Bewerkings-id: updateFile

Met deze actie wordt een bestand bijgewerkt met behulp van het opgegeven bestandspad en de bestandsinhoud.

Belangrijk

Als u een bestand op de FTP-server onmiddellijk na het maken in dezelfde werkstroom verwijdert of hernoemt, kan de bewerking een HTTP 404-fout retourneren. Dit is standaard. U kunt dit probleem voorkomen door een vertraging van 1 minuut op te nemen voordat u de zojuist gemaakte bestanden verwijdert of de naam ervan wijzigt. U kunt de actie Vertraging gebruiken om deze vertraging toe te voegen aan uw werkstroom.

Parameters

Naam Sleutel Vereist Type Omschrijving
Bestandspad filePath Waar string Het bestandspad, inclusief de bestandsextensie, indien van toepassing, ten opzichte van de hoofdmap.
Bestandsinhoud fileContent Waar string De inhoud voor het bestand

Retouren

Met deze actie wordt een BlobMetadata-object met de naam Hoofdtekst geretourneerd.

Naam Type
Tekst BlobMetadata

Volgende stappen