Esempio di script dell'interfaccia della riga di comando di Azure - Creare un'app per la logica

Articolo
01/04/2024

Si applica a: App per la logica di Azure (consumo)

Questo script crea un'app per la logica di esempio tramite l'estensione App per la logica dell'interfaccia della riga di comando di Azure (az logic). Per una guida dettagliata alla creazione e alla gestione delle app per la logica tramite l'interfaccia della riga di comando di Azure, vedere la guida introduttiva alle app per la logica per l'interfaccia della riga di comando di Azure.

Avviso

L'estensione app per la logica dell'interfaccia della riga di comando di Azure è attualmente sperimentale e non è coperta dall'assistenza clienti. Usare questa estensione dell'interfaccia della riga di comando con cautela, soprattutto se si sceglie di usare l'estensione negli ambienti di produzione.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, creare un account gratuito.
L'interfaccia della riga di comando di Azure installata nel computer locale.
L'estensione app per la logica dell'interfaccia della riga di comando di Azure installata nel computer. Per installare questa estensione, usare il comando seguente: az extension add --name logic
Definizione del flusso di lavoro per l'app per la logica. Questo file JSON deve seguire lo schema del linguaggio di definizione del flusso di lavoro.
Connessione API a un account di posta elettronica tramite un connettore di App per la logica di Azure supportato nello stesso gruppo di risorse dell'app per la logica. In questo esempio viene utilizzato il connettore Office 365 Outlook, ma è anche possibile usare altri connettori come Outlook.com.

Controllo dei prerequisiti

Prima di iniziare, convalidare l'ambiente:

Accedere al portale di Azure e verificare che la sottoscrizione sia attiva eseguendo az login.
Controllare la versione dell'interfaccia della riga di comando di Azure in una finestra terminale o di comando eseguendo az --version. Per la versione più recente, vedere le ultime note sulla versione.
- Se non si dispone della versione più recente, aggiornare l'installazione seguendo la guida all'installazione per il sistema operativo o la piattaforma in uso.

Spiegazione del flusso di lavoro di esempio

Questo file di definizione del flusso di lavoro di esempio crea lo stesso flusso di lavoro dell'app per la logica a consumo di esempio come illustrato nella guida introduttiva per il portale di Azure.

Questo flusso di lavoro di esempio:

Specifica uno schema, $schema, per l'app per la logica.
Definisce un trigger per l'app per la logica nell'elenco di trigger, triggers. Il trigger si ripete (recurrence) ogni 3 ore. Le azioni vengono attivate quando viene pubblicato un nuovo elemento del feed (When_a_feed_item_is_published) per il feed RSS specificato (feedUrl).
Definisce un'azione per l'app per la logica nell'elenco di azioni, actions. L'azione invia un messaggio di posta elettronica (Send_an_email_(V2)) tramite Microsoft 365 con i dettagli degli elementi del feed RSS come specificato nella sezione corpo (body) degli input dell'azione (inputs).

Definizione del flusso di lavoro di esempio

Prima di eseguire lo script di esempio, è necessario creare una definizione del flusso di lavoro di esempio.

Creare un file JSON nel testDefinition.json computer.

Copiare il contenuto seguente nel file 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"
                }
            }
        }
    }
}

Aggiornare i valori segnaposto con le proprie informazioni:
1. Sostituire l'indirizzo di posta elettronica segnaposto ("To": "test@example.com"). È necessario usare un indirizzo di posta elettronica compatibile con i connettori di App per la logica. Per altre informazioni, vedere i prerequisiti.
2. Sostituire i dettagli aggiuntivi del connettore se si usa un altro connettore di posta elettronica rispetto al connettore di Outlook Office 365.
3. Sostituire i valori della sottoscrizione segnaposto (00000000-0000-0000-0000-000000000000) per gli identificatori di connessione (connectionId e id) nel parametro connections ($connections) con i valori di sottoscrizione personalizzati.
Salvare le modifiche.

Script di esempio

Nota

Questo esempio viene scritto per la bash shell. Se si vuole eseguire questo esempio in un'altra shell, ad esempio Windows PowerShell o prompt dei comandi, potrebbe essere necessario apportare modifiche allo script.

Prima di eseguire questo script di esempio, eseguire questo comando per connettersi ad Azure:


az login

Passare quindi alla directory in cui è stata creata la definizione del flusso di lavoro. Ad esempio, se è stato creato il file JSON di definizione del flusso di lavoro sul desktop:


cd ~/Desktop

Eseguire quindi questo script per creare un'app per la logica.


#!/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"

Pulire la distribuzione

Al termine dell'uso dello script di esempio, eseguire il comando seguente per rimuovere il gruppo di risorse e tutte le risorse annidate, inclusa l'app per la logica.


az group delete --name testResourceGroup --yes

Spiegazione dello script

Questo script di esempio usa i comandi seguenti per creare un nuovo gruppo di risorse e un'app per la logica.

Comando	Note
`az group create`	Crea un gruppo di risorse in cui vengono archiviate le risorse dell'app per la logica.
`az logic workflow create`	Crea un'app per la logica basata sul flusso di lavoro definito nel parametro `--definition`.
`az group delete`	Elimina un gruppo di risorse e tutte le relative risorse annidate.

Passaggi successivi

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.

Per altri esempi di script dell'interfaccia della riga di comando di App per la logica, vedere Esplora gli esempi di codice.

Condividi tramite