Creare un flusso di lavoro Standard di esempio in App per la logica di Azure a tenant singolo con il portale di Azure

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

Questa guida pratica illustra come creare un flusso di lavoro automatizzato di esempio che attende una richiesta Web in ingresso e quindi invia un messaggio a un account di posta elettronica. In particolare, si creerà una risorsa dell'app per la logica Standard, che può includere più flussi di lavoro con stato e senza stato eseguiti in App per la logica di Azure a tenant singolo.

Nota

Per creare questo flusso di lavoro di esempio in Visual Studio Code, seguire invece la procedura descritta in Creare flussi di lavoro standard in App per la logica di Azure a tenant singolo con Visual Studio Code. Entrambe le opzioni offrono la possibilità di sviluppare, eseguire e distribuire flussi di lavoro delle app per la logica negli stessi tipi di ambienti. Tuttavia, con Visual Studio Code, è possibile sviluppare, testare ed eseguire flussi di lavoro in locale nell'ambiente di sviluppo.

Anche se questo flusso di lavoro di esempio è basato sul cloud e include solo due passaggi, è possibile creare flussi di lavoro da centinaia di operazioni in grado di connettere un'ampia gamma di app, dati, servizi e sistemi in ambienti cloud, locali e ibridi. Il flusso di lavoro di esempio inizia con il trigger predefinito Richiesta, seguito da un'azione di Office 365 Outlook. Il trigger crea un endpoint chiamabile per il flusso di lavoro e attende una richiesta HTTPS in ingresso da qualsiasi chiamante. Quando il trigger riceve una richiesta e viene attivata, l'azione successiva viene eseguita inviando un messaggio di posta elettronica all'indirizzo di posta elettronica specificato insieme agli output selezionati dal trigger.

Man mano che si procede, verranno completate queste attività generali:

• Creare una risorsa dell'app per la logica Standard e aggiungere un flusso di lavoro con stato vuoto.
• Aggiungere un trigger e un'azione.
• Attivare un'esecuzione del flusso di lavoro.
• Visualizzare la cronologia di esecuzione e trigger del flusso di lavoro.
• Abilitare o aprire Application Insights dopo la distribuzione.
• Abilitare la cronologia di esecuzione per i flussi di lavoro senza stato.

Nei App per la logica di Azure a tenant singolo, i flussi di lavoro nella stessa risorsa dell'app per la logica e nel tenant vengono eseguiti nello stesso processo del runtime, in modo da condividere le stesse risorse e offrire prestazioni migliori. Per altre informazioni sui App per la logica di Azure a tenant singolo, vedere Ambiente del servizio multi-tenant e multi-tenant.

Prerequisiti

• Account e sottoscrizione di Azure. Se non si ha una sottoscrizione, è possibile iscriversi per creare un account Azure gratuito.

• Un account di archiviazione di Azure. Se non è disponibile, è possibile creare un account di archiviazione in anticipo o durante la creazione dell'app per la logica.

  Nota

  Il tipo di risorsa app per la logica Standard è basato su Funzioni di Azure e presenta requisiti di archiviazione simili alle app per le funzioni. I flussi di lavoro con stato eseguono transazioni di archiviazione, ad esempio l'uso di code per la pianificazione e l'archiviazione degli stati del flusso di lavoro in tabelle e BLOB. Queste transazioni comportano addebiti per l'archiviazione. Per altre informazioni sul modo in cui i flussi di lavoro con stato archiviano i dati nell'archiviazione esterna, vedere Flussi di lavoro con stato e senza stato.

• Per creare lo stesso flusso di lavoro di esempio in questa guida, è necessario un account di posta elettronica di Office 365 Outlook che usa un account microsoft aziendale o dell'istituto di istruzione per accedere.

  Se non si ha un account di Office 365, è possibile usare qualsiasi altro connettore di posta elettronica disponibile in grado di inviare messaggi dall'account di posta elettronica, ad esempio Outlook.com. Se si usa un connettore di posta elettronica diverso, è comunque possibile seguire l'esempio e i passaggi generali sono gli stessi. Tuttavia, le opzioni potrebbero differire in alcuni modi. Ad esempio, se si usa il connettore Outlook.com, usare l'account Microsoft personale per accedere.

• Per testare il flusso di lavoro di esempio in questa guida, è necessario uno strumento in grado di inviare chiamate all'endpoint creato dal trigger di richiesta. Se non si dispone di uno strumento di questo tipo, è possibile scaricare, installare e usare Postman.

