Tworzenie standardowego przepływu pracy aplikacji logiki w usłudze Azure Logic Apps z jedną dzierżawą przy użyciu programu Visual Studio Code

Dotyczy: Azure Logic Apps (Standardowa)

W tym przewodniku z instrukcjami pokazano, jak utworzyć przykładowy przepływ pracy integracji uruchamiany w usłudze Azure Logic Apps z jedną dzierżawą przy użyciu programu Visual Studio Code z rozszerzeniem azure Logic Apps (Standard). Przed utworzeniem tego przepływu pracy utworzysz zasób standardowej aplikacji logiki, który zapewnia następujące możliwości:

  • Aplikacja logiki może zawierać wiele stanowych i bezstanowych przepływów pracy.

  • Przepływy pracy w tej samej aplikacji logiki i dzierżawie działają w tym samym procesie co środowisko uruchomieniowe usługi Azure Logic Apps, dzięki czemu współużytkują te same zasoby i zapewniają lepszą wydajność.

  • Przepływy pracy można tworzyć, uruchamiać i testować lokalnie przy użyciu środowiska deweloperskiego programu Visual Studio Code.

    Gdy wszystko będzie gotowe, możesz wdrożyć aplikację logiki na platformie Azure, w której przepływ pracy można uruchomić w środowisku usługi Azure Logic Apps z jedną dzierżawą lub w środowisku App Service Environment w wersji 3 (tylko plany usługi App Service oparte na systemie Windows). Możesz również wdrożyć i uruchomić przepływ pracy w dowolnym miejscu, w którym platforma Kubernetes może działać, w tym platforma Azure, usługa Azure Kubernetes Service, lokalna lub nawet inni dostawcy usług w chmurze ze względu na konteneryzowane środowisko uruchomieniowe usługi Azure Logic Apps.

    Uwaga

    Wdrażanie aplikacji logiki w klastrze Kubernetes jest obecnie dostępne w publicznej wersji zapoznawczej.

    Aby uzyskać więcej informacji na temat usługi Azure Logic Apps z jedną dzierżawą, zapoznaj się z artykułem Single-tenant versus multitenant and integration service environment (Jednodostępne i wielodostępne środowisko usługi integracji).

Chociaż przykładowy przepływ pracy jest oparty na chmurze i ma tylko dwa kroki, można tworzyć przepływy pracy z setek operacji, które mogą łączyć szeroką gamę aplikacji, danych, usług i systemów w chmurze, w środowiskach lokalnych i hybrydowych. Przykładowy przepływ pracy rozpoczyna się od wbudowanego wyzwalacza Żądania i jest zgodny z akcją usługi Office 365 Outlook. Wyzwalacz tworzy wywoływany punkt końcowy dla przepływu pracy i oczekuje na przychodzące żądanie HTTPS z dowolnego obiektu wywołującego. Gdy wyzwalacz odbierze żądanie i zostanie wyzwolone, następna akcja zostanie uruchomiona, wysyłając wiadomość e-mail na określony adres e-mail wraz z wybranymi danymi wyjściowymi z wyzwalacza.

Napiwek

Jeśli nie masz konta usługi Office 365, możesz użyć dowolnej innej dostępnej akcji, która może wysyłać wiadomości z konta e-mail, na przykład Outlook.com.

Aby utworzyć ten przykładowy przepływ pracy przy użyciu witryny Azure Portal, wykonaj kroki opisane w artykule Tworzenie przepływów pracy integracji przy użyciu usługi Azure Logic Apps z jedną dzierżawą i witryną Azure Portal. Obie opcje zapewniają możliwość tworzenia, uruchamiania i wdrażania przepływów pracy aplikacji logiki w takich samych środowiskach. Jednak za pomocą programu Visual Studio Code można lokalnie opracowywać, testować i uruchamiać przepływy pracy w środowisku projektowym.

Zrzut ekranu przedstawiający program Visual Studio Code, projekt aplikacji logiki i przepływ pracy.

W miarę postępu wykonasz te zadania wysokiego poziomu:

  • Utwórz projekt dla aplikacji logiki i pusty stanowy przepływ pracy.
  • Dodaj wyzwalacz i akcję.
  • Uruchamianie, testowanie, debugowanie i przeglądanie historii uruchamiania lokalnie.
  • Znajdź szczegóły nazwy domeny na potrzeby dostępu do zapory.
  • Wdróż na platformie Azure, która obejmuje opcjonalne włączanie Szczegółowe informacje aplikacji.
  • Zarządzanie wdrożona aplikacją logiki w programie Visual Studio Code i witrynie Azure Portal.
  • Włącz historię uruchamiania dla bezstanowych przepływów pracy.
  • Włącz lub otwórz Szczegółowe informacje aplikacji po wdrożeniu.

Wymagania wstępne

Dostęp i łączność

  • Jeśli planujesz lokalnie tworzyć projekty aplikacji logiki w warstwie Standardowa i uruchamiać przepływy pracy przy użyciu tylko wbudowanych łączników , które działają natywnie w środowisku uruchomieniowym usługi Azure Logic Apps, nie potrzebujesz następujących wymagań. Upewnij się jednak, że masz następujące poświadczenia łączności i konta platformy Azure umożliwiające publikowanie lub wdrażanie projektu z programu Visual Studio Code na platformie Azure, używanie łączników zarządzanych uruchamianych na globalnej platformie Azure lub uzyskiwanie dostępu do standardowych zasobów i przepływów pracy aplikacji logiki wdrożonych już na platformie Azure:

  • Aby utworzyć ten sam przykładowy przepływ pracy w tym artykule, potrzebujesz konta e-mail usługi Office 365 Outlook, które używa konta służbowego Microsoft do logowania.

    Jeśli wybierzesz inny łącznik poczty e-mail, taki jak Outlook.com, nadal możesz postępować zgodnie z przykładem, a ogólne ogólne kroki są takie same. Jednak opcje mogą się różnić w jakiś sposób. Jeśli na przykład używasz łącznika Outlook.com, użyj osobistego konta Microsoft, aby się zalogować.

Narzędzia

  1. Pobierz i zainstaluj program Visual Studio Code, który jest bezpłatny.

  2. Pobierz i zainstaluj rozszerzenie konta platformy Azure dla programu Visual Studio Code , aby mieć jedno typowe środowisko filtrowania logowania i subskrypcji platformy Azure we wszystkich rozszerzeniach platformy Azure w programie Visual Studio Code. Ten przewodnik z instrukcjami zawiera kroki, które korzystają z tego środowiska.

  3. Pobierz i zainstaluj następujące zależności programu Visual Studio Code dla określonego systemu operacyjnego przy użyciu jednej z metod:

    Automatycznie zainstaluj wszystkie zależności

    Począwszy od wersji 2.81.5, rozszerzenie usługi Azure Logic Apps (Standard) dla programu Visual Studio Code zawiera instalator zależności, który automatycznie instaluje wszystkie wymagane zależności w nowym folderze binarnym i pozostawia wszystkie istniejące zależności bez zmian. Aby uzyskać więcej informacji, zobacz Rozpoczynanie pracy z rozszerzeniem Azure Logic Apps (Standard) dla programu Visual Studio Code.

    To rozszerzenie obejmuje następujące zależności:

    Dependency opis
    Rozszerzenie C# for Visual Studio Code Umożliwia uruchamianie przepływu pracy przez funkcję F5.
    Azurite for Visual Studio Code Udostępnia lokalny magazyn danych i emulator do użycia z programem Visual Studio Code, dzięki czemu można pracować nad projektem aplikacji logiki i uruchamiać przepływy pracy w lokalnym środowisku projektowym. Jeśli nie chcesz, aby Azurite automatycznie uruchamiał, możesz wyłączyć tę opcję:

    1. W menu Plik wybierz pozycję Preferencje> Ustawienia.

    2. Na karcie Użytkownik wybierz pozycję Rozszerzenia>usługi Azure Logic Apps (Standardowa).

    3. Znajdź ustawienie o nazwie Azure Logic Apps Standard: Auto Start Azurite i wyczyść zaznaczone pole wyboru.
    Zestaw .NET SDK 6.x.x Obejmuje środowisko uruchomieniowe .NET Runtime 6.x.x, które jest wymaganiem wstępnym dla środowiska uruchomieniowego usługi Azure Logic Apps (Standard).
    Azure Functions Core Tools — wersja 4.x Instaluje wersję na podstawie systemu operacyjnego (Windows, macOS lub Linux).

    Te narzędzia obejmują wersję tego samego środowiska uruchomieniowego, która obsługuje środowisko uruchomieniowe usługi Azure Functions, które jest używane przez rozszerzenie usługi Azure Logic Apps (Standard) w programie Visual Studio Code.
    Node.js w wersji 16.x.x, chyba że nowsza wersja jest już zainstalowana Wymagane do włączenia akcji Operacje kodu wbudowanego z uruchomionym językiem JavaScript.

    Instalator nie wykonuje następujących zadań:

    • Sprawdź, czy wymagane zależności już istnieją.
    • Zainstaluj tylko brakujące zależności.
    • Zaktualizuj starsze wersje istniejących zależności.
    1. Pobierz i zainstaluj rozszerzenie usługi Azure Logic Apps (Standard) dla programu Visual Studio Code, począwszy od wersji 2.81.5).

    2. Na pasku Działania w programie Visual Studio Code wybierz pozycję Rozszerzenia. (Klawiatura: naciśnij klawisze Ctrl+Shift+X)

    3. W okienku Rozszerzenia otwórz menu wielokropka (...), a następnie wybierz pozycję Zainstaluj w programie VSIX.

    4. Znajdź i wybierz pobrany plik VSIX.

      Po zakończeniu instalacji rozszerzenie automatycznie aktywuje i uruchamia polecenie Weryfikuj i zainstaluj pliki binarne zależności. Aby wyświetlić dzienniki procesu, otwórz okno Dane wyjściowe .

    5. Po wyświetleniu następującego monitu wybierz pozycję Tak (zalecane), aby potwierdzić, że chcesz automatycznie zainstalować wymagane zależności:

      Zrzut ekranu przedstawia monit o automatyczne zainstalowanie zależności.

    6. W razie potrzeby załaduj ponownie program Visual Studio Code.

    7. Upewnij się, że zależności są poprawnie wyświetlane w następującym folderze:

      C:\Users\<your-user-name>\.azurelogicapps\dependencies\<dependency-name>

    8. Potwierdź następujące ustawienia rozszerzenia w programie Visual Studio Code:

      1. W menu Plik wybierz pozycję Preferencje> Ustawienia.

      2. Na karcie Użytkownik wybierz pozycję Rozszerzenia>usługi Azure Logic Apps (Standardowa).

      3. Przejrzyj następujące ustawienia:

        Ustawienie rozszerzenia Wartość
        Ścieżka zależności C:\Users\<your-user-name>\.azurelogicapps\dependencies
        Limit czasu zależności 60 s
        Ścieżka binarna Dotnet C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK\dotnet.exe
        Ścieżka binarna narzędzi Func Core Tools C:\Users\<your-user-name>\.azurelogicapps\dependencies\FuncCoreTools\func
        Ścieżka binarna js węzła C:\Users\<your-user-name>\.azurelogicapps\dependencies\NodeJs\node
        Automatyczne uruchamianie Azurite Włączona
        Czas projektowania automatycznego uruchamiania Włączona
    9. Jeśli masz istniejący projekt aplikacji logiki z niestandardowymi zadaniami przechowywanymi w pliku .vscode/tasks.json, przed otwarciem projektu upewnij się, że plik tasks.json został zapisany w innym miejscu.

      Po otwarciu projektu zostanie wyświetlony monit o zaktualizowanie pliku tasks.json w celu użycia wymaganych zależności. Jeśli zdecydujesz się kontynuować, rozszerzenie zastępuje plik tasks.json .

    10. Po otwarciu projektu aplikacji logiki są wyświetlane następujące powiadomienia:

      Powiadomienie Akcja
      Czy zawsze uruchamiać proces czasu projektowania w tle podczas uruchamiania? Aby szybciej otworzyć projektanta przepływu pracy, wybierz pozycję Tak (zalecane)..
      Czy skonfigurować usługę Azurite do automatycznego uruchamiania projektu? Aby magazyn Azurite był automatycznie uruchamiany po otwarciu projektu, wybierz pozycję Włącz autouruchomienie. W górnej części programu Visual Studio Code w wyświetlonym oknie polecenia naciśnij klawisz Enter, aby zaakceptować ścieżkę domyślną:

      C\Users\<your-user-name>\.azurelogicapps\.azurite

    Znane problemy z wersją zapoznawcza

    • Jeśli wybrano opcję automatycznego instalowania wszystkich zależności na komputerze, który nie ma żadnej wersji zestawu .NET Core SDK, zostanie wyświetlony następujący komunikat:

      "Nie można znaleźć zestawu .NET Core SDK: Błąd podczas uruchamiania polecenia dotnet - info: Błąd: Polecenie nie powiodło się: dotnet --info 'dotnet nie jest rozpoznawany jako wewnętrzne lub zewnętrzne polecenie, program do obsługi lub plik wsadowy. Polecenie "dotnet" nie jest rozpoznawane jako wewnętrzne lub zewnętrzne polecenie, program operacyjny lub plik wsadowy. . Debugowanie platformy .NET Core nie zostanie włączone. Upewnij się, że zestaw .NET Core SDK jest zainstalowany i znajduje się w ścieżce.

      Ten komunikat jest wyświetlany, ponieważ platforma .NET Core jest nadal instalowana po aktywowaniu rozszerzenia. Możesz bezpiecznie wyłączyć tę wiadomość.

      Jeśli masz problemy z otwarciem istniejącego projektu aplikacji logiki lub uruchomieniem zadania debugowania (tasks.json) na potrzeby uruchamiania hosta func i zostanie wyświetlony ten komunikat, wykonaj następujące kroki, aby rozwiązać problem:

      1. Dodaj ścieżkę binarną dotnet do zmiennej PATH środowiska.

        1. Na pasku zadań systemu Windows w polu wyszukiwania wprowadź zmienne środowiskowe i wybierz pozycję Edytuj zmienne środowiskowe systemu.

        2. W oknie Właściwości systemu na karcie Zaawansowane wybierz pozycję Zmienne środowiskowe.

        3. W polu Zmienne środowiskowe z listy Zmienne użytkownika wybierz <>pozycję ŚCIEŻKA, a następnie wybierz pozycję Edytuj.

        4. Jeśli na liście nie ma następującej wartości, wybierz pozycję Nowy , aby dodać następującą wartość:

          C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK

        5. Po zakończeniu wybierz OK.

      2. Zamknij wszystkie okna programu Visual Studio Code i otwórz ponownie projekt.

    • Jeśli masz problemy z instalowaniem i weryfikowaniem zależności binarnych, na przykład:

      • Problemy z uprawnieniami systemu Linux
      • Zostanie wyświetlony następujący błąd: <Plik lub ścieżka> nie istnieje
      • Walidacja zostaje zablokowana na <podstawie nazwy> zależności.

      Wykonaj następujące kroki, aby ponownie uruchomić polecenie Weryfikuj i zainstaluj zależności binarne:

      1. Z menu Widok wybierz pozycję Paleta poleceń.

      2. Po wyświetleniu okna polecenia wprowadź i uruchom polecenie Weryfikuj i zainstaluj zależności binarne.

    • Jeśli nie masz zainstalowanej platformy .NET Core 7 lub nowszej wersji i otworzysz obszar roboczy usługi Azure Logic Apps zawierający projekt usługi Azure Functions, zostanie wyświetlony następujący komunikat:

      Wystąpiły problemy z ładowaniem projektu [function-name].csproj. Aby uzyskać szczegółowe informacje, zobacz dziennik.

      Ten brakujący składnik nie ma wpływu na projekt usługi Azure Functions, więc można bezpiecznie zignorować ten komunikat.

    Zainstaluj każdą zależność oddzielnie

    Dependency opis
    Zestaw .NET SDK 6.x.x Obejmuje środowisko uruchomieniowe .NET Runtime 6.x.x, które jest wymaganiem wstępnym dla środowiska uruchomieniowego usługi Azure Logic Apps (Standard).
    Azure Functions Core Tools — wersja 4.x - Windows: użyj wersji Instalatora Microsoft (MSI), czyli func-cli-X.X.XXXX-x*.msi.
    - macOS
    - Linux

    Te narzędzia obejmują wersję tego samego środowiska uruchomieniowego, która obsługuje środowisko uruchomieniowe usługi Azure Functions, które jest używane przez rozszerzenie usługi Azure Logic Apps (Standard) w programie Visual Studio Code.

    Jeśli masz instalację starszą niż te wersje, odinstaluj ją najpierw lub upewnij się, że zmienna środowiskowa PATH wskazuje wersję pobraną i zainstalowaną.
    Node.js w wersji 16.x.x, chyba że nowsza wersja jest już zainstalowana Wymagane do włączenia akcji Operacje kodu wbudowanego z uruchomionym językiem JavaScript.

    Uwaga: w przypadku systemu Windows pobierz wersję MSI. Jeśli zamiast tego używasz wersji ZIP, musisz ręcznie udostępnić Node.js przy użyciu zmiennej środowiskowej PATH dla systemu operacyjnego.
  4. Jeśli zainstalowano już wersję rozszerzenia usługi Azure Logic Apps (Standard), która automatycznie instaluje wszystkie zależności (wersja zapoznawcza), pomiń ten krok. W przeciwnym razie pobierz i zainstaluj rozszerzenie usługi Azure Logic Apps (Standard) dla programu Visual Studio Code.

    1. W programie Visual Studio Code na lewym pasku narzędzi wybierz pozycję Rozszerzenia.

    2. W polu wyszukiwania rozszerzeń wprowadź wartość Azure Logic Apps Standard. Z listy wyników wybierz pozycję Azure Logic Apps (Standardowa)>Zainstaluj.

      Po zakończeniu instalacji rozszerzenie zostanie wyświetlone na liście Rozszerzenia: Zainstalowane .

      Zrzut ekranu przedstawiający program Visual Studio Code z zainstalowanym rozszerzeniem usługi Azure Logic Apps (Standard).

      Napiwek

      Jeśli rozszerzenie nie jest wyświetlane na zainstalowanej liście, spróbuj ponownie uruchomić program Visual Studio Code.

    Obecnie można mieć zainstalowane jednocześnie rozszerzenia Zużycie (wielodostępne) i Standardowe (jednodostępne). Środowiska programistyczne różnią się od siebie na kilka sposobów, ale subskrypcja platformy Azure może obejmować zarówno typy aplikacji logiki w warstwie Standardowa, jak i Zużycie. W programie Visual Studio Code okno platformy Azure zawiera wszystkie aplikacje logiki wdrożone i hostowane na platformie Azure w ramach subskrypcji platformy Azure, ale organizuje aplikacje w następujący sposób:

    • Sekcja Usługi Logic Apps (Zużycie): wszystkie aplikacje logiki Zużycie w ramach subskrypcji.

    • Sekcja Zasoby : wszystkie standardowe aplikacje logiki w ramach subskrypcji. Wcześniej te aplikacje logiki pojawiły się w sekcji Logic Apps (Standardowa), która została przeniesiona do sekcji Zasoby .

  5. Aby lokalnie uruchamiać wyzwalacze i akcje oparte na elementach webhook, takie jak wbudowany wyzwalacz elementu webhook HTTP, w programie Visual Studio Code należy skonfigurować przekazywanie dla adresu URL wywołania zwrotnego.

  6. Aby przetestować przykładowy przepływ pracy w tym artykule, potrzebujesz narzędzia, które może wysyłać wywołania do punktu końcowego utworzonego przez wyzwalacz Żądania. Jeśli nie masz takiego narzędzia, możesz pobrać, zainstalować i użyć aplikacji Postman .

  7. Jeśli tworzysz zasoby aplikacji logiki z ustawieniami obsługującymi korzystanie z usługi Application Szczegółowe informacje, opcjonalnie możesz włączyć rejestrowanie diagnostyczne i śledzenie zasobu aplikacji logiki. Można to zrobić podczas tworzenia aplikacji logiki lub po wdrożeniu. Musisz mieć wystąpienie usługi Application Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem, podczas tworzenia aplikacji logiki lub po wdrożeniu.

