Tworzenie przepływu pracy integracji z jedną dzierżawą Azure Logic Apps (standardowa) w Visual Studio Code

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

  2. W Visual Studio Code zamknij wszystkie otwarte foldery.

  3. W okienku Azure obok opcji Azure: Logic Apps (Standardowa)wybierz pozycję Utwórz nowy Project (ikona z folderem i ikoną pioruna).

    Zrzut ekranu przedstawiający pasek narzędzi okienka Platformy Azure z wybranym Project

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

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

    Zrzut ekranu przedstawiający okno dialogowe

  6. Z wyświetlonej listy szablonów wybierz pozycję Stateful Workflow (Stanowy przepływ pracy) lub Stateless Workflow (Bez stanowy przepływ pracy). W tym przykładzie jest wybierany stanowy przepływ pracy.

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

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

    Zrzut ekranu przedstawiający pola

    Visual Studio Code zakończy tworzenie projektu i otworzy 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 Visual Studio Code oknie. Aby otworzyć nowe wystąpienie usługi Visual Studio Code, wybierz pozycję Otwórz w nowym oknie.

  8. Na pasku Visual Studio narzędzi otwórz okienko Eksplorator, jeśli nie zostało jeszcze otwarte.

    W okienku Explorer (Eksplorator) jest dostępny projekt, który teraz zawiera automatycznie generowane pliki projektu. Na przykład projekt ma folder, który pokazuje nazwę przepływu pracy. Wewnątrz tego folderu 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:

    • Rozszerzenie oparte na pakiecie (Node.js), który jest typem domyślnym
    • NuGet oparty na pakiecie (.NET), który można przekonwertować z typu domyślnego

    W zależności od tych typów projekt zawiera nieco inne foldery i pliki. Projekt 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ą NuGet projektu opartego na interfejsie użytkownika, na przykład gdy chcesz tworzyć i uruchamiać niestandardowe operacje wbudowane. Aby uzyskać więcej informacji na temat konwertowania projektu do używania NuGet, zapoznaj się z tematem Włączanie tworzenia łączników wbudowanych.

    W przypadku domyślnego projektu opartego na pakiecie projekt ma strukturę folderów i plików podobną do następującego 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 Visual Studio Code ustawień, takie jak extensions.json,launch.json,settings.jsoni tasks.json.
    Artifacts Folder Zawiera artefakty konta integracji, które definiujesz i używasz w przepływach pracy, które obsługują scenariusze B2B (business-to-business). Na przykład przykładowa struktura zawiera mapy i schematy dla operacji przekształcania i walidacji kodu XML.
    Nazwa przepływu pracy Folder Dla każdego przepływu pracy folder << zawiera plik >> który zawiera bazową definicję JSON tego przepływu pracy.
    workflow-designtime Folder Zawiera pliki ustawień związanych ze środowiskiem dewelopera.
    .funcignore Plik Zawiera informacje związane z zainstalowanym Azure Functions Core Tools.
    connections.json Plik Zawiera metadane, punkty końcowe i klucze dla wszystkich połączeń zarządzanych i funkcji platformy Azure, których używają przepływy pracy.

    Ważne:Aby użyć różnych połączeń i funkcji dla każdego środowiska, upewnij się, że parametryzowanie tego pliku connections.json i zaktualizowanie punktów końcowych.

    host.json Plik Zawiera ustawienia i wartości konfiguracji specyficzne dla środowiska uruchomieniowego, na przykład domyślne limity dla platformy Azure Logic Apps pojedynczej dzierżawy, 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, których wszystkie przepływy pracy w tej samej aplikacji logiki używają podczas uruchamiania lokalnie lub na platformie Azure.

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

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

    Aby usunąć ten błąd, usuń dodatkowe pliki migawek z kontenera magazynu.

    local.settings.json Plik Zawiera ustawienia aplikacji, parametry połączenia i inne ustawienia, których przepływy pracy używają 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 używane przez lokalne narzędzia programskie jako wartości. Możesz wywołać te zmienne środowiskowe i odwoływać się do nich zarówno w czasie wykonywania, jak i podczas wdrażania przy użyciu ustawień iparametrów aplikacji.

    Ważne:plik local.settings.json może zawierać wpisy tajne, dlatego pamiętaj, aby wykluczyć ten plik z kontroli źródła projektu.

Włączanie tworzenia łączników wbudowanych

Możesz utworzyć własne wbudowane łączniki dla dowolnej potrzebnej usługi, korzystając z jednej dzierżawy Azure Logic Apps struktury rozszerzalności. Podobnie jak w przypadku łączników wbudowanych, takich jak usługi Azure Service Bus i SQL Server, te łączniki zapewniają wyższą przepływność, małe opóźnienia, łączność lokalną i działają natywnie w tym samym procesie co środowisko uruchomieniowe z Azure Logic Apps dzierżawy.

Możliwość tworzenia jest obecnie dostępna tylko w Visual Studio Code, ale nie jest domyślnie włączona. Aby utworzyć te łączniki, musisz najpierw przekonwertować projekt z opartego na pakiecie rozszerzeń (Node.js) na NuGet oparty na pakietach (.NET).

Ważne

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

  1. W okienku Eksploratora w katalogu głównym projektu przesuń wskaźnik myszy na dowolny pusty obszar pod wszystkimi innymi plikami i folderami, otwórz menu skrótów i wybierz pozycję Konwertuj na projekt aplikacji logiki opartej na nugetach.

    Zrzut ekranu przedstawiający okienko Eksplorator z menu skrótów projektu otwieranym 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 — Built-in connector extensibility(Uruchamianie w dowolnym miejscu — rozszerzalność wbudowanego łącznika).