• Se si crea la risorsa dell'app per la logica e si abilita Application Insights, è possibile abilitare facoltativamente la registrazione diagnostica e la traccia per l'app per la logica. È possibile farlo quando si crea l'app per la logica o dopo la distribuzione. È necessario avere un'istanza di Application Insights, ma è possibile creare questa risorsa in anticipo, quando si crea l'app per la logica o dopo la distribuzione.

• Per distribuire la risorsa dell'app per la logica Standard in un ambiente del servizio app v3 (A edizione Standard v3): solo il piano di Windows deve prima creare questa risorsa di ambiente. È quindi possibile selezionare questo ambiente come percorso di distribuzione quando si crea la risorsa dell'app per la logica. Per altre informazioni, vedere Tipi di risorse e ambienti e Creare un ambiente del servizio app.

• A partire da metà ottobre 2022, i nuovi flussi di lavoro delle app per la logica Standard nel portale di Azure usano automaticamente Funzioni di Azure v4. Durante tutto il mese di novembre 2022, i flussi di lavoro Standard esistenti nella portale di Azure vengono automaticamente migrati a Funzioni di Azure v4. A meno che le app per la logica Standard non siano state distribuite come progetti basati su NuGet o aggiunte alle app per la logica a una versione bundle specifica, questo aggiornamento è progettato per non richiedere alcuna azione né avere un impatto sul runtime. Tuttavia, se le eccezioni si applicano all'utente o per altre informazioni sul supporto Funzioni di Azure v4, vedere App per la logica di Azure Standard supporta ora Funzioni di Azure v4.

Procedure consigliate e raccomandazioni

Per una velocità di risposta e prestazioni ottimali della finestra di progettazione, esaminare e seguire queste linee guida:

• Usare non più di 50 azioni per flusso di lavoro. Il superamento di questo numero di azioni genera la possibilità di rallentare le prestazioni della finestra di progettazione.

• Valutare la possibilità di suddividere la logica di business in più flussi di lavoro, se necessario.

• Non avere più di 10-15 flussi di lavoro per ogni risorsa dell'app per la logica.

Più flussi di lavoro nell'app per la logica aumentano il rischio di tempi di caricamento più lunghi, che influiscono negativamente sulle prestazioni. Se sono presenti app per la logica cruciali che richiedono distribuzioni senza tempi di inattività, è consigliabile configurare gli slot di distribuzione.

Creare una risorsa dell'app per la logica Standard

1. Accedere al portale di Azure con l'account di Azure personale.

2. Nella casella di ricerca portale di Azure immettere app per la logica e selezionare App per la logica.

   

3. Nella pagina App per la logica selezionare Aggiungi.

4. Nella scheda Informazioni di base della pagina Crea app per la logica specificare le informazioni di base seguenti sull'app per la logica:

   Proprietà	Richiesto	Valore	Descrizione
   Abbonamento	Sì	<Azure-subscription-name>	Il nome della sottoscrizione di Azure.
   Gruppo di risorse	Sì	<Azure-resource-group-name>	Il gruppo di risorse di Azure in cui si crea l'app per la logica e le risorse correlate. Questo nome deve essere univoco tra aree e può contenere solo lettere, numeri, trattini (-), caratteri di sottolineatura (_), parentesi (()) e punti (.). In questo esempio viene creato un gruppo di risorse denominato Fabrikam-Workflows-RG.
   Nome dell'app per la logica	Sì	<logic-app-name>	Il nome della risorsa dell'app per la logica, che deve essere univoco tra aree e può contenere solo lettere, numeri, trattini (-), caratteri di sottolineatura (_), parentesi (()) e punti (.). Nota: il nome dell'app per la logica ottiene automaticamente il suffisso .azurewebsites.net, perché la risorsa dell'app per la logica Standard è basata sul runtime di App per la logica di Azure tenant singolo, che usa il modello di estendibilità Funzioni di Azure ed è ospitata come estensione nel runtime Funzioni di Azure. Funzioni di Azure usa la stessa convenzione di denominazione delle app. Questo esempio crea un'app per la logica denominata Fabrikam-Workflows.

