Delen via


Verbinding maken met on-premises bestandssystemen vanuit werkstromen in Azure Logic Apps

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

Deze handleiding laat zien hoe u toegang krijgt tot een on-premises bestandsshare vanuit een werkstroom in Azure Logic Apps met behulp van de bestandssysteemconnector. Vervolgens kunt u geautomatiseerde werkstromen maken die worden uitgevoerd wanneer ze worden geactiveerd door gebeurtenissen in uw bestandsshare of in andere systemen, en acties uitvoeren om uw bestanden te beheren. De connector biedt de volgende mogelijkheden:

  • Bestanden maken, ophalen, toevoegen, bijwerken en verwijderen.
  • Bestanden weergeven in mappen of hoofdmappen.
  • Bestandsinhoud en metagegevens ophalen.

In deze instructiegids laten de voorbeeldscenario's de volgende taken zien:

  • Een werkstroom activeren wanneer een bestand wordt gemaakt of toegevoegd aan een bestandsshare en vervolgens een e-mailbericht verzendt.
  • Een werkstroom activeren bij het kopiëren van een bestand van een Dropbox-account naar een bestandsshare en vervolgens een e-mailbericht verzenden.

Beperkingen en bekende problemen

  • De bestandssysteemconnector ondersteunt momenteel alleen Windows-bestandssystemen op Windows-besturingssystemen.
  • Toegewezen netwerkstations worden niet ondersteund.

Technische naslaginformatie over connectoren

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

Logische apps Omgeving Connectorversie
Verbruik Multitenant Azure Logic Apps Beheerde connector, die wordt weergegeven in de galerie met connectors onder Gedeeld. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde bestandssysteemconnector
- Beheerde connectors in Azure Logic Apps
Standaard Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) Beheerde connector, die wordt weergegeven in de galerie met connectors onder Gedeeld, en ingebouwde connector, die verschijnt in de connectorgalerij onder Ingebouwd en serviceprovider-gebaseerd is. De ingebouwde connector verschilt op de volgende manieren:

- De ingebouwde connector ondersteunt alleen standaard logische apps die worden uitgevoerd in een App Service Environment v3 met alleen Windows-abonnementen.

- De ingebouwde versie kan rechtstreeks verbinding maken met een bestandsshare en toegang krijgen tot virtuele Azure-netwerken met behulp van een verbindingsreeks zonder een on-premises gegevensgateway.

Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde bestandssysteemconnector
- Naslaginformatie over ingebouwde bestandssysteemconnector
- Ingebouwde connectors in Azure Logic Apps

Vereisten

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

  • Als u verbinding wilt maken met uw bestandsshare, zijn er verschillende vereisten van toepassing, op basis van uw logische app en de hostingomgeving:

    • Werkstromen voor verbruikslogische apps

    • Standaardwerkstromen voor logische apps:

      U kunt de ingebouwde connector of de beheerde connector van het bestandssysteem gebruiken.

      • Om de bestandsysteem-beheerconnector te gebruiken, volgt u dezelfde vereisten als een consumptielogica-app werkstroom in een multitenant-omgeving van Azure Logic Apps.

      • Als u de ingebouwde connector Bestandssysteem wilt gebruiken, moet de standaardwerkstroom van de logische app worden uitgevoerd in App Service Environment v3, maar hiervoor is geen gegevensgateway vereist.

  • Toegang tot de computer met het bestandssysteem dat u wilt gebruiken. Als u bijvoorbeeld de gegevensgateway installeert op dezelfde computer als uw bestandssysteem, hebt u de accountreferenties voor die computer nodig.

  • Als u het voorbeeldscenario in deze handleiding wilt volgen, hebt u een e-mailaccount nodig van een provider die wordt ondersteund door Azure Logic Apps, zoals Office 365 Outlook, Outlook.com of Gmail. Bekijk andere ondersteunde e-mailconnectors voor andere providers. In dit voorbeeld wordt de Office 365 Outlook-connector gebruikt met een werk- of schoolaccount. Als u een ander e-mailaccount gebruikt, zijn de algemene stappen hetzelfde, maar ziet de gebruikersinterface er misschien iets anders uit.

    Belangrijk

    Als u de Gmail-connector wilt gebruiken, kunnen alleen bedrijfsaccounts van G Suite deze connector zonder beperking in logische apps gebruiken. Als u een Gmail-consumentenaccount hebt, kunt u deze connector alleen gebruiken met specifieke door Google goedgekeurde services of kunt u een Google-client-app maken voor verificatie met uw Gmail-connector. Zie Beleid voor gegevensbeveiliging en privacybeleid voor Google-connectors in Azure Logic Apps voor meer informatie.

  • Voor het voorbeeldscenario voor bestandssysteemactie hebt u een Dropbox-account nodig. U kunt zich gratis registreren.

  • De Logic-app-resources met de werkstroom waarmee u toegang wilt krijgen tot uw bestandsdeling.

    Als u uw werkstroom wilt starten met een Bestandssysteem-trigger, moet u een lege werkstroom hebben.

    Als u een bestandssysteemactie wilt gebruiken, kan uw werkstroom beginnen met elke trigger die het beste bij uw scenario past.

    Als u geen resource en werkstroom voor logische apps hebt, raadpleegt u de volgende artikelen:

Een bestandssysteemtrigger toevoegen

  1. In de Azure portal, open uw logische app-resource voor verbruik.

  2. Selecteer in de zijbalkmenu's van de resource onder Ontwikkelhulpprogramma's de ontwerpfunctie om uw lege werkstroom te openen.

  3. Voeg de gewenste bestandssysteemtrigger toe voor uw scenario door de algemene stappen te volgen om een trigger toe te voegen.

    Zie Bestandssysteemtriggers voor meer informatie. In dit voorbeeld wordt de trigger voortgezet met de naam Wanneer een bestand wordt gemaakt.

  4. Geef in het vak verbindingsgegevens de volgende gegevens op zoals vereist:

    Eigenschappen Vereist Weergegeven als Beschrijving
    Verbindingsnaam Ja < verbindingsnaam> De naam die moet worden gebruikt voor uw verbinding
    Hoofdmap Ja < root-folder-name> De hoofdmap voor uw bestandssysteem, meestal de hoofdmap en is de map die wordt gebruikt voor de relatieve paden met alle triggers die aan bestanden werken.

    Als u bijvoorbeeld de on-premises gegevensgateway hebt geïnstalleerd, gebruikt u de lokale map op de computer met de installatie van de gegevensgateway. Of gebruik de map voor de netwerkshare waar de computer bijvoorbeeld \PublicShare\MyFileSystemtoegang heeft tot die map.
    Verificatietype Nee < verificatietype> Het type verificatie dat uw bestandssysteemserver gebruikt, wat Windows is
    Gebruikersnaam Ja < domein en gebruikersnaam> Het domein en de gebruikersnaam voor de computer waarop u uw bestandssysteem hebt.

    Gebruik voor de beheerde bestandssysteemconnector een van de volgende waarden met de backslash (\):

    - < domein>\<gebruikersnaam>
    - < lokale computer>\<gebruikersnaam>

    Als uw bestandssysteemmap zich bijvoorbeeld op dezelfde computer bevindt als de installatie van de on-premises gegevensgateway, kunt u de lokale computer<\>< gebruiken.>
    Wachtwoord Ja < wachtwoord> Het wachtwoord voor de computer waarop u uw bestandssysteem hebt
    Gateway Nee - <Azure-abonnement>

    - <naam van gateway-resource>
    Deze sectie is alleen van toepassing op de beheerde bestandssysteemconnector:

    - Abonnement: het Azure-abonnement dat is gekoppeld aan de gegevensgatewayresource
    - Verbindingsgateway: de gegevensgatewayresource

    In het volgende voorbeeld ziet u de verbindingsgegevens voor de trigger van de door het bestandssysteem beheerde connector:

    Schermopname van de Consumptieworkflowontwerper en verbindingsinformatie voor de trigger van de door een bestandssysteem beheerde connector.

  5. Wanneer u klaar bent, selecteert u Nieuwe maken.

    Azure Logic Apps maakt en test uw verbinding en zorgt ervoor dat de verbinding goed werkt. Als de verbinding juist is ingesteld, worden de installatieopties weergegeven voor de geselecteerde trigger.

  6. Ga door met het bouwen van uw werkstroom.

    1. Geef de vereiste informatie op voor uw trigger.

      Selecteer voor dit voorbeeld het mappad op de bestandssysteemserver om te controleren op een nieuw gemaakt bestand. Geef het aantal bestanden op dat moet worden geretourneerd en hoe vaak u wilt controleren.

      Schermopname van consumption workflow designer en de trigger met de naam Wanneer een bestand wordt gemaakt.

    2. Als u uw werkstroom wilt testen, voegt u een Outlook-connectoractie toe waarmee u een e-mail ontvangt wanneer een bestand wordt gemaakt op het bestandssysteem in de opgegeven map. Voer de geadresseerden, het onderwerp en de hoofdtekst van het e-mailbericht in. Voor het testen kunt u uw eigen e-mailadres gebruiken.

      Schermopname van Consumption workflow designer, beheerde connector-trigger genaamd Wanneer een bestand wordt aangemaakt, en actie genaamd Een e-mail verzenden.

      Aanbeveling

      Als u uitvoer uit de vorige stappen in de werkstroom wilt toevoegen, selecteert u de invoervakken van de trigger. Wanneer de lijst met dynamische inhoud wordt weergegeven, selecteert u een van de beschikbare uitvoer.

  7. Sla uw werkstroom op als u gereed bent.

  8. Als u uw werkstroom wilt testen, uploadt u een bestand dat de werkstroom activeert.