Otwieranie pliku definicji przepływu pracy w projektancie

  1. Sprawdź wersje zainstalowane na komputerze, uruchamiając to polecenie:

    ..\Users\{yourUserName}\dotnet --list-sdks

    Jeśli masz już zestaw .NET Core SDK 5.x, ta wersja może uniemożliwić otwarcie podstawowej definicji przepływu pracy aplikacji logiki w projektancie. Zamiast odinstalowywać tę wersję, w folderze głównym projektu utwórz plik global.json, który odwołuje się do posiadanej wersji środowiska uruchomieniowego .NET Core 3.x nowszej niż 3.1.201, na przykład:

    {
       "sdk": {
          "version": "3.1.8",
          "rollForward": "disable"
       }
    }
    

    Ważne

    Upewnij się, że jawnie dodasz plik global.json w folderze głównym projektu z folderu Visual Studio Code. W przeciwnym razie projektant nie zostanie otwarty.

  2. Rozwiń folder projektu dla przepływu pracy. Otwórz menu skrótów pliku workflow.json, a następnie wybierz pozycję Otwórz w projektancie.

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

  3. Z listy Włączanie łączników na platformie Azure wybierz pozycję Użyj łączników z platformy Azure,która ma zastosowanie do wszystkich łączników zarządzanych, które są dostępne i wdrożone na platformie Azure, a nie tylko łączników dla usług platformy Azure.

    Zrzut ekranu przedstawiający okienko Eksploratora z otwartą listą

    Uwaga

    Bez stanowe przepływy pracy obsługują obecnie tylko akcje dla zarządzanychłączników , które są wdrażane na platformie Azure, a nie wyzwalacze. Mimo że masz możliwość włączenia łączników na platformie Azure dla bez stanowego przepływu pracy, projektant nie pokazuje żadnych wyzwalaczy łącznika zarządzanego do wyboru.

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

    Zrzut ekranu przedstawiający okienko Eksplorator z polem

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

    Zrzut ekranu przedstawiający okienko Eksplorator z listą grup zasobów i wybranymi opcjami

  6. 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 pole nazwy grupy zasobów.

  7. Z listy lokalizacji wybierz region platformy Azure do użycia podczas tworzenia grupy zasobów i zasobów. W tym przykładzie użyto zachodnio-środkowych stanów USA.

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

    Po zakończeniu tego kroku Visual Studio Code projektanta przepływu pracy.

    Uwaga

    Po Visual Studio Code interfejsu API czasu projektowania przepływu pracy może zostać wyświetlony komunikat informujący o tym, że uruchomienie może potrwać kilka sekund. Możesz zignorować ten komunikat lub wybrać przycisk OK.

    Jeśli projektant nie otworzy się, przejrzyj sekcję rozwiązywania problemów. Projektant nie może otworzyć .

    Po wyświetleniu projektanta w projektancie zostanie wyświetlony monit Wybierz operację i zostanie on domyślnie wybrany, co pokazuje okienko Dodaj akcję.

    Zrzut ekranu przedstawiający projektanta przepływu pracy.

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

Dodawanie wyzwalacza i akcji

Po otwarciu projektanta w projektancie zostanie wyświetlony monit Wybierz operację i zostanie on 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 tych akcji:

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

  • Akcja Office 365 Outlook ,Wyślij wiadomość e-mail.

  • Wbudowana akcja Odpowiedź ,która umożliwia wysłanie odpowiedzi i zwrócenie danych do wywołującego.

Dodawanie wyzwalacza Żądania

  1. Obok projektanta w okienku Dodawanie wyzwalacza w polu wyszukiwania Wybierz operację upewnij się, że jest zaznaczona opcja Wbudowane, aby można było wybrać wyzwalacz uruchamiany natywnie.

  2. W polu wyszukiwania Wybierz operację wprowadź i wybierz wbudowany wyzwalacz Żądanie o nazwie Po otrzymaniu żądania HTTP.

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

    Gdy wyzwalacz pojawi się w projektancie, zostanie otwarte okienko szczegółów wyzwalacza, w którym będą wyświetlane 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 jest wyświetlane, 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 Office 365 Outlook akcji

  1. W projektancie w obszarze dodanego wyzwalacza wybierz znak plus ( + ) >+.

    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 Dodaj akcję w polu wyszukiwania Wybierz operację wybierz pozycję Azure, aby wybrać akcję dla łącznika zarządzanego wdrożonego na platformie Azure.

    W tym przykładzie zostanie wybrane i Office 365 Outlook akcji Wyślij wiadomość e-mail (V2).

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

  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 (V2) z wybraną pozycję

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

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

    Porada

    Aby uniknąć przyszłych monitów, wybierz pozycję Konfiguruj zaufane domeny, aby można było dodać stronę uwierzytelniania jako zaufaną domenę.

  5. Postępuj zgodnie z kolejnymi monitami, aby się zalogować, zezwolić na dostęp i zezwolić na powrót Visual Studio Code.

    Uwaga

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

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

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

    Porada

    Aby uniknąć przyszłych monitów, wybierz pozycję Nie pytaj ponownie o to rozszerzenie.

    Po Visual Studio Code połączenia niektóre łączniki pokazują komunikat z komunikatem 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ż stosowania, 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, które są używane podczas tworzenia połączenia. Jeśli wyłączysz tę przypisaną przez system tożsamość zarządzaną, połączenia nie będą działać w czasie wykonywania.

  7. W projektancie, jeśli akcja Wyślij wiadomość e-mail nie jest wyświetlana, 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 Office 365 Outlook akcji

    Właściwość Wymagany Wartość Opis
    Do Tak <<> 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, Static Resultlub Run After (Uruchom po), upewnij się, że wybierasz pozycję Gotowe, aby zatwierdzić te zmiany przed przełączeniem kart lub zmianą fokusu na projektanta. W przeciwnym Visual Studio Code zmiany nie zostaną wprowadzone.

  9. W projektancie wybierz pozycję Zapisz.

Ważne

Aby lokalnie uruchomić przepływ pracy, który używa wyzwalacza lub akcji opartych na webhookach, takich jak wbudowany wyzwalacz lub akcja http webhook,należy włączyć tę możliwość, ustawiając przekazywanie dla adresu URLwywołania zwrotnego.

Włączanie lokalnie uruchomionych webhook

Jeśli używasz wyzwalacza lub akcji opartej na webhook,takiej jak http webhook, z aplikacją logiki uruchomianą 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 w tym punkcie końcowym. Wyzwalacz lub akcja czeka na wywołanie adresu URL przez punkt końcowy usługi. Jednak podczas pracy z programem Visual Studio Code, wygenerowany adres URL wywołania zwrotnego rozpoczyna się od http://localhost:7071/... . Ten adres URL dotyczy serwera hosta lokalnego, 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 webhook w usłudze 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. Możesz użyć usługi przesyłania dalej i narzędzia, takiego jak ngrok, który otwiera tunel HTTP do portu hosta lokalnego, lub użyć własnego równoważnego narzędzia.