5. Prima di continuare con le selezioni, passare alla sezione Piano. Per Tipo di piano selezionare Standard in modo da visualizzare solo le impostazioni applicabili al tipo di app per la logica basata su piano Standard.

   La proprietà Tipo di piano specifica il piano di hosting e il modello di fatturazione da usare per l'app per la logica. Per altre informazioni, vedere Piani di hosting e piani tariffari.

   Tipo di piano	Descrizione
   Standard	Questo tipo di app per la logica è la selezione predefinita. I flussi di lavoro vengono eseguiti in App per la logica di Azure a tenant singolo e usano il modello di fatturazione Standard.
   Consumo	Questo tipo di app per la logica e il flusso di lavoro vengono eseguiti in App per la logica di Azure globali multi-tenant e usa il modello di fatturazione a consumo.

   Proprietà	Richiesto	Valore	Descrizione
   Piano Windows	Sì	<plan-name>	Nome del piano da usare. Selezionare un nome di piano esistente o specificare un nome per un nuovo piano. Questo esempio usa il nome My-App-Service-Plan. Nota: è supportato solo il piano di servizio app basato su Windows. Non usare un piano di servizio app basato su Linux.
   Piano tariffario	Sì	<piano tariffario>	Piano tariffario da usare per l'app per la logica e i flussi di lavoro. La selezione influisce sui prezzi, il calcolo, la memoria e l'archiviazione usati dall'app per la logica e dai flussi di lavoro. Per altre informazioni, vedere Piani di hosting e piani tariffari.

6. Continuare ora a effettuare le selezioni seguenti:

   Proprietà	Richiesto	Valore	Descrizione
   Pubblicazione	Sì	Flusso di lavoro	Questa opzione viene visualizzata e si applica solo quando il tipo di piano è impostato sul tipo di app per la logica Standard . Per impostazione predefinita, questa opzione è impostata su Workflow e crea una risorsa dell'app per la logica vuota in cui si aggiunge il primo flusso di lavoro. Nota: attualmente, l'opzione Contenitore Docker richiede una posizione personalizzata in un cluster Kubernetes con abilitazione di Azure Arc, che è possibile usare con App per la logica abilitate per Azure Arc (Standard). Le posizioni delle risorse per l'app per la logica, la posizione personalizzata e il cluster devono essere tutte uguali.
   Area	Sì	<Area di Azure>	Area del data center di Azure da usare per archiviare le informazioni dell'app. Questo esempio distribuisce l'app per la logica di esempio nell'area Stati Uniti occidentali di Azure. - Se in precedenza si è scelto Contenitore Docker, selezionare la posizione personalizzata dall'elenco Area . - Se si vuole distribuire l'app in una risorsa ambiente del servizio app v3 esistente, è possibile selezionare tale ambiente dall'elenco Area.

   Nota

   Se si seleziona un'area di Azure che supporta la ridondanza della zona di disponibilità, la sezione Ridondanza della zona è abilitata. Questa sezione offre la scelta di abilitare la ridondanza della zona di disponibilità per l'app per la logica. Tuttavia, le aree di Azure attualmente supportate non includono Stati Uniti occidentali, quindi è possibile ignorare questa sezione per questo esempio. Per altre informazioni, vedere Proteggere le app per la logica da errori di area con ridondanza della zona e zone di disponibilità.

   Al termine, le impostazioni sono simili all'esempio seguente:

   

7. Nella scheda Hosting specificare le informazioni seguenti sulla soluzione di archiviazione e sul piano di hosting da usare per l'app per la logica.

   Proprietà	Richiesto	Valore	Descrizione
   Tipo di archiviazione	Sì	- Archiviazione di Azure - SQL e Archiviazione di Azure	Tipo di archiviazione da usare per gli artefatti e i dati correlati al flusso di lavoro. - Per eseguire la distribuzione solo in Azure, selezionare Archiviazione di Azure. - Per usare SQL come risorsa di archiviazione primaria e Archiviazione di Azure come risorsa di archiviazione secondaria, selezionare SQL e Archiviazione di Azure ed esaminare Configurare l'archiviazione del database SQL per le app per la logica Standard in App per la logica di Azure a tenant singolo. Nota: se si esegue la distribuzione in un'area di Azure, è comunque necessario un account di archiviazione di Azure, usato per completare l'hosting monouso della configurazione dell'app per la logica nella piattaforma App per la logica di Azure. Lo stato del flusso di lavoro, la cronologia di esecuzione e altri artefatti di runtime vengono archiviati nel database SQL. Per le distribuzioni in una posizione personalizzata ospitata in un cluster Azure Arc, è necessario solo SQL come provider di archiviazione.
   Account di archiviazione	Sì	<Azure-storage-account-name>	L'account Archiviazione di Azure da usare per le transazioni di archiviazione. Questo nome di risorsa deve essere univoco tra aree e avere 3-24 caratteri con solo numeri e lettere minuscole. Selezionare un account esistente o crearne uno nuovo. Questo esempio crea un account di archiviazione denominato mystorageacct.

