Łączenie z lokalnymi systemami plików z poziomu przepływów pracy w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

W tym przewodniku pokazano, jak uzyskać dostęp do lokalnego udostępnionego zasobu plików za pomocą przepływu pracy w usłudze Azure Logic Apps, korzystając z konektora systemu plików. Następnie możesz tworzyć zautomatyzowane przepływy pracy, które są uruchamiane po wyzwoleniu przez zdarzenia w twoim zasobie plików lub w innych systemach oraz wykonywać działania w celu zarządzania plikami. Łącznik zapewnia następujące możliwości:

  • Tworzenie, pobieranie, dołączanie, aktualizowanie i usuwanie plików.
  • Wyświetl pliki w folderach lub folderach głównych.
  • Pobieranie zawartości pliku i metadanych.

W tym przewodniku z instrukcjami przykładowe scenariusze przedstawiają następujące zadania:

  • Wyzwól przepływ pracy, gdy plik zostanie utworzony lub dodany do udziału plików, a następnie wyślij wiadomość e-mail.
  • Wyzwalanie przepływu pracy podczas kopiowania pliku z konta usługi Dropbox do udziału plików, a następnie wysyłania wiadomości e-mail.

Ograniczenia i znane problemy

  • Łącznik systemu plików obsługuje obecnie tylko systemy plików Systemu Windows w systemach operacyjnych Windows.
  • Zamapowane dyski sieciowe nie są obsługiwane.
  • Dla wbudowanego konektora folder główny musi być najwyższym poziomem udostępnienia plików. Łącznik nie obsługuje zagnieżdżonych ścieżek do folderów głównych. Zamiast tego określ podfoldery, używając ścieżek względnych w operacjach łączących.
  • Standardowa aplikacja logiczna obsługuje do 20 wbudowanych połączeń z systemem plików.
  • Złącze nie obsługuje wielu wbudowanych połączeń korzystających z tego samego folderu głównego z różnymi datami uwierzytelniającymi.

Dokumentacja techniczna łącznika

Łącznik systemu plików ma różne wersje, w zależności od typu aplikacji logiki i środowiska hosta.

Aplikacja logiki Środowisko Wersja łącznika
Zużycie Wielodostępna usługa Azure Logic Apps Łącznik zarządzany wyświetlany w galerii łączników w obszarze Udostępnione. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

- Dokumentacja referencyjna zarządzanego łącznika File System
- Łączniki zarządzane w usłudze Azure Logic Apps
Standard Single-tenant Azure Logic Apps in a Workflow Service Plan or App Service Environment v3 (tylko plany Windows) Łącznik zarządzany, który jest wyświetlany w galerii łączników w obszarze Udostępnione i wbudowany łącznik, który jest wyświetlany w galerii łączników w obszarze Wbudowane i jest oparty na dostawcy usług. Wbudowany łącznik może łączyć się bezpośrednio z udostępnianiem plików i korzystać z wirtualnych sieci Azure bez lokalnej bramy danych.

Aby uzyskać więcej informacji, zobacz:

- Dokumentacja referencyjna zarządzanego łącznika File System
- Informacje o wbudowanym łączniku systemu plików
- Wbudowane łączniki w usłudze Azure Logic Apps