Konfigurowanie przekazywania wywołań przy użyciu narzędzia ngrok

  1. Zarejestruj się, aby uzyskać konto ngrok, jeśli go nie masz. W przeciwnym razie zaloguj się do swojego konta.

  2. Pobierz osobisty token uwierzytelniania, którego klient ngrok potrzebuje do nawiązania połączenia i uwierzytelnienia dostępu do konta.

    1. Aby znaleźć stronę tokenu uwierzytelniania, w menu pulpitu nawigacyjnego konta rozwiń pozycję Uwierzytelnianiei wybierz pozycję Twój uwierzytelniony .

    2. Z pola Your Authtoken (Twój uwierzytelniony token) skopiuj token do bezpiecznej lokalizacji.

  3. Ze strony pobierania ngrok lub pulpitu nawigacyjnego konta pobierz wersję ngrok i wyodrębnij .zip plik. Aby uzyskać więcej informacji, zobacz Krok 1. Rozpakuj, aby zainstalować program.

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

  5. Połączenie klienta ngrok do konta ngrok, uruchamiając następujące polecenie. Aby uzyskać więcej informacji, zobacz Krok 2. Połą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. Odpal 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 w tym formacie: http://<domain>.ngrok.io

Konfigurowanie adresu URL przekazywania w ustawieniach aplikacji

  1. W Visual Studio Code w projektancie dodaj wyzwalacz lub akcję HTTP + Webhook.

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

    Uwaga

    Zignorowanie monitu powoduje, że pojawi się ostrzeżenie, że musisz podać adres URL przekazywania, więc wybierz pozycję Konfiguruji wprowadź adres URL. Po ukończeniu tego kroku monit nie będzie ponownie wyświetlany dla kolejnych wyzwalaczy lub akcji, które można dodać.

    Aby ponownie utworzyć 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 można było podać adres URL przekazywania.

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

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

Przy pierwszym uruchomieniu sesji debugowania lokalnego lub uruchomieniu przepływu pracy bez debugowania środowisko uruchomieniowe usługi Logic Apps rejestruje przepływ pracy w punkcie końcowym usługi i subskrybuje ten punkt końcowy w celu powiadamiania o operacjach na nich. Przy następnym uruchomieniu przepływu pracy środowisko uruchomieniowe nie zarejestruje się ani nie ponownie zasubskrybuje, ponieważ rejestracja subskrypcji już istnieje w magazynie lokalnym.

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

Uwaga

Po uruchomieniu przepływu pracy w oknie terminalu mogą być wyświetlane błędy podobne do tych w tym przykładzie:

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 :

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Zarządzanie punktami przerwania na potrzeby debugowania

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

Obecnie punkty przerwania są obsługiwane tylko dla 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 trafiony 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 trafienia podczas sesji debugowania, możesz przejrzeć wyniki akcji przed zakończeniem działania akcji.

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 po lewej stronie okna kodu zostanie wyświetlony widok Uruchom, a w górnej części pojawi się pasek narzędzi Debugowanie.

    Uwaga

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

  3. Aby przejrzeć dostępne informacje w przypadku trafienia punktu przerwania, 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 zaktualizujemy plik workflow.json po uruchomieniu uruchomienia, punkty przerwania nie będą automatycznie aktualizowane. Aby zaktualizować punkty przerwania, uruchom ponownie aplikację logiki.

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