8. Nella scheda Rete è possibile lasciare le opzioni predefinite per questo esempio.

   Per gli scenari specifici e reali, assicurarsi di esaminare e selezionare le opzioni appropriate. È anche possibile modificare questa configurazione dopo aver distribuito la risorsa dell'app per la logica. Per altre informazioni, vedere Proteggere il traffico tra app per la logica Standard e reti virtuali di Azure usando endpoint privati.

   Abilitare l'accesso pubblico	Comportamento
   On	L'app per la logica ha un endpoint pubblico con un indirizzo in ingresso aperto a Internet e non può accedere a una rete virtuale di Azure.
   Disattivato	L'app per la logica non ha un endpoint pubblico, ma ha invece un endpoint privato per la comunicazione all'interno di una rete virtuale di Azure ed è isolato in tale rete virtuale. L'endpoint privato può comunicare con gli endpoint nella rete virtuale, ma solo dai client all'interno di tale rete. Questa configurazione significa anche che il traffico dell'app per la logica può essere regolato da gruppi di sicurezza di rete o interessati dalle route di rete virtuale.

   Per consentire all'app per la logica di accedere agli endpoint in una rete virtuale, assicurarsi di selezionare l'opzione appropriata:

   Abilitare l'inserimento di rete	Comportamento
   On	I flussi di lavoro dell'app per la logica possono comunicare privatamente e in modo sicuro con gli endpoint nella rete virtuale.
   Disattivato	I flussi di lavoro dell'app per la logica non possono comunicare con gli endpoint nella rete virtuale.

9. Se le impostazioni di creazione e distribuzione supportano l'uso di Application Insights, è possibile abilitare facoltativamente la registrazione diagnostica e la traccia per i flussi di lavoro dell'app per la logica.

   1. Nella scheda Monitoraggio, in Application Insights, impostare Abilita Application Insights su Sì, se non è già selezionato.

   2. Per l'impostazione di Application Insights, selezionare un'istanza di Application Insights esistente o se si vuole creare una nuova istanza, selezionare Crea nuovo e specificare il nome da usare.

10. Dopo che Azure convalida le impostazioni dell'app per la logica, nella scheda Rivedi e crea selezionare Crea, ad esempio:

    

    Nota

    Se durante questo passaggio viene visualizzato un errore di convalida, aprire ed esaminare i dettagli dell'errore. Ad esempio, se l'area selezionata raggiunge una quota per le risorse che si sta tentando di creare, potrebbe essere necessario provare un'area diversa.

    Al termine della distribuzione di Azure, la risorsa dell'app per la logica è attiva automaticamente, ma non esegue ancora alcuna operazione perché la risorsa è vuota e non sono ancora stati aggiunti flussi di lavoro.

11. Nella pagina di completamento della distribuzione selezionare Vai alla risorsa in modo da poter aggiungere un flusso di lavoro vuoto.

    

Aggiungere un flusso di lavoro vuoto

Dopo aver creato la risorsa dell'app per la logica vuota, è necessario aggiungere il primo flusso di lavoro.

1. Dopo che Azure apre la risorsa, nel menu delle risorse dell'app per la logica selezionare Flussi di lavoro. Sulla barra degli strumenti Flussi di lavoro selezionare Aggiungi.

   

2. Dopo aver aperto il riquadro Nuovo flusso di lavoro , specificare un nome per il flusso di lavoro e selezionare il tipo di stato, con stato o senza stato. Al termine, seleziona Crea.

   In questo esempio viene aggiunto un flusso di lavoro con stato vuoto denominato Stateful-Workflow. Per impostazione predefinita, il flusso di lavoro è abilitato, ma non esegue alcuna operazione fino a quando non si aggiunge un trigger e azioni.

   

3. Nell'elenco del flusso di lavoro selezionare il flusso di lavoro con stato vuoto.

4. Nel menu del flusso di lavoro, in Sviluppatore, selezionare Progettazione.

   Nell'area di progettazione viene visualizzato un prompt per selezionare un'operazione di trigger. Per impostazione predefinita, il prompt è già selezionato in modo che venga già visualizzato un riquadro con trigger disponibili.

A questo punto si aggiungerà un trigger che avvia il flusso di lavoro.

Aggiungere un trigger

Questo flusso di lavoro di esempio inizia con il trigger di richiesta predefinito denominato Quando viene ricevuta una richiesta HTTP. Questo trigger crea un endpoint che altri servizi o flussi di lavoro dell'app per la logica possono chiamare e attendere l'arrivo di tali chiamate o richieste in ingresso. Le operazioni predefinite vengono eseguite in modo nativo e direttamente all'interno del runtime di App per la logica di Azure.

1. Nella finestra di progettazione del flusso di lavoro verificare che il flusso di lavoro vuoto sia aperto e che nell'area di progettazione sia selezionata l'opzione Aggiungi un trigger .

