Przykładowy skrypt interfejsu wiersza polecenia platformy Azure — tworzenie aplikacji logiki

Artykuł
01/04/2024

Dotyczy: Azure Logic Apps (Zużycie)

Ten skrypt tworzy przykładową aplikację logiki za pomocą rozszerzenia usługi Logic Apps interfejsu wiersza polecenia platformy Azure (az logic). Aby uzyskać szczegółowy przewodnik dotyczący tworzenia aplikacji logiki i zarządzania nimi za pomocą interfejsu wiersza polecenia platformy Azure, zobacz przewodnik Szybki start dotyczący usługi Logic Apps dla interfejsu wiersza polecenia platformy Azure.

Ostrzeżenie

Rozszerzenie usługi Logic Apps interfejsu wiersza polecenia platformy Azure jest obecnie eksperymentalne i nie jest objęte pomocą techniczną. Użyj tego rozszerzenia interfejsu wiersza polecenia ostrożnie, zwłaszcza jeśli zdecydujesz się używać rozszerzenia w środowiskach produkcyjnych.

Wymagania wstępne

Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz subskrypcji platformy Azure, utwórz bezpłatne konto.
Interfejs wiersza polecenia platformy Azure zainstalowany na komputerze lokalnym.
Rozszerzenie interfejsu wiersza polecenia platformy Azure usługi Logic Apps zainstalowane na komputerze. Aby zainstalować to rozszerzenie, użyj następującego polecenia: az extension add --name logic
Definicja przepływu pracy dla aplikacji logiki. Ten plik JSON musi być zgodny ze schematem języka definicji przepływu pracy.
Połączenie interfejsu API z kontem e-mail za pośrednictwem obsługiwanego łącznika usługi Azure Logic Apps w tej samej grupie zasobów co aplikacja logiki. W tym przykładzie użyto łącznika Office 365 Outlook, ale można również użyć innych łączników, takich jak Outlook.com.

Sprawdzanie wymagań wstępnych

Przed rozpoczęciem sprawdź poprawność środowiska:

Zaloguj się do Azure Portal i sprawdź, czy subskrypcja jest aktywna, uruchamiając polecenie az login.
Sprawdź wersję interfejsu wiersza polecenia platformy Azure w terminalu lub oknie polecenia, uruchamiając polecenie az --version. Aby uzyskać najnowszą wersję, zobacz najnowsze informacje o wersji.
- Jeśli nie masz najnowszej wersji, zaktualizuj instalację, postępując zgodnie z przewodnikiem instalacji dla systemu operacyjnego lub platformy.

Wyjaśnienie przykładowego przepływu pracy

Ten przykładowy plik definicji przepływu pracy tworzy ten sam podstawowy przykład przepływ pracy aplikacji logiki Zużycie, co w przewodniku Szybki start dla Azure Portal.

Ten przykładowy przepływ pracy:

Określa schemat , $schemadla aplikacji logiki.
Definiuje wyzwalacz dla aplikacji logiki na liście wyzwalaczy triggers. Wyzwalacz jest powtarzany (recurrence) co 3 godziny. Akcje są wyzwalane po opublikowaniu nowego elementu kanału informacyjnego (When_a_feed_item_is_published) dla określonego kanału informacyjnego RSS (feedUrl).
Definiuje akcję dla aplikacji logiki na liście akcji actions. Akcja wysyła wiadomość e-mail (Send_an_email_(V2)) do platformy Microsoft 365 ze szczegółami z elementów kanału informacyjnego RSS, jak określono w sekcji treści (body) danych wejściowych akcji (inputs).

Przykładowa definicja przepływu pracy

Przed uruchomieniem przykładowego skryptu należy najpierw utworzyć przykładową definicję przepływu pracy.

Utwórz plik testDefinition.json JSON na komputerze.

Skopiuj następującą zawartość do pliku JSON:


{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {
            "Send_an_email_(V2)": {
                "inputs": {
                    "body": {
                        "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                        "Subject": "@triggerBody()?['title']",
                        "To": "test@example.com"
                    },
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['office365']['connectionId']"
                        }
                    },
                    "method": "post",
                    "path": "/v2/Mail"
                },
                "runAfter": {},
                "type": "ApiConnection"
            }
        },
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {
            "$connections": {
                "defaultValue": {},
                "type": "Object"
            }
        },
        "triggers": {
            "When_a_feed_item_is_published": {
                "inputs": {
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['rss']['connectionId']"
                        }
                    },
                    "method": "get",
                    "path": "/OnNewFeed",
                    "queries": {
                        "feedUrl": "https://www.pbs.org/now/rss.xml"
                    }
                },
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 3
                },
                "splitOn": "@triggerBody()?['value']",
                "type": "ApiConnection"
            }
        }
    },
    "parameters": {
        "$connections": {
            "value": {
                "office365": {
                    "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                    "connectionName": "office365",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                },
                "rss": {
                    "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                    "connectionName": "rss",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                }
            }
        }
    }
}

Zaktualizuj wartości symboli zastępczych własnymi informacjami:
1. Zastąp symbol zastępczy adres e-mail ("To": "test@example.com"). Musisz użyć adresu e-mail zgodnego z łącznikami usługi Logic Apps. Aby uzyskać więcej informacji, zobacz wymagania wstępne.
2. Zastąp dodatkowe szczegóły łącznika, jeśli używasz innego łącznika poczty e-mail niż łącznik Office 365 Outlook.
3. Zastąp symbol zastępczy wartości subskrypcji (00000000-0000-0000-0000-000000000000) dla identyfikatorów połączeń (connectionId i id) w parametrze connections ($connections) własnymi wartościami subskrypcji.
Zapisz zmiany.

Przykładowy skrypt

Uwaga

Ten przykład jest napisany dla powłoki bash . Jeśli chcesz uruchomić ten przykład w innej powłoce, takiej jak Windows PowerShell lub wiersz polecenia, może być konieczne wprowadzenie modyfikacji skryptu.

Przed uruchomieniem tego przykładowego skryptu uruchom następujące polecenie, aby nawiązać połączenie z platformą Azure:


az login

Następnie przejdź do katalogu, w którym utworzono definicję przepływu pracy. Jeśli na przykład utworzono plik JSON definicji przepływu pracy na pulpicie:


cd ~/Desktop

Następnie uruchom ten skrypt, aby utworzyć aplikację logiki.


#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

Czyszczenie wdrożenia

Po zakończeniu korzystania z przykładowego skryptu uruchom następujące polecenie, aby usunąć grupę zasobów i wszystkie jej zagnieżdżone zasoby, w tym aplikację logiki.


az group delete --name testResourceGroup --yes

Objaśnienia dla skryptu

Ten przykładowy skrypt używa następujących poleceń do utworzenia nowej grupy zasobów i aplikacji logiki.

Polecenie	Uwagi
`az group create`	Tworzy grupę zasobów, w której są przechowywane zasoby aplikacji logiki.
`az logic workflow create`	Tworzy aplikację logiki na podstawie przepływu pracy zdefiniowanego w parametrze `--definition`.
`az group delete`	Usuwa grupę zasobów i wszystkie jej zagnieżdżone zasoby.

Następne kroki

Aby uzyskać więcej informacji na temat interfejsu wiersza polecenia platformy Azure, zobacz dokumentację interfejsu wiersza polecenia platformy Azure.

Dodatkowe przykłady skryptów interfejsu wiersza polecenia usługi Logic Apps można znaleźć w przeglądarce przykładów kodu firmy Microsoft.

Udostępnij za pośrednictwem