Als dit lukt, verzendt uw werkstroom een e-mailbericht over het nieuwe bestand.

Een bestandssysteemactie toevoegen

De voorbeeldwerkstroom van de logische app begint met de Dropbox-trigger, maar u kunt elke gewenste trigger gebruiken.

  1. In de Azure portal, open uw logische app-resource voor verbruik.

  2. Selecteer in het zijbalkmenu van de resource onder Ontwikkelhulpprogramma's de ontwerpfunctie om uw werkstroom te openen.

  3. Voeg de gewenste bestandssysteemactie voor uw scenario toe door de algemene stappen te volgen om een actie toe te voegen.

    Zie Bestandssysteemtriggers voor meer informatie. In dit voorbeeld wordt de actie Bestand maken voortgezet.

  4. Geef uw verbindingsgegevens op als u hierom wordt gevraagd. Zie de tabel in de vorige sectie voor meer informatie.

  5. Ga door met het bouwen van uw werkstroom.

    1. Geef de vereiste informatie op voor uw actie.

      Voor dit voorbeeld selecteert u het mappad op de bestandssysteemserver die u wilt gebruiken. Dit is de hoofdmap hier. Voer de bestandsnaam en inhoud in op basis van het bestand dat is geüpload naar Dropbox.

      Schermopname die de werkstroomontwerper voor consumptie en de beheerconnectoractie van het bestandssysteem toont, genaamd Bestand maken.

      Aanbeveling

      Als u uitvoer uit de vorige stappen in de werkstroom wilt toevoegen, selecteert u de bewerkingsvakken van de actie. Wanneer de lijst met dynamische inhoud wordt weergegeven, selecteert u een van de beschikbare uitvoer.

    2. Als u uw werkstroom wilt testen, voegt u een Outlook-actie toe waarmee u een e-mailbericht ontvangt wanneer de actie Bestandssysteem een bestand maakt. Voer de geadresseerden, het onderwerp en de hoofdtekst van het e-mailbericht in. Voor het testen kunt u uw eigen e-mailadres gebruiken.

      Schermopname van Verbruiksworkflow-ontwerper, beheerconnector Actie 'Bestand maken' en Actie 'E-mail verzenden'.

  6. Sla uw werkstroom op als u gereed bent.

  7. Als u uw werkstroom wilt testen, uploadt u een bestand dat de werkstroom activeert.

Als dit lukt, maakt uw werkstroom een bestand op uw bestandssysteemserver op basis van het geüploade bestand in DropBox en verzendt u een e-mail over het gemaakte bestand.