2. Usando la richiesta come termine di ricerca, seguire questa procedura per aggiungere il trigger di richiesta predefinito denominato Quando viene ricevuta una richiesta HTTP al flusso di lavoro.

   Quando il trigger viene visualizzato nella finestra di progettazione, viene aperto il riquadro informazioni del trigger per visualizzare le proprietà, le impostazioni e altre azioni del trigger.

   

3. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

   Quando si salva un flusso di lavoro per la prima volta e il flusso di lavoro inizia con un trigger di richiesta, App per la logica di Azure genera automaticamente un URL per un endpoint creato dal trigger richiesta. Successivamente, quando si testa il flusso di lavoro, si invia una richiesta a questo URL, che attiva il trigger e avvia l'esecuzione del flusso di lavoro.

Aggiunge un'azione

Questo flusso di lavoro di esempio continua con l'azione del connettore gestito di Office 365 Outlook denominata Invia un messaggio di posta elettronica. Le operazioni del connettore gestito vengono eseguite in Azure in modo nativo e direttamente nel runtime di App per la logica di Azure.

1. Nella finestra di progettazione, sotto il trigger aggiunto, selezionare il segno più (+) >Aggiungi un'azione.

   Viene visualizzato il riquadro Aggiungi un'azione in modo che sia possibile selezionare l'azione successiva.

2. Usando Office invia un messaggio di posta elettronica come termine di ricerca, seguire questa procedura per aggiungere l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2) al flusso di lavoro.

3. Nel riquadro delle informazioni dell'azione, nella scheda Crea Connessione ion selezionare Accedi in modo da poter creare una connessione all'account di posta elettronica.

   

4. Quando viene richiesto di accedere all'account di posta elettronica, accedere con le credenziali dell'account.

   Nota

   Se viene visualizzato il messaggio di errore "Failed with error: 'The browser is closed'. Accedi di nuovo", controlla se il browser blocca i cookie di terze parti. Se questi cookie sono bloccati, provare ad aggiungere https://portal.azure.com all'elenco dei siti che possono usare i cookie. Se si usa la modalità in incognito, assicurarsi che i cookie di terze parti non vengano bloccati durante il funzionamento in tale modalità.

   Se necessario, ricaricare la pagina, aprire il flusso di lavoro, aggiungere nuovamente l'azione di posta elettronica e provare a creare la connessione.

   Dopo che Azure ha creato la connessione, viene visualizzata l'azione Invia un messaggio di posta elettronica nella finestra di progettazione ed è selezionata per impostazione predefinita. Se l'azione non è selezionata, selezionare l'azione in modo che sia aperto anche il relativo riquadro informazioni.

5. Nel riquadro delle informazioni sull'azione, nella scheda Parametri , specificare le informazioni necessarie per l'azione, ad esempio:

   

   Proprietà	Richiesto	Valore	Descrizione
   Per	Sì	<indirizzo-posta-elettronica>	Destinatario del messaggio di posta elettronica, che può essere l'indirizzo di posta elettronica a scopo di test. In questo esempio viene usato il messaggio di posta elettronica fittizio, sophiaowen@fabrikam.com.
   Argomento	Sì	Un messaggio di posta elettronica dal flusso di lavoro di esempio	L'oggetto del messaggio di posta elettronica
   Testo	Sì	Ciao dal flusso di lavoro di esempio.	Contenuto del corpo del messaggio di posta elettronica

   Nota

   Quando si apportano modifiche nel riquadro informazioni delle schede Impostazioni, Risultato statico o Esegui dopo, assicurarsi di selezionare Fine per eseguire il commit di tali modifiche prima di passare alle schede o modificare lo stato attivo nella finestra di progettazione. In caso contrario, la finestra di progettazione non manterrà le modifiche.

6. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

7. Se l'ambiente ha requisiti di rete o firewall rigorosi che limitano il traffico, è necessario configurare le autorizzazioni per qualsiasi connessione di trigger o azione esistente nel flusso di lavoro. Per trovare i nomi di dominio completi, vedere Trovare i nomi di dominio per l'accesso al firewall.

   In caso contrario, per testare il flusso di lavoro, attivare manualmente un'esecuzione.

Eliminare elementi dalla finestra di progettazione

Per eliminare un elemento nel flusso di lavoro dalla finestra di progettazione, seguire questa procedura:

• Selezionare l'elemento, aprire il menu di scelta rapida dell'elemento (MAIUSC+F10) e selezionare Elimina. Per confermare, scegliere OK.

• Selezionare l'elemento e premere il tasto di eliminazione. Per confermare, scegliere OK.

