Verbinding maken met 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:
Technische naslaginformatie over connectoren
De FTP-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.
Type logische app (plan) | Omgeving | Connectorversie |
---|---|---|
Verbruik | Multitenant Azure Logic Apps | Beheerde connector, die wordt weergegeven in de galerie met connectors onder Runtime>Shared. Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie over beheerde FTP-connector - 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), die wordt weergegeven in de connectorgalerie onder Runtime>Shared en ingebouwde connector, die wordt weergegeven in de connectorgalerie onder Runtime>In App en 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:
Haal bestandsmetagegevens op om de metagegevens van elk bestand op te halen.
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:
Werkstromen voor logische apps voor verbruik: Visual Studio of Visual Studio Code
Standaardwerkstromen voor logische apps: Visual Studio Code
Open in Azure Portal uw lege werkstroom voor logische apps in de ontwerpfunctie.
Selecteer Standard in de ontwerpfunctie onder het zoekvak. Voer ftp in het zoekvak in.
Selecteer in de lijst met triggers de trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen).
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.
Nadat het triggerinformatievak wordt weergegeven, zoekt u de map die u wilt controleren op nieuwe of bewerkte bestanden.
Selecteer in het vak Map het mappictogram om de mapmap weer te geven.
Selecteer de pijl met de rechterhoek (>). Blader naar de gewenste map en selecteer de map.
De geselecteerde map wordt weergegeven in het vak Map .
Sla uw werkstroom op als u gereed 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:
Werkstromen voor logische apps voor verbruik: Visual Studio of Visual Studio Code
Standaardwerkstromen voor logische apps: 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 ingebouwde trigger terugkeerpatroon gebruiken om uw werkstroom volgens een specifiek schema te starten.
Open uw werkstroom voor logische apps in Azure Portal in de ontwerpfunctie.
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.
Selecteer nieuwe stap in de ontwerpfunctie onder de trigger of andere acties.
Selecteer Standard onder het zoekvak Een bewerking kiezen.
Voer in het zoekvak ftp get file metadata in.
Selecteer in de lijst met acties de actie met de naam Metagegevens van bestand ophalen.
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.
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.
Selecteer in de lijst met dynamische inhoud onder Wanneer een bestand wordt toegevoegd of gewijzigd de lijst met bestands-id's.
De eigenschap Bestand verwijst nu naar de uitvoer van de trigger List of Files Id .
Selecteer in de ontwerpfunctie onder de actie Bestandmetagegevens ophalen de optie Nieuwe stap.
Selecteer Standard onder het zoekvak Een bewerking kiezen.
Voer in het zoekvak ftp-bestandsinhoud op.
Selecteer in de lijst met acties de actie Get file content.
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.
Selecteer in de lijst met dynamische inhoud onder Metagegevens van bestand ophalen de id, die verwijst naar het bestand dat is toegevoegd of bijgewerkt.
De eigenschap Bestand verwijst nu naar de uitvoer van de id-actie .
Sla uw werkstroom op als u gereed 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.
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.
Selecteer in de ontwerpfunctie onder de actie Bestandsinhoud ophalen de optie Nieuwe stap.
Selecteer Standard onder het zoekvak Een bewerking kiezen.
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.
Meld u indien nodig aan bij uw e-mailaccount.
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:
Klik in de actie Bestandsinhoud ophalen in het vak Hoofdtekst , zodat de lijst met dynamische inhoud wordt geopend.
Selecteer in de lijst met dynamische inhoud naast Bestandsinhoud ophalen de optie Meer informatie.
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 .
Sla uw werkstroom voor logische apps op.
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:
Activator | Beschrijving |
---|---|
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 | Description |
---|---|---|---|---|
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.
Name | 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 | Description |
---|---|---|---|---|
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.
Name | 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 | Description |
---|---|---|---|---|
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 | Description |
---|---|---|---|---|
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.
Name | 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 | Description |
---|---|---|---|---|
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:
Name | 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 | Description |
---|---|---|---|---|
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 .
Name | 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 | Description |
---|---|---|---|---|
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.
Name | Type |
---|---|
Tekst | BlobMetadata |