Szybki start: tworzenie definicji przepływów pracy aplikacji logiki i zarządzanie nimi za pomocą wielodostępnych usług Azure Logic Apps i Visual Studio Code

Artykuł
01/10/2024

Dotyczy: Azure Logic Apps (Zużycie)

W tym przewodniku Szybki start pokazano, jak tworzyć przepływy pracy aplikacji logiki i zarządzać nimi, które ułatwiają automatyzowanie zadań i procesów integrujących aplikacje, dane, systemy i usługi w organizacjach i przedsiębiorstwach przy użyciu wielodostępnych usług Azure Logic Apps i Visual Studio Code. Możesz tworzyć i edytować bazowe definicje przepływu pracy, które używają formatu JavaScript Object Notation (JSON) dla aplikacji logiki za pomocą środowiska opartego na kodzie. Możesz również pracować nad istniejącymi aplikacjami logiki, które zostały już wdrożone na platformie Azure. Aby uzyskać więcej informacji na temat wielodostępnego i pojedynczego modelu dzierżawy, zapoznaj się z artykułem Single-tenant versus multitenant and integration service environment (Środowisko usługi jednodostępnej i wielodostępnej).

Chociaż możesz wykonywać te same zadania w witrynie Azure Portal i programie Visual Studio, możesz rozpocząć pracę szybciej w programie Visual Studio Code, gdy znasz już definicje aplikacji logiki i chcesz pracować bezpośrednio w kodzie. Możesz na przykład wyłączyć, włączyć, usunąć i odświeżyć już utworzone aplikacje logiki. Ponadto możesz pracować nad aplikacjami logiki i kontami integracji z dowolnej platformy programistycznej, na której działa program Visual Studio Code, takich jak Linux, Windows i Mac.

W tym artykule możesz utworzyć tę samą aplikację logiki z tego przewodnika Szybki start, która koncentruje się bardziej na podstawowych pojęciach. Możesz również dowiedzieć się, jak utworzyć przykładową aplikację w programie Visual Studio i nauczyć się tworzyć aplikacje i zarządzać nimi za pomocą interfejsu wiersza polecenia platformy Azure. W programie Visual Studio Code aplikacja logiki wygląda następująco:

Example logic app workflow definition

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy:

Jeśli nie masz konta i subskrypcji platformy Azure, utwórz bezpłatne konto platformy Azure.
Podstawowa wiedza na temat definicji przepływu pracy aplikacji logiki i ich struktury zgodnie z opisem w formacie JSON

Jeśli dopiero zaczynasz korzystać z usługi Azure Logic Apps, wypróbuj ten przewodnik Szybki start, który tworzy swój pierwszy przepływ pracy aplikacji logiki w witrynie Azure Portal i koncentruje się bardziej na podstawowych pojęciach.
Dostęp do internetu na potrzeby logowania się do platformy Azure i subskrypcji platformy Azure
Pobierz i zainstaluj te narzędzia, jeśli jeszcze ich nie masz:
- Program Visual Studio Code w wersji 1.25.1 lub nowszej, który jest bezpłatny
- Rozszerzenie programu Visual Studio Code dla usługi Azure Logic Apps
  
  To rozszerzenie można pobrać i zainstalować z witryny Visual Studio Marketplace lub bezpośrednio z poziomu programu Visual Studio Code. Upewnij się, że po zainstalowaniu ponownie załadujesz program Visual Studio Code.
  
  Aby sprawdzić, czy rozszerzenie jest zainstalowane poprawnie, wybierz ikonę platformy Azure wyświetlaną na pasku narzędzi programu Visual Studio Code.
  
  Aby uzyskać więcej informacji, zobacz Rozszerzenie Marketplace. Aby współtworzyć wersję typu open source tego rozszerzenia, odwiedź stronę rozszerzenia Azure Logic Apps dla programu Visual Studio Code w witrynie GitHub.
Jeśli aplikacja logiki musi komunikować się za pośrednictwem zapory, która ogranicza ruch do określonych adresów IP, zapora musi zezwolić na dostęp zarówno dla adresów IP przychodzących, jak i wychodzących używanych przez usługę Azure Logic Apps lub środowiska uruchomieniowego w regionie świadczenia usługi Azure, w którym istnieje aplikacja logiki. Jeśli aplikacja logiki używa również łączników zarządzanych, takich jak łącznik usługi Office 365 Outlook lub łącznik SQL, lub używa łączników niestandardowych, zapora musi również zezwolić na dostęp dla wszystkich wychodzących adresów IP łącznika zarządzanego w regionie platformy Azure aplikacji logiki.

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