Wymagania wstępne

  • Konto i subskrypcja platformy Azure. Uzyskaj bezpłatne konto platformy Azure.

  • Aby połączyć się z udziałem plików, obowiązują różne wymagania w zależności od aplikacji logiki i środowiska hostingu:

    • Przepływy pracy aplikacji logiki konsumpcyjnej

    • Standardowe przepływy pracy aplikacji logiki:

      Możesz użyć wbudowanego łącznika systemu plików lub łącznika zarządzanego.

      • Aby użyć zarządzanego łącznika systemu plików, postępuj zgodnie z tymi samymi wymaganiami co przepływ pracy aplikacji logicznych typu Consumption w usłudze multi-tenant Azure Logic Apps.

        • Aby korzystać z wbudowanego złącza systemu plików, przepływ pracy standardowej aplikacji logiki musi działać w planie usługi Workflow Service Plan opartym na systemie Windows lub w środowisku App Service Environment v3, ale nie wymaga zasobu bramy danych.

        • Aby kierować ruch udostępniany plikami przez zintegrowaną sieć wirtualną, ustaw WEBSITE_CONTENTOVERVNET ustawienie aplikacji na 1, lub włącz właściwość vnetContentShareEnabled strony. Upewnij się, że sieć wirtualna może rozpoznać w pełni kwalifikowaną nazwę domenową (FQDN) serwera plików i umożliwia wychodzący ruch SMB na porcie 445.

  • Dostęp do komputera z systemem plików, którego chcesz użyć. Jeśli na przykład brama danych zostanie zainstalowana na tym samym komputerze co system plików, potrzebne są poświadczenia konta dla tego komputera.

  • Aby postępować zgodnie z przykładowym scenariuszem w tym przewodniku, potrzebujesz konta e-mail od dostawcy obsługiwanego przez usługę Azure Logic Apps, takiego jak Office 365 Outlook, Outlook.com lub Gmail. W przypadku innych dostawców przejrzyj inne obsługiwane konektory poczty e-mail. W tym przykładzie użyto łącznika Office 365 Outlook z kontem służbowym lub szkolnym. Jeśli korzystasz z innego konta e-mail, ogólne kroki będą takie same, ale interfejs użytkownika może się trochę różnić.

    Ważne

    Aby korzystać z konektora Gmail, tylko konta biznesowe G-Suite mogą korzystać z tego złącza bez ograniczeń w aplikacjach logicznych.

    Jeśli masz konto użytkownika Gmail, możesz użyć tego łącznika tylko z określonymi usługami zatwierdzonymi przez firmę Google lub utworzyć aplikację kliencką Google do użycia do uwierzytelniania za pomocą łącznika gmaila.

    Aby uzyskać więcej informacji, zobacz Zasady zabezpieczeń i prywatności danych dla łączników Google w usłudze Azure Logic Apps.

  • Na potrzeby przykładowego scenariusza działania systemu plików potrzebne jest konto usługi Dropbox. Możesz zarejestrować się bezpłatnie.

  • W aplikacji logicznej znajduje się zasób z przepływem pracy, w którym chcesz uzyskać dostęp do zasobu plików.

    Aby uruchomić przepływ pracy za pomocą wyzwalacza systemu plików , musisz mieć pusty przepływ pracy.

    Aby użyć akcji System plików , przepływ pracy może zaczynać się od dowolnego wyzwalacza, który najlepiej pasuje do danego scenariusza.

    Jeśli nie masz zasobu aplikacji logicznej i przepływu pracy, zobacz następujące artykuły:

Dodaj wyzwalacz systemu plików

  1. W portalu Azure otwórz zasób aplikacji logiki Zużycia. W projektancie otwórz pusty przepływ pracy.

  2. Dodaj wyzwalacz System plików do swojego scenariusza, wykonując ogólne kroki, aby dodać wyzwalacz do swojego przepływu pracy.

    Aby uzyskać więcej informacji, zobacz Wyzwalacze systemu plików. Ten przykład jest kontynuacją z wyzwalaczem o nazwie Gdy plik zostanie utworzony.

  3. W polu informacje o połączeniu podaj następujące informacje zgodnie z wymaganiami:

    Właściwości Wymagane Wartość Opis
    Nazwa połączenia Tak < nazwa połączenia> Nazwa do użycia dla połączenia
    Folder główny Tak < nazwa folderu głównego> Folder główny systemu plików, który jest zazwyczaj głównym folderem nadrzędnym i jest folderem używanym dla ścieżek względnych ze wszystkimi wyzwalaczami, które działają na plikach.

    Jeśli na przykład zainstalowano lokalną bramę danych, użyj folderu lokalnego na komputerze z instalacją bramy danych. Lub użyj folderu w udziale sieciowym, do którego komputer ma dostęp, na przykład \PublicShare\MyFileSystem.
    Typ uwierzytelnienia Nie. < typ uwierzytelniania> Typ uwierzytelniania używanego przez serwer systemu plików, czyli Windows
    Nazwa użytkownika Tak < domena i nazwa użytkownika> Domena i nazwa użytkownika komputera, na którym masz system plików.

    W przypadku zarządzanego łącznika systemu plików użyj jednej z poniższych wartości w połączeniu z ukośnikiem odwrotnym (\):

    - < domena>\<nazwa użytkownika>
    - < komputer-lokalny>\<nazwa użytkownika>

    Na przykład jeśli folder systemu plików znajduje się na tym samym komputerze, na którym zainstalowano lokalną bramę danych, możesz użyć <local-computer>\<username>.
    Hasło Tak < hasło> Hasło komputera, na którym masz system plików
    Brama Nie. — <Subskrypcja platformy Azure>

    - <gateway-resource-name>    		 Ta sekcja dotyczy tylko zarządzanego łącznika systemu plików:

    - Subskrypcja: subskrypcja platformy Azure skojarzona z zasobem bramy danych
    - Brama połączeń: zasób bramy danych

    W poniższym przykładzie przedstawiono informacje o połączeniu wyzwalacza łącznika zarządzanego przez system plików :

    Zrzut ekranu przedstawiający projektanta przepływu pracy użycia i informacje o połączeniu dla wyzwalacza łącznika zarządzanego przez system plików.

  4. Po zakończeniu wybierz pozycję Utwórz nową.

    Usługa Azure Logic Apps tworzy i testuje połączenie, upewniając się, że połączenie działa prawidłowo. Jeśli połączenie jest skonfigurowane poprawnie, opcje konfiguracji zostaną wyświetlone dla wybranego wyzwalacza.

  5. Kontynuuj tworzenie przepływu pracy.

    1. Podaj wymagane informacje dla wyzwalacza.

      W tym przykładzie wybierz ścieżkę folderu na serwerze systemu plików, aby sprawdzić nowo utworzony plik. Określ liczbę plików do zwrócenia i częstotliwość sprawdzania.

      Zrzut ekranu przedstawiający projektanta przepływu pracy o nazwie 'Zużycie' oraz wyzwalacz 'Kiedy plik jest tworzony'.

    2. Aby przetestować przepływ pracy, dodaj akcję łącznika programu Outlook, która wysyła wiadomość e-mail po utworzeniu pliku w systemie plików w określonym folderze. Wprowadź adresatów wiadomości e-mail, temat i treść. Na potrzeby testowania możesz użyć własnego adresu e-mail.

      Zrzut ekranu przedstawiający projektanta przepływu pracy dla zużycia, wyzwalacz łącznika zarządzanego o nazwie Po utworzeniu pliku oraz akcję o nazwie Wyślij wiadomość e-mail.

      Wskazówka

      Aby dodać dane wyjściowe z poprzednich kroków w przepływie pracy, kliknij w polach edycyjnych wyzwalacza. Gdy zostanie wyświetlona lista zawartości dynamicznej, wybierz z dostępnych danych wyjściowych.

  6. Gdy wszystko będzie gotowe, zapisz proces.

  7. Aby przetestować przepływ pracy, przekaż plik, który wyzwala przepływ pracy.

Jeśli przepływ pracy zakończy się pomyślnie, wyśle wiadomość e-mail dotyczącą nowego pliku.

Dodaj akcję systemu plików