• Selezionare l'elemento in modo che venga aperto il riquadro informazioni per l'elemento. Nell'angolo superiore destro del riquadro aprire i puntini di sospensione (...) e selezionare Elimina. Per confermare, scegliere OK.

  

  Suggerimento

  Se il menu con i puntini di sospensione non è visibile, espandere la finestra del browser sufficientemente ampia in modo che il riquadro informazioni mostri i puntini di sospensione (...) nell'angolo superiore destro.

Trovare i nomi di dominio per l'accesso al firewall

Prima di distribuire l'app per la logica ed eseguire il flusso di lavoro nel portale di Azure, se l'ambiente ha requisiti di rete o firewall rigorosi che limitano il traffico, è necessario configurare le autorizzazioni di rete o firewall per qualsiasi connessione di trigger o azione nei flussi di lavoro presenti nell'app per la logica.

Per trovare gli indirizzi IP in ingresso e in uscita usati dall'app per la logica e dai flussi di lavoro, seguire questa procedura:

1. Nel menu dell'app per la logica, in Impostazioni, selezionare Rete (anteprima).

2. Nella pagina rete trovare ed esaminare le sezioni Traffico in ingresso e Traffico in uscita.

Per trovare i nomi di dominio completi (FQDN) per le connessioni, seguire questa procedura:

1. Nel menu dell'app per la logica, in Flussi di lavoro selezionare Connessione ions. Nella scheda API Connessione ions selezionare il nome della risorsa della connessione, ad esempio:

   

2. Espandere il browser in modo che, quando viene visualizzata la visualizzazione JSON nell'angolo in alto a destra del browser, selezionare Visualizzazione JSON.

   

3. Copiare e salvare il valore della proprietà connectionRuntimeUrl in un punto sicuro in modo che sia possibile configurare il firewall con queste informazioni.

   

4. Per ogni connessione, ripetere i passaggi pertinenti.

Attivare il flusso di lavoro

In questo esempio il flusso di lavoro viene eseguito quando il trigger request riceve una richiesta in ingresso, che viene inviata all'URL per l'endpoint creato dal trigger. Quando il flusso di lavoro è stato salvato per la prima volta, App per la logica di Azure generato automaticamente questo URL. Quindi, prima di poter inviare questa richiesta per attivare il flusso di lavoro, è necessario trovare questo URL.

1. Nella finestra di progettazione del flusso di lavoro selezionare il trigger Richiesta denominato Quando viene ricevuta una richiesta HTTP.

2. Dopo l'apertura del riquadro informazioni, nella scheda Parametri individuare la proprietà URL HTTP POST. Per copiare l'URL generato, selezionare l'icona Copia URL (copia file) e salvare l'URL altrove per il momento. L'URL segue questo formato:

   https://<*logic-app-name*>.azurewebsites.net:443/api/<*workflow-name*>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*shared-access-signature*>

   

   Per questo esempio, l'URL è simile al seguente:

   https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

   Suggerimento

   È anche possibile trovare l'URL dell'endpoint nel riquadro Panoramica dell'app per la logica nella proprietà URL flusso di lavoro.

   1. Nel menu della risorsa selezionare Panoramica.
   2. Nel riquadro Panoramica trovare la proprietà URL flusso di lavoro.
   3. Per copiare l'URL dell'endpoint, spostare il puntatore sulla fine del testo dell'URL dell'endpoint e selezionare Copia negli Appunti (icona copia file).

3. Per testare l'URL inviando una richiesta, aprire Postman o lo strumento preferito per la creazione e l'invio di richieste.

   Questo esempio continua usando Postman. Per altre informazioni, vedere Introduzione a Postman.

   1. Sulla barra degli strumenti postman selezionare Nuovo.

      

   2. Nel riquadro Crea nuovo, in Blocchi predefiniti, selezionare Richiesta.

   3. Nella finestra Salva richiesta, in Nome richiesta, specificare un nome per la richiesta, ad esempio, Trigger del flusso di lavoro di test.

   4. In Selezionare una raccolta o una cartella in cui salvare selezionare Crea raccolta.

   5. In Tutte le raccolte specificare un nome per la raccolta da creare per organizzare le richieste, premere INVIO e selezionare Salva in <nome> raccolta. Questo esempio usa le richieste di App per la logica come nome della raccolta.

      Nell'app Postman viene aperto il riquadro delle richieste in modo che sia possibile inviare una richiesta all'URL dell'endpoint per il trigger di richiesta.

      

   6. Nel riquadro della richiesta, nella casella indirizzo accanto all'elenco dei metodi, che attualmente mostra GET come metodo di richiesta predefinito, incollare l'URL copiato in precedenza e selezionare Invia.

      

      Quando il trigger viene attivato, il flusso di lavoro di esempio viene eseguito e invia un messaggio di posta elettronica simile a questo esempio:

      

