Udostępnij za pośrednictwem


Szybki start: Tworzenie przepływów pracy w modelu zużycia w usłudze wielodostępnej Azure Logic Apps przy użyciu Visual Studio Code

Dotyczy: Azure Logic Apps (Zużycie)

Jako deweloper integracji często trzeba zautomatyzować procesy biznesowe w aplikacjach SaaS, systemach dla przedsiębiorstw i źródłach danych bez zarządzania infrastrukturą. Potrzebujesz również podejścia typu "code-first" do tworzenia przepływów pracy, aby móc wersjonować definicje, sprawnie wprowadzać aktualizacje i przeglądać zmiany.

W tym przewodniku Szybki start pokazano, jak tworzyć przepływy pracy Użycia i zarządzać nimi w wielodostępnej usłudze Azure Logic Apps przy użyciu lokalnych narzędzi opartych na kodzie w programie Visual Studio Code. Przepływy pracy oparte na zużyciu zapewniają bezserwerowy model integracji dla opartych na zdarzeniach i zaplanowanych przepływów pracy, dzięki czemu można łączyć usługi i automatyzować procesy, płacąc tylko za akcje, które są uruchamiane.

W programie Visual Studio Code można edytować definicje przepływu pracy w formacie JavaScript Object Notation (JSON) przy użyciu edytora kodu, używać projektanta wizualnego w razie potrzeby i zarządzać wdrożonymi przepływami pracy na platformie Azure. Możesz również pracować nad przepływami pracy i kontami integracji z dowolnej platformy programistycznej, na której działa program Visual Studio Code, takich jak Linux, Windows i macOS.

Poniższy zrzut ekranu pokazuje, jak może wyglądać przykład definicji przepływu pracy Konsumpcja.

Zrzut ekranu przedstawiający przykładową definicję przepływu pracy aplikacji logiki Zużycie w programie Visual Studio Code.

Aby uzyskać więcej informacji, zobacz:

Wymagania wstępne

Uzyskiwanie dostępu do platformy Azure z poziomu programu Visual Studio Code

  1. W programie Visual Studio Code zaloguj się do swojego konta platformy Azure.

    Jeśli logowanie trwa dłużej niż zwykle, program Visual Studio Code wyświetli monit o zalogowanie się za pośrednictwem witryny internetowej uwierzytelniania firmy Microsoft, podając kod urządzenia. Aby zalogować się przy użyciu kodu, wykonaj następujące kroki:

    1. Wybierz pozycję Użyj kodu urządzenia, a następnie wybierz pozycję Kopiuj i otwórz.

    2. Wybierz pozycję Otwórz link, aby otworzyć nowe okno przeglądarki i przejść do witryny internetowej uwierzytelniania.

    3. Na stronie Zaloguj się do konta wprowadź kod uwierzytelniania, a następnie wybierz pozycję Dalej.

  2. Na pasku Działania wybierz ikonę platformy Azure.

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

    W okienku Azure sekcje Usługi Logic Apps (Zużycie) i Konta integracji zawierają teraz subskrypcje platformy Azure skojarzone z Twoim kontem. Jeśli nie widzisz oczekiwanych subskrypcji lub jeśli sekcje zawierają zbyt wiele subskrypcji, wykonaj następujące kroki:

    1. W sekcji Logic Apps (Zużycie) wybierz pozycję Wybierz subskrypcje.

      Zrzut ekranu przedstawiający okienko platformy Azure, sekcję Zużycie usługi Logic Apps i pozycję Wybierz subskrypcje wybrane do filtrowania subskrypcji platformy Azure.

    2. Z listy subskrypcji wybierz subskrypcje, których chcesz użyć.

  3. W sekcji Logic Apps (Zużycie) rozwiń subskrypcję, aby wyświetlić wszystkie wdrożone aplikacje logiki w tej subskrypcji.

    Zrzut ekranu przedstawiający rozszerzoną subskrypcję platformy Azure ze skojarzonymi aplikacjami logiki.

