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 tematem Single-tenant versus multitenant in Azure Logic Apps (Pojedyncze dzierżawy i wielodostępne w usłudze Azure Logic Apps).

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.

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.
• Wdrażanie na platformie Azure, które obejmuje opcjonalne włączanie usługi Application Insights.
• 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 usługę Application Insights 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:

  • Dostęp do Internetu, aby móc pobrać wymagania, połączyć się z programem Visual Studio Code z kontem platformy Azure i opublikować go z programu Visual Studio Code na platformę Azure.

  • Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji, zarejestruj się w celu założenia bezpłatnego konta platformy 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.
   • Pobierz i zainstaluj każdą zależność oddzielnie.

   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ę Ustawienia preferencji>. 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 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:

      

   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ę Ustawienia preferencji>.

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

      

      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. Jeśli tworzysz zasoby aplikacji logiki z ustawieniami obsługującymi usługę Application Insights, możesz opcjonalnie 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 Insights, ale możesz utworzyć ten zasób z wyprzedzeniem, podczas tworzenia aplikacji logiki lub po wdrożeniu.

7. Zainstaluj lub użyj narzędzia, które może wysyłać żądania HTTP w celu przetestowania rozwiązania, na przykład:

   • Program Visual Studio Code z rozszerzeniem z witryny Visual Studio Marketplace
   • PowerShell Invoke-RestMethod
   • Microsoft Edge — narzędzie konsoli sieciowej
   • Bruno
   • lok

   Uwaga

   W przypadku scenariuszy, w których masz poufne dane, takie jak poświadczenia, wpisy tajne, tokeny dostępu, klucze interfejsu API i inne podobne informacje, upewnij się, że używasz narzędzia chroniącego dane przy użyciu niezbędnych funkcji zabezpieczeń, działa w trybie offline lub lokalnie, nie synchronizuje danych z chmurą i nie wymaga zalogowania się do konta online. Dzięki temu można zmniejszyć ryzyko ujawnienia poufnych danych publicznie.

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 Ustawienia preferencji > .

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

   3. Upewnij się, że wybrano opcję Automatyczne sprawdzanie aktualizacji 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 Ustawienia preferencji > .

   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:

      

Nawiąż połączenie z kontem platformy Azure

1. Na pasku działań programu Visual Studio Code wybierz 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.

   

   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.

      

      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.

   

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.

   

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.

   

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

   

   Uwaga

   Może wystąpić błąd o nazwie azureLogicAppsStandard.createNewProject z komunikatem o błędzie Nie można zapisać w ustawieniach obszaru roboczego, 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.

   

   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.

   Uwaga

   Ustawienie aplikacji FUNCTIONS_WORKER_RUNTIME jest wymagane dla aplikacji logiki w warstwie Standardowa, a wartość została wcześniej ustawiona na węzeł. Jednak wymagana wartość to teraz dotnet dla wszystkich nowych i istniejących wdrożonych aplikacji logiki w warstwie Standardowa. Ta zmiana wartości nie powinna mieć wpływu na środowisko uruchomieniowe przepływu pracy, więc wszystko powinno działać tak samo jak wcześniej. Aby uzyskać więcej informacji, zobacz ustawienie aplikacji FUNCTIONS_WORKER_RUNTIME.

   Ustawienie aplikacji APP_KIND jest wymagane dla aplikacji logiki w warstwie Standardowa, a wartość musi być przepływem pracyAplikacja. W zależności od tego, w niektórych scenariuszach, może brakować tego ustawienia aplikacji, na przykład ze względu na automatyzację przy użyciu szablonów usługi Azure Resource Manager lub innych scenariuszy, w których ustawienie nie jest uwzględnione. Jeśli niektóre akcje nie działają, takie jak akcja Wykonaj kod JavaScript lub czy przepływ pracy przestanie działać, sprawdź , czy ustawienie aplikacji APP_KIND istnieje i jest ustawione na wartość workflowApp. Aby uzyskać więcej informacji, zobacz ustawienie aplikacji APP_KIND.

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.

   

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:

Dodawanie map do projektu

Aby dodać mapy do projektu, w hierarchii projektu rozwiń węzeł Artifacts>Maps, czyli folder, w którym można umieścić 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.

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:

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

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

   

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.

   

   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.

   

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

   

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

   

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.

   

   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że 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.

   

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:

• Wyzwalacz wbudowanego łącznika żądania o nazwie Po odebraniu żądania HTTP, który może odbierać wywołania przychodzące lub żądania i tworzy punkt końcowy, który może wywoływać inne usługi lub przepływy pracy aplikacji logiki.

• Akcja łącznika zarządzanego usługi Office 365 Outlook o nazwie Wyślij wiadomość e-mail. Aby postępować zgodnie z tym przewodnikiem z instrukcjami, potrzebujesz konta e-mail usługi Office 365 Outlook. Jeśli masz konto e-mail obsługiwane przez inny łącznik, możesz użyć tego łącznika, ale środowisko użytkownika tego łącznika będzie się różnić od kroków opisanych w tym przykładzie.

