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

  • Artikel

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.

Verbinding maken of technische naslaginformatie

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

Logische apps Omgeving Verbinding maken orversie
Verbruik Azure Logic Apps met meerdere tenants Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Standard . Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde bestandssysteemconnector
- Beheerde connectors in Azure Logic Apps
Verbruik Integratieserviceomgeving (ISE) Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Standard en de ISE-versie, die verschillende berichtlimieten heeft dan de Standard-klasse. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde bestandssysteemconnector
- 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, die wordt weergegeven in de connectorgalerie onder Runtime>Shared en de ingebouwde connector, die wordt weergegeven in de connectorgalerie onder Runtime>In-App en is gebaseerd op 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.

      • In een ISE hebt u de on-premises gegevensgateway niet nodig. In plaats daarvan kunt u de ISE-versie van de bestandssysteemconnector gebruiken.

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

    - Voor de op ISE gebaseerde bestandssysteemconnector gebruikt u in plaats daarvan de slash (/):

    - <domein>/<gebruikersnaam>
    - <local-computer>/<gebruikersnaam>
    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
    - Verbinding maken ion-gateway: de gegevensgatewayresource

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

    Screenshot showing Consumption workflow designer and connection information for File System managed connector trigger.

    In het volgende voorbeeld ziet u de verbindingsgegevens voor de op ISE gebaseerde trigger van het bestandssysteem:

    Screenshot showing Consumption workflow designer and connection information for File System ISE-based connector trigger.

  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.

      Screenshot showing Consumption workflow designer and the trigger named When a file is created.

    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.

      Screenshot showing Consumption workflow designer, managed connector trigger named When a file is created, and action named Send an email.

      Fooi

      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 wanneer u klaar 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 Omschrijving
    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.<

    - Voor de op ISE gebaseerde bestandssysteemconnector gebruikt u in plaats daarvan de slash (/):

    - <domein>/<gebruikersnaam>
    - <local-computer>/<gebruikersnaam>
    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
    - Verbinding maken ion-gateway: de gegevensgatewayresource

    In het volgende voorbeeld ziet u de verbindingsgegevens voor de door het bestandssysteem beheerde connectoractie:

    Screenshot showing connection information for File System managed connector action.

    In het volgende voorbeeld ziet u de verbindingsgegevens voor de connectoractie Op basis van bestandssysteem ISE:

    Screenshot showing connection information for File System ISE-based connector action.

  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.

      Screenshot showing Consumption workflow designer and the File System managed connector action named Create file.

      Fooi

      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.

      Screenshot showing Consumption workflow designer, managed connector

  6. Sla uw werkstroom op wanneer u klaar 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