Esaminare la cronologia di esecuzione del flusso di lavoro

Al termine dell'esecuzione di un flusso di lavoro con stato, è possibile visualizzare la cronologia di esecuzione del flusso di lavoro, incluso lo stato per l'esecuzione complessiva, per il trigger e per ogni azione insieme ai relativi input e output. Nella portale di Azure la cronologia di esecuzione del flusso di lavoro e la cronologia dei trigger vengono visualizzati a livello di flusso di lavoro, non a livello di risorsa dell'app per la logica. Per altre informazioni, vedere Esaminare la cronologia di esecuzione del flusso di lavoro e Esaminare la cronologia dei trigger.

Per questo flusso di lavoro di esempio, la cronologia di esecuzione del flusso di lavoro è simile all'esempio seguente:

Esaminare la cronologia dei trigger

Per un flusso di lavoro con stato, è possibile esaminare la cronologia dei trigger per ogni esecuzione, incluso lo stato del trigger insieme agli input e agli output, separatamente dalla cronologia di esecuzione del flusso di lavoro. Nella portale di Azure la cronologia dei trigger e la cronologia di esecuzione vengono visualizzati a livello di flusso di lavoro, non a livello di app per la logica. Per altre informazioni, vedere Esaminare la cronologia dei trigger.

Inviare di nuovo il flusso di lavoro con gli stessi input

Per un'esecuzione del flusso di lavoro con stato esistente, è possibile rieseguire l'intero flusso di lavoro con gli stessi input usati in precedenza per l'esecuzione. Per altre informazioni, vedere Rieseguire un flusso di lavoro con gli stessi input.

Abilitare la cronologia di esecuzione per i flussi di lavoro senza stato

Per eseguire il debug di un flusso di lavoro senza stato più facilmente, è possibile abilitare la cronologia di esecuzione per tale flusso di lavoro e quindi disabilitare la cronologia di esecuzione al termine. Seguire questa procedura per il portale di Azure o se si usa Visual Studio Code, vedere Creare flussi di lavoro con stato e senza stato in Visual Studio Code.

1. Nella portale di Azure aprire la risorsa dell'app per la logica Standard.

2. Nel menu dell'app per la logica, in Impostazioni selezionare Configurazione.

3. Nella scheda Impostazioni applicazione selezionare Nuova impostazione applicazione.

4. Nella casella Nome del riquadro Delle impostazioni dell'applicazione Aggiungi/Modifica applicazione immettere il nome dell'opzione dell'operazione:

   Workflow. {yourWorkflowName}. OperationOptions

5. Nella casella Valore immettere il valore seguente: WithStatelessRunHistory

   

6. Per completare questa attività, selezionare OK. Sulla barra degli strumenti del riquadro Configurazione selezionare Salva.

7. Per disabilitare la cronologia di esecuzione al termine, impostare la proprietà denominata Workflow.{nome-flusso di lavoro}. OperationOptions su Nessuno oppure eliminare la proprietà e il relativo valore.

Abilitare o aprire Application Insights dopo la distribuzione

Durante l'esecuzione del flusso di lavoro, l'app per la logica genera dati di telemetria insieme ad altri eventi. È possibile usare questi dati di telemetria per ottenere una migliore visibilità sull'esecuzione del flusso di lavoro e sul funzionamento del runtime di App per la logica in vari modi. È possibile monitorare il flusso di lavoro usando Application Insights, che fornisce dati di telemetria quasi in tempo reale (metriche in tempo reale). Questa funzionalità consente di analizzare più facilmente gli errori e i problemi di prestazioni quando si usano questi dati per diagnosticare i problemi, configurare avvisi e creare grafici.

Se le impostazioni di creazione e distribuzione dell'app per la logica supportano l'uso di Application Insights, è possibile abilitare facoltativamente la registrazione diagnostica e la traccia per il flusso di lavoro dell'app per la logica. È possibile farlo quando si crea la risorsa dell'app per la logica nel portale di Azure o dopo la distribuzione. È necessario avere un'istanza di Application Insights, ma è possibile creare questa risorsa in anticipo, quando si crea l'app per la logica o dopo la distribuzione. Facoltativamente, è anche possibile abilitare i dati di telemetria avanzati in Application Insights per flussi di lavoro Standard.

Abilitare Application Insights in un'app per la logica distribuita

1. Nella portale di Azure trovare l'app per la logica distribuita.

2. Nel menu dell'app per la logica, in Impostazioni selezionare Application Insights.

3. Nel riquadro Application Insights selezionare Attiva Application Insights.