Konfigurowanie programu Visual Studio Code

  1. Aby upewnić się, że wszystkie rozszerzenia są poprawnie zainstalowane, załaduj ponownie lub uruchom ponownie program Visual Studio Code.

  2. Upewnij się, że program Visual Studio Code automatycznie wyszukuje i instaluje aktualizacje rozszerzeń, aby wszystkie rozszerzenia pobierały najnowsze aktualizacje. W przeciwnym razie należy ręcznie odinstalować nieaktualną wersję i zainstalować najnowszą wersję.

    1. W menu Plik przejdź do pozycji Preferencje> Ustawienia.

    2. Na karcie Użytkownik przejdź do pozycji Rozszerzenia funkcji>.

    3. Upewnij się, że wybrano opcję Auto check Aktualizacje i że opcja Automatyczna aktualizacja jest ustawiona na Wszystkie rozszerzenia.

  3. Upewnij się, że ustawienie Usługi Azure Logic Apps w warstwie Standardowa: środowisko uruchomieniowe projektu dla rozszerzenia azure Logic Apps (Standardowa) jest ustawione na wersję ~4:

    Uwaga

    Ta wersja jest wymagana do korzystania z akcji Operacje wbudowanego kodu.

    1. W menu Plik przejdź do pozycji Preferencje> Ustawienia.

    2. Na karcie Użytkownik przejdź do pozycji >Rozszerzenia>usługi Azure Logic Apps (Standardowa).

      Na przykład możesz znaleźć ustawienie Azure Logic Apps Standard: Project Runtime tutaj lub użyć pola wyszukiwania, aby znaleźć inne ustawienia:

      Zrzut ekranu przedstawiający ustawienia programu Visual Studio Code dla rozszerzenia usługi Azure Logic Apps (Standard).

Nawiąż połączenie z kontem platformy Azure

  1. Na pasku działań programu Visual Studio Code wybierz ikonę platformy Azure.

    Zrzut ekranu przedstawiający pasek działań programu Visual Studio Code i wybraną ikonę platformy Azure.

  2. W oknie Platformy Azure w obszarze Zasoby wybierz pozycję Zaloguj się do platformy Azure. Po wyświetleniu strony uwierzytelniania programu Visual Studio Code zaloguj się przy użyciu konta platformy Azure.

    Zrzut ekranu przedstawiający okno platformy Azure i wybrany link do logowania na platformie Azure.

    Po zalogowaniu się w oknie platformy Azure są wyświetlane subskrypcje platformy Azure skojarzone z kontem platformy Azure. Jeśli oczekiwane subskrypcje nie są wyświetlane lub chcesz, aby okienko wyświetlało tylko określone subskrypcje, wykonaj następujące kroki:

    1. Na liście subskrypcji przenieś wskaźnik obok pierwszej subskrypcji do momentu wyświetlenia przycisku Wybierz subskrypcje (ikona filtru). Wybierz ikonę filtru.

      Zrzut ekranu przedstawiający okno platformy Azure z subskrypcjami i wybraną ikoną filtru.

      Możesz też wybrać konto platformy Azure na pasku stanu programu Visual Studio Code.

    2. Gdy zostanie wyświetlona inna lista subskrypcji, wybierz żądane subskrypcje, a następnie upewnij się, że wybierzesz przycisk OK.

Tworzenie projektu lokalnego

