Verbindung zu lokalen Dateisystemen aus Workflows in Azure Logic Apps

  • Artikel

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Diese Anleitung zeigt, wie man von einem Workflow in Azure Logic Apps über den File System Connector auf eine lokale Dateifreigabe zugreifen kann. Sie können dann automatisierte Workflows erstellen, die durch Ereignisse in Ihrer Dateifreigabe oder in anderen Systemen ausgelöst werden und Aktionen zur Verwaltung Ihrer Dateien ausführen. Der Connector bietet die folgenden Funktionen:

  • Erstellen, Abrufen, Anfügen, Aktualisieren und Löschen von Dateien.
  • Auflisten von Dateien in Ordnern oder Stammordnern
  • Sie können Dateiinhalte und Metadaten abrufen.

In dieser Schrittanleitung werden anhand von Beispielszenarien die folgenden Aufgaben erläutert:

  • Lösen Sie einen Workflow aus, wenn eine Datei erstellt oder zu einer Dateifreigabe hinzugefügt wird, und senden Sie dann eine E-Mail.
  • Lösen Sie einen Workflow aus, wenn Sie eine Datei aus einem Dropbox-Konto in eine Dateifreigabe kopieren, und senden Sie dann eine E-Mail.

Einschränkungen und bekannte Probleme

  • Der Dateisystemconnector unterstützt zurzeit nur Windows-Dateisysteme unter Windows-Betriebssystemen.
  • Zugeordnete Laufwerke werden nicht unterstützt.

Technische Referenz für den Connector

Der Dateisystem-Connector hat verschiedene Versionen, die auf dem Typ der logischen Anwendung und der Hostumgebung basieren.

Logik-App Environment Connector-Version
Verbrauch Azure Logic Apps mit mehreren Mandanten Verwalteter Connector, der im Designer unter der Bezeichnung Standard angezeigt wird. Weitere Informationen können Sie in der folgenden Dokumentation lesen:

- Referenz zum verwalteten Dateisystem-Connector
- Verwaltete Connectors in Azure Logic Apps
Verbrauch Integrationsdienstumgebung (Integration Service Environment, ISE) Verwalteter Connector, der im Designer unter der Bezeichnung Standard erscheint, und die ISE-Version, die andere Nachrichtengrenzen als die Standardklasse hat. Weitere Informationen können Sie in der folgenden Dokumentation lesen:

- Referenz zum verwalteten Dateisystem-Connector
- ISE-Nachrichtenlimits
- Verwaltete Connectors in Azure Logic Apps
Standard Einzelmandanten-Azure Logic Apps und App Service-Umgebung v3 (nur Windows-Pläne) Verwalteter Connector, der im Connectorkatalog unter Runtime>Freigegeben erscheint, und der integrierte Connector, der im Connectorkatalog unter Runtime>In-App erscheint wird und auf einem Dienstanbieter basiert. Der integrierte Verbinder unterscheidet sich auf folgende Weise:

– Der integrierte Connector unterstützt nur Standard-Logik-Apps, die nur in einer App Service-Umgebung v3 mit Windows-Plänen ausgeführt werden.

– Die integrierte Version kann sich direkt mit einer Dateifreigabe verbinden und auf virtuelle Azure-Netzwerke zugreifen, indem eine Verbindungszeichenfolge ohne ein lokales Datengateway verwendet wird.

Weitere Informationen können Sie in der folgenden Dokumentation lesen:

- Referenz zum verwalteten Dateisystem-Connector
- Dateisystem mit integriertem Connector als Referenz
- Integrierte Connectors in Azure Logic Apps