4. Dopo aver aggiornato il riquadro, nella parte inferiore selezionare Applica>sì.

5. Nel riquadro Application Insights selezionare Visualizza dati di Application Insights.

   Dopo aver aperto il dashboard di Application Insights, è possibile esaminare le metriche o i log per il flusso di lavoro dell'app per la logica. Ad esempio, per creare un grafico o eseguire query per i dati, nel menu delle risorse di Application Insights, in Monitoraggio selezionare Metriche o log.

Aprire Application Insights

1. Nella portale di Azure trovare l'app per la logica distribuita.

2. Nel menu dell'app per la logica, in Impostazioni selezionare Application Insights.

3. Nel riquadro Application Insights selezionare Visualizza dati di Application Insights.

   Dopo aver aperto il dashboard di Application Insights, è possibile esaminare le metriche o i log per il flusso di lavoro dell'app per la logica. Ad esempio, per creare un grafico o eseguire query per i dati, nel menu delle risorse di Application Insights, in Monitoraggio selezionare Metriche o log.

Visualizzare le connessioni

Quando si creano connessioni in un flusso di lavoro usando connettori gestiti da Microsoft, queste connessioni sono effettivamente separate da risorse di Azure con le proprie definizioni di risorse e sono ospitate in Azure globale multi-tenant. I flussi di lavoro delle app per la logica standard possono anche usare connettori del provider di servizi predefiniti eseguiti in modo nativo e basati sul runtime di App per la logica di Azure tenant singolo. Per visualizzare e gestire queste connessioni, vedere Visualizzare le connessioni.

Arrestare o avviare le risorse dell'app per la logica

Seguire la procedura descritta in Disabilitare o abilitare le app per la logica.

Risolvere i problemi e gli errori

Nuovi trigger e azioni non sono disponibili nella selezione della finestra di progettazione per i flussi di lavoro creati in precedenza

L'App per la logica di Azure a tenant singolo supporta azioni predefinite per operazioni di funzioni di Azure, operazioni liquide e operazioni XML, ad esempio convalida XML e TRASFORMAZIONE XML. Tuttavia, per le app per la logica create in precedenza, queste azioni potrebbero non essere visualizzate nella finestra di progettazione per selezionare se l'app per la logica usa una versione obsoleta del bundle di estensione Microsoft.Azure.Functions.ExtensionBundle.Workflows.

Per risolvere il problema, seguire questa procedura per eliminare la versione obsoleta in modo che il bundle di estensioni possa eseguire automaticamente l'aggiornamento alla versione più recente.

Nota

Questa soluzione specifica si applica solo alle risorse dell'app per la logica Standard create usando il portale di Azure, non alle app per la logica create e distribuite usando Visual Studio Code e l'estensione App per la logica di Azure (Standard). Vedere Trigger e azioni supportati mancanti nella finestra di progettazione in Visual Studio Code.

1. Nella portale di Azure arrestare l'app per la logica.

   1. Selezionare Panoramica dal menu dell'app per la logica.

   2. Sulla barra degli strumenti del riquadro Panoramica selezionare Arresta.

2. Nel menu dell'app per la logica, in Strumenti di sviluppo selezionare Strumenti avanzati.

3. Nel riquadro Strumenti avanzati selezionare Vai per aprire l'ambiente Kudu per l'app per la logica.

4. Sulla barra degli strumenti Kudu aprire il menu Console di debug e selezionare CMD.

   Viene visualizzata una finestra della console in modo che sia possibile passare alla cartella bundle usando il prompt dei comandi. In alternativa, è possibile esplorare la struttura di directory visualizzata sopra la finestra della console.

5. Passare alla cartella seguente, che contiene le cartelle con controllo delle versioni per il bundle esistente:

   ...\home\data\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

6. Eliminare la cartella della versione per il bundle esistente. Nella finestra della console è possibile eseguire questo comando in cui si sostituisce {bundle-version} con la versione esistente:

   rm -rf {bundle-version}

   Ad esempio: rm -rf 1.1.3

   Suggerimento

   Se viene visualizzato un errore, ad esempio "autorizzazione negata" o "file in uso", aggiornare la pagina nel browser e riprovare i passaggi precedenti fino all'eliminazione della cartella.

7. Nella portale di Azure tornare alla pagina Panoramica dell'app per la logica e selezionare Riavvia.

   Il portale ottiene e usa automaticamente il bundle più recente.

Passaggi successivi

• Monitorare lo stato dell'esecuzione del flusso di lavoro, esaminare la cronologia di esecuzione del trigger e del flusso di lavoro e configurare gli avvisi in App per la logica di Azure