Tworzenie aplikacji logiki

  1. W programie Visual Studio Code w sekcji Logic Apps (Consumption) z menu kontekstowego subskrypcji wybierz pozycję Utwórz Logic App.

    Zrzut ekranu przedstawiający menu skrótów subskrypcji i Tworzenie aplikacji logiki.

    Zostanie wyświetlona lista zawierająca wszystkie grupy zasobów platformy Azure w ramach subskrypcji.

  2. Z listy grupy zasobów wybierz pozycję Utwórz nową grupę zasobów lub istniejącą grupę zasobów.

    W tym przykładzie wybierz pozycję Utwórz nową grupę zasobów, na przykład:

    Zrzut ekranu przedstawiający listę grup zasobów z wybraną pozycją Utwórz nową grupę zasobów.

  3. Wprowadź nazwę grupy zasobów platformy Azure.

    Zrzut ekranu przedstawiający wprowadzoną nową nazwę grupy zasobów platformy Azure.

  4. Wybierz region świadczenia usługi Azure, w którym chcesz zapisać metadane aplikacji logiki.

    Zrzut ekranu przedstawiający wybrany region świadczenia usługi Azure.

  5. Wprowadź nazwę aplikacji logiki.

    Zrzut ekranu przedstawiający nazwę wprowadzoną dla aplikacji logiki.

    W oknie Azure, w ramach subskrypcji, są wyświetlane twoja nowa aplikacja logiczna i pusty przepływ pracy. Program Visual Studio Code otwiera również plik JSON (.logicapp.json), który zawiera definicję szkieletowego przepływu pracy, na przykład:

    Zrzut ekranu przedstawiający strukturę dla pustej definicji przepływu pracy aplikacji logiki w pliku JSON.

    Teraz możesz rozpocząć ręczne tworzenie definicji przepływu pracy w tym pliku JSON. Aby uzyskać informacje techniczne dotyczące struktury i składni definicji przepływu pracy, zobacz Schemat języka definicji przepływu pracy dla usługi Azure Logic Apps.

    Poniższa przykładowa definicja przepływu pracy aplikacji logiki rozpoczyna się od wyzwalacza RSS i akcji usługi Office 365 Outlook. Zazwyczaj elementy JSON są wyświetlane alfabetycznie w każdej sekcji. Ten przykład pokazuje jednak te elementy w przybliżeniu w kolejności, w jaką operacje przepływu pracy są wyświetlane w projektancie.

    {
       "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
          "$connections": {
             "defaultValue": {},
             "type": "Object"
          }
       },
       "triggers": {
          "When_a_feed_item_is_published": {
             "recurrence": {
                "frequency": "Minute",
                "interval": 30
             },
             "splitOn": "@triggerBody()?['value']",
             "type": "ApiConnection",
             "inputs": {
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['rss']['connectionId']"
                   }
                },
                "method": "get",
                "path": "/OnNewFeed",
                "queries": {
                   "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                   "sinceProperty": "PublishDate"
                }
             }
          }
       },
       "actions": {
          "Send_an_email_(V2)": {
             "runAfter": {},
             "type": "ApiConnection",
             "inputs": {
                "body": {
                   "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                   "Subject": "RSS item: @{triggerBody()?['title']}",
                   "To": "sophia-owen@fabrikam.com"
                },
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['office365']['connectionId']"
                   }
                },
                "method": "post",
                "path": "/v2/Mail"
             }
          }
       },
       "outputs": {}
    }
    

    Ważne

    Aby ponownie użyć tej przykładowej definicji przepływu pracy, potrzebujesz konta służbowego lub szkolnego organizacji, na przykład @fabrikam.com. Upewnij się, że zastąpisz fikcyjny adres e-mail własnym adresem e-mail.

    Aby użyć innego łącznika poczty e-mail, takiego jak Outlook.com lub Gmail, zastąp Send_an_email_action akcję podobną akcją dostępną z łącznika poczty e-mail obsługiwanego przez usługę Azure Logic Apps.

    Jeśli chcesz użyć łącznika Gmail, tylko konta biznesowe usługi G-Suite mogą używać tego łącznika bez ograniczeń w aplikacjach logiki. Jeśli masz konto użytkownika Gmail, możesz użyć tego łącznika tylko z określonymi usługami zatwierdzonymi przez firmę Google lub utworzyć aplikację kliencką Google do użycia do uwierzytelniania za pomocą łącznika Usługi Gmail. Aby uzyskać więcej informacji, zobacz Zasady zabezpieczeń i prywatności danych dla łączników Google w usłudze Azure Logic Apps.

  6. Po zakończeniu zapisz definicję przepływu pracy. (Plik>Zapisz lub naciśnij klawisze Ctrl+S).

  7. Po wyświetleniu monitu o przekazanie definicji przepływu pracy aplikacji logiki do subskrypcji platformy Azure wybierz pozycję Przekaż.

    Ten krok publikuje definicję przepływu pracy aplikacji logiki z programu Visual Studio Code do witryny Azure Portal, co sprawia, że przepływ pracy działa na platformie Azure.

    Zrzut ekranu przedstawiający okno dialogowe z wyróżnionym przyciskiem Przekaż w celu przekazania aplikacji logicznej do portalu Azure.