Lokalne uruchamianie, testowanie i debugowanie

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 można było później wysłać żądanie do tego punktu końcowego.

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

  2. Na pasku 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 zostanie wyświetlony 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 wyświetlić projekt.

    2. W 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ą oknie

    3. Znajdź wartość Callback URL (Adres 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-preview&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 narzędzia Postman wybierz pozycję Nowy.

      Zrzut ekranu przedstawiający program Postman z wybranym przyciskiem Nowy

    2. W okienku Utwórz nowy w obszarze Bloki konstrukcyjnewybierz pozycję Zażądaj.

    3. W oknie Zapisywanie żądania w obszarze Nazwa żądaniapodaj nazwę żądania, na przykład .

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

    5. W obszarze Wszystkiekolekcje podaj nazwę kolekcji, która ma być tworzyć w celu organizowania żądań, naciśnij klawisz Enter i wybierz pozycję Zapisz w nazwie kolekcji. W tym przykładzie Logic Apps requests użyto 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 program Postman z okienkiem otwartego żą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 postmana. W okienku żądania obok listy metod, na której obecnie jest wyświetlona domyślna metoda żądania GET, wklej wcześniej skopiowany adres URL wywołania zwrotnego w polu adresu, a następnie wybierz pozycję Wyślij.

      Zrzut ekranu przedstawiający program Postman i adres URL 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 Outlook e-mail 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 wyzwoleniu przepływu pracy przez wysłane żądanie na stronie przeglądu jest przedstawiany stan i historia uruchomienia przepływu pracy.

    Porada

    Jeśli stan uruchomienia nie jest wyświetlany, spróbuj odświeżyć stronę przeglądu, wybierając pozycję Odśwież. W przypadku wyzwalacza, który został pominięty z powodu niesprawnych kryteriów lub znalezienia żadnych danych, nie jest uruchamiany żaden przebieg.

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

    Stan uruchomienia Opis
    Zostało przerwane Przebieg został zatrzymany lub nie zakończył się z powodu problemów zewnętrznych, takich jak przerwa w pracy systemu lub przerwana subskrypcja platformy Azure.
    Anulowane Przebieg został wyzwolony i uruchomiony, ale otrzymał żądanie anulowania.
    Niepowodzenie Co najmniej jedna akcja w uruchomieniu nie powiodła się. Żadne kolejne akcje w przepływie pracy nie zostały ustawione do obsługi błędu.
    Uruchomienie Przebieg został wyzwolony i jest w toku, ale ten stan może być również wyświetlany dla uruchomienia, który jest ograniczany z powodu limitów akcji lub bieżącego planu cenowego.

    Porada:W przypadku skonfigurowania rejestrowania diagnostycznegomoż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.
    Uchylino czas Przekroczono limit czasu uruchomienia, ponieważ bieżący czas trwania przekroczył limit czasu trwania uruchomienia, który jest kontrolowany przez ustawienie Przechowywanie historii przebiegów w dniach. Czas trwania uruchomienia jest obliczany przy użyciu limitu czasu rozpoczęcia i czasu trwania uruchomienia w tym czasie rozpoczęcia.

    Uwaga:jeśli czas trwania uruchomienia przekracza również bieżący limit przechowywania historii przebiegów ,który jest również kontrolowany przez ustawienie Przechowywanie historii przebiegów w dniach, przebieg zostanie wyczyszony z historii przebiegów za pomocą codziennego zadania oczyszczania. Niezależnie od tego, czy limit czasu uruchomienia zostanie ukończony, okres przechowywania jest zawsze obliczany przy użyciu czasu rozpoczęcia uruchomienia i bieżącego limitu przechowywania. Dlatego jeśli zmniejszysz limit czasu trwania dla przebiegów w locie, limit czasu uruchomienia zostanie ukreślony. Jednak przebieg pozostaje lub jest wyczyszowany z historii przebiegów w zależności od tego, czy czas trwania uruchomienia przekroczył limit przechowywania.

    Oczekiwanie Przebieg nie został uruchomiony lub został wstrzymany, na przykład z powodu wcześniejszego wystąpienia przepływu pracy, które nadal działa.
  6. Aby przejrzeć stany dla każdego kroku w określonym uruchomieniu oraz dane wejściowe i wyjściowe kroku, wybierz przycisk wielokropka (...) dla tego uruchomienia, a następnie wybierz pozycję Pokażuruchomienie .

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

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

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

    Uwaga

    Jeśli uruchomienie nie powiodło się, a krok w widoku monitorowania pokazuje 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 przez podstawowy Uniform Resource Identifier 400 Bad Request (URI). Aby uzyskać więcej informacji, zobacz "400 Bad Request" (400 Złe żądanie).

    Poniżej podano możliwe stany, które mogą mieć poszczególne kroki przepływu pracy:

    Stan akcji Opis
    Zostało przerwane Akcja została zatrzymana lub nie została przerwana z powodu problemów zewnętrznych, takich jak przerwa w działaniu systemu lub przerwana subskrypcja platformy Azure.
    Anulowane Akcja została uruchomiona, ale otrzymano żądanie anulowania.
    Niepowodzenie Akcja nie powiodła się.
    Uruchomienie Akcja jest obecnie uruchomiona.
    Pominięto Akcja została pominięta, ponieważ bezpośrednio poprzedzana akcja nie powiodła się. Akcja ma warunek, który wymaga pomyślnego zakończenia poprzedniej akcji przed runAfter uruchomieniem bieżącej akcji.
    Powodzenie Akcja zakończyła się pomyślnie.
    Powodzenie po ponownych próbach Akcja zakończyła się pomyślnie, ale tylko po co najmniej jednej próbie. Aby przejrzeć historię ponawiania prób, w widoku szczegółów historii uruchamiania wybierz tę akcję, aby wyświetlić dane wejściowe i wyjściowe.
    Uchylino czas Akcja została zatrzymana z powodu limitu czasu określonego przez ustawienia tej akcji.
    Oczekiwanie Dotyczy akcji element webhook, która oczekuje na żądanie przychodzące od 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 jeszcze bardziej 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

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

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

    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 Dodaj akcję w polu wyszukiwania Wybierz akcję upewnij się, że wybrano pozycję Wbudowane. W polu wyszukiwania wprowadź response i wybierz response Odpowiedź.

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

    Gdy akcja Odpowiedź pojawi się 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 zwracana jest wartość właściwości Treść, która jest wynikiem 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-mailwybierz pozycję Treść.

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

      Gdy wszystko będzie gotowe, właściwość Treść akcji Odpowiedź jest teraz ustawiona na wartość wyjściową 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 test aplikacji logiki

Po zaktualizowaniu aplikacji logiki możesz uruchomić kolejny test, uruchamiając ponownie debuger w programie Visual Studio i wysyłając kolejne żądanie w celu wyzwolenia zaktualizowanej aplikacji logiki, podobnie jak w przypadku kroków w teście Uruchamianie, testowanie i debugowanie lokalnie.

  1. Na pasku 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 dane wyjściowe dla każdego kroku w tym uruchomieniu, wybierz przycisk wielokropka (...) dla tego uruchomienia, a następnie wybierz pozycję Pokaż uruchamianie.

    Oto na przykład stan krok po kroku uruchomienia 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 rozwiniętej akcji

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

Znajdowanie nazw domen w celu uzyskania dostępu do zapory

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

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

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

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

    Ten przykładowy plik connections.json zawiera dwa połączenia: połączenie AS2 i połączenie Office 365 z tymi 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 Visual Studio Code można bezpośrednio opublikować projekt na platformie Azure, która 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 w przypadku wymagań aplikacji funkcji. Możesz też opublikować aplikację logiki we wcześniej wdrożonym zasobie aplikacji logiki (w standardowych), co spowoduje zastąpienie tej aplikacji logiki.

Wdrożenie dla typu zasobu Aplikacja logiki (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 (standardowa)

  1. Na pasku Visual Studio Code wybierz ikonę Platformy Azure.

  2. Na pasku narzędzi okienka Azure: Logic Apps (Standardowa) wybierz pozycję Deploy to Logic App (Wd wdrażaj w aplikacji logiki).

    Zrzut ekranu przedstawiający okienko

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

  4. Z listy, która Visual Studio Code, wybierz jedną z tych opcji:

    • Tworzenie nowej aplikacji logiki (w standardowych wersjach) 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 kontynuujemy tworzenie nowej aplikacji logiki (standardowa) w zaawansowanej usłudze Azure.

    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 będzie nazwą używaną dla zasobu aplikacji logiki (wersja 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 jest wybierana App Service Utwórz nowy plan.

      Zrzut ekranu przedstawiający okienko

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

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

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

      Uwaga

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

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

      Zrzut ekranu przedstawiający okienko

    6. Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Szczegółowe informacje , możesz opcjonalniewłączyć rejestrowanie diagnostyczne i śledzenie dla 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 Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem ,podczas wdrażania aplikacji logiki lub po wdrożeniu.

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

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

      2. W Azure Portalprzejdź do zasobu Application Szczegółowe informacje.

      3. W menu zasobu wybierz pozycję Przegląd. Znajdź i skopiuj wartość Klucz instrumentacji.

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

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

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

        Porada

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

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

        2. W menu zasobu w obszarze Zbadajwybierz pozycję Mapa aplikacji.

        3. Przejrzyj nazwy operacji, które są wyświetlane na mapie.

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

      6. Następnie możesz opcjonalnie dostosować poziom ważności danych śledzenia zbieranych i przesyłanych do wystąpienia aplikacji Szczegółowe informacje logiki.

        Za każdym razem, gdy ma miejsce zdarzenie związane z przepływem pracy, na przykład po wyzwoleniu przepływu pracy lub uruchomieniu akcji, środowisko uruchomieniowe emituje różne ślady. Te ślady obejmują okres istnienia przepływu pracy i obejmują między innymi następujące typy 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.
        • Storage żądania, takie jak powodzenie lub niepowodzenie.
        • Działanie żądania HTTP, takie jak przychodzące, wychodzące, powodzenie i niepowodzenie.
        • Wszelkie ślady rozwoju, takie jak komunikaty debugowania.

        Każdy typ zdarzenia jest przypisany do poziomu ważności. Na przykład poziom przechwytuje najbardziej szczegółowe komunikaty, a poziom przechwytuje ogólne działania w przepływie pracy, takie jak uruchomienie i zatrzymanie aplikacji logiki, przepływu pracy, wyzwalacza i TraceInformation 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żyć do badania podczas opracowywania, na przykład przychodzące i wychodzące wywołania HTTP.
        Błąd Dzienniki, które wskazują błąd podczas wykonywania przepływu pracy, ale nie ogólny błąd w aplikacji logiki.
        Informacje 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 uruchomienia.
        — Gdy aplikacja logiki jest uruchamiana lub kończy się.

        Ślad Dzienniki zawierające najbardziej szczegółowe komunikaty, na przykład żądania magazynu lub działania dyspozytora, a także wszystkie komunikaty związane z działaniem wykonywania przepływu pracy.
        Ostrzeżenie Dzienniki, które wyróżnią nietypowy stan w aplikacji logiki, ale nie uniemożliwiają jej uruchomienia.

        Aby ustawić poziom ważności, na poziomie głównym projektu otwórz plik host.json i znajdź obiekt . Ten obiekt kontroluje filtrowanie dzienników dla wszystkich przepływów pracy w aplikacji logiki i stosuje ASP.NET Core filtrowania typu dziennika.

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

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

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

    Po zakończeniu kroków wdrażania program Visual Studio Code 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. Na liście narzędzi okna Dane wyjściowe wybierz pozycję Azure Logic Apps.

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

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

    Zrzut ekranu przedstawiający komunikat informujący o pomyślnym ukończeniu wdrożenia 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

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

  1. Na pasku Visual Studio Code wybierz ikonę Platformy Azure.

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

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

  4. Podaj nazwę przepływu pracy.

Gdy wszystko będzie gotowe, w projekcie zostanie wyświetlony nowy folder przepływu pracy wraz z plikiem workflow.json dla definicji przepływu pracy.

Zarządzanie wdrożonych aplikacji logiki w Visual Studio Code

W usłudze 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 Logic Apps, czy typ zasobu Aplikacja logiki (standardowa), a następnie wybrać zadania, które ułatwiają zarządzanie tymi aplikacjami logiki. Jednak aby uzyskać dostęp do obu typów zasobów, potrzebne są rozszerzenia Azure Logic Apps i Azure Logic Apps (Standardowa) dla Visual Studio Code.

  1. Na pasku narzędzi po lewej stronie 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

    Operacje zatrzymania aplikacji logiki i usuwania aplikacji logiki wpływają na wystąpienia przepływu pracy na różne sposoby. Aby uzyskać więcej informacji, zapoznaj się z tematami Considerations for stopping logic apps (Zagadnienia dotyczące zatrzymywania aplikacji logiki) i Considerations for deleting logic apps (Zagadnienia dotyczące usuwania aplikacji logiki).

    Zrzut ekranu przedstawiający Visual Studio Code z otwartą 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, a następnie 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 Visual Studio Code otwórz plik workflow.json projektu w projektancie przepływu pracy, dokonaj edycji i ponownie wdń aplikację logiki na platformie Azure.

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

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

    Aplikacja Azure Portal w przeglądarce, automatycznie zalogował się do portalu, jeśli zalogowano się do usługi Visual Studio Code, i pokazuje aplikację logiki.

    Zrzut ekranu przedstawiający 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 wyświetlonymi wynikami wyszukiwania dla wdrożonej aplikacji logiki.

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 Logic Apps natychmiast anuluje wszystkie przebiegi w toku i oczekujące.

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

  • Wyzwalacze nie będą wyzwalane przy następnym spełniania warunków. Stany wyzwalacza pamiętają jednak punkty, w których zatrzymano aplikację logiki. Dlatego po ponownym uruchomieniu aplikacji logiki wyzwalacze są wyzwalane dla wszystkich nieprzetworzonych elementów od czasu ostatniego uruchomienia.

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

    1. Na Visual Studio Code pasku narzędzi po lewej stronie wybierz ikonę platformy Azure.
    2. W okienku Azure: Logic Apps (Standardowa) 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 Workflows (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 te czynności dla każdego przepływu pracy.
    7. Gdy wszystko będzie gotowe, uruchom ponownie aplikację logiki.

Zagadnienia dotyczące usuwania aplikacji logiki

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

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

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

  • Jeśli usuniesz przepływ pracy, a następnie ponownie odtworzysz ten sam przepływ pracy, ponownie utworzony przepływ pracy nie będzie miał tych samych metadanych co usunięty przepływ pracy. Aby odświeżyć metadane, musisz ponownie włączyć dowolny przepływ pracy, który wywołał usunięty przepływ pracy. Dzięki temu wywołujący pobiera poprawne informacje dla ponownie utworzonego przepływu pracy. W przeciwnym razie wywołania do ponownie utworzonego przepływu pracy nie powiodą się z Unauthorized błędem. To zachowanie dotyczy również przepływów pracy, które używają artefaktów na kontach integracji i przepływów pracy, które wywołują funkcje platformy Azure.

Zarządzanie wdrożonych aplikacji logiki w portalu

Po wdrożeniu aplikacji logiki w usłudze Azure Portal z poziomu usługi 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 oryginalne typy zasobów usługi Logic Apps, czy aplikacje logiki (standardowy). Obecnie każdy typ zasobu jest zorganizowany i zarządzany jako osobne kategorie na platformie Azure. Aby znaleźć aplikacje logiki, które mają typ zasobu Aplikacja logiki (standardowa), wykonaj następujące kroki:

  1. W polu Azure Portal wyszukiwania wpisz logic apps . Gdy zostanie wyświetlona lista wyników, w obszarze Usługiwybierz pozycję Aplikacje logiki.

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

  2. W okienku Aplikacja logiki (standardowa) wybierz aplikację logiki wdrożoną z poziomu Visual Studio Code.

    Zrzut ekranu przedstawiający zasoby Azure Portal i aplikacji logiki (w standardowych) wdrożonych na platformie Azure.

    W Azure Portal zostanie otwarta strona pojedynczego zasobu dla wybranej aplikacji logiki.

    Zrzut ekranu przedstawiający stronę zasobów 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.

    Okienko Przepływy pracy zawiera 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 z większej liczby 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 z przepływem pracy, który został Visual Studio Code. Teraz możesz wprowadzać 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 kolejnego przepływu pracy w portalu

Za pomocą Azure Portal można dodawać puste przepływy pracy do zasobu aplikacji logiki (Standardowa), który został wdrożony z poziomu usługi Visual Studio Code, i tworzyć te przepływy pracy w Azure Portal.

  1. W Azure Portalwybierz 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 lubBez stanoweUtwórz.

    Po wdrożeniu przez platformę Azure nowego przepływu pracy, który jest wyświetlany w okienku Przepływy pracy, wybierz ten przepływ pracy, aby można było zarządzać innymi zadaniami, takimi jak otwieranie projektanta lub widoku kodu, oraz wykonywać inne zadania.

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

    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 bez stanowych przepływów pracy

Aby łatwiej debugować bez stanowy przepływ pracy, możesz włączyć historię uruchamiania dla tego przepływu pracy, a następnie wyłączyć historię uruchamiania, gdy wszystko będzie gotowe. Wykonaj następujące kroki dla Visual Studio Code, a jeśli pracujesz w aplikacji Azure Portal, zobacz Tworzenie przepływów pracy opartych na jednej dzierżawie w Azure Portal.

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

  2. Dodaj właściwość Workflows.{yourWorkflowName}.operationOptions i ustaw wartość na , na WithStatelessRunHistory 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. Aby wyłączyć historię uruchamiania, gdy wszystko będzie gotowe, ustaw właściwość na wartość lub usuń właściwość Workflows.{yourWorkflowName}.OperationOptionsNone i jej wartość.

Włączanie widoku monitorowania w Azure Portal

Po wdrożeniu zasobu aplikacji logiki (standardowa) z usługi Visual Studio Code na platformie Azure możesz przejrzeć dowolną dostępną historię przebiegów i szczegóły przepływu pracy w tym zasobie przy użyciu narzędzia Azure Portal i funkcji Monitorowania dla tego przepływu pracy. Najpierw jednak należy włączyć możliwość wyświetlania Monitora dla tego zasobu aplikacji logiki.

  1. W Azure Portalwybierz wdrożony zasób aplikacja logiki (standardowa).

  2. W menu tego zasobu w obszarze interfejsu APIwybierz pozycję CORS.

  3. W okienku CORS w obszarze Dozwolone źródładodaj 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 zasobu jest wybierana pozycja

Włączanie lub otwieranie usługi Application Szczegółowe informacje po wdrożeniu

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

Jeśli ustawienia tworzenia i wdrażania aplikacji logiki obsługują korzystanie z usługi Application Szczegółowe informacje , możesz opcjonalniewłączyć rejestrowanie diagnostyczne i śledzenie dla 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 Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem ,podczas wdrażania aplikacji logiki lub po wdrożeniu.

Aby włączyć usługę Application Szczegółowe informacje we wdrożonej aplikacji logiki lub przejrzeć dane usługi Application Szczegółowe informacje, gdy są już włączone, wykonaj następujące kroki:

  1. W Azure Portal znajdź wdrożoną aplikację logiki.

  2. W menu aplikacji logiki w obszarze Ustawieniawybierz pozycję Application Szczegółowe informacje.

  3. Jeśli Szczegółowe informacje nie jest włączona, w okienku Application Szczegółowe informacje wybierz pozycję Włącz usługę Application Szczegółowe informacje. Po aktualizacji okienka w dolnej części wybierz pozycję Zastosuj.

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

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

Usuwanie elementów z projektanta

Aby usunąć element w przepływie pracy z projektanta, wykonaj dowolną z tych czynności:

  • 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 dla tego elementu było otwierane okienko szczegółów. 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ń pozycję Visual Studio Code wystarczająco szerokie, aby w okienku szczegółów był widoczny 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 komunikat o błędzie "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ć poprawnie pobierany. Aby sprawdzić, czy ta przyczyna jest problemem, wykonaj następujące kroki:

  1. W Visual Studio Code otwórz okno Dane wyjściowe. W menu Widok wybierz pozycję Output (Dane wyjściowe).

  2. Na liście na pasku tytułu okna Dane wyjściowe wybierz pozycję Azure Logic Apps (Standardowa), aby przejrzeć dane wyjściowe z rozszerzenia, na przykład:

    Zrzut ekranu przedstawiający okno Dane wyjściowe z wybraną oknie Azure Logic Apps

  3. Przejrzyj dane wyjściowe i sprawdź, czy jest wyświetlany następujący 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 usunąć ten błąd, usuń folder ExtensionBundles w tej lokalizacji ...\Users{twoja_nazwa_użytkownika}\AppData\Local\Temp\Functions\ExtensionBundles,a następnie spróbuj ponownie otworzyć plik workflow.json w projektancie.

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

Funkcje jednodostępne Azure Logic Apps wbudowane 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ć, Visual Studio Code korzysta z 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 podczas tworzenia aplikacji logiki włączono lub wybrano opcję Użyj łączników z platformy Azure. Jeśli łączniki wdrożone na platformie Azure nie zostały włączyć podczas 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 z platformy Azure.

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

Uwaga

To rozwiązanie dotyczy tylko aplikacji logiki utworzonych i wdrożonych przy użyciu usługi Visual Studio Code z rozszerzeniem Azure Logic Apps (Standardowa), a nie aplikacji logiki utworzonych przy użyciu Azure Portal. Zobacz Obsługiwane wyzwalacze i akcje, których brakuje w projektancie w Azure Portal.

  1. Zapisz pracę, której nie chcesz utracić, i zamknij Visual Studio.

  2. Na komputerze przejdź do następującego folderu, który zawiera foldery z wersjami 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 z wersją dla wymaganego NuGet pakietu:

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

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

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

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

W wyzwalaczu lub akcji pojawia się komunikat "400 Bad Request" (400 Złe żądanie)

Jeśli uruchomienie zakończy się niepowodzeniem i sprawdzisz przebieg w widoku monitorowania, ten błąd może pojawić się w wyzwalaczu lub akcji o dłuższej nazwie, co spowoduje przekroczenie domyślnego limitu znaków przez podstawowy Uniform Resource Identifier (URI).

Aby rozwiązać ten problem i dostosować go do dłuższego czasu URI, edytuj klucze rejestru i na komputerze, UrlSegmentMaxCountUrlSegmentMaxLength korzystając z poniższych kroków. Te wartości domyślne klucza opisano w tym temacie, Http.sys ustawienia rejestrudla Windows .

Ważne

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

  1. Na komputerze otwórz okno Uruchamianie i uruchom polecenie , co spowoduje otwarcie edytora rejestru.

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

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

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

  5. Zwiększ te wartości klucza na tyle, aby URI mieściły się w nazwach, których chcesz użyć. Jeśli te klucze nie istnieją, dodaj je do folderu Parameters, wykonać następujące kroki:

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

    2. W wyświetlonym oknie edycji wprowadź UrlSegmentMaxCount jako nową nazwę klucza.

    3. Otwórz menu skrótów nowego klucza, a następnie wybierz pozycję Modyfikuj.

    4. W wyświetlonym polu Edytuj ciąg wprowadź wartość klucza danych Wartość w formacie szesnastkowym lub dziesiętnym. Na przykład w 400 formacie szesnastkowym jest odpowiednikiem liczby 1024 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ć podobnie do poniższego przykładu:

    Zrzut ekranu przedstawiający edytor rejestru.

  6. Gdy wszystko będzie gotowe, uruchom ponownie komputer, aby zmiany weszły w życie.

Nie można uruchomić sesji debugowania

Podczas próby uruchomienia sesji debugowania jest wyświetlany błąd "Błąd występuje 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 .vscodei otwórz plik tasks.json.

  2. W poniższym zadaniu usuń wiersz wraz z przecinkiem, który kończy poprzedni "dependsOn: "generateDebugSymbols" 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

Chcemy się do Ciebie odsłuchać na temat Twoich doświadczeń z rozszerzeniem Azure Logic Apps (Standard).

W tym artykule przedstawiono sposób tworzenia przykładowego zautomatyzowanego przepływu pracy integracji uruchamianego w środowisku usługi Azure Logic Apps z jedną dzierżawą przy użyciu Visual Studio Code z rozszerzeniem Azure Logic Apps (Standard). Aplikacja logiki tworzymy za pomocą tego rozszerzenia jest oparta na typie zasobu Aplikacja logiki (standardowa), który zapewnia następujące możliwości:

  • Przepływy pracy aplikacji logiki można uruchamiać i testować lokalnie w Visual Studio Code dewelopera.

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

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

  • Typ zasobu Aplikacja logiki (standardowa) można wdrożyć bezpośrednio w środowisku usługi Azure Logic Apps z jedną dzierżawą lub w dowolnym miejscu, Azure Functions, w tym w kontenerach, ze względu na konteneryzowane środowisko uruchomieniowe Azure Logic Apps dzierżawy.

Aby uzyskać więcej informacji na temat oferty dzierżawy Azure Logic Apps, zapoznaj się z tematem Single-tenant versus multi-tenant and integration service environment(Środowisko usługi integracji i jednej dzierżawy w porównaniu z wieloma dzierżawami).

Przykładowy przepływ pracy jest oparty na chmurze i obejmuje tylko dwa kroki, ale można tworzyć przepływy pracy z setek operacji, które mogą łączyć szeroką gamę aplikacji, danych, usług i systemów w środowisku chmurowym, lokalnym i hybrydowym. Przykładowy przepływ pracy rozpoczyna się od wbudowanego wyzwalacza Żądania i następuje po nim Office 365 Outlook akcji. Wyzwalacz tworzy wywołowalny punkt końcowy dla przepływu pracy i czeka na przychodzące żądanie HTTPS od dowolnego wywołującego. Gdy wyzwalacz odbierze żądanie i zostanie wyzwolone, zostanie uruchomiona następna akcja, wysyłając wiadomość e-mail na podany adres e-mail wraz z wybranymi wyjściami z wyzwalacza.

Porada

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

Aby zamiast tego utworzyć ten przykładowy przepływ pracy przy użyciu Azure Portal, wykonaj kroki opisane w te tematach Create integration workflows using single tenant Azure Logic Apps and the Azure Portal(Tworzenie przepływów pracy integracji przy użyciu jednego przepływu pracy Azure Logic Apps dzierżawy i Azure Portal . Obie opcje zapewniają możliwość tworzenia, uruchamiania i wdrażania przepływów pracy aplikacji logiki w tego samego rodzaju środowiskach. Jednak dzięki Visual Studio Code można lokalnie opracowywać, testować i uruchamiać przepływy pracy w środowisku dewelopera.

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

W toku będziesz wykonywać następujące 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.
  • Znajdowanie szczegółów nazwy domeny na temat dostępu przez zaporę.
  • Wdrażanie na platformie Azure, co obejmuje opcjonalne włączanie usługi Application Szczegółowe informacje.
  • Zarządzanie wdrożoną aplikacją logiki w Visual Studio Code i Azure Portal.
  • Włącz historię uruchamiania dla bez stanowych przepływów pracy.
  • Włącz lub otwórz aplikację Application Szczegółowe informacje po wdrożeniu.

Wymagania wstępne

Dostęp i łączność

  • Dostęp do Internetu, aby można było pobrać wymagania, nawiązać połączenie z usługi Visual Studio Code do konta platformy Azure i opublikować z witryny 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, potrzebne jest Office 365 Outlook e-mail, które używa konta służbowego Microsoft do logowania.

    Jeśli wybierzesz inny łącznikpoczty e-mail, na przykład Outlook.com, nadal możesz postępować zgodnie z przykładem, a 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 swojego osobistego konto Microsoft, aby się zalogować.

Storage wymagań

W przypadku lokalnego Visual Studio Code należy skonfigurować lokalny magazyn danych dla projektu aplikacji logiki i przepływów pracy do uruchamiania w lokalnym środowisku dewelopera. Emulatora magazynu Azurite można używać i uruchamiać jako lokalny magazyn danych.

  1. Pobierz i zainstaluj program Azurite 3.12.0 lub nowszy.
  2. Przed uruchomieniem aplikacji logiki pamiętaj o uruchomieniu emulatora.

Aby uzyskać więcej informacji, zapoznaj się z dokumentacją programu 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 wspólne środowisko logowania i filtrowania subskrypcji platformy Azure dla wszystkich innych rozszerzeń platformy Azure w Visual Studio Code.

    • Język C# Visual Studio Code ,które umożliwia uruchamianie aplikacji logiki za pomocą funkcji F5.

    • Azure Functions Core Tools wersji 3.x przy użyciu Instalatora Microsoft (MSI), czyli . Nie instaluj wersji 4.x, która nie jest obsługiwana i nie będzie działać.

      Te narzędzia obejmują wersję tego samego środowiska uruchomieniowego, które Azure Functions uruchomieniowe, którego rozszerzenie Azure Logic Apps (Standardowa) używa w Visual Studio Code.

      Ważne

      Jeśli masz instalację wcześniejszą niż te wersje, najpierw odinstaluj tę wersję lub upewnij się, że zmienna środowiskowa PATH wskazuje wersję, którą pobierasz i instalujesz.

    • Azure Logic Apps (standardowa) dla Visual Studio Code.

      Ważne

      Projekty utworzone przy użyciu wcześniejszych rozszerzeń w wersji zapoznawczej już nie działają. Aby kontynuować, odinstaluj wszystkie wcześniejsze wersje i utwórz ponownie projekty aplikacji logiki.

      Aby zainstalować rozszerzenie Azure Logic Apps (Standardowa), wykonaj następujące kroki:

      1. Na Visual Studio Code 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ę Zainstaluj Azure Logic Apps (Standardowa).

        Po zakończeniu instalacji rozszerzenie pojawi się na liście Rozszerzenia: Zainstalowane.

        Zrzut ekranu Visual Studio Code z zainstalowanym rozszerzeniem Azure Logic Apps (Standardowa)

        Porada

        Jeśli rozszerzenia nie ma na liście zainstalowanych, spróbuj ponownie uruchomić Visual Studio Code.

      Obecnie w tym samym czasie można zainstalować rozszerzenia Zużycie (z wieloma dzierżawami) i Standardowe (z jedną dzierżawą). Środowisko programowe różni się pod pewnymi względami od siebie, ale subskrypcja platformy Azure może obejmować zarówno typy aplikacji logiki Standard, jak i Consumption. Visual Studio Code wszystkie wdrożone aplikacje logiki w ramach subskrypcji platformy Azure, ale organizuje aplikacje w ramach każdego rozszerzenia, Azure Logic Apps (Zużycie)i Azure Logic Apps (Standardowa).

  • Aby użyć akcji Wbudowane operacje na kodzie, która uruchamia język JavaScript, zainstaluj programNode.js w wersji 10.x.x, 11.x.x lub 12.x.x.

    Porada

    Aby 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 linkach webhook,takie jak wbudowany wyzwalacz http webhook , na platformie Visual Studio Code, należy skonfigurować przekazywanie dla adresu URL wywołania zwrotnego.

  • Aby przetestować przykładowy przepływ pracy w tym artykule, potrzebne jest narzędzie, 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żywać aplikacji Postman.

  • Jeśli tworzysz zasoby aplikacji logiki z ustawieniami, które obsługują korzystanie z usługi Application Szczegółowe informacje, możesz opcjonalniewłą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 Szczegółowe informacje, ale możesz utworzyć ten zasób z wyprzedzeniem ,podczas tworzenia aplikacji logiki lub po wdrożeniu.

Konfigurowanie programu Visual Studio Code

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

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

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

    2. Na karcie Użytkownik przejdź do rozszerzeniafunkcji.

    3. Upewnij się, że są zaznaczone pola Automatyczne sprawdzanie aktualizacji i Aktualizacje automatyczne.

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

  • Azure Logic Apps Standardowa: Project Runtime,które jest ustawione na wersję ~3

    Uwaga

    Ta wersja jest wymagana do korzystania z akcji wbudowanej operacji kodu.

  • Azure Logic Apps Standardowa: Eksperymentalny menedżer widoków,który umożliwia korzystanie z najnowszego projektanta w Visual Studio Code. Jeśli w projektancie występują problemy, 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 Preferencje Ustawienia.

  2. Na karcie User (Użytkownik) przejdź do Azure Logic Apps(Standardowa).

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

    Zrzut ekranu przedstawiający Visual Studio Code dla rozszerzenia

Nawiąż połączenie z kontem platformy Azure

  1. Na pasku Visual Studio Code wybierz ikonę Azure.

    Zrzut ekranu przedstawiający pasek 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 Visual Studio Code uwierzytelniania zaloguj się przy użyciu konta platformy Azure.

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

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

    Jeśli oczekiwane subskrypcje nie są wyświetlane lub chcesz, aby w okienku były wyświetlane tylko określone subskrypcje, wykonaj następujące kroki:

    1. Na liście subskrypcji przesuń wskaźnik obok pierwszej subskrypcji, aż pojawi się przycisk Wybierz subskrypcje (ikona filtru). Wybierz ikonę filtru.

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

      Lub na pasku Visual Studio Code wybierz swoje konto platformy Azure.

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

Tworzenie projektu lokalnego

Przed utworzeniem aplikacji logiki utwórz projekt lokalny, aby można było zarządzać aplikacją logiki, uruchamiać ją i wdrażać z jej Visual Studio Code. Podstawowy projekt 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.