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

Dotyczy: Azure Logic Apps (wersja 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 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ółdzielą te same zasoby i zapewniają lepszą wydajność.

  • Możesz lokalnie tworzyć, uruchamiać i testować przepływy pracy przy użyciu środowiska deweloperskiego 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 App Service Environment v3 (tylko asEv3 — plany systemu 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, Azure Kubernetes Service, lokalna lub nawet inni dostawcy usług w chmurze, ze względu na środowisko uruchomieniowe konteneryzowane usługi Azure Logic Apps. Aby uzyskać więcej informacji na temat usługi Azure Logic Apps z jedną dzierżawą, zobacz Single-tenant versus multi-tenant and integration service environment (Jednodostępne i wielodostępne środowisko usługi integracji).

Chociaż przykładowy przepływ pracy jest oparty na chmurze i ma tylko dwa kroki, możesz tworzyć przepływy pracy z setek operacji, które mogą łączyć szeroką gamę aplikacji, danych, usług i systemów w chmurze, lokalnie i środowiskach hybrydowych. Przykładowy przepływ pracy rozpoczyna się od wbudowanego wyzwalacza Żądania i następuje po akcji Office 365 Outlook. Wyzwalacz tworzy wywoływany punkt końcowy dla przepływu pracy i oczekuje na przychodzące żądanie HTTPS od 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.

Porada

Jeśli nie masz konta 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 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 Azure Portal. Obie opcje zapewniają możliwość tworzenia, uruchamiania i wdrażania przepływów pracy aplikacji logiki w tych samych środowiskach. Jednak w przypadku Visual Studio Code można lokalnie opracowywać, testować i uruchamiać przepływy pracy w środowisku projektowym.

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

W miarę postępu będziesz wykonywać 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ądzaj wdrożona aplikacją logiki w Visual Studio Code i 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ść

  • Dostęp do Internetu, aby móc pobrać wymagania, nawiązać połączenie z Visual Studio Code z kontem platformy Azure i opublikować je z Visual Studio Code na platformie 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 Office 365 Outlook, które używa Microsoft konta służbowego 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ć pod pewnymi względami. Jeśli na przykład używasz łącznika Outlook.com, użyj osobistego konta Microsoft, aby się zalogować.

Wymagania dotyczące magazynu

W przypadku lokalnego programowania w Visual Studio Code należy skonfigurować lokalny magazyn danych dla projektu aplikacji logiki i przepływy pracy, które będą używane do uruchamiania w lokalnym środowisku projektowym. Możesz użyć i uruchomić emulator magazynu Azurite jako lokalny magazyn danych.

  1. Pobierz i zainstaluj aplikację Azurite 3.12.0 lub nowszą.
  2. Przed uruchomieniem aplikacji logiki upewnij się, że emulator został uruchomiony.

Aby uzyskać więcej informacji, zapoznaj się z dokumentacją Azurite.

Narzędzia

  • Visual Studio Code, który jest bezpłatny. Ponadto pobierz i zainstaluj te narzędzia dla Visual Studio Code, jeśli jeszcze ich nie masz:

    • Rozszerzenie konta platformy Azure, które zapewnia jedno typowe środowisko filtrowania logowania i subskrypcji platformy Azure dla wszystkich innych rozszerzeń platformy Azure w Visual Studio Code.

    • Język C# dla rozszerzenia Visual Studio Code, który umożliwia uruchamianie aplikacji logiki przez funkcję F5.

    • Azure Functions Core Tools — wersja 4.x przy użyciu wersji Instalatora Microsoft (MSI), czyli func-cli-X.X.XXXX-x*.msi. Narzędzia te obejmują wersję tego samego środowiska uruchomieniowego, która obsługuje środowisko uruchomieniowe Azure Functions, którego rozszerzenie usługi Azure Logic Apps (Standard) używa w 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ą.

      • wsparcie Azure Functions w wersji 3 kończy się pod koniec 2022 r. Od połowy października 2022 r. nowe przepływy pracy standardowej aplikacji logiki w Azure Portal automatycznie używają Azure Functions v4. W listopadzie 2022 r. istniejące przepływy pracy w warstwie Standardowa w Azure Portal są automatycznie migrowane do Azure Functions v4. O ile aplikacje logiki w warstwie Standardowa nie zostały wdrożone jako projekty oparte na pakiecie NuGet lub przypięte aplikacje logiki do określonej wersji pakietu, to uaktualnienie zostało zaprojektowane tak, aby nie wymagać żadnej akcji ani mieć wpływu na środowisko uruchomieniowe. Jeśli jednak wyjątki dotyczą Ciebie lub aby uzyskać więcej informacji na temat obsługi Azure Functions w wersji 3, zobacz Azure Logic Apps Standard obsługuje teraz Azure Functions v4.

    • Rozszerzenie usługi Azure Logic Apps (Standardowa) dla Visual Studio Code.

      Ważne

      Projekty utworzone z wcześniejszymi rozszerzeniami w wersji zapoznawczej nie działają już. Aby kontynuować, odinstaluj wszystkie wcześniejsze wersje i utwórz ponownie projekty aplikacji logiki.

      Aby zainstalować rozszerzenie usługi Azure Logic Apps (Standard), wykonaj następujące kroki:

      1. W Visual Studio Code na pasku narzędzi po lewej stronie wybierz pozycję Rozszerzenia.

      2. W polu wyszukiwania rozszerzeń wprowadź .azure logic apps standard Z listy wyników wybierz pozycję Azure Logic Apps (Standardowa)>Zainstaluj.

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

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

        Porada

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

      Obecnie można mieć zainstalowane jednocześnie rozszerzenia Consumption (multi-tenant) i Standard (single-tenant). Środowiska programistyczne różnią się od siebie na kilka sposobów, ale subskrypcja platformy Azure może zawierać zarówno typy aplikacji logiki Standardowe, jak i Consumption. Visual Studio Code pokazuje wszystkie wdrożone aplikacje logiki w ramach subskrypcji platformy Azure, ale organizuje aplikacje w ramach każdego rozszerzenia, usług Azure Logic Apps (Zużycie) i Azure Logic Apps (Standardowa).

  • Aby użyć akcji Operacje kodu wbudowanego z uruchomionym językiem JavaScript, zainstaluj programNode.js w wersji 12.x.x lub 14.x.x.

    Porada

    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.

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

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

  • Jeśli tworzysz zasoby aplikacji logiki z ustawieniami, które obsługują usługę Application Insights, możesz opcjonalnie włączyć rejestrowanie diagnostyczne i śledzenie dla 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.

Konfigurowanie programu Visual Studio Code

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

  2. Upewnij się, że Visual Studio Code automatycznie odnajduje 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 Aktualizacje i automatycznej aktualizacji.

Domyślnie następujące ustawienia są włączone i ustawiane dla rozszerzenia usługi Azure Logic Apps (Standardowa):

  • Azure Logic Apps w warstwie Standardowa: środowisko uruchomieniowe projektu, które jest ustawione na wersję ~3

    Uwaga

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

  • Azure Logic Apps Standard: Eksperymentalny menedżer widoków, który umożliwia najnowszego projektanta w Visual Studio Code. Jeśli wystąpią problemy w projektancie, takie jak przeciąganie i upuszczanie elementów, wyłącz to ustawienie.

Aby znaleźć i potwierdzić te ustawienia, wykonaj następujące kroki:

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

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

    Możesz na przykład znaleźć ustawienie Azure Logic Apps Standard: Project Runtime (Standardowa usługa Azure Logic Apps: środowisko uruchomieniowe projektu ) w tym miejscu lub użyć pola wyszukiwania, aby znaleźć inne ustawienia:

    Zrzut ekranu przedstawiający ustawienia Visual Studio Code dla rozszerzenia

Nawiąż połączenie z kontem platformy Azure

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

    Zrzut ekranu przedstawiający pasek aktywności Visual Studio Code i wybraną ikonę platformy Azure.

  2. W okienku Azure w obszarze Azure: Logic Apps (Standardowa) wybierz pozycję Zaloguj się do platformy Azure. Po wyświetleniu strony uwierzytelniania Visual Studio Code zaloguj się przy użyciu konta platformy Azure.

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

    Po zalogowaniu okienko platformy Azure wyświetli subskrypcje na koncie platformy Azure. Jeśli masz również publicznie wydane rozszerzenie, możesz znaleźć wszystkie aplikacje logiki utworzone za pomocą tego rozszerzenia w sekcji Logic Apps, a nie w sekcji Logic Apps (Standardowa).

    Jeśli oczekiwane subskrypcje nie są wyświetlane lub chcesz, aby okienko wyświetlało tylko określone subskrypcje, wykonaj następujące kroki:

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

      Zrzut ekranu przedstawiający okienko platformy Azure i wybraną ikonę filtru.

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

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

Tworzenie projektu lokalnego

Przed utworzeniem aplikacji logiki utwórz projekt lokalny, aby umożliwić zarządzanie, uruchamianie i wdrażanie aplikacji logiki z poziomu Visual Studio Code. Projekt bazowy jest podobny do projektu 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 Visual Studio Code.

  2. W Visual Studio Code zamknij wszystkie otwarte foldery.

  3. W okienku Azure obok pozycji Azure: Logic Apps (Standardowa) wybierz pozycję Utwórz nowy projekt (ikona przedstawiająca folder i piorun).

    Zrzut ekranu przedstawiający pasek narzędzi okienka platformy Azure z wybraną pozycją

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

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

    Zrzut ekranu przedstawiający okno dialogowe

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

    Zrzut ekranu przedstawiający listę szablonów przepływów pracy z wybraną listą

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

    Zrzut ekranu przedstawiający pole

    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 Azure Functions dla Visual Studio Code bezpośrednio z witryny Visual Studio Marketplace lub z poziomu Visual Studio Code.

    Visual Studio Code kończy tworzenie projektu i otwiera plik workflow.json dla przepływu pracy w edytorze kodu.

    Uwaga

    Jeśli zostanie wyświetlony monit o wybranie sposobu otwierania projektu, wybierz pozycję Otwórz w bieżącym oknie, jeśli chcesz otworzyć projekt w bieżącym oknie Visual Studio Code. Aby otworzyć nowe wystąpienie dla Visual Studio Code, wybierz pozycję Otwórz w nowym oknie.

  8. Na pasku narzędzi 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 generowane pliki projektu. Na przykład projekt ma folder, który pokazuje nazwę przepływu pracy. W tym folderze plik workflow.json zawiera podstawową definicję JSON przepływu pracy.

    Zrzut ekranu przedstawiający okienko Eksplorator z folderem projektu, folderem przepływu pracy i plikiem

    W 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
    • Oparty na pakietach NuGet (.NET), który można przekonwertować na podstawie typu domyślnego

    Na podstawie tych typów projekt zawiera nieco inne foldery i pliki. Projekt oparty na programie NuGet zawiera folder .bin, który zawiera 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 korzystanie z narzędzia NuGet, zobacz Włączanie tworzenia wbudowanych łączników.

    W przypadku domyślnego projektu opartego na pakietach 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:

    Nazwa Folder lub plik Opis
    .vscode Folder Zawiera pliki ustawień związanych z Visual Studio Code, takie jak extensions.json, launch.json, settings.json i tasks.json.
    Artifacts Folder Zawiera artefakty konta integracji, które są definiowane i używane w przepływach pracy, które obsługują scenariusze 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, który zawiera podstawową definicję JSON tego przepływu pracy.
    czas projektowania przepływu pracy Folder Zawiera pliki ustawień związanych ze środowiskiem projektowym.
    .funcignore Plik Zawiera informacje dotyczące zainstalowanych narzędzi 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 platformy Azure Logic Apps z jedną dzierżawą, aplikacje logiki, przepływy pracy, wyzwalacze i akcje. 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 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, zostanie wyświetlony następujący błąd:

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

    Aby rozwiązać ten problem, 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.

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 Visual Studio Code, ale nie jest domyślnie włączona. Aby utworzyć te łączniki, należy najpierw przekonwertować projekt z opartego na pakiecie rozszerzeń (Node.js) na pakiet NuGet (.NET).

Ważne

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

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

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

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

  3. Aby kontynuować, przejrzyj i wykonaj kroki opisane w artykule Azure Logic Apps Running Anywhere — rozszerzalność wbudowanego łącznika.

Otwórz plik definicji przepływu pracy w projektancie

  1. Rozwiń folder projektu dla przepływu pracy. Otwórz menu skrótów pliku workflow.json i wybierz pozycję Otwórz w projektancie.

    Zrzut ekranu przedstawiający okienko Eksplorator i okno skrótów dla pliku workflow.json z wybraną pozycją

  2. Z listy Włącz łączniki na platformie Azure wybierz pozycję Użyj łączników z platformy Azure, która ma zastosowanie do wszystkich zarządzanych łączników dostępnych i wdrożonych na platformie Azure, a nie tylko łączników dla usług platformy Azure.

    Zrzut ekranu przedstawiający okienko Eksplorator z wybraną listą

    Uwaga

    Przepływy pracy bezstanowe obsługują obecnie tylko akcjedla łączników zarządzanych, które są wdrażane na platformie Azure, a nie wyzwalacze. 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.

  3. Z listy Wybierz subskrypcję wybierz subskrypcję platformy Azure do użycia dla projektu aplikacji logiki.

    Zrzut ekranu przedstawiający okienko Eksplorator z polem

  4. Z listy grupy zasobów wybierz pozycję Utwórz nową grupę zasobów.

    Zrzut ekranu przedstawiający okienko Eksplorator z listą grup zasobów i wybraną pozycją

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

    Zrzut ekranu przedstawiający okienko Eksplorator i nazwę grupy zasobów.

  6. Z listy lokalizacji wybierz region platformy Azure, który ma być używany podczas tworzenia grupy zasobów i zasobów. W tym przykładzie użyto zachodnio-środkowego regionu USA.

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

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

    Uwaga

    Po uruchomieniu Visual Studio Code interfejsu API czasu projektowania przepływu pracy może upłynąć 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, nie można otworzyć projektanta.

    Po wyświetleniu projektanta zostanie wyświetlony monit Wybierz operację w projektancie i jest domyślnie wybrany, co powoduje wyświetlenie okienka Dodaj akcję .

    Zrzut ekranu przedstawiający projektanta przepływu pracy.

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

Dodawanie wyzwalacza i akcji

Po otwarciu projektanta zostanie wyświetlony monit Wybierz operację w projektancie i zostanie domyślnie wybrany. Teraz możesz rozpocząć tworzenie przepływu pracy, dodając wyzwalacz i akcje.

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

  • Wbudowany wyzwalacz żądania po odebraniu żądania HTTP, który odbiera wywołania przychodzące lub żądania i tworzy punkt końcowy, który może wywoływać inne usługi lub aplikacje logiki.

  • Akcja Office 365 Outlookwyślij wiadomość e-mail.

  • Wbudowana akcja Odpowiedź, która służy do wysyłania odpowiedzi i zwracania danych z powrotem do wywołującego.

Dodawanie wyzwalacza żądania

  1. Obok projektanta w okienku Dodawanie wyzwalacza w polu wyszukiwania Wybierz operację upewnij się, że wybrano opcję Wbudowane , aby umożliwić wybranie wyzwalacza uruchamianego natywnie.

  2. W polu wyszukiwania Wybierz operację wprowadź , when a http requesta następnie wybierz wbudowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i okienko Dodawanie wyzwalacza z wybranym wyzwalaczem

    Po wyświetleniu wyzwalacza w projektancie zostanie otwarte okienko szczegółów wyzwalacza, aby wyświetlić właściwości, ustawienia i inne akcje wyzwalacza.

    Zrzut ekranu przedstawiający projektanta przepływu pracy z wybranym wyzwalaczem

    Porada

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

  3. 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 dodanego wyzwalacza wybierz znak plus (+) >Dodaj akcję.

    W projektancie zostanie wyświetlony monit Wybierz operację , a okienko Dodaj akcję zostanie ponownie otwarte, aby można było wybrać następną akcję.

  2. W okienku Dodawanie akcji w polu wyszukiwania Wybierz operację wybierz pozycję Azure , aby wybrać akcję dla łącznika zarządzanego wdrożonego na platformie Azure.

    W tym przykładzie wybiera i używa akcji Office 365 Outlook Wyślij wiadomość e-mail (wersja 2).

    Zrzut ekranu przedstawiający projektanta przepływu pracy i okienko akcji Dodaj z wybraną akcją Office 365 Outlook

  3. W okienku szczegółów akcji wybierz pozycję Zaloguj się , aby utworzyć połączenie z kontem e-mail.

    Zrzut ekranu przedstawiający projektanta przepływu pracy i okienko Wyślij wiadomość e-mail (wersja 2) z wybraną pozycję

  4. Gdy Visual Studio Code monituje o zgodę na dostęp do konta e-mail, wybierz pozycję Otwórz.

    Zrzut ekranu przedstawiający monit Visual Studio Code o zezwolenie na dostęp.

    Porada

    Aby zapobiec monitom w przyszłości, wybierz pozycję Konfiguruj zaufane domeny , aby można było dodać stronę uwierzytelniania jako zaufaną domenę.

  5. Postępuj zgodnie z kolejnymi monitami, aby zalogować się, zezwolić na dostęp i zezwolić na powrót do 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.

  6. Gdy rozszerzenie usługi Azure Logic Apps (Standard) wyświetli monit o zgodę na dostęp do konta e-mail, wybierz pozycję Otwórz. Postępuj zgodnie z kolejnym monitem, aby zezwolić na dostęp.

    Zrzut ekranu przedstawiający monit rozszerzenia o zezwolenie na dostęp.

    Porada

    Aby zapobiec monitom w przyszłości, wybierz pozycję Nie pytaj ponownie o to rozszerzenie.

    Po utworzeniu połączenia Visual Studio Code niektóre łączniki pokazują komunikat .The connection will be valid for {n} days only Ten limit czasu dotyczy tylko czasu trwania podczas tworzenia aplikacji logiki w Visual Studio Code. Po wdrożeniu ten limit nie ma już zastosowania, ponieważ aplikacja logiki 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 parametrów 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.

  7. Jeśli w projektancie nie jest wyświetlana akcja Wyślij wiadomość e-mail , wybierz tę akcję.

  8. W okienku szczegółów akcji na karcie Parametry podaj wymagane informacje dotyczące akcji, na przykład:

    Zrzut ekranu przedstawiający projektanta przepływu pracy ze szczegółami akcji Office 365 Outlook

    Właściwość Wymagany Wartość Opis
    Do Tak <twój adres e-mail> 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: sophiaowen@fabrikam.com.
    Temat Tak An email from your example workflow Temat wiadomości e-mail
    Treść Tak Hello from your example workflow! Zawartość treści wiadomości e-mail

    Uwaga

    Jeśli chcesz wprowadzić jakiekolwiek zmiany w okienku szczegółów na karcie Ustawienia, Wynik statyczny lub Uruchom po , upewnij się, że przed przełączenie kart lub zmiana fokusu na projektanta wybierz pozycję Gotowe , aby zatwierdzić te zmiany. W przeciwnym razie Visual Studio Code nie zachowa zmian.

  9. W projektancie wybierz pozycję Zapisz.

Ważne

Aby lokalnie uruchomić przepływ pracy, który używa 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.

Włączanie lokalnie uruchomionych elementów webhook

Jeśli używasz wyzwalacza lub akcji opartej na elemecie webhook opartym na elemecie webhook protokołu HTTP z aplikacją logiki uruchomioną na platformie Azure, środowisko uruchomieniowe usługi 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 następnie czeka na wywołanie adresu URL przez punkt końcowy usługi. Jednak podczas pracy w 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, dzięki czemu punkt końcowy usługi nie może wywołać tego adresu URL.

Aby lokalnie uruchamiać wyzwalacze i akcje oparte na elementach webhook w 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. Utwórz konto ngrok, jeśli go nie masz. W przeciwnym razie zaloguj się do swojego konta.

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

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

    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 do portu localhost 7071, uruchamiając następujące polecenie. Aby uzyskać więcej informacji, zobacz Krok 3. Wyzwol go.

    ngrok http 7071

  7. W 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 Visual Studio Code w projektancie dodaj wyzwalacz lub akcję http + element webhook.

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

    Uwaga

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

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

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

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

    Uwaga

    Jeśli projekt jest oparty na pakietach NuGet (.NET), a nie oparty na pakiecie rozszerzeń (Node.js), "FUNCTIONS_WORKER_RUNTIME" jest ustawiony na "dotnet"wartość . Jednak aby można było używać operacji kodu wbudowanego, musisz ustawić "FUNCTIONS_WORKER_RUNTIME" wartość na "node"

Przy pierwszym uruchomieniu lokalnej sesji debugowania lub uruchomieniu przepływu pracy bez debugowania środowisko uruchomieniowe usługi Logic Apps rejestruje przepływ pracy z punktem końcowym usługi i subskrybuje ten punkt końcowy w celu powiadamiania o operacjach 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 w oknie terminalu mogą pojawić się 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 zostanie osiągnięty 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 zostanie wyświetlony po lewej stronie okna kodu, a pasek narzędzi Debugowanie pojawi się w górnej części.

    Uwaga

    Jeśli widok Uruchom nie jest automatycznie wyświetlany, naciśnij klawisze Ctrl+Shift+D.

  3. Aby przejrzeć dostępne informacje, gdy punkt przerwania zostanie osiągnięty, 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 plik workflow.json zostanie zaktualizowany 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ć aplikację 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. Na pasku działań 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.

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

    1. Otwórz ponownie okienko Eksplorator, aby można było wyświetlić projekt.

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

      Zrzut ekranu przedstawiający okienko Eksploratora i okno skrótów dla pliku workflow.json z wybraną pozycją

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

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

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

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

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

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

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

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

    3. W oknie Zapisywanie żądania w obszarze Nazwa żądania podaj nazwę żądania, na przykład Test workflow trigger.

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

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

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

      Zrzut ekranu przedstawiający narzędzie Postman z otwartym okienkiem żądania

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

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

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

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

      Zrzut ekranu przedstawiający pocztę e-mail programu Outlook zgodnie z opisem w przykładzie

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

    Porada

    Jeśli stan uruchomienia nie zostanie wyświetlony, spróbuj odświeżyć stronę przeglądu, wybierając pozycję Odśwież. Żaden przebieg nie występuje dla wyzwalacza, który został pominięty z powodu niezaspokojonych kryteriów lub znalezienia żadnych danych.

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

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

    Stan uruchomienia Opis
    Zostało przerwane Przebieg został zatrzymany lub nie został ukończony z powodu problemów zewnętrznych, na przykład awarii systemu lub zakończenia subskrypcji platformy Azure.
    Anulowane Przebieg został wyzwolony i uruchomiony, ale otrzymał żądanie anulowania.
    Niepowodzenie 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óry jest ograniczany z powodu limitów akcji lub bieżącego planu cenowego.

    Porada: Jeśli skonfigurujesz rejestrowanie diagnostyczne, możesz uzyskać informacje o wszelkich zdarzeniach ograniczania, 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 uruchomień 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 uruchomień w dniach, przebieg zostanie wyczyszczone z historii przebiegów przez codzienne zadanie oczyszczania. Niezależnie od tego, czy limit czasu uruchomienia jest przekroczony, czy ukończony, 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.

    Oczekiwanie Uruchomienie nie zostało uruchomione lub wstrzymane, na przykład ze względu na wcześniejsze wystąpienie przepływu pracy, które nadal działa.
  6. Aby przejrzeć stan każdego kroku w określonym przebiegu oraz dane wejściowe i wyjściowe kroku, wybierz przycisk wielokropka (...), a następnie wybierz przycisk Pokaż przebieg.

    Zrzut ekranu przedstawiający wiersz historii uruchamiania przepływu pracy z przyciskiem wielokropka i wybraną opcję

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

    Zrzut ekranu przedstawiający każdy krok w przebiegu przepływu pracy i ich stan

    Uwaga

    Jeśli przebieg zakończył się niepowodzeniem, a krok w widoku monitorowania pokazuje 400 Bad Request błąd, ten problem może wynikać z dłuższej nazwy wyzwalacza lub nazwy akcji, która powoduje przekroczenie domyślnego limitu znaków. Aby uzyskać więcej informacji, zobacz "400 Nieprawidłowe żądanie".

    W poniższej tabeli przedstawiono możliwe stany, które każda akcja przepływu pracy może zawierać i wyświetlać w Visual Studio Code:

    Stan akcji Opis
    Zostało przerwane Akcja została zatrzymana lub zakończona z powodu problemów zewnętrznych, na przykład awarii systemu lub zakończenia subskrypcji platformy Azure.
    Anulowane Akcja została uruchomiona, ale odebrano żądanie anulowania.
    Niepowodzenie 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 powiodła się, ale tylko po jednej lub kilku ponownych próbach. Aby przejrzeć historię ponawiania prób, w widoku szczegółów historii uruchamiania wybierz tę akcję, aby można było 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.
    Oczekiwanie Dotyczy akcji elementu webhook, która oczekuje na żądanie przychodzące od obiektu wywołującego.
  7. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, wybierz krok, który chcesz sprawdzić.

    Zrzut ekranu przedstawiający stan każdego kroku w przepływie pracy oraz dane wejściowe i wyjściowe w rozwiniętej akcji

  8. Aby dokładniej zapoznać się z nieprzetworzonymi danymi wejściowymi i wyjściowymi 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

Aby zwrócić odpowiedź na obiekt wywołujący, który wysłał żądanie do aplikacji logiki, możesz użyć wbudowanej akcji Odpowiedź dla przepływu pracy rozpoczynającego się od wyzwalacza Żądania.

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

    W projektancie zostanie wyświetlony monit Wybierz operację , a okienko Dodaj akcję zostanie ponownie otwarte, aby można było wybrać następną akcję.

  2. W okienku Dodawanie akcji w polu wyszukiwania Wybierz akcję upewnij się, że wybrano opcję Wbudowane . W polu wyszukiwania wprowadź , responsea następnie wybierz akcję Odpowiedź .

    Zrzut ekranu przedstawiający projektanta przepływu pracy z wybraną akcją Odpowiedź.

    Po wyświetleniu akcji Odpowiedź w projektancie zostanie automatycznie otwarte okienko szczegółów akcji.

    Zrzut ekranu przedstawiający projektanta przepływu pracy z otwartym okienkiem szczegółów akcji

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

    W tym przykładzie zwraca wartość właściwości Body , która jest wyjściowa z akcji Wyślij wiadomość e-mail .

    1. Kliknij wewnątrz pola właściwości Treść , aby wyświetlić listę zawartości dynamicznej i wyświetlić dostępne wartości wyjściowe z poprzedniego wyzwalacza i akcji w przepływie pracy.

      Zrzut ekranu przedstawiający okienko szczegółów akcji

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

      Zrzut ekranu przedstawiający otwartą listę zawartości dynamicznej. Na liście w nagłówku

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

      Zrzut ekranu przedstawiający stan każdego kroku w przepływie pracy oraz dane wejściowe i wyjściowe w rozwiniętej akcji

  4. W projektancie wybierz pozycję Zapisz.

Ponowne testowanie aplikacji logiki

Po wprowadzeniu aktualizacji 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ń 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 najnowszego przebiegu. 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ż uruchom.

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

    Zrzut ekranu przedstawiający stan każdego kroku w zaktualizowanym przepływie pracy oraz dane wejściowe i wyjściowe w rozwiniętej akcji

  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 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 jest tworzony 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ę za pomocą tych informacji.

    Ten przykładowy plik connections.json zawiera dwa połączenia, połączenie AS2 i połączenie Office 365 z następującymi connectionRuntimeUrl wartościami:

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

    • Usługa 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

Z poziomu Visual Studio Code możesz bezpośrednio opublikować projekt na platformie Azure, który wdraża aplikację logiki przy użyciu typu zasobu aplikacja logiki (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, podobnie jak wymagania aplikacji funkcji. Możesz też opublikować aplikację logiki w wcześniej wdrożonym zasobie aplikacji logiki (Standardowa), który zastępuje aplikację logiki.

Wdrożenie typu zasobu aplikacji logiki (w warstwie Standardowa) wymaga planu hostingu i warstwy cenowej wybranej podczas wdrażania. Aby uzyskać więcej informacji, zobacz Plany hostingu i warstwy cenowe.

Publikowanie w nowym zasobie aplikacji logiki (w warstwie Standardowa)

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

  2. Na pasku narzędzi okienka Azure: Logic Apps (Standardowa) wybierz pozycję Wdróż w aplikacji logiki.

    Zrzut ekranu przedstawiający okienko

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

  4. Z listy, która zostanie otwarta Visual Studio Code, wybierz spośród następujących opcji:

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

    W tym przykładzie nadal jest tworzona nowa aplikacja logiki (Standardowa) w usłudze Azure Advanced.

    Zrzut ekranu przedstawiający okienko

  5. Aby utworzyć nowy zasób aplikacji logiki (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 wartości Fabrikam-Workflows-App.

      Zrzut ekranu przedstawiający okienko

    2. Wybierz plan hostingu dla nowej aplikacji logiki. Utwórz nazwę planu lub wybierz istniejący plan. W tym przykładzie wybrano pozycję Utwórz nowy plan App Service.

      Zrzut ekranu przedstawiający okienko

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

      Aby uzyskać więcej informacji, zobacz 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ć lub użyć innej grupy zasobów, może to mieć wpływ na wydajność. Jeśli tworzysz lub wybierasz inną grupę zasobów, ale anuluj po wyświetleniu monitu o potwierdzenie wdrożenie zostanie również anulowane.

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

      Zrzut ekranu przedstawiający okienko

    6. Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Insights, możesz opcjonalnie włączyć rejestrowanie diagnostyczne i śledzenie aplikacji logiki. Można to zrobić podczas wdrażania aplikacji logiki z 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 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 Visual Studio Code w folderze głównym projektu otwórz plik local.settings.json.

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

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

        Porada

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

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

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

        3. Przejrzyj nazwy operacji wyświetlane na mapie.

        Niektóre żądania przychodzące z wbudowanych wyzwalaczy mogą pojawiać się jako duplikaty w mapie aplikacji. Zamiast używać formatu, te duplikaty używają WorkflowName.ActionName nazwy przepływu pracy jako nazwy operacji i pochodzą z hosta Azure Functions.

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

        Za każdym razem, gdy wystąpi 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, powodzenie i niepowodzenie.
        • Wszelkie ślady programowania, takie jak komunikaty debugowania.

        Każdy typ zdarzenia jest przypisany 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 opisujące nieodwracalny błąd w aplikacji logiki.
        Debugowanie Dzienniki, których można użyć do badania podczas programowania, na przykład przychodzące i wychodzące wywołania HTTP.
        Błąd Dzienniki wskazujące błąd podczas wykonywania przepływu pracy, ale nie ogólny błąd w aplikacji logiki.
        Informacje Dzienniki, które śledzą ogólne działania w aplikacji logiki lub przepływie pracy, na przykład:

        — Po uruchomieniu wyzwalacza, akcji lub uruchomieniu rozpoczyna się i kończy.
        — Po uruchomieniu lub zakończeniu aplikacji logiki.

        Ślad 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 kontroluje filtrowanie dzienników dla wszystkich przepływów pracy w aplikacji logiki i jest zgodny z układem ASP.NET Core filtrowania typów dzienników.

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

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

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

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

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

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

    Po zakończeniu wdrażania aplikacji logiki na platformie Azure Visual Studio Code zostanie wyświetlony następujący komunikat:

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

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

Następnie dowiesz się, jak wykonywać następujące zadania:

Dodawanie pustego przepływu pracy do projektu

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

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

  2. W okienku Azure obok pozycji Azure: Logic Apps (Standardowa) wybierz pozycję Utwórz przepływ pracy (ikona usługi Azure Logic Apps).

  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 Visual Studio Code

W Visual Studio Code można wyświetlić wszystkie wdrożone aplikacje logiki w ramach subskrypcji platformy Azure, niezależnie od tego, czy są to oryginalne aplikacje logiki, czy typ zasobu aplikacji logiki (Standardowa) i wybierać zadania, które ułatwiają zarządzanie tymi aplikacjami logiki. Jednak aby uzyskać dostęp do obu typów zasobów, potrzebujesz zarówno rozszerzeń usługi Azure Logic Apps, jak i rozszerzeń usługi Azure Logic Apps (Standard) dla Visual Studio Code.

  1. Na lewym pasku narzędzi wybierz ikonę platformy Azure. W okienku Azure: Logic Apps (Standardowa) rozwiń swoją subskrypcję, która zawiera wszystkie wdrożone aplikacje logiki 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żesz 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ć przy użyciu 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, zobacz Zagadnienia dotyczące zatrzymywania aplikacji logiki i zagadnień dotyczących usuwania aplikacji logiki.

    Zrzut ekranu przedstawiający Visual Studio Code z otwartym okienkiem rozszerzenia

  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, który otwiera przepływ pracy w trybie tylko do odczytu.

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

    • W 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 Azure Portal otwórz aplikację logiki. Następnie możesz otworzyć, edytować i zapisać przepływ pracy.

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

    Azure Portal zostanie otwarty w przeglądarce, zaloguje się do portalu automatycznie, jeśli zalogowałeś się do Visual Studio Code i wyświetli aplikację logiki.

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

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

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

Zagadnienia dotyczące zatrzymywania aplikacji logiki

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

  • Usługa Azure Logic Apps anuluje wszystkie uruchomienia w toku i oczekujące uruchomienia 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. Jednak stany wyzwalacza pamiętają 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. W Visual Studio Code na lewym pasku narzędzi wybierz ikonę platformy Azure.
    2. W okienku Azure: Logic Apps (Standardowa) rozwiń swoją 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 resetuje bieżący stan 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, należy 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 dla ponownie utworzonych przepływów pracy. W przeciwnym razie wywołania ponownego 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 Azure Portal z Visual Studio Code można wyświetlić wszystkie wdrożone aplikacje logiki, które znajdują się w subskrypcji platformy Azure, niezależnie od tego, czy są to oryginalny typ zasobu usługi Logic Apps, czy typ zasobu aplikacji logiki (Standardowa). Obecnie każdy typ zasobu jest zorganizowany i zarządzany jako oddzielne kategorie na platformie Azure. Aby znaleźć aplikacje logiki, które mają typ zasobu aplikacji logiki (Standardowa), wykonaj następujące kroki:

  1. W polu wyszukiwania Azure Portal wprowadź .logic apps Po wyświetleniu listy wyników w obszarze Usługi wybierz pozycję Aplikacje logiki.

    Zrzut ekranu przedstawiający pole wyszukiwania Azure Portal z tekstem wyszukiwania

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

    Zrzut ekranu przedstawiający Azure Portal i zasoby aplikacji logiki (Standardowa) wdrożone na platformie Azure.

    Azure Portal otwiera stronę pojedynczego zasobu dla wybranej aplikacji logiki.

    Zrzut ekranu przedstawiający stronę zasobu przepływu pracy aplikacji logiki w Azure Portal.

  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 przedstawiono przepływ pracy utworzony w Visual Studio Code.

    Zrzut ekranu przedstawiający stronę zasobu

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

    Zostanie otwarte okienko przepływu pracy i zostanie wyświetlone więcej informacji i zadań, które można wykonać w tym przepływie pracy.

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

    Zrzut ekranu przedstawiający okienko

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

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

Dodawanie innego przepływu pracy w portalu

Za pomocą Azure Portal można dodawać puste przepływy pracy do zasobu aplikacji logiki (Standardowa) wdrożonego z Visual Studio Code i tworzyć te przepływy pracy w Azure Portal.

  1. W Azure Portal wybierz wdrożony zasób aplikacji logiki (Standardowa).

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

    Zrzut ekranu przedstawiający okienko

  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 pojawi się w okienku Przepływy pracy , wybierz ten przepływ pracy, aby zarządzać innymi zadaniami, takimi jak otwieranie projektanta lub widoku kodu.

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

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

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

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

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

  1. W projekcie Visual Studio Code rozwiń folder o nazwie workflow-designtime i otwórz plik local.settings.json.

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

    Windows

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

    macOS lub Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    
  3. 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 Azure Portal

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

  1. W Azure Portal wybierz wdrożony zasób aplikacji logiki (Standardowa).

  2. W menu tego zasobu w obszarze INTERFEJS API wybierz pozycję CORS.

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

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

    Zrzut ekranu przedstawiający Azure Portal z wdrożonym zasobem aplikacji logiki (Standardowa). W menu zasobów wybrano pozycję

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. Dzięki tej telemetrii można uzyskać lepszy wgląd w przebieg przepływu pracy i sposób działania środowiska uruchomieniowego 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 błędów i problemów z wydajnością, gdy te dane są używane do diagnozowania problemów, konfigurowania alertów i wykresów kompilacji.

Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Insights, możesz opcjonalnie włączyć rejestrowanie diagnostyczne i śledzenie aplikacji logiki. Można to zrobić podczas wdrażania aplikacji logiki z Visual Studio Code lub po wdrożeniu. Musisz mieć wystąpienie usługi Application Insights, ale ten zasób można utworzyć 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 tej funkcji, wykonaj następujące kroki:

  1. W 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:

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), a następnie wybierz pozycję Usuń. Aby potwierdzić, wybierz pozycję OK.

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

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

    Zrzut ekranu przedstawiający wybrany element w projektancie z otwartym okienkiem szczegółów oraz wybranym przyciskiem wielokropka i poleceniem

    Porada

    Jeśli menu wielokropka nie jest widoczne, rozwiń Visual Studio Code okno wystarczająco szerokie, 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 jest wyświetlany ten błąd "Nie można uruchomić czasu projektowania przepływu pracy". Jeśli wcześniej próbowano otworzyć projektanta, a następnie wycofano lub usunięto projekt, pakiet rozszerzeń może nie być pobierany poprawnie. Aby sprawdzić, czy przyczyną jest problem, wykonaj następujące kroki:

  1. W 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 wyświetlić dane wyjściowe z rozszerzenia, na przykład:

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

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

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

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

Brak nowych wyzwalaczy i akcji w selektorze projektanta dla wcześniej utworzonych 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 Visual Studio Code używa nieaktualnej wersji pakietu rozszerzeń. Microsoft.Azure.Functions.ExtensionBundle.Workflows

Ponadto łącznik i akcje operacji funkcji platformy Azure nie są wyświetlane w selektorze projektanta, chyba że podczas tworzenia aplikacji logiki wybrano opcję Użyj łączników z platformy Azure . Jeśli łączniki wdrożone na platformie Azure nie zostały włączone w czasie tworzenia aplikacji, możesz je włączyć z projektu w 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 Visual Studio Code automatycznie aktualizować pakiet rozszerzeń do najnowszej wersji.

Uwaga

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

  1. Zapisz 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 dla wersji 1.1.3, usuń ten folder.

  4. Teraz przejdź do następującego folderu, który zawiera foldery w wersji 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 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

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

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 , co 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. W 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 w 400 formacie szesnastkowym 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 będzie wyglądać następująco:

    Zrzut ekranu przedstawiający edytor rejestru.

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

Nie można uruchomić sesji debugowania

Podczas próby uruchomienia sesji debugowania jest wyświetlany 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 (standard) !