Wyświetlanie przepływu pracy w projektancie

W programie Visual Studio Code możesz otworzyć przepływ pracy aplikacji Logic Apps w widoku projektowania tylko do odczytu. Chociaż nie możesz edytować definicji przepływu pracy w projektancie, możesz wizualnie sprawdzić przepływ pracy przy użyciu widoku projektanta.

W oknie platformy Azure, w sekcji Logic Apps (Zużycie), z menu skrótów aplikacji Logic Apps wybierz pozycję Otwórz w projektancie.

Projektant tylko do odczytu otwiera się w osobnej karcie i wyświetla przepływ pracy aplikacji logicznej, na przykład:

Zrzut ekranu przedstawiający przepływ pracy aplikacji logiki w widoku projektu.

Wyświetlanie przepływu pracy w witrynie Azure Portal

Aby przejrzeć definicję przepływu pracy aplikacji logiki w witrynie Azure Portal, wykonaj następujące kroki:

  1. Na portalu Azure zaloguj się, używając tego samego konta platformy Azure i subskrypcji powiązanej z aplikacją logiki.

  2. W polu wyszukiwania witryny Azure Portal wprowadź nazwę aplikacji logiki. Z listy wyników wybierz aplikację logiki.

    Zrzut ekranu przedstawiający witrynę Azure Portal, pole wyszukiwania i nazwę wprowadzoną dla aplikacji logiki z wyróżnionym wynikiem.

  3. Na pasku bocznym aplikacji logiki w obszarze Narzędzia programistyczne otwórz przepływ pracy w widoku projektanta lub kodu.

Edytowanie wdrożonej aplikacji logiki

W programie Visual Studio Code możesz otworzyć i edytować definicję przepływu pracy dla już wdrożonego zasobu aplikacji logiki na platformie Azure.

Ważne