Przed utworzeniem aplikacji logiki utwórz projekt lokalny, aby można było zarządzać, uruchamiać i wdrażać aplikację logiki z poziomu programu Visual Studio Code. Projekt bazowy jest podobny do projektu usługi Azure Functions, znanego również jako projekt aplikacji funkcji. Jednak te typy projektów są oddzielone od siebie, więc aplikacje logiki i aplikacje funkcji nie mogą istnieć w tym samym projekcie.

  1. Na komputerze utwórz pusty folder lokalny do użycia dla projektu, który zostanie później utworzony w programie Visual Studio Code.

  2. W programie Visual Studio Code zamknij wszystkie otwarte foldery.

  3. W oknie Platformy Azure na pasku narzędzi sekcji Obszar roboczy z menu Azure Logic Apps wybierz pozycję Utwórz nowy projekt.

    Zrzut ekranu przedstawiający okno platformy Azure, pasek narzędzi obszaru roboczego i menu usługi Azure Logic Apps z wybraną pozycją Utwórz nowy projekt.

  4. Jeśli zapora Windows Defender wyświetli monit o udzielenie dostępu do sieci dla Code.exeprogramu , czyli programu Visual Studio Code i func.exedla programu , czyli narzędzi Azure Functions Core Tools, wybierz pozycję Sieci prywatne, takie jak moja sieć domowa lub służbowa>Zezwalaj na dostęp.

  5. Przejdź do lokalizacji, w której utworzono folder projektu, wybierz ten folder i kontynuuj.

    Zrzut ekranu przedstawiający pole Wybierz folder i nowy folder projektu z wybranym przyciskiem Wybierz.

  6. Z wyświetlonej listy szablonów wybierz pozycję Stanowy przepływ pracy lub Przepływ pracy bezstanowy. W tym przykładzie wybrano stanowy przepływ pracy.

    Zrzut ekranu przedstawiający listę szablonów przepływów pracy z wybranym przepływem pracy stanowym.

  7. Podaj nazwę przepływu pracy i naciśnij klawisz Enter. W tym przykładzie użyto nazwy Stateful-Workflow .

    Zrzut ekranu przedstawiający pole Utwórz nowy stanowy przepływ pracy (3/4) i nazwę przepływu pracy, Stanowy przepływ pracy.

    Uwaga

    Może wystąpić błąd o nazwie azureLogicAppsStandard.createNewProject z komunikatem o błędzie Nie można zapisać w obszarze roboczym Ustawienia, ponieważ azureFunctions.suppressProject nie jest zarejestrowaną konfiguracją. Jeśli to zrobisz, spróbuj zainstalować rozszerzenie usługi Azure Functions dla programu Visual Studio Code bezpośrednio z witryny Visual Studio Marketplace lub z poziomu programu Visual Studio Code.

  8. Jeśli program Visual Studio Code wyświetli monit o otwarcie projektu w bieżącym programie Visual Studio Code lub w nowym oknie programu Visual Studio Code, wybierz pozycję Otwórz w bieżącym oknie. W przeciwnym razie wybierz pozycję Otwórz w nowym oknie.

    Program Visual Studio Code kończy tworzenie projektu.

  9. Na pasku działań programu Visual Studio otwórz okienko Eksplorator, jeśli jeszcze nie jest otwarte.

    W okienku Eksplorator zostanie wyświetlony projekt, który zawiera teraz automatycznie wygenerowane pliki projektu. Na przykład projekt ma folder, który pokazuje nazwę przepływu pracy. W tym folderze plik workflow.json zawiera podstawową definicję JSON przepływu pracy.

    Zrzut ekranu przedstawia okienko Eksploratora z folderem projektu, folderem przepływu pracy i plikiem workflow.json.

    W programie Visual Studio Code projekt aplikacji logiki ma jeden z następujących typów:

    • Oparty na pakiecie rozszerzenia (Node.js), który jest typem domyślnym
    • Pakiet NuGet (.NET), który można przekonwertować na podstawie typu domyślnego

    Na podstawie tych typów projekt zawiera nieco różne foldery i pliki. Projekt oparty na nuGet zawiera folder .bin zawierający pakiety i inne pliki biblioteki. Projekt oparty na pakiecie nie zawiera folderu .bin i innych plików. Niektóre scenariusze wymagają uruchomienia projektu opartego na oprogramowaniu NuGet, na przykład w przypadku tworzenia i uruchamiania niestandardowych operacji wbudowanych. Aby uzyskać więcej informacji na temat konwertowania projektu na używanie narzędzia NuGet, zobacz Włączanie tworzenia wbudowanego łącznika.

    W przypadku domyślnego projektu opartego na pakiecie projekt ma strukturę folderów i plików podobną do poniższego przykładu:

    MyBundleBasedLogicAppProjectName
    | .vscode
    | Artifacts
      || Maps 
         ||| MapName1
         ||| ...
      || Schemas
         ||| SchemaName1
         ||| ...
    | WorkflowName1
      || workflow.json
      || ...
    | WorkflowName2
      || workflow.json
      || ...
    | workflow-designtime
    | .funcignore
    | connections.json
    | host.json
    | local.settings.json
    

    Na poziomie głównym projektu można znaleźć następujące pliki i foldery z innymi elementami:

    Nazwisko Folder lub plik opis
    .vscode Folder Zawiera pliki ustawień związanych z programem Visual Studio Code, takie jak pliki extensions.json, launch.json, settings.json i tasks.json.
    Artefakty Folder Zawiera artefakty konta integracji zdefiniowane i używane w przepływach pracy, które obsługują scenariusze biznesowe (B2B). Na przykład przykładowa struktura zawiera mapy i schematy dla operacji przekształcania i walidacji XML.
    <Nazwa przepływu pracy> Folder Dla każdego przepływu pracy <folder WorkflowName> zawiera plik workflow.json zawierający podstawową definicję JSON tego przepływu pracy.
    czas projektowania przepływu pracy Folder Zawiera pliki ustawień środowiska deweloperskiego.
    .funcignore Plik Zawiera informacje związane z zainstalowanymi narzędziami Azure Functions Core Tools.
    connections.json Plik Zawiera metadane, punkty końcowe i klucze dla wszystkich zarządzanych połączeń i funkcji platformy Azure używanych przez przepływy pracy.

    Ważne: Aby używać różnych połączeń i funkcji dla każdego środowiska, upewnij się, że sparametryzujesz ten plik connections.json i zaktualizuj punkty końcowe.
    host.json Plik Zawiera ustawienia i wartości konfiguracji specyficzne dla środowiska uruchomieniowego, na przykład domyślne limity dla pojedynczej dzierżawy platformy Azure Logic Apps, aplikacji logiki, przepływów pracy, wyzwalaczy i akcji. Na poziomie głównym projektu aplikacji logiki plik metadanych host.json zawiera ustawienia konfiguracji i wartości domyślne używane przez wszystkie przepływy pracy w tej samej aplikacji logiki podczas uruchamiania, zarówno lokalnie, jak i na platformie Azure.

    Uwaga: podczas tworzenia aplikacji logiki program Visual Studio Code tworzy plik host.snapshot.*.json w kontenerze magazynu. Jeśli usuniesz aplikację logiki, ten plik kopii zapasowej nie zostanie usunięty. Jeśli tworzysz inną aplikację logiki o tej samej nazwie, zostanie utworzony inny plik migawki. Dla tej samej aplikacji logiki można mieć maksymalnie 10 migawek. Jeśli przekroczysz ten limit, wystąpi następujący błąd:

    Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))

    Aby rozwiązać ten błąd, usuń dodatkowe pliki migawek z kontenera magazynu.
    local.settings.json Plik Zawiera ustawienia aplikacji, parametry połączenia i inne ustawienia używane przez przepływy pracy podczas uruchamiania lokalnego. Innymi słowy, te ustawienia i wartości mają zastosowanie tylko w przypadku uruchamiania projektów w lokalnym środowisku projektowym. Podczas wdrażania na platformie Azure plik i ustawienia są ignorowane i nie są uwzględniane we wdrożeniu.

    Ten plik przechowuje ustawienia i wartości jako lokalne zmienne środowiskowe, które są używane przez lokalne narzędzia programistyczne jako appSettings wartości. Te zmienne środowiskowe można wywoływać i odwoływać się do nich zarówno w czasie wykonywania, jak i w czasie wdrażania przy użyciu ustawień aplikacji i parametrów.

    Ważne: plik local.settings.json może zawierać wpisy tajne, dlatego upewnij się, że ten plik został również wyklucz z kontroli źródła projektu.

Konwertowanie projektu na pakiet NuGet (.NET)

Domyślnie program Visual Studio Code tworzy projekt aplikacji logiki oparty na pakiecie (Node.js), a nie oparty na pakietach NuGet (.NET). Jeśli potrzebujesz projektu aplikacji logiki opartego na pakiecie NuGet (.NET), na przykład w celu włączenia tworzenia wbudowanych łączników, musisz przekonwertować projekt z opartego na pakiecie rozszerzeń (Node.js) na pakiet NuGet (.NET).

Ważne

Ta akcja jest jednokierunkową operacją, której nie można cofnąć.

  1. W okienku Eksplorator w katalogu głównym projektu przenieś wskaźnik myszy na dowolny pusty obszar poniżej wszystkich innych plików i folderów, otwórz menu skrótów i wybierz pozycję Konwertuj na projekt aplikacji logiki opartej na nuGet.

    Zrzut ekranu przedstawiający okienko Eksplorator z menu skrótów projektu otwartym z pustego obszaru w oknie projektu.

  2. Po wyświetleniu monitu potwierdź konwersję projektu.

Włączanie tworzenia wbudowanych łączników

Możesz utworzyć własne wbudowane łączniki dla dowolnej potrzebnej usługi przy użyciu platformy rozszerzalności usługi Azure Logic Apps z jedną dzierżawą. Podobnie jak w przypadku wbudowanych łączników, takich jak Azure Service Bus i SQL Server, te łączniki zapewniają większą przepływność, małe opóźnienia, łączność lokalną i działają natywnie w tym samym procesie co środowisko uruchomieniowe usługi Azure Logic Apps z jedną dzierżawą.

Funkcja tworzenia jest obecnie dostępna tylko w programie Visual Studio Code, ale nie jest domyślnie włączona. Aby utworzyć te łączniki, wykonaj następujące kroki:

  1. Jeśli jeszcze tego nie zrobiono, przekonwertuj projekt z rozszerzenia opartego na pakiecie (Node.js) na oparty na pakietach NuGet (.NET).

  2. Przejrzyj i wykonaj kroki opisane w artykule Azure Logic Apps Running Anywhere — rozszerzenie wbudowanego łącznika.

Dodawanie artefaktów niestandardowych do projektu

W przepływie pracy aplikacji logiki niektóre łączniki mają zależności od artefaktów, takich jak mapy, schematy lub zestawy. W programie Visual Studio Code możesz przekazać te artefakty do projektu aplikacji logiki, podobnie jak w przypadku przekazywania tych artefaktów w witrynie Azure Portal za pomocą menu zasobów aplikacji logiki w obszarze Artefakty, na przykład:

Zrzut ekranu przedstawiający menu zasobów aplikacji logiki w witrynie Azure Portal i standardowej aplikacji z wyróżnioną sekcją Artifacts (Artefakty).

Dodawanie map do projektu

Aby dodać mapy do projektu, w hierarchii projektu rozwiń węzeł Artifacts> Mapy czyli folder, w którym można umieścić mapy.

Zrzut ekranu przedstawiający hierarchię projektu programu Visual Studio Code z rozwiniętymi folderami Artifacts i Mapy.

Dodawanie schematów do projektu

Aby dodać schematy do projektu, w hierarchii projektu rozwiń węzeł Artifacts Schemas (Schematy>artefaktów), czyli folder, w którym można umieścić schematy.

Zrzut ekranu przedstawiający hierarchię projektu programu Visual Studio Code z rozwiniętymi folderami Artifacts and Schemas (Artefakty i schematy).

Dodawanie zestawów do projektu

Aplikacja logiki w warstwie Standardowa może używać lub odwoływać się do określonych rodzajów zestawów, które można przekazać do projektu w programie Visual Studio Code. Należy jednak dodać je do określonych folderów w projekcie. Poniższa tabela zawiera więcej informacji o poszczególnych typach zestawów i o tym, gdzie dokładnie umieścić je w projekcie.

Typ zestawu opis
Zestaw klienta/zestawu SDK (.NET Framework) Ten typ zestawu zapewnia magazyn i wdrażanie klienta i niestandardowego zestawu SDK dla programu .NET Framework. Na przykład wbudowany łącznik SAP używa tych zestawów do ładowania plików DLL innych niż redystrybucyjne sap NCo.

Upewnij się, że te zestawy zostały dodane do następującego folderu: \lib\builtinOperationSdks\net472
Zestaw klienta/zestawu SDK (Java) Ten typ zestawu zapewnia magazyn i wdrażanie niestandardowego zestawu SDK dla języka Java. Na przykład wbudowany łącznik JDBC używa tych plików JAR do znajdowania sterowników JDBC dla niestandardowych relacyjnych baz danych (RDB).

Pamiętaj, aby dodać te zestawy do następującego folderu: \lib\builtinOperationSdks\JAR
Zestaw niestandardowy (.NET Framework) Ten typ zestawu zapewnia magazyn i wdrażanie niestandardowych bibliotek DLL. Na przykład operacja Przekształć xml używa tych zestawów dla niestandardowych funkcji przekształcania, które są wymagane podczas przekształcania XML.

Pamiętaj, aby dodać te zestawy do następującego folderu: \lib\custom\net472

Na poniższej ilustracji pokazano, gdzie umieścić każdy typ zestawu w projekcie:

Zrzut ekranu przedstawia program Visual Studio Code, projekt aplikacji logiki oraz miejsce przekazywania zestawów.

Aby uzyskać więcej informacji na temat przekazywania zestawów do zasobu aplikacji logiki w witrynie Azure Portal, zobacz Dodawanie zestawów, do których odwołuje się odwołanie.

Migrowanie projektów opartych na oprogramowaniu NuGet do używania zestawów "lib\*"

Ważne

To zadanie jest wymagane tylko dla projektów aplikacji logiki opartych na nuGet.

Jeśli projekt aplikacji logiki został utworzony, gdy obsługa zestawów nie była dostępna dla przepływów pracy aplikacji logiki w warstwie Standardowa, możesz dodać następujące wiersze do <pliku project-name.csproj>, aby pracować z projektami korzystającymi z zestawów:

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Ważne

W przypadku projektu działającego w systemie Linux lub MacOS pamiętaj o zaktualizowaniu separatora katalogu. Przejrzyj na przykład poniższy obraz przedstawiający poprzedni kod dodany do <pliku project-name.csproj>.

Zrzut ekranu przedstawia zmigrowane zestawy i dodany kod w pliku CSPROJ.

Otwórz plik definicji przepływu pracy w projektancie

  1. Rozwiń folder projektu przepływu pracy o nazwie Stateful-Workflow w tym przykładzie i otwórz plik workflow.json .

  2. Otwórz menu skrótów pliku workflow.json i wybierz pozycję Otwórz Projektant.

    Zrzut ekranu przedstawiający okienko Eksploratora, workflow.json menu skrótów do pliku i wybraną pozycję Otwórz Projektant.

  3. Po otworze listy Włącz łączniki na platformie Azure wybierz pozycję Użyj łączników z platformy Azure, która ma zastosowanie do wszystkich łączników zarządzanych lub "udostępnionych", które są hostowane i uruchamiane na platformie Azure, a nie wbudowane, natywne lub "w aplikacji", które są uruchamiane bezpośrednio ze środowiskiem uruchomieniowym usługi Azure Logic Apps.

    Zrzut ekranu przedstawiający okienko Eksploratora, otwartą listę o nazwie Włącz łączniki na platformie Azure i wybraną opcję Użyj łączników z platformy Azure.

    Uwaga

    Przepływy pracy bezstanowe obsługują obecnie tylko akcje z łączników zarządzanych, a nie wyzwalaczy. Mimo że masz możliwość włączenia łączników na platformie Azure dla bezstanowego przepływu pracy, projektant nie wyświetla żadnych wyzwalaczy łącznika zarządzanego do wybrania.

  4. Po otworze listy Wybierz subskrypcję platformy Azure do użycia dla projektu aplikacji logiki.

    Zrzut ekranu przedstawiający okienko Eksploratora z listą o nazwie Wybierz subskrypcję i wybraną subskrypcję.

  5. Po otworze listy grup zasobów wybierz pozycję Utwórz nową grupę zasobów.

    Zrzut ekranu przedstawiający okienko Eksplorator z listą grup zasobów i wybraną opcją utworzenia nowej grupy zasobów.

  6. Podaj nazwę grupy zasobów i naciśnij klawisz Enter. W tym przykładzie użyto Fabrikam-Workflows-RG.

    Zrzut ekranu przedstawia okienko Eksploratora i pole nazwy grupy zasobów.

  7. Z listy lokalizacji wybierz region świadczenia usługi Azure, który ma być używany podczas tworzenia grupy zasobów i zasobów. W tym przykładzie użyto zachodnio-środkowych stanów USA.

    Zrzut ekranu przedstawiający okienko Eksplorator z wybraną listą lokalizacji i wybranymi opcjami

    Po wykonaniu tego kroku program Visual Studio Code otworzy projektanta przepływu pracy.

    Uwaga

    Gdy program Visual Studio Code uruchamia interfejs API czasu projektowania przepływu pracy, może zostać wyświetlony komunikat, że uruchomienie może potrwać kilka sekund. Możesz zignorować ten komunikat lub wybrać przycisk OK.

    Jeśli projektant nie zostanie otwarty, zapoznaj się z sekcją rozwiązywania problemów, Projektant nie można otworzyć.

    Po wyświetleniu projektanta zostanie wyświetlony monit Dodawanie wyzwalacza w projektancie.

  8. W projektancie wybierz pozycję Dodaj wyzwalacz, który otwiera okienko Dodawanie wyzwalacza i galerię zawierającą wszystkie łączniki, które mają wyzwalacze do wybrania.

    Zrzut ekranu przedstawia projektanta przepływu pracy, wybrany monit o nazwie Dodaj wyzwalacz oraz galerię łączników z wyzwalaczami.

  9. Następnie dodaj wyzwalacz i akcje do przepływu pracy.