Otwórz Visual Studio Code. Na pasku narzędzi programu Visual Studio Code wybierz ikonę platformy Azure.
W oknie platformy Azure w obszarze Logic Apps wybierz pozycję Zaloguj się do platformy Azure. Gdy na stronie logowania firmy Microsoft zostanie wyświetlony monit, zaloguj się przy użyciu konta platformy Azure.
1. 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, wybierz pozycję Użyj kodu urządzenia.
2. Aby skopiować kod, wybierz pozycję Kopiuj i otwórz.
3. Aby otworzyć nowe okno przeglądarki i przejść do witryny internetowej uwierzytelniania, wybierz pozycję Otwórz link.
4. Na stronie Zaloguj się do konta wprowadź kod uwierzytelniania, a następnie wybierz pozycję Dalej.
Wybierz swoje konto platformy Azure. Po zalogowaniu możesz zamknąć przeglądarkę i wrócić do programu Visual Studio Code.

W okienku Azure sekcje Konta usługi Logic Apps i Integracji zawierają teraz subskrypcje platformy Azure skojarzone z Twoim kontem. Jeśli jednak nie widzisz oczekiwanych subskrypcji lub jeśli sekcje zawierają zbyt wiele subskrypcji, wykonaj następujące kroki:
1. Przenieś wskaźnik na etykietę usługi Logic Apps . Po wyświetleniu paska narzędzi wybierz pozycję Wybierz subskrypcje (ikona filtru).
2. Z wyświetlonej listy wybierz subskrypcje, które chcesz wyświetlić.
W obszarze Logic Apps wybierz odpowiednią subskrypcję. Węzeł subskrypcji rozszerza się i pokazuje wszystkie aplikacje logiki, które istnieją w tej subskrypcji.

Napiwek

W obszarze Konta integracji wybranie subskrypcji spowoduje wyświetlenie wszystkich kont integracji, które istnieją w tej subskrypcji.

Tworzenie nowej aplikacji logiki

Jeśli jeszcze nie zalogowaliśmy się do konta platformy Azure i subskrypcji z poziomu programu Visual Studio Code, wykonaj poprzednie kroki, aby się zalogować teraz.
W programie Visual Studio Code w obszarze Logic Apps otwórz menu skrótów subskrypcji i wybierz pozycję Utwórz aplikację logiki.

Zostanie wyświetlona lista zawierająca wszystkie grupy zasobów platformy Azure w ramach subskrypcji.
Z listy grup zasobów wybierz pozycję Utwórz nową grupę zasobów lub istniejącą grupę zasobów. W tym przykładzie utwórz nową grupę zasobów.
Podaj nazwę grupy zasobów platformy Azure i naciśnij klawisz ENTER.
Wybierz region świadczenia usługi Azure, w którym chcesz zapisać metadane aplikacji logiki.
Podaj nazwę aplikacji logiki i naciśnij klawisz Enter.

W oknie platformy Azure w ramach subskrypcji platformy Azure zostanie wyświetlona nowa i pusta aplikacja logiki. Program Visual Studio Code otwiera również plik JSON (.logicapp.json), który zawiera szkieletową definicję przepływu pracy dla aplikacji logiki. Teraz możesz rozpocząć ręczne tworzenie definicji przepływu pracy aplikacji logiki 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.

Na przykład poniżej przedstawiono przykładową definicję przepływu pracy aplikacji logiki, która 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ą kroki aplikacji logiki są wyświetlane w projektancie.

Ważne

Jeśli chcesz ponownie użyć tej przykładowej definicji aplikacji logiki, potrzebujesz konta organizacyjnego, 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 Gmail. Aby uzyskać więcej informacji, zobacz Zasady zabezpieczeń i prywatności danych dla łączników Google w usłudze Azure Logic Apps.
```
{
 "$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": 1
 },
 "splitOn": "@triggerBody()?['value']",
 "type": "ApiConnection",
 "inputs": {
 "host": {
 "connection": {
 "name": "@parameters('$connections')['rss']['connectionId']"
 }
 },
 "method": "get",
 "path": "/OnNewFeed",
 "queries": {
 "feedUrl": "http://feeds.reuters.com/reuters/topNews"
 }
 }
 }
 },
 "actions": {
 "Send_an_email_(V2)": {
 "runAfter": {},
 "type": "ApiConnection",
 "inputs": {
 "body": {
 "Body": "Title: @{triggerBody()?['title']} \n \nDate published: @{triggerBody()?['updatedOn']} \n \nLink: @{triggerBody()?['primaryLink']}",
 "Subject": "RSS item: @{triggerBody()?['title']}",
 "To": "sophia-owen@fabrikam.com"
 },
 "host": {
 "connection": {
 "name": "@parameters('$connections')['office365']['connectionId']"
 }
 },
 "method": "post",
 "path": "/v2/Mail"
 }
 }
 },
 "outputs": {}
}
```
Po zakończeniu zapisz definicję przepływu pracy aplikacji logiki. (Menu > Plik Zapisz lub naciśnij klawisze Ctrl+S)
Po wyświetleniu monitu o przekazanie aplikacji logiki do subskrypcji platformy Azure wybierz pozycję Przekaż.