• Wbudowana akcja łącznika Request (Żądanie wbudowanego łącznika) o nazwie Response (Odpowiedź), która służy do wysyłania odpowiedzi i zwracania danych z powrotem do obiektu wywołującego.

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.

   

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

   

   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.

   

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

   

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.

      

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

      

   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:

   

   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łącz klienta ngrok z kontem ngrok, uruchamiając następujące polecenie. Aby uzyskać więcej informacji, zobacz Krok 2. Łączenie konta.

   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": "dotnet",
         "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
         <...>
         "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
         <...>
      }
   }
   

   Uwaga

   Wcześniej wartością domyślną ustawienia FUNCTIONS_WORKER_RUNTIME było node. dotnet Teraz jest to wartość domyślna dla wszystkich nowych i istniejących wdrożonych aplikacji logiki w warstwie Standardowa, nawet w przypadku aplikacji, które miały inną wartość. Ta zmiana nie powinna mieć wpływu na środowisko uruchomieniowe przepływu pracy i wszystkie elementy powinny działać tak samo jak wcześniej. Aby uzyskać więcej informacji, zobacz ustawienie aplikacji FUNCTIONS_WORKER_RUNTIME.

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

      

   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>

      

   4. Skopiuj i zapisz wartość właściwości Adresu URL wywołania zwrotnego.

5. Aby przetestować adres URL wywołania zwrotnego i wyzwolić przepływ pracy, wyślij żądanie HTTP do adresu URL, w tym metodę oczekiwaną przez wyzwalacz żądania przy użyciu narzędzia żądania HTTP i jego instrukcji.

   W tym przykładzie użyto metody GET z skopiowanym adresem URL, który wygląda podobnie do następującego przykładu:

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

   Po wyzwoleniu wyzwalacza przykładowy przepływ pracy jest uruchamiany i wysyła wiadomość e-mail podobną do tego przykładu:

   

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.

   

   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.

   

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

   

   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.

   

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.

   

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ść.

      

      Po zakończeniu właściwość Treść akcji odpowiedzi jest teraz ustawiona na wartość Dane wyjściowe treść akcji 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ź.

   

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.

   

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.

   

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.

      

   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.

      

   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.

      

   6. Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Insights, opcjonalnie możesz włączyć rejestrowanie i śledzenie diagnostyczne dla 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 Insights, 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 usługi Application Insights lub Utwórz nowy zasób usługi Application Insights.

      2. W witrynie Azure Portal przejdź do zasobu usługi Application Insights.

      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": "dotnet",
               "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
            }
         }
         

         Napiwek

         Możesz sprawdzić, czy nazwy wyzwalacza i akcji są poprawnie wyświetlane w wystąpieniu usługi Application Insights.

         1. W witrynie Azure Portal przejdź do zasobu usługi Application Insights.

         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, które aplikacja logiki zbiera i wysyła do wystąpienia usługi Application Insights.

         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 logLevel Host.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.

   

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

   

   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:

• Dodaj pusty przepływ pracy do projektu.

• Zarządzanie wdrożonymi aplikacjami logiki w programie Visual Studio Code lub przy użyciu witryny Azure Portal.

• Włącz historię uruchamiania w bezstanowych przepływach pracy.

• Włącz widok monitorowania w witrynie Azure Portal dla wdrożonej aplikacji logiki.

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.

   

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 projektancie, 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.

   

   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.

   

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.

   

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

   

   Witryna Azure Portal otwiera pojedynczą stronę zasobu dla wybranej 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.

   

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.

   

   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.

   

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.

   

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.

   

   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.

   

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": "dotnet",
         "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": "dotnet",
         "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.

   

Włączanie lub otwieranie usługi Application Insights 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 Insights, 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 Insights, opcjonalnie możesz włączyć rejestrowanie i śledzenie diagnostyczne dla 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 Insights, ale możesz utworzyć ten zasób z wyprzedzeniem, podczas wdrażania aplikacji logiki lub po wdrożeniu.

Aby włączyć usługę Application Insights w wdrożonej aplikacji logiki lub przejrzeć dane usługi Application Insights 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ę Application Insights.

3. Jeśli usługa Application Insights nie jest włączona, w okienku Application Insights wybierz pozycję Włącz usługę Application Insights. Po zaktualizowaniu okienka w dolnej części wybierz pozycję Zastosuj.

   Jeśli usługa Application Insights jest włączona, w okienku Application Insights wybierz pozycję Wyświetl dane usługi Application Insights.

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

• Azure Logic Apps Running Anywhere — Monitorowanie za pomocą usługi Application Insights — część 1
• Azure Logic Apps Running Anywhere — Monitorowanie za pomocą usługi Application Insights — część 2

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

  

  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ć projektanta

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:

   

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 łączników na platformie 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:

   

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) !

• W przypadku usterek lub problemów utwórz problemy w usłudze GitHub.
• W przypadku pytań, żądań, komentarzy i innych opinii użyj tego formularza opinii.