Przed rozpoczęciem edycji aktywnie działającego przepływu pracy aplikacji logiki w środowisku produkcyjnym zminimalizuj zakłócenia i unikaj ryzyka przerwania przepływu pracy, wyłączając najpierw zasób aplikacji logiki.

  1. Na pasku Działania w programie Visual Studio Code wybierz ikonę platformy Azure.

  2. W oknie Platformy Azure w sekcji Logic Apps (Zużycie) rozwiń subskrypcję platformy Azure i wybierz odpowiednią aplikację logiki.

  3. W menu skrótów aplikacji logiki wybierz pozycję Otwórz w edytorze. Możesz też wybrać ikonę edycji obok nazwy aplikacji logiki.

    Zrzut ekranu przedstawiający okno platformy Azure, menu skrótów dla usługi Logic Apps oraz wybraną opcję Otwórz w edytorze.

    Program Visual Studio Code otwiera plik .logicapp.json w lokalnym folderze tymczasowym, aby można było wyświetlić definicję przepływu pracy.

    Zrzut ekranu przedstawiający program Visual Studio Code i otwarty plik definicji przepływu pracy aplikacji logiki.

  4. Wprowadź zmiany w pliku definicji przepływu pracy.

  5. Po zakończeniu zapisz zmiany (Zapisz plik> lub naciśnij klawisze Ctrl+S).

  6. Kiedy zostaniesz poproszony o przekazanie zmian i zastąpienie istniejącego przepływu pracy aplikacji Logic Apps w portalu Azure, wybierz pozycję Przekaż.

    Ten krok publikuje aktualizacje zasobu aplikacji logiki w witrynie Azure Portal.

    Zrzut ekranu przedstawiający okno dialogowe programu Visual Studio Code z wyróżnionym przyciskiem Prześlij do przesłania zmian aplikacji logiki do portalu Azure.

Wyświetlanie lub podwyższanie poziomu innych wersji

W programie Visual Studio Code możesz otworzyć i przejrzeć wcześniejsze wersje przepływu pracy aplikacji logiki. Możesz również awansować wcześniejszą wersję na bieżącą wersję.

Ważne

Przed zmianą aktywnego przepływu pracy aplikacji logicznej w środowisku produkcyjnym, zminimalizuj zakłócenia i unikaj ryzyka uszkodzenia tej aplikacji, wyłączając najpierw zasób aplikacji logicznej.

  1. W oknie platformy Azure w sekcji Logic Apps (Zużycie) rozwiń subskrypcję platformy Azure, aby wyświetlić skojarzone aplikacje logiki.

  2. W ramach subskrypcji rozwiń swoją aplikację logiczną i rozwiń pozycję Wersje.

    Lista Wersje zawiera wcześniejsze wersje aplikacji logiki, jeśli istnieją.

    Zrzut ekranu przedstawiający program Visual Studio Code i starsze wersje aplikacji logiki.

  3. Aby wyświetlić starszą wersję, wybierz jedną z następujących czynności:

    • Aby wyświetlić definicję JSON, w obszarze Wersje wybierz numer wersji dla tej definicji. Lub w menu skrótów wersji wybierz pozycję Otwórz w edytorze.

      Nowy plik zostanie otwarty na komputerze lokalnym, pokazując definicję JSON tej wersji.

    • Aby wyświetlić wersję w projektancie tylko do odczytu, w menu skrótów wersji wybierz pozycję Otwórz w projektancie.

  4. Aby podwyższyć poziom starszej wersji do bieżącej wersji, wykonaj następujące kroki:

    1. W obszarze Wersje z menu skrótów starszej wersji wybierz opcję Promuj.

      Zrzut ekranu przedstawiający program Visual Studio Code i sposób podwyższania poziomu starszej wersji aplikacji logiki do bieżącej wersji.

    2. Aby kontynuować po wyświetleniu monitu o potwierdzenie w programie Visual Studio Code, wybierz pozycję Tak.

      Program Visual Studio Code promuje wybraną wersję do bieżącej wersji i przypisuje nowy numer do promowanej wersji. Poprzednio bieżąca wersja jest teraz wyświetlana w ramach promowanej wersji.

Wyłączanie lub włączanie aplikacji logiki

W Visual Studio Code, jeśli edytujesz opublikowany przepływ pracy aplikacji Logic Apps i zapiszesz zmiany, zastąpisz już wdrożoną aplikację Logic Apps. Aby uniknąć przerywania przepływu pracy aplikacji logiki w środowisku produkcyjnym i zminimalizować zakłócenia, najpierw wyłącz zasób aplikacji logiki. Po potwierdzeniu, że przepływ pracy nadal działa zgodnie z oczekiwaniami, możesz ponownie uaktywnić zasób aplikacji logiki.