Ten krok publikuje aplikację logiki w witrynie Azure Portal, co sprawia, że logika jest aktywna i uruchomiona na platformie Azure.

Wyświetlanie aplikacji logiki w projektancie

W programie Visual Studio Code możesz otworzyć aplikację logiki w widoku projektu tylko do odczytu. Chociaż nie możesz edytować aplikacji logiki w projektancie, możesz wizualnie sprawdzić przepływ pracy aplikacji logiki przy użyciu widoku projektanta.

W oknie platformy Azure w obszarze Logic Apps otwórz menu skrótów aplikacji logiki i wybierz pozycję Otwórz w Projektant.

Projektant tylko do odczytu zostanie otwarty w osobnym oknie i wyświetli przepływ pracy aplikacji logiki, na przykład:

View logic app in read-only designer

Wyświetlanie w witrynie Azure Portal

Aby przejrzeć aplikację logiki w witrynie Azure Portal, wykonaj następujące kroki:

Zaloguj się do witryny Azure Portal przy użyciu tego samego konta platformy Azure i subskrypcji skojarzonej z aplikacją logiki.
W polu wyszukiwania witryny Azure Portal wprowadź nazwę aplikacji logiki. Z listy wyników wybierz aplikację logiki.

Edytowanie wdrożonej aplikacji logiki

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

Ważne

Przed rozpoczęciem edycji aktywnie działającej aplikacji logiki w środowisku produkcyjnym należy unikać ryzyka naruszenia tej aplikacji logiki i zminimalizować zakłócenia, wyłączając najpierw aplikację logiki.

Jeśli jeszcze nie zalogowaliśmy się do konta platformy Azure i subskrypcji z poziomu programu Visual Studio Code, wykonaj poprzednie kroki, aby się zalogować teraz.
W oknie Platformy Azure w obszarze Logic Apps rozwiń subskrypcję platformy Azure i wybierz odpowiednią aplikację logiki.
Otwórz menu aplikacji logiki i wybierz pozycję Otwórz w edytorze. Możesz też wybrać ikonę edycji obok nazwy aplikacji logiki.

Program Visual Studio Code otwiera plik .logicapp.json w lokalnym folderze tymczasowym, aby można było wyświetlić definicję przepływu pracy aplikacji logiki.
Wprowadź zmiany w definicji przepływu pracy aplikacji logiki.
Gdy wszystko będzie gotowe, zapisz zmiany. (Menu > Plik Zapisz lub naciśnij klawisze Ctrl+S)
Po wyświetleniu monitu o przekazanie zmian i zastąpienie istniejącej aplikacji logiki w witrynie Azure Portal wybierz pozycję Przekaż.

Ten krok publikuje aktualizacje aplikacji logiki w witrynie Azure Portal.

Wyświetlanie lub podwyższanie poziomu innych wersji

W programie Visual Studio Code możesz otworzyć i przejrzeć wcześniejsze wersje aplikacji logiki. Możesz również podwyższyć poziom starszej wersji do bieżącej wersji.

Ważne

Przed zmianą aktywnie działającej aplikacji logiki w środowisku produkcyjnym należy unikać ryzyka naruszenia tej aplikacji logiki i zminimalizować zakłócenia, wyłączając najpierw aplikację logiki.

W oknie Platformy Azure w obszarze Logic Apps rozwiń subskrypcję platformy Azure, aby wyświetlić wszystkie aplikacje logiki w tej subskrypcji.
W ramach subskrypcji rozwiń swoją aplikację logiki i rozwiń pozycję Wersje.

Lista Wersje zawiera wcześniejsze wersje aplikacji logiki, jeśli istnieją.
Aby wyświetlić starszą wersję, wybierz dowolny krok:
- Aby wyświetlić definicję JSON, w obszarze Wersje wybierz numer wersji dla tej definicji. Możesz też otworzyć menu skrótów tej wersji i wybrać pozycję Otwórz w edytorze.
  
  Nowy plik zostanie otwarty na komputerze lokalnym i pokazuje, że definicja JSON wersji.