Dodawanie wyzwalacza i akcji

Po otwarciu pustego przepływu pracy w projektancie zostanie wyświetlony monit Dodawanie wyzwalacza w projektancie. Teraz możesz rozpocząć tworzenie przepływu pracy, dodając wyzwalacz i akcje.

Ważne

Aby lokalnie uruchomić przepływ pracy, który korzysta z wyzwalacza lub akcji opartego na elementach webhook, takich jak wbudowany wyzwalacz lub akcja elementu webhook HTTP, należy włączyć tę funkcję, konfigurując przekazywanie dla adresu URL wywołania zwrotnego elementu webhook.

Przepływ pracy w tym przykładzie używa następującego wyzwalacza i akcji:

Dodawanie wyzwalacza żądania

  1. W projektancie przepływu pracy w okienku Dodawanie wyzwalacza otwórz listę Środowisko uruchomieniowe i wybierz pozycję W aplikacji , aby wyświetlić tylko dostępne wbudowane wyzwalacze łącznika.

  2. Znajdź wyzwalacz żądania o nazwie Po odebraniu żądania HTTP przy użyciu pola wyszukiwania i dodaj ten wyzwalacz do przepływu pracy. Aby uzyskać więcej informacji, zobacz Tworzenie przepływu pracy za pomocą wyzwalacza i akcji.

    Zrzut ekranu przedstawiający projektanta przepływu pracy, okienko Dodaj wyzwalacz i wybrany wyzwalacz o nazwie Po odebraniu żądania HTTP.

    Po wyświetleniu wyzwalacza w projektancie zostanie otwarte okienko informacji wyzwalacza i zostanie wyświetlone parametry, ustawienia i inne powiązane zadania wyzwalacza.

    Zrzut ekranu przedstawiający okienko informacji dla wyzwalacza o nazwie Po odebraniu żądania HTTP.

    Napiwek

    Jeśli okienko informacji nie zostanie wyświetlone, upewnij się, że wyzwalacz został wybrany w projektancie.

  3. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Jeśli musisz usunąć element z projektanta, wykonaj następujące kroki, aby usunąć elementy z projektanta.

Dodawanie akcji office 365 Outlook

  1. W projektancie w obszarze Wyzwalacz żądania wybierz znak plus (+) >Dodaj akcję.

  2. W otwartym okienku Dodaj akcję z listy Środowisko uruchomieniowe wybierz pozycję Udostępnione , aby wyświetlić tylko dostępne akcje łącznika zarządzanego.

  3. Znajdź akcję łącznika zarządzanego usługi Office 365 Outlook o nazwie Wyślij wiadomość e-mail (wersja 2) przy użyciu pola wyszukiwania i dodaj akcję do przepływu pracy. Aby uzyskać więcej informacji, zobacz Tworzenie przepływu pracy za pomocą wyzwalacza i akcji.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i okienko akcji Dodaj z wybraną akcją usługi Office 365 Outlook o nazwie Wyślij wiadomość e-mail.

  4. Po otwarciu okienka uwierzytelniania akcji wybierz pozycję Zaloguj, aby utworzyć połączenie z kontem e-mail.

    Zrzut ekranu przedstawia akcję o nazwie Wyślij wiadomość e-mail (wersja 2) z wybranym przyciskiem logowania.

  5. Postępuj zgodnie z kolejnymi monitami, aby wybrać konto, zezwolić na dostęp i zezwolić na powrót do programu Visual Studio Code.

    Uwaga

    Jeśli przed ukończeniem monitów upływa zbyt dużo czasu, proces uwierzytelniania przekracza limit czasu i kończy się niepowodzeniem. W takim przypadku wróć do projektanta i spróbuj ponownie zalogować się, aby utworzyć połączenie.

    1. Po wyświetleniu monitu firmy Microsoft wybierz konto użytkownika dla usługi Office 365 Outlook, a następnie wybierz pozycję Zezwalaj na dostęp.

    2. Gdy usługa Azure Logic Apps wyświetli monit o otwarcie linku programu Visual Studio Code, wybierz pozycję Otwórz.

      Zrzut ekranu przedstawia monit o otwarcie linku dla programu Visual Studio Code.

    3. Gdy program Visual Studio Code wyświetli monit o otwarcie narzędzi platformy Microsoft Azure, wybierz pozycję Otwórz.

      Zrzut ekranu przedstawia monit o otwarcie narzędzi platformy Microsoft Azure.

    Napiwek

    Aby pominąć takie monity w przyszłości, wybierz następujące opcje po wyświetleniu skojarzonych monitów:

    • Uprawnienie do otwierania linku dla programu Visual Studio Code: wybierz pozycję Zawsze zezwalaj logic-apis-westcentralus.consent.azure-apim.net na otwieranie linków tego typu w skojarzonej aplikacji. Ta domena zmienia się w zależności od regionu świadczenia usługi Azure wybranego dla zasobu aplikacji logiki.

    • Uprawnienie do otwierania narzędzi platformy Microsoft Azure: wybierz pozycję Nie pytaj ponownie o to rozszerzenie.

    Po utworzeniu połączenia przez program Visual Studio Code niektóre łączniki pokazują komunikat, że połączenie będzie prawidłowe tylko przez {n} dni. Ten limit czasu dotyczy tylko czasu trwania podczas tworzenia przepływu pracy aplikacji logiki w programie Visual Studio Code. Po wdrożeniu ten limit nie ma już zastosowania, ponieważ przepływ pracy może uwierzytelniać się w czasie wykonywania przy użyciu automatycznie włączonej tożsamości zarządzanej przypisanej przez system. Ta tożsamość zarządzana różni się od poświadczeń uwierzytelniania lub parametry połączenia używanych podczas tworzenia połączenia. Jeśli wyłączysz tę tożsamość zarządzaną przypisaną przez system, połączenia nie będą działać w czasie wykonywania.

  6. Jeśli w projektancie nie zostanie wybrana akcja Wyślij wiadomość e-mail , wybierz tę akcję.

  7. W okienku informacji o akcji na karcie Parametry podaj wymagane informacje dotyczące akcji, na przykład:

    Zrzut ekranu przedstawia informacje dotyczące akcji usługi Office 365 Outlook o nazwie Wyślij wiadomość e-mail.

    Właściwości Wymagania Wartość Opis
    Do Tak <your-email-address> Adresat wiadomości e-mail, który może być twoim adresem e-mail do celów testowych. W tym przykładzie użyto fikcyjnej wiadomości e-mail: sophia.owen@fabrikam.com.
    Temat Tak Wiadomość e-mail z przykładowego przepływu pracy Temat wiadomości e-mail
    Treść Tak Witaj z przykładowego przepływu pracy! Zawartość treści wiadomości e-mail

    Uwaga

    Jeśli wprowadzisz jakiekolwiek zmiany na karcie Testowanie , upewnij się, że wybierzesz pozycję Zapisz , aby zatwierdzić te zmiany przed przełączeniem kart lub zmianą fokusu na projektancie. W przeciwnym razie program Visual Studio Code nie zachowa zmian.

  8. Zapisz przepływ pracy. W projektancie wybierz pozycję Zapisz.

Włączanie lokalnie uruchomionych elementów webhook

Jeśli używasz wyzwalacza lub akcji opartej na elemecie webhook opartym na elementach webhook protokołu HTTP z przepływem pracy aplikacji logiki uruchomionym na platformie Azure, środowisko uruchomieniowe usługi Azure Logic Apps subskrybuje punkt końcowy usługi, generując i rejestrując adres URL wywołania zwrotnego za pomocą tego punktu końcowego. Wyzwalacz lub akcja czeka na wywołanie adresu URL przez punkt końcowy usługi. Jednak podczas pracy w programie Visual Studio Code wygenerowany adres URL wywołania zwrotnego rozpoczyna się od http://localhost:7071/.... Ten adres URL jest przeznaczony dla serwera localhost, który jest prywatny, więc punkt końcowy usługi nie może wywołać tego adresu URL.

Aby lokalnie uruchamiać wyzwalacze i akcje oparte na elementach webhook w programie Visual Studio Code, należy skonfigurować publiczny adres URL, który uwidacznia serwer localhost i bezpiecznie przekazuje wywołania z punktu końcowego usługi do adresu URL wywołania zwrotnego elementu webhook. Możesz użyć usługi przekazywania i narzędzia, takiego jak ngrok, który otwiera tunel HTTP na porcie localhost lub możesz użyć własnego narzędzia równoważnego.

Konfigurowanie przekazywania połączeń przy użyciu narzędzia ngrok

  1. Przejdź do witryny internetowej ngrok. Utwórz nowe konto lub zaloguj się do swojego konta, jeśli masz je już.

  2. Uzyskaj osobisty token uwierzytelniania, który klient ngrok musi nawiązać połączenie i uwierzytelnić dostęp do konta.

    1. Aby znaleźć stronę tokenu uwierzytelniania, w menu pulpitu nawigacyjnego konta rozwiń węzeł Uwierzytelnianie i wybierz pozycję Twój token uwierzytelniania.

    2. W polu Your Authtoken (Twój token Authtoken) skopiuj token do bezpiecznej lokalizacji.

  3. Na stronie pobierania ngrok lub na pulpicie nawigacyjnym konta pobierz odpowiednią wersję narzędzia ngrok i wyodrębnij plik .zip. Aby uzyskać więcej informacji, zobacz Krok 1: Rozpakuj, aby zainstalować.

  4. Na komputerze otwórz narzędzie wiersza polecenia. Przejdź do lokalizacji, w której znajduje się plik ngrok.exe .

  5. Połączenie klienta ngrok do konta ngrok, uruchamiając następujące polecenie. Aby uzyskać więcej informacji, zobacz Krok 2: Połączenie twoje konto.

    ngrok authtoken <your_auth_token>

  6. Otwórz tunel HTTP na porcie localhost 7071, uruchamiając następujące polecenie. Aby uzyskać więcej informacji, zobacz Krok 3. Wyzwol go.

    ngrok http 7071

  7. Z danych wyjściowych znajdź następujący wiersz:

    http://<domain>.ngrok.io -> http://localhost:7071

  8. Skopiuj i zapisz adres URL, który ma następujący format: http://<domain>.ngrok.io

Konfigurowanie adresu URL przekazywania w ustawieniach aplikacji

  1. W programie Visual Studio Code w projektancie dodaj wyzwalacz oparty na elemecie webhook lub akcję, której chcesz użyć.

    W tym przykładzie jest kontynuowany wyzwalacz HTTP + element webhook .

  2. Po wyświetleniu monitu dla lokalizacji punktu końcowego hosta wprowadź wcześniej utworzony adres URL przekazywania (przekierowania).

    Uwaga

    Ignorowanie monitu powoduje wyświetlenie ostrzeżenia, że musisz podać adres URL przekazywania, więc wybierz pozycję Konfiguruj i wprowadź adres URL. Po zakończeniu tego kroku monit nie będzie wyświetlany dla kolejnych wyzwalaczy ani akcji elementu webhook, które można dodać.

    Aby wyświetlić monit, na poziomie głównym projektu otwórz menu skrótów pliku local.settings.json i wybierz pozycję Konfiguruj punkt końcowy przekierowania elementu webhook. Zostanie wyświetlony monit, aby podać adres URL przekazywania.

    Program Visual Studio Code dodaje adres URL przekazywania do pliku local.settings.json w folderze głównym projektu. Values W obiekcie jest wyświetlana właściwość o nazwie Workflows.WebhookRedirectHostUri i jest ustawiona na adres URL przekazywania, na przykład:

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
          <...>
          "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
          <...>
       }
    }
    

Przy pierwszym uruchomieniu lokalnej sesji debugowania lub uruchomieniu przepływu pracy bez debugowania środowisko uruchomieniowe usługi Azure Logic Apps rejestruje przepływ pracy z punktem końcowym usługi i subskrybuje ten punkt końcowy na potrzeby powiadamiania operacji elementu webhook. Przy następnym uruchomieniu przepływu pracy środowisko uruchomieniowe nie będzie rejestrować ani ponownie zapisywać, ponieważ rejestracja subskrypcji już istnieje w magazynie lokalnym.