Wyłączenie lub włączenie zasobu aplikacji logiki wpływa na instancje przepływu pracy w następujący sposób:

  • Usługa Azure Logic Apps kontynuuje uruchomienia i oczekujące przepływy pracy do momentu ich zakończenia. W zależności od ilości pracy lub zaległości, ten proces może zająć trochę czasu.

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

  • Wyzwalacz nie uruchamia się przy następnym spełnieniu warunków.

  • Stan wyzwalacza zapamiętuje punkt, w którym zatrzymano przepływ pracy. Dlatego jeśli ponownie reaktywujesz aplikację Logic Apps, wyzwalacz uruchomi się dla wszystkich elementów, które od ostatniego uruchomienia nie zostały jeszcze przetworzone.

    Aby zatrzymać wyzwalacz przed uruchomieniem na tych nieprzetworzonych elementach, przed ponownym aktywowaniem zasobu aplikacji logiki, wyczyść stan wyzwalacza.

    1. W przepływie pracy edytuj dowolną część wyzwalacza.
    2. Zapisz zmiany. Ten krok powoduje zresetowanie bieżącego stanu wyzwalacza.
    3. Ponownie uaktywnij zasób aplikacji logiki.
  • Gdy zasób aplikacji logiki jest wyłączony, nadal można ponownie przesłać przebiegi przepływu pracy.

Aby wyłączyć lub włączyć zasób aplikacji logiki w programie Visual Studio Code, wykonaj następujące kroki:

  1. W programie Visual Studio Code otwórz okno platformy Azure.

  2. W sekcji Logic Apps (Zużycie) rozwiń subskrypcję platformy Azure, aby wyświetlić skojarzone aplikacje logiki.

  3. Aby wyłączyć zasób aplikacji logiki, w menu skrótów aplikacji logiki wybierz pozycję Wyłącz.

    Zrzut ekranu przedstawiający Visual Studio Code i jak wyłączyć zasób Logic Apps.

  4. Gdy wszystko będzie gotowe do ponownego aktywowania zasobu aplikacji logiki, w menu skrótów aplikacji logiki wybierz pozycję Włącz.

    Zrzut ekranu przedstawiający program Visual Studio Code i sposób włączania zasobu aplikacji logicznej.

Usuwanie aplikacji logiki

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

  • Usługa Azure Logic Apps próbuje anulować wszelkie uruchomienia przepływów pracy, które są w toku lub oczekujące.

    Nawet w przypadku dużego wolumenu lub zaległości większość procesów jest anulowana przed ich zakończeniem lub rozpoczęciem. Jednak ukończenie procesu anulowania może zająć trochę czasu. W międzyczasie usługa może przyjmować niektóre zadania do wykonania, podczas przebiegu procesu anulowania.

  • 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 będzie miał inne metadane. Należy ponownie zapisać każdy przepływ pracy, który wywołał usunięty przepływ pracy. Podczas ponownego zapisania wywołujący pobiera poprawne informacje dotyczące ponownie utworzonego przepływu pracy. W przeciwnym razie wywołania do ponownie utworzonego 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.

Aby usunąć zasób aplikacji logiki z programu Visual Studio Code, wykonaj następujące kroki:

  1. W programie Visual Studio Code otwórz okno platformy Azure.

  2. W sekcji Logic Apps (Zużycie) rozwiń subskrypcję platformy Azure, aby wyświetlić skojarzone zasoby aplikacji logiki. Znajdź zasób aplikacji logiki, który chcesz usunąć.

  3. Z menu skrótów aplikacji logiki wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający program Visual Studio Code oraz sposób na usunięcie zasobu aplikacji logicznej.