Voraussetzungen

  • Ein Azure-Konto und ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.

  • Um eine Verbindung zu Ihrer Dateifreigabe herzustellen, gelten je nach Logik-Apps und Hosting-Umgebung unterschiedliche Anforderungen:

    • Logik-App-Workflows für den Verbrauch

      • In Azure Logic Apps mit mehreren Mandanten müssen Sie die folgenden Anforderungen erfüllen, falls Sie dies nicht bereits getan haben:

        1. Installieren Sie das lokale Datengateway auf einem lokalen Computer.

          Der über das Dateisystem verwaltete Connector erfordert, dass Ihre Gateway-Installation und der Dateisystemserver in derselben Windows-Domäne vorhanden sind.

        2. Erstellen einer lokalen Datengateway-Ressource in Azure.

        3. Nachdem Sie einen von einem Dateisystem verwalteten Connector-Auslöser oder eine Aktion zu Ihrem Workflow hinzugefügt haben, wählen Sie die zuvor erstellte Datengateway-Ressource aus, um eine Verbindung zu Ihrem Dateisystem herzustellen.

      • Bei einer ISE brauchen Sie das lokale Datengateway nicht. Stattdessen können Sie den ISE-versionierten Dateisystem-Connector verwenden.

    • Standard-Logik-App-Workflows

      Sie können den im Dateisystem integrierten Connector oder den verwalteten Connector verwenden.

      • Für die Verwendung des verwalteten Dateisystem-Connectors gelten die gleichen Anforderungen wie für einen Logik-App-Workflow für den Verbrauch in Azure Logic Apps mit mehreren Mandanten.

      • Um den integrierten Dateisystem-Connector zu verwenden, muss Ihr Standard-Logik-App-Workflow in der App Service-Umgebung v3 ausgeführt werden, benötigt aber nicht die Datengateway-Ressource.

  • Zugriff auf den Computer mit dem Dateisystem, das Sie verwenden. Wenn Sie z.B. das Datengateway auf dem gleichen Computer installieren, auf dem sich Ihr Dateisystem befindet, benötigen Sie die Anmeldeinformationen für diesen Computer.

  • Um das Beispielszenario in dieser Anleitung nachvollziehen zu können, benötigen Sie ein E-Mail-Konto von einem Anbieter, der von Azure Logic Apps unterstützt wird, z. B. Office 365 Outlook, Outlook.com oder Gmail. Überprüfen Sie für andere Anbieter andere unterstützte E-Mail-Connectors. In diesem Beispiel wird der Office 365 Outlook Connector mit einem Geschäfts-, Schul- oder Unikonto verwendet. Bei Verwendung eines anderen E-Mail-Kontos sind die Schritte im Großen und Ganzen identisch, aber die Benutzeroberfläche weicht ggf. etwas ab.

    Wichtig

    Wenn Sie den Gmail-Connector verwenden möchten, können nur G-Suite-Geschäftskonten diesen Connector ohne Einschränkung in Logik-Apps verwenden. Wenn Sie über ein Gmail-Consumerkonto verfügen, können Sie diesen Connector nur mit bestimmten von Google genehmigten Diensten verwenden, oder Sie können eine Google-Client-App erstellen, die für die Authentifizierung mit Ihrem Gmail-Connector verwendet werden soll. Weitere Informationen finden Sie unter Datensicherheit und Datenschutzrichtlinien für Google-Connectors in Azure Logic Apps.

  • Für das Beispiel Dateisystem-Aktionsszenario benötigen Sie ein Dropbox Konto, das Sie kostenlos registrieren können.

  • Der Logik-App-Workflow, in dem Sie auf Ihr FTP-Konto zugreifen möchten. Um Ihren Workflow mit einem Dateisystem-Auslöser zu starten, müssen Sie mit einem leeren Workflow beginnen. Um eine Dateisystemaktion hinzuzufügen, starten Sie Ihren Workflow mit einem beliebigen Auslöser.