Po zatrzymaniu sesji debugowania dla przebiegu przepływu pracy, który używa lokalnie uruchamianych wyzwalaczy lub akcji opartych na elementach webhook, istniejące rejestracje subskrypcji nie zostaną usunięte. Aby wyrejestrować, musisz ręcznie usunąć lub usunąć rejestracje subskrypcji.

Uwaga

Po uruchomieniu przepływu pracy okno terminalu może wyświetlać błędy podobne do tego przykładu:

message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.'

W takim przypadku otwórz plik local.settings.json w folderze głównym projektu i upewnij się, że właściwość jest ustawiona na true:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Zarządzanie punktami przerwania na potrzeby debugowania

Przed uruchomieniem i przetestowaniem przepływu pracy aplikacji logiki przez uruchomienie sesji debugowania można ustawić punkty przerwania wewnątrz pliku workflow.json dla każdego przepływu pracy. Nie jest wymagana żadna inna konfiguracja.

Obecnie punkty przerwania są obsługiwane tylko w przypadku akcji, a nie wyzwalaczy. Każda definicja akcji ma następujące lokalizacje punktów przerwania:

  • Ustaw początkowy punkt przerwania w wierszu, który pokazuje nazwę akcji. Gdy ten punkt przerwania trafi podczas sesji debugowania, możesz przejrzeć dane wejściowe akcji przed ich oceną.

  • Ustaw końcowy punkt przerwania w wierszu, który pokazuje zamykający nawias klamrowy akcji (}). Gdy ten punkt przerwania zostanie osiągnięty podczas sesji debugowania, możesz przejrzeć wyniki akcji przed zakończeniem działania.

Aby dodać punkt przerwania, wykonaj następujące kroki:

  1. Otwórz plik workflow.json dla przepływu pracy, który chcesz debugować.

  2. W wierszu, w którym chcesz ustawić punkt przerwania, w lewej kolumnie wybierz wewnątrz tej kolumny. Aby usunąć punkt przerwania, wybierz ten punkt przerwania.

    Po rozpoczęciu sesji debugowania widok Uruchom jest wyświetlany po lewej stronie okna kodu, a pasek narzędzi Debugowanie jest wyświetlany w górnej części.

    Uwaga

    Jeśli widok Uruchom nie pojawi się automatycznie, naciśnij klawisze Ctrl+Shift+D.

  3. Aby przejrzeć dostępne informacje, gdy punkt przerwania trafi, w widoku Uruchom sprawdź okienko Zmienne .

  4. Aby kontynuować wykonywanie przepływu pracy, na pasku narzędzi Debugowanie wybierz pozycję Kontynuuj (przycisk odtwarzania).

Punkty przerwania można dodawać i usuwać w dowolnym momencie podczas uruchamiania przepływu pracy. Jeśli jednak zaktualizujesz plik workflow.json po uruchomieniu przebiegu, punkty przerwania nie zostaną automatycznie zaktualizowane. Aby zaktualizować punkty przerwania, uruchom ponownie aplikację logiki.

Aby uzyskać ogólne informacje, zobacz Punkty przerwania — Visual Studio Code.

Uruchamianie, testowanie i debugowanie lokalnie

Aby przetestować przepływ pracy aplikacji logiki, wykonaj następujące kroki, aby rozpocząć sesję debugowania i znaleźć adres URL punktu końcowego utworzonego przez wyzwalacz Żądania. Ten adres URL jest potrzebny, aby później można było wysłać żądanie do tego punktu końcowego.

  1. Aby łatwiej debugować bezstanowy przepływ pracy, możesz włączyć historię uruchamiania dla tego przepływu pracy.

  2. Jeśli emulator usługi Azurite jest już uruchomiony, przejdź do następnego kroku. W przeciwnym razie przed uruchomieniem przepływu pracy upewnij się, że emulator został uruchomiony:

    1. W programie Visual Studio Code z menu Widok wybierz pozycję Paleta poleceń.

    2. Po pojawieniu się palety poleceń wprowadź Azurite : Start.

    Aby uzyskać więcej informacji na temat poleceń Azurite, zobacz dokumentację rozszerzenia Azurite w programie Visual Studio Code.

  3. Na pasku działań programu Visual Studio Code otwórz menu Uruchom , a następnie wybierz pozycję Rozpocznij debugowanie (F5).

    Zostanie otwarte okno Terminal , aby można było przejrzeć sesję debugowania.

    Uwaga

    Jeśli wystąpi błąd "Błąd istnieje po uruchomieniu preLaunchTask "generateDebugSymbols", zobacz sekcję rozwiązywania problemów, nie można uruchomić sesji debugowania.

  4. Teraz znajdź adres URL wywołania zwrotnego dla punktu końcowego w wyzwalaczu żądania.

    1. Otwórz ponownie okienko Eksplorator, aby wyświetlić projekt.

    2. Z menu skrótów pliku workflow.json wybierz pozycję Przegląd.

      Zrzut ekranu przedstawiający okienko Eksploratora, workflow.json menu skrótów pliku z wybraną opcją Przegląd.

    3. Znajdź wartość adresu URL wywołania zwrotnego, która wygląda podobnie do tego adresu URL dla przykładowego wyzwalacza żądania:

      http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

      Zrzut ekranu przedstawiający stronę przeglądu przepływu pracy z adresem URL wywołania zwrotnego.

  5. Aby przetestować adres URL wywołania zwrotnego, wyzwalając przepływ pracy aplikacji logiki, otwórz narzędzie Postman lub preferowane narzędzie do tworzenia i wysyłania żądań.

    Ten przykład jest kontynuowany przy użyciu narzędzia Postman. Aby uzyskać więcej informacji, zobacz Postman Getting Started (Wprowadzenie do programu Postman).

    1. Na pasku narzędzi Postman wybierz pozycję Nowy.

      Zrzut ekranu przedstawiający narzędzie Postman z wybranym przyciskiem Nowy

    2. W okienku Tworzenie nowego w obszarze Bloki konstrukcyjne wybierz pozycję Żądanie.

    3. W oknie Zapisywanie żądania w obszarze Nazwa żądania podaj nazwę żądania, na przykład Wyzwalacz przepływu pracy testowego.

    4. W obszarze Wybierz kolekcję lub folder do zapisania wybierz pozycję Utwórz kolekcję.

    5. W obszarze Wszystkie kolekcje podaj nazwę kolekcji, która ma zostać utworzona na potrzeby organizowania żądań, naciśnij klawisz Enter i wybierz pozycję Zapisz do <nazwy> kolekcji. W tym przykładzie żądania usługi Logic Apps są używane jako nazwa kolekcji.

      W narzędziu Postman zostanie otwarte okienko żądania, aby można było wysłać żądanie do adresu URL wywołania zwrotnego dla wyzwalacza Żądania.

      Zrzut ekranu przedstawia narzędzie Postman z otwartym okienkiem żądania.

    6. Wróć do programu Visual Studio Code. Na stronie przeglądu przepływu pracy skopiuj wartość właściwości Adres URL wywołania zwrotnego.

    7. Wróć do narzędzia Postman. W okienku żądania obok listy metod, która obecnie jest wyświetlana jako domyślna metoda żądania, wklej wcześniej skopiowany adres URL wywołania zwrotnego w polu adresu, a następnie wybierz pozycję Wyślij.

      Zrzut ekranu przedstawiający adres URL narzędzia Postman i wywołania zwrotnego w polu adresu z wybranym przyciskiem Wyślij.

      Przykładowy przepływ pracy aplikacji logiki wysyła wiadomość e-mail podobną do tego przykładu:

      Zrzut ekranu przedstawia wiadomość e-mail programu Outlook zgodnie z opisem w przykładzie.

  6. W programie Visual Studio Code wróć do strony przeglądu przepływu pracy.

    Jeśli utworzono stanowy przepływ pracy, po wysłaniu żądania wyzwalającego przepływ pracy na stronie przeglądu zostanie wyświetlony stan uruchomienia i historia przepływu pracy.

    Napiwek

    Jeśli stan uruchomienia nie jest wyświetlany, spróbuj odświeżyć stronę przeglądu, wybierając pozycję Odśwież. W przypadku wyzwalacza pomijanego z powodu niezaspokojonych kryteriów lub znalezienia danych nie ma żadnego przebiegu.

    Zrzut ekranu przedstawiający stronę przeglądu przepływu pracy ze stanem przebiegu i historią

    W poniższej tabeli przedstawiono możliwe końcowe stany, które mogą mieć i pokazać każdy przebieg przepływu pracy w programie Visual Studio Code:

    Stan przebiegu opis
    Przerwane Przebieg został zatrzymany lub nie został zakończony z powodu problemów zewnętrznych, na przykład awarii systemu lub wygasłej subskrypcji platformy Azure.
    Anulowane Przebieg został wyzwolony i uruchomiony, ale otrzymał żądanie anulowania.
    Nie działa Co najmniej jedna akcja w przebiegu nie powiodła się. Nie skonfigurowano żadnych kolejnych akcji w przepływie pracy w celu obsługi awarii.
    Uruchomiono Przebieg został wyzwolony i jest w toku, ale ten stan może być również wyświetlany dla przebiegu, które jest ograniczane z powodu limitów akcji lub bieżącego planu cenowego.

    Porada: Jeśli skonfigurujesz rejestrowanie diagnostyczne, możesz uzyskać informacje o wszelkich zdarzeniach ograniczania przepustowości, które się zdarzają.

    Powodzenie Przebieg zakończył się pomyślnie. Jeśli jakakolwiek akcja nie powiodła się, kolejna akcja w przepływie pracy obsłużyła ten błąd.
    Przekroczono limit czasu Upłynął limit czasu wykonywania, ponieważ bieżący czas trwania przekroczył limit czasu trwania przebiegu, który jest kontrolowany przez ustawienie Przechowywanie historii uruchamiania w dniach. Czas trwania przebiegu jest obliczany przy użyciu czasu rozpoczęcia przebiegu i limitu czasu trwania przebiegu w tym czasie rozpoczęcia.

    Uwaga: Jeśli czas trwania przebiegu przekracza również bieżący limit przechowywania historii uruchamiania, który jest również kontrolowany przez ustawienie Przechowywanie historii uruchamiania w dniach, przebieg zostanie wyczyszczone z historii przebiegów przez codzienne zadanie oczyszczania. Bez względu na to, czy limit czasu uruchomienia, czy ukończenie, okres przechowywania jest zawsze obliczany przy użyciu czasu rozpoczęcia przebiegu i bieżącego limitu przechowywania. W związku z tym, jeśli zmniejszysz limit czasu trwania przebiegu w locie, limit czasu uruchamiania przekracza limit czasu. Jednak przebieg pozostaje lub jest czyszczone z historii przebiegów na podstawie tego, czy czas trwania przebiegu przekroczył limit przechowywania.

    Oczekuje Uruchomienie nie zostało uruchomione lub zostało wstrzymane, na przykład ze względu na wcześniejsze wystąpienie przepływu pracy, które jest nadal uruchomione.
  7. Aby przejrzeć stany poszczególnych kroków w określonym przebiegu oraz dane wejściowe i wyjściowe kroku, wybierz przycisk wielokropka (...) dla tego przebiegu, a następnie wybierz pozycję Pokaż przebieg.

    Zrzut ekranu przedstawia wiersz historii uruchamiania przepływu pracy z wybranym przyciskiem wielokropka i pokaż przebieg.

    Program Visual Studio Code otwiera widok monitorowania i pokazuje stan każdego kroku w przebiegu.

    Zrzut ekranu przedstawia każdy krok w przebiegu przepływu pracy i ich stan.

    Uwaga

    Jeśli przebieg zakończył się niepowodzeniem, a w widoku monitorowania zostanie wyświetlony błąd 400 Nieprawidłowe żądanie , ten problem może wynikać z dłuższej nazwy wyzwalacza lub nazwy akcji, która powoduje przekroczenie domyślnego limitu znaków przez podstawowy identyfikator URI ( Uniform Resource Identifier). Aby uzyskać więcej informacji, zobacz "400 Nieprawidłowe żądanie".

    W poniższej tabeli przedstawiono możliwe stany, które mogą zawierać poszczególne akcje przepływu pracy i które mogą być wyświetlane w programie Visual Studio Code:

    Stan akcji opis
    Przerwane Akcja została zatrzymana lub nie została zakończona z powodu problemów zewnętrznych, na przykład awarii systemu lub wygaśnięcia subskrypcji platformy Azure.
    Anulowane Akcja została uruchomiona, ale odebrano żądanie anulowania.
    Nie działa Akcja nie powiodła się.
    Uruchomiono Akcja jest obecnie uruchomiona.
    Pominięto Akcja została pominięta, ponieważ natychmiast poprzednia akcja nie powiodła się. Akcja ma runAfter warunek, który wymaga pomyślnego zakończenia poprzedniej akcji przed uruchomieniem bieżącej akcji.
    Powodzenie Akcja zakończyła się pomyślnie.
    Powodzenie z ponownymi próbami Akcja zakończyła się pomyślnie, ale tylko po co najmniej jednym ponawianiu prób. Aby przejrzeć historię ponowień, w widoku szczegółów historii uruchamiania wybierz tę akcję, aby wyświetlić dane wejściowe i wyjściowe.
    Przekroczono limit czasu Akcja została zatrzymana z powodu limitu czasu określonego przez ustawienia tej akcji.
    Oczekuje Dotyczy akcji elementu webhook, która oczekuje na żądanie przychodzące od obiektu wywołującego.
  8. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, wybierz krok, który chcesz sprawdzić. Aby dokładniej przejrzeć nieprzetworzone dane wejściowe i wyjściowe dla tego kroku, wybierz pozycję Pokaż nieprzetworzone dane wejściowe lub Pokaż nieprzetworzone dane wyjściowe.

    Zrzut ekranu przedstawia stan każdego kroku w przepływie pracy oraz dane wejściowe i wyjściowe w rozszerzonej akcji o nazwie Wyślij wiadomość e-mail.

  9. Aby zatrzymać sesję debugowania, w menu Uruchom wybierz pozycję Zatrzymaj debugowanie (Shift + F5).