- Aby wyświetlić wersję w widoku projektanta tylko do odczytu, otwórz menu skrótów tej wersji i wybierz pozycję Otwórz w Projektant.
Aby podwyższyć poziom starszej wersji do bieżącej wersji, wykonaj następujące kroki:
1. W obszarze Wersje otwórz menu skrótów starszej wersji i wybierz pozycję Podwyższ poziom.
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 programie Visual Studio Code, jeśli edytujesz opublikowaną aplikację logiki i zapiszesz zmiany, zastąpisz już wdrożona aplikację. Aby uniknąć przerywania działania aplikacji logiki w środowisku produkcyjnym i zminimalizować zakłócenia, najpierw wyłącz aplikację logiki. Następnie możesz ponownie uaktywnić aplikację logiki po potwierdzeniu, że aplikacja logiki nadal działa.

Usługa Azure Logic Apps kontynuuje wszystkie przebiegi w toku i oczekujące do ich zakończenia. Na podstawie woluminu lub listy prac 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 zostanie wyzwolony przy następnym spełnieniu warunków.
Stan wyzwalacza zapamiętuje punkt, w którym aplikacja logiki została zatrzymana. Dlatego jeśli ponownie uaktywnisz aplikację logiki, wyzwalacz zostanie wyzwolony dla wszystkich nieprzetworzonych elementów od ostatniego uruchomienia.

Aby zatrzymać wyzwalacz w przypadku nieprzetworzonych elementów od ostatniego uruchomienia, wyczyść stan wyzwalacza przed ponownym uaktywnieniem aplikacji logiki:
1. W aplikacji logiki edytuj dowolną część wyzwalacza przepływu pracy.
2. Zapisz zmiany. Ten krok powoduje zresetowanie bieżącego stanu wyzwalacza.
3. Ponowne aktywowanie aplikacji logiki.
Gdy przepływ pracy jest wyłączony, nadal można ponownie przesłać przebiegi.

Jeśli jeszcze nie zalogowaliśmy się do konta platformy Azure i subskrypcji z poziomu programu Visual Studio Code, wykonaj poprzednie kroki, aby się zalogować teraz.
W oknie Platformy Azure w obszarze Logic Apps rozwiń subskrypcję platformy Azure, aby wyświetlić wszystkie aplikacje logiki w tej subskrypcji.
1. Aby wyłączyć odpowiednią aplikację logiki, otwórz menu aplikacji logiki i wybierz pozycję Wyłącz.
2. Gdy wszystko będzie gotowe do ponownego aktywowania aplikacji logiki, otwórz menu aplikacji logiki i wybierz pozycję Włącz.

Usuwanie aplikacji logiki

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

Usługa Azure Logic Apps pozwala anulować wszystkie przebiegi w toku i oczekujące.

Nawet w przypadku dużego woluminu lub listy prac większość przebiegów jest anulowana przed zakończeniem lub rozpoczęciem. Jednak ukończenie procesu anulowania może zająć trochę czasu. W międzyczasie niektóre uruchomienia mogą zostać pobrane do wykonania, gdy usługa działa przez proces 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 nie będzie miał tych samych metadanych co usunięty przepływ pracy. Musisz ponownie zapisać dowolny przepływ pracy, który nazwał usunięty przepływ pracy. W ten sposób obiekt wywołujący pobiera poprawne informacje dotyczące ponownie tworzonego przepływu pracy. W przeciwnym razie wywołania ponownego utworzenia przepływu pracy kończą się niepowodzeniem z powodu błędu Unauthorized . To zachowanie dotyczy również przepływów pracy, które używają artefaktów na kontach integracji i przepływach pracy wywołujących funkcje platformy Azure.

Jeśli jeszcze nie zalogowaliśmy się do konta platformy Azure i subskrypcji z poziomu programu Visual Studio Code, wykonaj poprzednie kroki, aby się zalogować teraz.
W oknie Platformy Azure w obszarze Logic Apps rozwiń subskrypcję platformy Azure, aby wyświetlić wszystkie aplikacje logiki w tej subskrypcji.
Znajdź aplikację logiki, którą chcesz usunąć, otwórz menu aplikacji logiki i wybierz pozycję Usuń.

Następne kroki

Tworzenie przepływów pracy aplikacji logiki opartej na jednej dzierżawie w programie Visual Studio Code