Hinzufügen eines Dateisystemtriggers

  1. Öffnen Sie im Azure-Portal den leeren Logik-App-Workflow im Designer.

  2. Führen Sie im Designer diese allgemeinen Schritte aus, um Ihrem Workflow den gewünschten Dateisystemtrigger hinzuzufügen.

    Weitere Informationen finden Sie unter Dateisystemtrigger. In diesem Beispiel wird weiterhin der Trigger Wenn eine Datei erstellt wird verwendet.

  3. Geben Sie im Feld Verbindungsinformationen die folgenden Informationen an:

    Eigenschaft Erforderlich Wert BESCHREIBUNG
    Verbindungsname Ja <connection-name> Der Name, der für Ihre Verbindung verwendet werden soll
    Stammordner Ja <Name des Stammordners> Der Stammordner für Ihr Dateisystem ist in der Regel der hauptübergeordnete Ordner und wird für die relativen Pfade mit allen Triggern verwendet wird, die an Dateien arbeiten.

    Wenn Sie beispielsweise das lokale Datengateway installiert haben, verwenden Sie den lokalen Ordner auf dem Computer mit der Installation des Datengateways. Oder verwenden Sie den Ordner für die Netzwerkfreigabe, wobei der Computer auf diesen Ordner zugreifen kann, z. B. \\PublicShare\\MyFileSystem.
    Authentifizierungstyp Nein <Authentifizierungstyp> Der Typ der Authentifizierung, der von Ihrem Dateisystemsystem verwendet wird: Windows
    Benutzername Ja <domain-and-username> Die Domäne und der Benutzername für den Computer, auf dem sich Ihr Dateisystem befindet.

    Verwenden Sie für den verwalteten Dateisystemconnector einen der folgenden Werte mit dem umgekehrten Schrägstrich (\):

    - <Domäne>\<Benutzername>
    - <lokaler Computer>\<Benutzername>

    Wenn sich Ihr Dateisystemordner beispielsweise auf demselben Computer wie das lokale Datengateway befindet, können Sie <lokaler Computer>\<Benutzername verwenden>.

    - Verwenden Sie für den ISE-basierten Dateisystemconnector stattdessen den Schrägstrich (/):

    - <Domäne>/<Benutzername>
    - <lokaler Computer>/<Benutzername>
    Kennwort Ja <password> Das Kennwort für den Computer, auf dem sich das Dateisystem befindet
    Gateway Nein - <Azure-subscription>
    – <Gateway-Ressourcenname>    		 Dieser Abschnitt gilt nur für den verwalteten Dateisystemconnector:

    - Abonnement: Das Azure-Abonnement, das der Datengatewayressource zugeordnet ist
    - Verbindungsgateway: Die Datengatewayressource

    Das folgende Beispiel zeigt die Verbindungsinformationen für den Auslöser des vom Dateisystem verwalteten Connectors:

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

    Das folgende Beispiel zeigt die Verbindungsinformationen für den ISE-basierten Dateisystem-Auslöser:

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

  4. Wählen Sie Erstellen, wenn Sie fertig sind.

    Azure Logic Apps erstellt und testet Ihre Verbindung, sodass sichergestellt ist, dass sie ordnungsgemäß funktioniert. Wenn die Verbindung ordnungsgemäß eingerichtet ist, werden die Setupoptionen für den ausgewählten Trigger angezeigt.

  5. Fahren Sie mit dem Erstellen Ihres Workflows fort.

    1. Geben Sie die erforderlichen Informationen für Ihren Trigger an.

      Wählen Sie in diesem Beispiel den Ordnerpfad auf Ihrem Dateisystemserver aus, um nach einer neu erstellten Datei zu suchen. Geben Sie die Anzahl der zurückzugebenden Dateien an und wie oft Sie suchen möchten.

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

    2. Um Ihren Workflow zu testen, fügen Sie eine Outlook-Aktion hinzu, die Sie eine E-Mail sendet, wenn eine Datei im Dateisystem im angegebenen Ordner erstellt wird. Geben Sie die E-Mail-Empfänger, den Betreff und den Textkörper ein. Zu Testzwecken können Sie hier Ihre eigene E-Mail-Adresse angeben.

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

      Tipp

      Zum Hinzufügen von Ausgaben aus vorherigen Schritten im Workflow wählen Sie die Bearbeitungsfelder des Triggers aus. Wenn die dynamische Inhaltsliste angezeigt wird, wählen Sie aus den verfügbaren Ausgaben aus.

  6. Wenn Sie fertig sind, speichern Sie Ihren Workflow.

  7. Um Ihren Workflow zu testen, laden Sie eine Datei hoch, die den Workflow auslöst.

Wenn der Workflow erfolgreich verläuft, sendet Ihr Workflow eine E-Mail über die neue Datei.

Hinzufügen einer Dateisystemaktion