Zwracanie odpowiedzi

Jeśli masz przepływ pracy rozpoczynający się od wyzwalacza Żądanie, możesz zwrócić odpowiedź na obiekt wywołujący, który wysłał żądanie do przepływu pracy, używając wbudowanej akcji Żądanie o nazwie Odpowiedź.

  1. W projektancie przepływu pracy w obszarze akcji Wyślij wiadomość e-mail wybierz znak plus (+) >Dodaj akcję.

    Zostanie otwarte okienko Dodaj akcję , aby można było wybrać następną akcję.

  2. W okienku Dodaj akcję z listy Środowisko uruchomieniowe wybierz pozycję W aplikacji. Znajdź i dodaj akcję Odpowiedź .

    Po pojawieniu się akcji Odpowiedź w projektancie zostanie automatycznie otwarte okienko szczegółów akcji.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i okienko informacji o odpowiedzi.

  3. Na karcie Parametry podaj wymagane informacje dotyczące funkcji, którą chcesz wywołać.

    W tym przykładzie jest zwracana wartość parametru Treść , która jest danymi wyjściowymi akcji Wyślij wiadomość e-mail .

    1. Dla parametru Treść wybierz wewnątrz pola edycji i wybierz ikonę błyskawicy, która otwiera listę zawartości dynamicznej. Ta lista zawiera dostępne wartości wyjściowe z poprzedniego wyzwalacza i akcji w przepływie pracy.

    2. Na liście zawartości dynamicznej w obszarze Wyślij wiadomość e-mail wybierz pozycję Treść.

      Zrzut ekranu przedstawiający otwartą listę zawartości dynamicznej, w której w obszarze Wyślij nagłówek wiadomości e-mail wybrano wartość danych wyjściowych Treść.

      Po zakończeniu właściwość Treść akcji odpowiedzi jest teraz ustawiona na wartość Dane wyjściowe treść akcjiWyślij wiadomość e-mail.

      Zrzut ekranu przedstawiający projektanta przepływu pracy, okienko informacji o odpowiedzi i parametr treść ustawiony na wartość Treść akcji o nazwie Wyślij wiadomość e-mail.

  4. W projektancie wybierz pozycję Zapisz.

Ponowne testowanie aplikacji logiki

Po wprowadzeniu aktualizacji do aplikacji logiki możesz uruchomić kolejny test, uruchamiając ponownie debuger w programie Visual Studio i wysyłając kolejne żądanie, aby wyzwolić zaktualizowaną aplikację logiki, podobnie jak kroki opisane w temacie Uruchamianie, testowanie i debugowanie lokalnie.

  1. Na pasku działań programu Visual Studio Code otwórz menu Uruchom , a następnie wybierz pozycję Rozpocznij debugowanie (F5).

  2. W narzędziu Postman lub narzędziu do tworzenia i wysyłania żądań wyślij kolejne żądanie, aby wyzwolić przepływ pracy.

  3. Jeśli utworzono stanowy przepływ pracy, na stronie przeglądu przepływu pracy sprawdź stan ostatniego uruchomienia. Aby wyświetlić stan, dane wejściowe i wyjściowe dla każdego kroku w tym przebiegu, wybierz przycisk wielokropka (...) dla tego przebiegu, a następnie wybierz pozycję Pokaż przebieg.

    Na przykład poniżej przedstawiono stan krok po kroku dla przebiegu po zaktualizowaniu przykładowego przepływu pracy za pomocą akcji Odpowiedź.

    Zrzut ekranu przedstawia stan każdego kroku zaktualizowanego przepływu pracy oraz dane wejściowe i wyjściowe w rozszerzonej akcji Odpowiedź.

  4. Aby zatrzymać sesję debugowania, w menu Uruchom wybierz pozycję Zatrzymaj debugowanie (Shift + F5).

Znajdowanie nazw domen na potrzeby dostępu do zapory

Przed wdrożeniem i uruchomieniem przepływu pracy aplikacji logiki w witrynie Azure Portal, jeśli środowisko ma ścisłe wymagania sieciowe lub zapory ograniczające ruch, musisz skonfigurować uprawnienia dla wszystkich połączeń wyzwalacza lub akcji, które istnieją w przepływie pracy.

Aby znaleźć w pełni kwalifikowane nazwy domen (FQDN) dla tych połączeń, wykonaj następujące kroki:

  1. W projekcie aplikacji logiki otwórz plik connections.json , który zostanie utworzony po dodaniu pierwszego wyzwalacza lub akcji opartej na połączeniu do przepływu pracy i znajdź managedApiConnections obiekt.

  2. Dla każdego utworzonego połączenia skopiuj i zapisz connectionRuntimeUrl wartość właściwości w bezpiecznym miejscu, aby można było skonfigurować zaporę przy użyciu tych informacji.

    W tym przykładzie plik connections.json zawiera dwa połączenia, połączenie AS2 i połączenie usługi Office 365 z następującymi connectionRuntimeUrl wartościami:

    • AS2: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba

    • Office 365: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f

    {
       "managedApiConnections": {
          "as2": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          },
          "office365": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          }
       }
    }
    

Wdróż na platformie Azure

W programie Visual Studio Code możesz bezpośrednio opublikować projekt na platformie Azure, aby wdrożyć zasób aplikacji logiki w warstwie Standardowa. Aplikację logiki można opublikować jako nowy zasób, który automatycznie tworzy wszelkie niezbędne zasoby, takie jak konto usługi Azure Storage, podobne do wymagań aplikacji funkcji. Możesz też opublikować aplikację logiki w wcześniej wdrożonym zasobie aplikacji logiki w warstwie Standardowa, który zastępuje aplikację logiki.

Wdrożenie zasobu aplikacji logiki w warstwie Standardowa wymaga planu hostingu i warstwy cenowej wybranej podczas wdrażania. Aby uzyskać więcej informacji, zapoznaj się z tematem Hosting plans and pricing tiers (Plany hostingu i warstwy cenowe).

Publikowanie w nowym zasobie aplikacji logiki w warstwie Standardowa

  1. Na pasku działań programu Visual Studio Code wybierz ikonę platformy Azure, aby otworzyć okno platformy Azure.

  2. W oknie Platformy Azure na pasku narzędzi sekcji Obszar roboczy z menu usługi Azure Logic Apps wybierz pozycję Wdróż w aplikacji logiki.

    Zrzut ekranu przedstawiający okno platformy Azure z paskiem narzędzi obszaru roboczego i menu skrótów usługi Azure Logic Apps z wybraną pozycją Wdróż w aplikacji logiki.

  3. Jeśli zostanie wyświetlony monit, wybierz subskrypcję platformy Azure do użycia na potrzeby wdrożenia aplikacji logiki.

  4. Z listy otwieranej przez program Visual Studio Code wybierz z następujących opcji:

    • Tworzenie nowej aplikacji logiki (Standardowa) na platformie Azure (szybkie)
    • Tworzenie nowej aplikacji logiki (Standardowa) w usłudze Azure Advanced
    • Wcześniej wdrożony zasób aplikacji logiki (Standardowa), jeśli istnieje

    W tym przykładzie jest kontynuowane tworzenie nowej aplikacji logiki (Standardowa) w usłudze Azure Advanced.

    Zrzut ekranu przedstawiający listę opcji wdrażania i wybraną opcję Utwórz nową aplikację logiki (Standardowa) w usłudze Azure Advanced.

  5. Aby utworzyć nowy zasób aplikacji logiki w warstwie Standardowa, wykonaj następujące kroki:

    1. Podaj globalnie unikatową nazwę nowej aplikacji logiki, która jest nazwą używaną dla zasobu aplikacji logiki (Standardowa). W tym przykładzie użyto aplikacji Fabrikam-Workflows-App.

      Zrzut ekranu przedstawia monit o podanie nazwy nowej aplikacji logiki do utworzenia.

    2. Wybierz plan hostingu dla nowej aplikacji logiki. Utwórz nazwę planu lub wybierz istniejący plan (tylko plany usługi App Service oparte na systemie Windows). W tym przykładzie wybrano pozycję Utwórz nowy plan usługi App Service.

      Zrzut ekranu przedstawiający okienko

    3. Podaj nazwę planu hostingu, a następnie wybierz warstwę cenową dla wybranego planu.

      Aby uzyskać więcej informacji, zapoznaj się z tematem Hosting plans and pricing tiers (Plany hostingu i warstwy cenowe).

    4. Aby uzyskać optymalną wydajność, wybierz tę samą grupę zasobów co projekt dla wdrożenia.

      Uwaga

      Chociaż można utworzyć inną grupę zasobów lub użyć jej, może to mieć wpływ na wydajność. Jeśli tworzysz lub wybierzesz inną grupę zasobów, ale anuluj po wyświetleniu monitu o potwierdzenie wdrożenie zostanie również anulowane.

    5. W przypadku stanowych przepływów pracy wybierz pozycję Utwórz nowe konto magazynu lub istniejące konto magazynu.

      Zrzut ekranu przedstawiający okienko

    6. Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Szczegółowe informacje, opcjonalnie możesz włączyć rejestrowanie diagnostyczne i śledzenie aplikacji logiki. Można to zrobić podczas wdrażania aplikacji logiki z programu Visual Studio Code lub po wdrożeniu. Musisz mieć wystąpienie usługi Application Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem, podczas wdrażania aplikacji logiki lub po wdrożeniu.

      Aby włączyć rejestrowanie i śledzenie teraz, wykonaj następujące kroki:

      1. Wybierz istniejący zasób Szczegółowe informacje aplikacji lub Utwórz nowy zasób Szczegółowe informacje aplikacji.

      2. W witrynie Azure Portal przejdź do zasobu Application Szczegółowe informacje.

      3. W menu zasobów wybierz pozycję Przegląd. Znajdź i skopiuj wartość Klucza instrumentacji.

      4. W programie Visual Studio Code w folderze głównym projektu otwórz plik local.settings.json .

      5. Values W obiekcie dodaj APPINSIGHTS_INSTRUMENTATIONKEY właściwość i ustaw wartość na klucz instrumentacji, na przykład:

        {
           "IsEncrypted": false,
           "Values": {
              "AzureWebJobsStorage": "UseDevelopmentStorage=true",
              "FUNCTIONS_WORKER_RUNTIME": "node",
              "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
           }
        }
        

        Napiwek

        Możesz sprawdzić, czy nazwy wyzwalacza i akcji są poprawnie wyświetlane w wystąpieniu aplikacji Szczegółowe informacje.

        1. W witrynie Azure Portal przejdź do zasobu Szczegółowe informacje aplikacji.

        2. W menu zasobów w obszarze Zbadaj wybierz pozycję Mapa aplikacji.

        3. Przejrzyj nazwy operacji wyświetlane na mapie.

        Niektóre żądania przychodzące z wbudowanych wyzwalaczy mogą być wyświetlane jako duplikaty na mapie aplikacji. Zamiast używać WorkflowName.ActionName formatu, te duplikaty używają nazwy przepływu pracy jako nazwy operacji i pochodzą z hosta usługi Azure Functions.

      6. Następnie możesz opcjonalnie dostosować poziom ważności dla danych śledzenia zbieranych przez aplikację logiki i wysyłanych do wystąpienia usługi Application Szczegółowe informacje.

        Za każdym razem, gdy występuje zdarzenie związane z przepływem pracy, takie jak po wyzwoleniu przepływu pracy lub uruchomieniu akcji, środowisko uruchomieniowe emituje różne ślady. Te ślady obejmują okres istnienia przepływu pracy i obejmują, ale nie są ograniczone do następujących typów zdarzeń:

        • Działanie usługi, takie jak uruchamianie, zatrzymywanie i błędy.
        • Zadania i działanie dyspozytora.
        • Działanie przepływu pracy, takie jak wyzwalacz, akcja i uruchamianie.
        • Działanie żądania magazynu, takie jak powodzenie lub niepowodzenie.
        • Działanie żądania HTTP, takie jak przychodzące, wychodzące, zakończone powodzeniem i niepowodzeniem.
        • Wszelkie ślady programowania, takie jak komunikaty debugowania.

        Każdy typ zdarzenia jest przypisywany do poziomu ważności. Na przykład Trace poziom przechwytuje najbardziej szczegółowe komunikaty, podczas gdy Information poziom przechwytuje ogólne działanie w przepływie pracy, takie jak uruchamianie i zatrzymywanie aplikacji logiki, przepływu pracy, wyzwalacza i akcji. W tej tabeli opisano poziomy ważności i ich typy śledzenia:

        Poziom ważności Typ śledzenia
        Krytyczne Dzienniki, które opisują nieodwracalny błąd w aplikacji logiki.
        Debugowanie Dzienniki, których można używać do badania podczas programowania, na przykład przychodzące i wychodzące wywołania HTTP.
        Błąd Dzienniki wskazujące niepowodzenie wykonywania przepływu pracy, ale nie ogólny błąd w aplikacji logiki.
        Informacja Dzienniki śledzące ogólne działania w aplikacji logiki lub przepływie pracy, na przykład:

        — Po uruchomieniu i zakończeniu wyzwalacza, akcji lub uruchamiania.
        — Po uruchomieniu lub zakończeniu aplikacji logiki.

        Śledzenie Dzienniki zawierające najbardziej szczegółowe komunikaty, na przykład żądania magazynu lub działanie dyspozytora oraz wszystkie komunikaty związane z działaniem wykonywania przepływu pracy.
        Ostrzeżenie Dzienniki, które podkreślają nietypowy stan w aplikacji logiki, ale nie uniemożliwiają jej działania.

        Aby ustawić poziom ważności, na poziomie głównym projektu otwórz plik host.json i znajdź logging obiekt. Ten obiekt steruje filtrowaniem dzienników dla wszystkich przepływów pracy w aplikacji logiki i jest zgodny z układem ASP.NET Core na potrzeby filtrowania typów dzienników.

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              }
           }
        }
        

        logging Jeśli obiekt nie zawiera obiektu zawierającego logLevelHost.Triggers.Workflow właściwość , dodaj te elementy. Ustaw właściwość na poziom ważności dla żądanego typu śledzenia, na przykład:

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              },
              "logLevel": {
                 "Host.Triggers.Workflow": "Information"
              }
           }
        }
        

    Po wykonaniu kroków wdrażania program Visual Studio Code rozpoczyna tworzenie i wdrażanie zasobów niezbędnych do opublikowania aplikacji logiki.

  6. Aby przejrzeć i monitorować proces wdrażania, w menu Widok wybierz pozycję Dane wyjściowe. Z listy pasek narzędzi okna danych wyjściowych wybierz pozycję Azure Logic Apps.

    Zrzut ekranu przedstawiający okno Dane wyjściowe z usługą Azure Logic Apps wybraną na liście pasków narzędzi wraz z postępem wdrażania i stanami.

    Gdy program Visual Studio Code zakończy wdrażanie aplikacji logiki na platformie Azure, zostanie wyświetlony następujący komunikat:

    Zrzut ekranu przedstawia komunikat informujący o pomyślnym zakończeniu wdrażania na platformie Azure.

    Gratulacje, twoja aplikacja logiki jest teraz aktywna na platformie Azure i domyślnie włączona.