Przykładowy przepływ pracy aplikacji logiki rozpoczyna się od wyzwalacza Dropbox, ale możesz użyć dowolnego wyzwalacza.

  1. W portalu Azure otwórz zasób aplikacji logiki Zużycia. W edytorze otwórz przepływ pracy.

  2. Dodaj akcję systemu plików dla swojego scenariusza, postępując zgodnie z ogólnymi krokami dodania akcji do swojego workflow.

    Aby uzyskać więcej informacji, zobacz Wyzwalacze systemu plików. W tym przykładzie jest kontynuowana akcja o nazwie Utwórz plik.

  3. Jeśli zostanie wyświetlony monit, podaj informacje o połączeniu. Aby uzyskać więcej informacji, zobacz tabelę w poprzedniej sekcji.

  4. Kontynuuj tworzenie przepływu pracy.

    1. Podaj wymagane informacje dotyczące akcji.

      W tym przykładzie wybierz ścieżkę folderu na serwerze systemu plików do użycia, czyli folder główny tutaj. Wprowadź nazwę pliku i zawartość na podstawie pliku przekazanego do usługi Dropbox.

      Zrzut ekranu przedstawiający projektanta przepływu pracy Konsumpcja oraz akcję łącznika zarządzanego przez system plików o nazwie Utwórz plik.

      Wskazówka

      Aby dodać dane wyjściowe z poprzednich kroków w przepływie pracy, kliknij wewnątrz pól edycyjnych akcji. Gdy zostanie wyświetlona lista zawartości dynamicznej, wybierz z dostępnych danych wyjściowych.

    2. Aby przetestować przepływ pracy, dodaj akcję programu Outlook, która wysyła wiadomość e-mail po utworzeniu pliku przez akcję System plików. Wprowadź adresatów wiadomości e-mail, temat i treść. Na potrzeby testowania możesz użyć własnego adresu e-mail.

      Zrzut ekranu przedstawiający projektanta przepływu pracy dotyczącego zużycia, akcję Utwórz plik przy użyciu zarządzanego łącznika i akcję Wyślij e-mail.

  5. Gdy wszystko będzie gotowe, zapisz proces.

  6. Aby przetestować przepływ pracy, przekaż plik, który wyzwala przepływ pracy.

Jeśli operacja zakończy się powodzeniem, ten przepływ pracy utworzy plik na serwerze systemu plików na podstawie pliku przesłanego do Dropbox i wyśle wiadomość e-mail z informacją o utworzonym pliku.

Rozwiąż problemy z wbudowanym łącznikiem File System

Jeśli operacja zakończy się błędem InvalidServiceProviderConnection i zostanie zgłoszone, że ścieżka instalacji, taka jak C:\mounts\FileSystem, nie istnieje, aplikacja logiki nie może zamontować udziału plików ani uzyskać do niego dostępu.

Sprawdź następujące elementy:

  • Potwierdź, że folder główny korzysta z pełnej ścieżki UNC z FQDN lub adresem IP serwera plików oraz nazwą najwyższego poziomu, na przykład \\file-server.contoso.com\MyShare. Nie używaj tylko nazwy maszyny ani nie dodawaj zagnieżdżonych folderów.
  • Potwierdź, że wirtualne tabele routowania sieci i grupy bezpieczeństwa sieciowego pozwalają na ruch SMB z aplikacji logicznej do serwera plików na porcie 445.
  • Z konsoli Kudu aplikacji logiki uruchom nslookup <FQDN>, aby potwierdzić, że nazwa serwera plików jest prawidłowo rozpoznawana, i sprawdź, czy oczekiwana ścieżka istnieje pod C:\mounts.
  • Jeśli ruch musi korzystać ze zintegrowanej sieci wirtualnej, potwierdź, że parametr WEBSITE_CONTENTOVERVNET jest ustawiony na 1 lub że właściwość vnetContentShareEnabled witryny jest włączona.
  • Potwierdź, że konto ma uprawnienia dostępu do udziału najwyższego poziomu. Jeśli konto ma dostęp tylko do folderu zagnieżdżonego, udostępnij ten folder jako osobny udział i użyj nowo utworzonego udziału najwyższego poziomu jako folderu głównego.

Treści powiązane

  • Last updated on