Der Beispielworkflow der Logik-App beginnt mit dem Dropbox-Auslöser. Sie können jedoch jeden beliebigen Auslöser verwenden.

  1. Öffnen Sie im Azure-Portal den Logik-App-Workflow im Designer.

  2. Führen Sie im Designer diese allgemeinen Schritte aus, um Ihrem Workflow die gewünschte Dateisystemaktion hinzuzufügen.

    Weitere Informationen finden Sie unter Dateisystemtrigger. In diesem Beispiel wird mit der Aktion Datei erstellen fortgesetzt.

  3. Geben Sie im Feld Verbindungsinformationen die folgenden Informationen an:

    Eigenschaft Erforderlich Wert BESCHREIBUNG
    Verbindungsname Ja <connection-name> Der Name, der für Ihre Verbindung verwendet werden soll
    Stammordner Ja <Name des Stammordners> Der Stammordner für Ihr Dateisystem ist in der Regel der hauptübergeordnete Ordner und wird für die relativen Pfade mit allen Triggern verwendet wird, die an Dateien arbeiten.

    Wenn Sie beispielsweise das lokale Datengateway installiert haben, verwenden Sie den lokalen Ordner auf dem Computer mit der Installation des Datengateways. Oder verwenden Sie den Ordner für die Netzwerkfreigabe, wobei der Computer auf diesen Ordner zugreifen kann, z. B. \\PublicShare\\MyFileSystem.
    Authentifizierungstyp Nein <Authentifizierungstyp> Der Typ der Authentifizierung, der von Ihrem Dateisystemsystem verwendet wird: Windows
    Benutzername Ja <domain-and-username> Die Domäne und der Benutzername für den Computer, auf dem sich Ihr Dateisystem befindet.

    Verwenden Sie für den verwalteten Dateisystemconnector einen der folgenden Werte mit dem umgekehrten Schrägstrich (\):

    - <Domäne>\<Benutzername>
    - <lokaler Computer>\<Benutzername>

    Wenn sich Ihr Dateisystemordner beispielsweise auf demselben Computer wie das lokale Datengateway befindet, können Sie <lokaler Computer>\<Benutzername verwenden>.

    - Verwenden Sie für den ISE-basierten Dateisystemconnector stattdessen den Schrägstrich (/):

    - <Domäne>/<Benutzername>
    - <lokaler Computer>/<Benutzername>
    Kennwort Ja <password> Das Kennwort für den Computer, auf dem sich das Dateisystem befindet
    Gateway Nein - <Azure-subscription>
    – <Gateway-Ressourcenname>    		 Dieser Abschnitt gilt nur für den verwalteten Dateisystemconnector:

    - Abonnement: Das Azure-Abonnement, das der Datengatewayressource zugeordnet ist
    - Verbindungsgateway: Die Datengatewayressource

    Das folgende Beispiel zeigt die Verbindungsinformationen für die verwaltete Connector-Aktion „Dateisystem“:

    Screenshot showing connection information for File System managed connector action.

    Das folgende Beispiel zeigt die Verbindungsinformationen für die ISE-basierte Connector-Aktion „Dateisystem“:

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

  4. Wählen Sie Erstellen, wenn Sie fertig sind.

    Azure Logic Apps erstellt und testet Ihre Verbindung, sodass sichergestellt ist, dass sie ordnungsgemäß funktioniert. Wenn die Verbindung ordnungsgemäß eingerichtet ist, werden die Setupoptionen für die ausgewählte Aktion angezeigt.

  5. Fahren Sie mit dem Erstellen Ihres Workflows fort.

    1. Geben Sie die erforderlichen Informationen für Ihre Aktion an.

      Wählen Sie in diesem Beispiel den Ordnerpfad auf Ihrem Dateisystemserver aus, der verwendet werden soll – in diesem Fall der Stammordner. Geben Sie den Dateinamen und den Inhalt, basierend auf der in Dropbox hochgeladenen Datei, ein.

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

      Tipp

      Zum Hinzufügen von Ausgaben aus vorherigen Schritten im Workflow wählen Sie die Bearbeitungsfelder der Aktion aus. Wenn die dynamische Inhaltsliste angezeigt wird, wählen Sie aus den verfügbaren Ausgaben aus.

    2. Um Ihren Workflow zu testen, fügen Sie eine Outlook-Aktion hinzu, die Sie an eine E-Mail sendet, wenn die Dateisystemaktion eine Datei erstellt. Geben Sie die E-Mail-Empfänger, den Betreff und den Textkörper ein. Zu Testzwecken können Sie hier Ihre eigene E-Mail-Adresse angeben.

      Screenshot showing Consumption workflow designer, managed connector

  6. Wenn Sie fertig sind, speichern Sie Ihren Workflow.

  7. Um Ihren Workflow zu testen, laden Sie eine Datei hoch, die den Workflow auslöst.

Wenn der Workflow erfolgreich verläuft, erstellt Ihr Workflow eine Datei auf Ihrem Dateisystemserver basierend auf der hochgeladenen Datei in DropBox und sendet eine E-Mail über die erstellte Datei.

Nächste Schritte