Następnie możesz dowiedzieć się, jak wykonywać następujące zadania:

Dodawanie pustego przepływu pracy do projektu

W projekcie aplikacji logiki można mieć wiele przepływów pracy. Aby dodać pusty przepływ pracy do projektu, wykonaj następujące kroki:

  1. Na pasku działań programu Visual Studio Code wybierz ikonę platformy Azure.

  2. W oknie platformy Azure na pasku narzędzi sekcji Obszar roboczy z menu usługi Azure Logic Apps wybierz pozycję Utwórz przepływ pracy.

  3. Wybierz typ przepływu pracy, który chcesz dodać: Stanowy lub Bezstanowy

  4. Podaj nazwę przepływu pracy.

Po zakończeniu w projekcie zostanie wyświetlony nowy folder przepływu pracy wraz z plikiem workflow.json definicji przepływu pracy.

Zarządzanie wdrożonymi aplikacjami logiki w programie Visual Studio Code

W programie Visual Studio Code możesz wyświetlić wszystkie wdrożone aplikacje logiki w ramach subskrypcji platformy Azure, niezależnie od tego, czy są zasobami aplikacji logiki Consumption, czy Standard, i wybrać zadania, które ułatwiają zarządzanie tymi aplikacjami logiki. Jednak aby uzyskać dostęp do obu typów zasobów, potrzebne są zarówno rozszerzenia Azure Logic Apps (Consumption) i Azure Logic Apps (Standard) dla programu Visual Studio Code.

  1. Na pasku działań programu Visual Studio Code wybierz ikonę platformy Azure. W obszarze Zasoby rozwiń subskrypcję, a następnie rozwiń węzeł Aplikacja logiki, która zawiera wszystkie aplikacje logiki wdrożone na platformie Azure dla tej subskrypcji.

  2. Otwórz aplikację logiki, którą chcesz zarządzać. Z menu skrótów aplikacji logiki wybierz zadanie, które chcesz wykonać.

    Można na przykład wybrać zadania, takie jak zatrzymywanie, uruchamianie, ponowne uruchamianie lub usuwanie wdrożonej aplikacji logiki. Przepływ pracy można wyłączyć lub włączyć za pomocą witryny Azure Portal.

    Uwaga

    Zatrzymywanie aplikacji logiki i usuwanie operacji aplikacji logiki wpływa na wystąpienia przepływu pracy na różne sposoby. Aby uzyskać więcej informacji, zapoznaj się z tematem Zagadnienia dotyczące zatrzymywania aplikacji logiki i zagadnienia dotyczące usuwania aplikacji logiki.

    Zrzut ekranu przedstawiający sekcję Visual Studio Code z zasobami i wdrożonym zasobem aplikacji logiki.

  3. Aby wyświetlić wszystkie przepływy pracy w aplikacji logiki, rozwiń aplikację logiki, a następnie rozwiń węzeł Przepływy pracy.

  4. Aby wyświetlić określony przepływ pracy, otwórz menu skrótów przepływu pracy i wybierz pozycję Otwórz w Projektant, co spowoduje otwarcie przepływu pracy w trybie tylko do odczytu.

    Aby edytować przepływ pracy, dostępne są następujące opcje:

    • W programie Visual Studio Code otwórz plik workflow.json projektu w projektancie przepływu pracy, wprowadź zmiany i ponownie wdróż aplikację logiki na platformie Azure.

    • W witrynie Azure Portal otwórz aplikację logiki. Następnie możesz otworzyć, edytować i zapisać przepływ pracy.

  5. Aby otworzyć wdrożona aplikacja logiki w witrynie Azure Portal, otwórz menu skrótów aplikacji logiki i wybierz pozycję Otwórz w portalu.

    Witryna Azure Portal zostanie otwarta w przeglądarce, automatycznie zaloguje się do portalu po zalogowaniu się do programu Visual Studio Code i wyświetli aplikację logiki.

    Zrzut ekranu przedstawiający stronę witryny Azure Portal dla aplikacji logiki w programie Visual Studio Code.

    Możesz również zalogować się oddzielnie do witryny Azure Portal, użyć pola wyszukiwania portalu, aby znaleźć aplikację logiki, a następnie wybrać aplikację logiki z listy wyników.

    Zrzut ekranu przedstawiający witrynę Azure Portal i pasek wyszukiwania z wynikami wyszukiwania dla wdrożonej aplikacji logiki, która zostanie wybrana.

Zagadnienia dotyczące zatrzymywania aplikacji logiki

Zatrzymanie aplikacji logiki wpływa na wystąpienia przepływu pracy w następujący sposób:

  • Usługa Azure Logic Apps anuluje wszystkie przebiegi w toku i oczekujące natychmiast.

  • Usługa Azure Logic Apps nie tworzy ani nie uruchamia nowych wystąpień przepływu pracy.

  • Wyzwalacze nie będą uruchamiane przy następnym spełnieniu warunków. Stany wyzwalacza pamiętają jednak punkty, w których aplikacja logiki została zatrzymana. Dlatego po ponownym uruchomieniu aplikacji logiki wyzwalacze są uruchamiane dla wszystkich nieprzetworzonych elementów od ostatniego uruchomienia.

    Aby zatrzymać wyzwalacz przed uruchomieniem nieprzetworzonych elementów od ostatniego uruchomienia, wyczyść stan wyzwalacza przed ponownym uruchomieniem aplikacji logiki:

    1. Na pasku działań programu Visual Studio Code wybierz ikonę platformy Azure, aby otworzyć okno platformy Azure.

    2. W sekcji Zasoby rozwiń subskrypcję, która zawiera wszystkie wdrożone aplikacje logiki dla tej subskrypcji.

    3. Rozwiń aplikację logiki, a następnie rozwiń węzeł o nazwie Przepływy pracy.

    4. Otwórz przepływ pracy i edytuj dowolną część wyzwalacza tego przepływu pracy.

    5. Zapisz zmiany. Ten krok powoduje zresetowanie bieżącego stanu wyzwalacza.

    6. Powtórz dla każdego przepływu pracy.

    7. Po zakończeniu uruchom ponownie aplikację logiki.

Zagadnienia dotyczące usuwania aplikacji logiki

Usunięcie aplikacji logiki wpływa na wystąpienia przepływu pracy w następujący sposób:

  • Usługa Azure Logic Apps anuluje przebiegi w toku i oczekuje natychmiast, ale nie uruchamia zadań oczyszczania w magazynie używanym przez aplikację.

  • Usługa Azure Logic Apps nie tworzy ani nie uruchamia nowych wystąpień przepływu pracy.

  • Jeśli usuniesz przepływ pracy, a następnie ponownie utworzysz ten sam przepływ pracy, utworzony ponownie przepływ pracy nie będzie miał tych samych metadanych co usunięty przepływ pracy. Aby odświeżyć metadane, musisz ponownie zapisać dowolny przepływ pracy, który nazwał usunięty przepływ pracy. W ten sposób obiekt wywołujący pobiera poprawne informacje dotyczące ponownie tworzonego przepływu pracy. W przeciwnym razie wywołania ponownego utworzenia przepływu pracy kończą się niepowodzeniem z powodu błędu Unauthorized . To zachowanie dotyczy również przepływów pracy, które używają artefaktów na kontach integracji i przepływach pracy wywołujących funkcje platformy Azure.

Zarządzanie wdrożonymi aplikacjami logiki w portalu

Po wdrożeniu aplikacji logiki w witrynie Azure Portal z poziomu programu Visual Studio Code możesz wyświetlić wszystkie wdrożone aplikacje logiki, które znajdują się w subskrypcji platformy Azure, niezależnie od tego, czy są zasobami aplikacji logiki Consumption, czy Standard. Obecnie każdy typ zasobu jest zorganizowany i zarządzany jako oddzielne kategorie na platformie Azure. Aby znaleźć standardowe aplikacje logiki, wykonaj następujące kroki:

  1. W polu wyszukiwania w witrynie Azure Portal wprowadź wartość Logic Apps. Gdy zostanie wyświetlona lista wyników, w obszarze Usługi wybierz pozycję Aplikacje logiki.

    Zrzut ekranu przedstawiający pole wyszukiwania w witrynie Azure Portal z aplikacjami logiki jako tekst wyszukiwania.

  2. W okienku Aplikacje logiki wybierz aplikację logiki wdrożona w programie Visual Studio Code.

    Zrzut ekranu przedstawiający witryny Azure Portal i standardowe zasoby aplikacji logiki wdrożone na platformie Azure.

    Witryna Azure Portal otwiera pojedynczą stronę zasobu dla wybranej aplikacji logiki.

    Zrzut ekranu przedstawiający witrynę Azure Portal i stronę zasobu aplikacji logiki.

  3. Aby wyświetlić przepływy pracy w tej aplikacji logiki, w menu aplikacji logiki wybierz pozycję Przepływy pracy.

    W okienku Przepływy pracy są wyświetlane wszystkie przepływy pracy w bieżącej aplikacji logiki. W tym przykładzie pokazano przepływ pracy utworzony w programie Visual Studio Code.

    Zrzut ekranu przedstawiający stronę zasobu aplikacji logiki z otwartym okienkiem Przepływy pracy i przepływami pracy.

  4. Aby wyświetlić przepływ pracy, w okienku Przepływy pracy wybierz ten przepływ pracy.

    Zostanie otwarte okienko przepływu pracy zawierające więcej informacji i zadań, które można wykonać w tym przepływie pracy.

    Aby na przykład wyświetlić kroki w przepływie pracy, wybierz pozycję Projektant.

    Zrzut ekranu przedstawia okienko Przegląd wybranego przepływu pracy, a menu przepływu pracy pokazuje wybrane polecenie

    Zostanie otwarty projektant przepływu pracy i zostanie wyświetlony przepływ pracy utworzony w programie Visual Studio Code. Teraz możesz wprowadzić zmiany w tym przepływie pracy w witrynie Azure Portal.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i przepływ pracy wdrożony z programu Visual Studio Code.

Dodawanie innego przepływu pracy w portalu

Za pośrednictwem witryny Azure Portal można dodawać puste przepływy pracy do zasobu standardowej aplikacji logiki wdrożonego z poziomu programu Visual Studio Code i tworzyć te przepływy pracy w witrynie Azure Portal.

  1. W witrynie Azure Portal wybierz wdrożony zasób aplikacji logiki w warstwie Standardowa.

  2. W menu zasobów aplikacji logiki wybierz pozycję Przepływy pracy. W okienku Przepływy pracy wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający okienko Przepływy pracy wybranej aplikacji logiki i pasek narzędzi z wybranym poleceniem Dodaj.

  3. W okienku Nowy przepływ pracy podaj nazwę przepływu pracy . Wybierz pozycję Stanowe lub Bezstanowe> utwórz.

    Po wdrożeniu nowego przepływu pracy na platformie Azure, który zostanie wyświetlony w okienku Przepływy pracy, wybierz ten przepływ pracy, aby umożliwić zarządzanie innymi zadaniami, takimi jak otwieranie projektanta lub widoku kodu.

    Zrzut ekranu przedstawia wybrany przepływ pracy z opcjami zarządzania i przeglądania.

    Na przykład otwarcie projektanta dla nowego przepływu pracy pokazuje pustą kanwę. Teraz możesz skompilować ten przepływ pracy w witrynie Azure Portal.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i pusty przepływ pracy.

