Share 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 Runtime>Shared. 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 connectorgalerie onder Runtime>Shared en ingebouwde connector, die wordt weergegeven in de connectorgalerie onder Runtime>In-App en is op basis van serviceproviders. 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 logische apps voor verbruik

      • In Azure Logic Apps met meerdere tenants moet u voldoen aan de volgende vereisten, als u dat nog niet hebt gedaan:

        1. Installeer de on-premises gegevensgateway op een lokale computer.

          De door het bestandssysteem beheerde connector vereist dat uw gatewayinstallatie en bestandssysteemserver aanwezig moeten zijn in hetzelfde Windows-domein.

        2. Maak een on-premises gegevensgatewayresource in Azure.

        3. Nadat u een door het bestandssysteem beheerde connectortrigger of -actie aan uw werkstroom hebt toegevoegd, selecteert u de gegevensgatewayresource die u eerder hebt gemaakt, zodat u verbinding kunt maken met uw bestandssysteem.

    • Standaardwerkstromen voor logische apps

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

      • Als u de door het bestandssysteem beheerde connector wilt gebruiken, volgt u dezelfde vereisten als een werkstroom voor logische verbruiks-apps in Azure Logic Apps met meerdere tenants.

      • Als u de ingebouwde connector voor bestandssysteem wilt gebruiken, moet de werkstroom voor de logische standaard-app worden uitgevoerd in App Service Environment v3, maar hiervoor is geen gegevensgatewayresource 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 u kunt een Google-client-app maken voor verificatie bij 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, dat u gratis kunt registreren.

  • De werkstroom van de logische app waar u toegang wilt krijgen tot uw bestandsshare. Als u uw werkstroom wilt starten met een bestandssysteemtrigger, moet u beginnen met een lege werkstroom. Als u een bestandssysteemactie wilt toevoegen, start u uw werkstroom met een trigger.

Een bestandssysteemtrigger toevoegen

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

  2. Volg deze algemene stappen in de ontwerpfunctie om de bestandssysteemtrigger toe te voegen die u aan uw werkstroom wilt toevoegen.

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

  3. 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>
    - <local-computer>\<username>

    Als uw bestandssysteemmap zich bijvoorbeeld op dezelfde computer bevindt als de installatie van de on-premises gegevensgateway, kunt u de lokale computer>\<gebruikersnaam> gebruiken.<
    Wachtwoord Ja <password> 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 ontwerpfunctie voor werkstromen van verbruik en verbindingsgegevens voor de trigger van de beheerde bestandssysteemconnector.

  4. Selecteer Maken als u klaar bent.

    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.

  5. 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-actie toe waarmee u een e-mailbericht 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, managed connector trigger named When a file is created, and action named Send an email.

      Tip

      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.

  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, 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. Open uw werkstroom voor logische apps in Azure Portal in de ontwerpfunctie.

  2. Volg deze algemene stappen in de ontwerpfunctie om de actie Bestandssysteem toe te voegen die u aan uw werkstroom wilt toevoegen.

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

  3. 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>
    - <local-computer>\<username>

    Als uw bestandssysteemmap zich bijvoorbeeld op dezelfde computer bevindt als de installatie van de on-premises gegevensgateway, kunt u de lokale computer>\<gebruikersnaam> gebruiken.<
    Wachtwoord Ja <password> 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 door het bestandssysteem beheerde connectoractie:

    Schermopname van de verbindingsinformatie voor de door het bestandssysteem beheerde connectoractie.

  4. Selecteer Maken als u klaar bent.

    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 actie.

  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 van De ontwerpfunctie voor werkstromen verbruik en de actie Bestandssysteem beheerde connector met de naam Bestand maken.

      Tip

      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 de actie 'Bestand maken' van de beheerde connector en de actie Een 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.

Volgende stappen