Włączanie historii uruchamiania dla przepływów pracy bezstanowych

Aby łatwiej debugować bezstanowy przepływ pracy, możesz włączyć historię uruchamiania dla tego przepływu pracy, a następnie wyłączyć historię uruchamiania po zakończeniu. Wykonaj następujące kroki dla programu Visual Studio Code lub jeśli pracujesz w witrynie Azure Portal, zobacz Tworzenie przepływów pracy opartych na jednej dzierżawie w witrynie Azure Portal.

  1. W projekcie programu Visual Studio Code na poziomie folderu głównego otwórz plik local.settings.json .

  2. Workflows.{yourWorkflowName}.operationOptions Dodaj właściwość i ustaw wartość na WithStatelessRunHistory, na przykład:

    Windows

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    

    macOS lub Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    
  3. W folderze projektu o nazwie workflow-designtime otwórz plik local.settings.json i wprowadź tę samą zmianę.

  4. Aby wyłączyć historię uruchamiania po zakończeniu, ustaw Workflows.{yourWorkflowName}.OperationOptionswłaściwość na None, lub usuń właściwość i jej wartość.

Włączanie widoku monitorowania w witrynie Azure Portal

Po wdrożeniu zasobu aplikacji logiki (Standardowa) z programu Visual Studio Code na platformę Azure możesz przejrzeć dowolną dostępną historię uruchamiania i szczegóły przepływu pracy w tym zasobie przy użyciu witryny Azure Portal i środowiska Monitor dla tego przepływu pracy. Należy jednak najpierw włączyć funkcję Monitorowanie widoku dla tego zasobu aplikacji logiki.

  1. W witrynie Azure Portal otwórz zasób standardowej aplikacji logiki.

  2. W menu zasobów aplikacji logiki w obszarze INTERFEJS API wybierz pozycję CORS.

  3. W okienku CORS w obszarze Dozwolone źródła dodaj symbol wieloznaczny (*).

  4. Gdy wszystko będzie gotowe, na pasku narzędzi CORS wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający witrynę Azure Portal z wdrożonym zasobem aplikacji logiki w warstwie Standardowa. W menu zasobów mechanizm CORS jest wybierany z nowym wpisem dozwolonych źródeł ustawionym na symbol wieloznaczny * znak.

Włączanie lub otwieranie Szczegółowe informacje aplikacji po wdrożeniu

Podczas wykonywania przepływu pracy aplikacja logiki emituje dane telemetryczne wraz z innymi zdarzeniami. Za pomocą tej telemetrii można uzyskać lepszy wgląd w to, jak dobrze działa przepływ pracy i jak działa środowisko uruchomieniowe usługi Logic Apps na różne sposoby. Przepływ pracy można monitorować przy użyciu usługi Application Szczegółowe informacje, która zapewnia dane telemetryczne niemal w czasie rzeczywistym (metryki na żywo). Ta funkcja może ułatwić badanie niepowodzeń i problemów z wydajnością w przypadku używania tych danych do diagnozowania problemów, konfigurowania alertów i tworzenia wykresów.

Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Szczegółowe informacje, opcjonalnie możesz włączyć rejestrowanie diagnostyczne i śledzenie aplikacji logiki. Można to zrobić podczas wdrażania aplikacji logiki z programu Visual Studio Code lub po wdrożeniu. Musisz mieć wystąpienie usługi Application Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem, podczas wdrażania aplikacji logiki lub po wdrożeniu.

Aby włączyć Szczegółowe informacje aplikacji w wdrożonej aplikacji logiki lub przejrzeć dane Szczegółowe informacje aplikacji po włączeniu, wykonaj następujące kroki:

  1. W witrynie Azure Portal znajdź wdrożona aplikację logiki.

  2. W menu aplikacji logiki w obszarze Ustawienia wybierz pozycję Aplikacja Szczegółowe informacje.

  3. Jeśli Szczegółowe informacje aplikacji nie jest włączona, w okienku Aplikacja Szczegółowe informacje wybierz pozycję Włącz aplikację Szczegółowe informacje. Po zaktualizowaniu okienka w dolnej części wybierz pozycję Zastosuj.

    Jeśli Szczegółowe informacje aplikacji jest włączona, w okienku Aplikacja Szczegółowe informacje wybierz pozycję Wyświetl dane Szczegółowe informacje aplikacji.

Po uruchomieniu Szczegółowe informacje aplikacji możesz przejrzeć różne metryki dla aplikacji logiki. Aby uzyskać więcej informacji, zapoznaj się z następującymi tematami:

Usuwanie elementów z projektanta

Aby usunąć element w przepływie pracy z projektanta, wykonaj dowolne z następujących kroków:

  • Wybierz element, otwórz menu skrótów elementu (Shift+F10) i wybierz pozycję Usuń. Aby potwierdzić, wybierz pozycję OK.

  • Wybierz element i naciśnij klawisz delete. Aby potwierdzić, wybierz pozycję OK.

  • Wybierz element, aby okienko szczegółów było otwierane dla tego elementu. W prawym górnym rogu okienka otwórz menu wielokropka (...), a następnie wybierz pozycję Usuń. Aby potwierdzić, wybierz pozycję OK.

    Zrzut ekranu przedstawia wybrany element w projektancie z otwartym okienkiem informacji oraz wybranym przyciskiem wielokropka i poleceniem

    Napiwek

    Jeśli menu wielokropka nie jest widoczne, rozwiń wystarczająco szerokie okno programu Visual Studio Code, aby okienko szczegółów wyświetlało przycisk wielokropka (...) w prawym górnym rogu.

Rozwiązywanie problemów i błędów

Nie można otworzyć Projektant

Podczas próby otwarcia projektanta zostanie wyświetlony ten błąd "Nie można uruchomić czasu projektowania przepływu pracy". Jeśli wcześniej podjęto próbę otwarcia projektanta, a następnie wycofano lub usunięto projekt, pakiet rozszerzenia może nie być pobierany poprawnie. Aby sprawdzić, czy przyczyną jest ten problem, wykonaj następujące kroki:

  1. W programie Visual Studio Code otwórz okno Dane wyjściowe. Z menu Widok wybierz pozycję Dane wyjściowe.

  2. Z listy na pasku tytułu okna Dane wyjściowe wybierz pozycję Azure Logic Apps (Standardowa), aby można było przejrzeć dane wyjściowe z rozszerzenia, na przykład:

    Zrzut ekranu przedstawiający okno Dane wyjściowe z wybraną pozycją

  3. Przejrzyj dane wyjściowe i sprawdź, czy jest wyświetlany ten komunikat o błędzie:

    A host error has occurred during startup operation '{operationID}'.
    System.Private.CoreLib: The file 'C:\Users\{userName}\AppData\Local\Temp\Functions\
    ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\
    DurableTask.AzureStorage.dll' already exists.
    Value cannot be null. (Parameter 'provider')
    Application is shutting down...
    Initialization cancellation requested by runtime.
    Stopping host...
    Host shutdown completed.
    

Aby rozwiązać ten błąd, usuń folder ExtensionBundles w tej lokalizacji ...\Users{your-username}\AppData\Local\Temp\Functions\ExtensionBundles i ponów próbę otwarcia pliku workflow.json w projektancie.

Brak nowych wyzwalaczy i akcji w selektorze projektanta dla utworzonych wcześniej przepływów pracy

Usługa Azure Logic Apps z jedną dzierżawą obsługuje wbudowane akcje dla operacji funkcji platformy Azure, operacji liquid i operacji XML, takich jak walidacja XML i przekształcanie kodu XML. Jednak w przypadku wcześniej utworzonych aplikacji logiki te akcje mogą nie być wyświetlane w selektorze projektanta, aby wybrać, czy program Visual Studio Code używa nieaktualnej wersji pakietu rozszerzeń. Microsoft.Azure.Functions.ExtensionBundle.Workflows

Ponadto łącznik Operacje funkcji platformy Azure i akcje nie są wyświetlane w selektorze projektanta, chyba że włączono lub wybrano opcję Użyj łączników z platformy Azure podczas tworzenia aplikacji logiki. Jeśli nie włączono łączników wdrożonych na platformie Azure w czasie tworzenia aplikacji, możesz je włączyć z projektu w programie Visual Studio Code. Otwórz menu skrótów workflow.json i wybierz pozycję Użyj Połączenie orów z platformy Azure.

Aby naprawić nieaktualny pakiet, wykonaj następujące kroki, aby usunąć nieaktualny pakiet, co sprawia, że program Visual Studio Code automatycznie aktualizuje pakiet rozszerzenia do najnowszej wersji.

Uwaga

To rozwiązanie dotyczy tylko aplikacji logiki tworzonych i wdrażanych przy użyciu programu Visual Studio Code z rozszerzeniem usługi Azure Logic Apps (Standard), a nie aplikacji logiki utworzonych przy użyciu witryny Azure Portal. Zobacz Brak obsługiwanych wyzwalaczy i akcji w projektancie w witrynie Azure Portal.

  1. Zapisz każdą pracę, której nie chcesz utracić, i zamknij program Visual Studio.

  2. Na komputerze przejdź do następującego folderu, który zawiera foldery w wersji dla istniejącego pakietu:

    ...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  3. Usuń folder wersji dla wcześniejszego pakietu, na przykład jeśli masz folder w wersji 1.1.3, usuń ten folder.

  4. Teraz przejdź do następującego folderu, który zawiera foldery w wersji dla wymaganego pakietu NuGet:

    ...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension

  5. Usuń folder wersji dla wcześniejszego pakietu.

  6. Otwórz ponownie program Visual Studio Code, projekt i plik workflow.json w projektancie.

Brakujące wyzwalacze i akcje są teraz wyświetlane w projektancie.

Komunikat "400 Nieprawidłowe żądanie" pojawia się w wyzwalaczu lub akcji

Gdy przebieg zakończy się niepowodzeniem i sprawdzisz przebieg w widoku monitorowania, ten błąd może pojawić się w wyzwalaczu lub akcji, która ma dłuższą nazwę, co powoduje przekroczenie domyślnego limitu znaków.

Aby rozwiązać ten problem i dostosować go do dłuższego identyfikatora URI, zmodyfikuj UrlSegmentMaxCount klucze rejestru i UrlSegmentMaxLength na komputerze, wykonując poniższe kroki. Wartości domyślne tego klucza opisano w tym temacie, Http.sys ustawienia rejestru dla systemu Windows.

Ważne

Przed rozpoczęciem upewnij się, że zapisujesz swoją pracę. To rozwiązanie wymaga ponownego uruchomienia komputera po zakończeniu, aby zmiany mogły obowiązywać.

  1. Na komputerze otwórz okno Uruchom i uruchom regedit polecenie , które spowoduje otwarcie edytora rejestru.

  2. W polu Kontrola konta użytkownika wybierz pozycję Tak, aby zezwolić na zmiany na komputerze.

  3. W okienku po lewej stronie w obszarze Komputer rozwiń węzły wzdłuż ścieżki, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters, a następnie wybierz pozycję Parametry.

  4. W okienku po prawej stronie znajdź UrlSegmentMaxCount klucze rejestru i UrlSegmentMaxLength .

  5. Zwiększ te wartości klucza na tyle, aby identyfikatory URI mogły pomieścić nazwy, których chcesz użyć. Jeśli te klucze nie istnieją, dodaj je do folderu Parameters , wykonując następujące kroki:

    1. Z menu skrótów Parametry wybierz pozycję Nowa>wartość DWORD (32-bitowa).

    2. W wyświetlonym polu edycji wprowadź UrlSegmentMaxCount nazwę nowego klucza.

    3. Otwórz menu skrótów nowego klucza i wybierz pozycję Modyfikuj.

    4. W wyświetlonym polu Edytuj ciąg wprowadź wartość klucza danych wartości, która ma być szesnastkowa lub dziesiętna. Na przykład 400 w szesnastkowym szesnastku jest odpowiednikiem 1024 liczby dziesiętnej.

    5. Aby dodać UrlSegmentMaxLength wartość klucza, powtórz te kroki.

    Po zwiększeniu lub dodaniu tych wartości klucza edytor rejestru wygląda następująco:

    Zrzut ekranu przedstawiający edytor rejestru.

  6. Gdy wszystko będzie gotowe, uruchom ponownie komputer, aby zmiany mogły obowiązywać.

Nie można uruchomić sesji debugowania

Podczas próby uruchomienia sesji debugowania zostanie wyświetlony błąd "Błąd istnieje po uruchomieniu preLaunchTask "generateDebugSymbols". Aby rozwiązać ten problem, edytuj plik tasks.json w projekcie, aby pominąć generowanie symboli.

  1. W projekcie rozwiń folder o nazwie .vscode i otwórz plik tasks.json .

  2. W poniższym zadaniu usuń wiersz , "dependsOn: "generateDebugSymbols"wraz z przecinkiem kończącym poprzedni wiersz, na przykład:

    Przed:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true,
       "dependsOn": "generateDebugSymbols"
     }
    

    Po:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true
     }
    

Następne kroki

Chcielibyśmy usłyszeć od Ciebie o doświadczeniach z rozszerzeniem usługi Azure Logic Apps (Standardowa) !