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: 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 successivamente invia un messaggio a un account di posta elettronica. In particolare, si creerà una risorsa in app per la logica Standard, che può includere più flussi di lavoro con stato e senza stato che vengono 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 implementare flussi di lavoro di app per la logica negli stessi tipi di ambienti. Tuttavia, con Visual Studio Code, è possibile sviluppare, testare ed eseguire localmente flussi di lavoro nell'ambiente di sviluppo.

Anche se il flusso di lavoro di esempio è basato sul cloud e include solo due passaggi, è possibile creare flussi di lavoro da centinaia di operazioni che possono connettere un'ampia gamma di app, dati, servizi e sistemi nel cloud, in locale e in ambienti 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 contattabile per il flusso di lavoro e attende una richiesta HTTPS in ingresso da qualsiasi chiamante. Quando il trigger riceve una richiesta e viene attivato, 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 attività ai livelli successivi:

• Creare una risorsa di 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 dell’esecuzione e attivazione del flusso di lavoro.
• Abilitare o aprire Application Insights dopo la distribuzione.
• Abilitare la cronologia di esecuzione per i flussi di lavoro senza stato.

In App per la logica di Azure a tenant singolo, i flussi di lavoro nella stessa risorsa in app per la logica e nello stesso tenant vengono eseguiti nello stesso processo del runtime, quindi condividono le stesse risorse e offrono migliori prestazioni. Per altre informazioni su App per la logica di Azure a tenant singolo, vedere tenant singolo versus multi tenant e ambiente del servizio di integrazione.

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 di 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, come l'uso di code per pianificare e archiviare gli stati del flusso di lavoro in tabelle e blob. Queste transazioni comportano addebiti per l'archiviazione. Per maggiori informazioni su come i flussi di lavoro con stato archiviano i dati nell'archivio esterno, vedere Flussi di lavoro con stato e senza stato.

• Per creare il flusso di lavoro proposto a esempio in questa guida, è necessario avere un account di posta elettronica di Office 365 Outlook che usa un account Microsoft aziendale o istituzionale per accedere.

  Se non si ha un account di Office 365, è possibile usare qualunque altro connettore e-mail 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 da seguire sono gli stessi. Tuttavia, talvolta le opzioni potrebbero differire. Ad esempio, se si usa il connettore Outlook.com, effettuare l’accesso usando l'account personale di Microsoft.

• Per testare il flusso di lavoro di esempio in questa guida, è necessario avere uno strumento o app in locale, in grado di inviare chiamate all'endpoint creato dal Trigger di richiesta. Ad esempio, è possibile usare strumenti locali come Insonnia o Bruno per inviare la richiesta HTTP.

• Se si crea la risorsa dell'app per la logica e si abilita Application Insights, è possibile abilitare facoltativamente la registrazione diagnostica e il tracciamento per l'app per la logica. È possibile effettuare questa operazione quando si crea l'app per la logica, oppure 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 implementare la risorsa dell'app per la logica Standard in un ambiente del servizio app v3 (ASEv3) - Solo piano di Windows, è prima necessario 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. Nel mese di novembre 2022, i flussi di lavoro Standard esistenti nel portale di Azure vengono automaticamente migrati a Funzioni di Azure v4. A meno che le app per la logica Standard siano implementate come progetti basati su NuGet o aggiunte a una versione bundle specifica, questo aggiornamento non richiede alcuna azione né ha un impatto sul runtime. Per eccezioni che dovessero interessare l’utente o per altre informazioni sul supporto di Funzioni di Azure v4, vedere App per la logica di Azure Standard ora supporta Funzioni di Azure v4.

Procedure consigliate e raccomandazioni

Per prestazioni e velocità di risposta ottimali della finestra di progettazione, consultare e seguire le seguenti linee guida:

• Usare un massimo di 50 azioni per flusso di lavoro. Il superamento di questo numero di azioni aumenta 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 la possibilità di tempi di caricamento più lunghi, che influiscono negativamente sulle prestazioni. Se sono presenti app per la logica mission-critical 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 del 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 pagina Creare app per la logica, nella scheda Nozioni di base, fornire le seguenti informazioni di base 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 vengono create l'app per la logica e le risorse correlate. Questo nome deve essere univoco tra aree e può contenere solo lettere, numeri, trattini (-), trattino basso (_), 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 (-), trattino basso (_), parentesi (()) e punti (.). Nota: il nome dell'app per la logica ottiene automaticamente il suffisso, azurewebsites.net, poiché la risorsa dell'app per la logica Standard è basata sul runtime di App per la logica di Azure a tenant singolo, che usa il modello di estendibilità di Funzioni di Azure ed è ospitata come estensione nel runtime di 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 viene eseguito in App per la logica di Azure multi tenant globale e usa il modello di fatturazione A consumo.

   Proprietà	Richiesto	Valore	Descrizione
   Piano Windows	Sì	<nome piano>	Nome del piano da usare. Selezionare il nome di un 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 dell’app basato su Windows. Non usare un piano di servizio dell’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 Flusso di lavoro 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 abilitato per Azure Arc, che è possibile usare con App per la logica (Standard) abilitate per Azure Arc. 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>	Regione del data center di Azure da usare per l'archiviazione delle 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 Regione. - Se si vuole implementare l'app a una risorsa v3 dell'ambiente del servizio app esistente, è possibile selezionare tale ambiente dall'elenco Regione.

   Nota

   Se si seleziona una regione di Azure che supporta la ridondanza della zona di disponibilità, la sezione Ridondanza della zona è abilitata. Con questa sezione, si può scegliere di abilitare la ridondanza della zona di disponibilità per l'app per la logica. Tuttavia, le regioni di Azure attualmente supportate non includono Stati Uniti occidentali, quindi tale sezione si può ignorare per questo esempio. Per altre informazioni, vedere Proteggere le app per la logica da errori di regione con ridondanza della zona e zone di disponibilità.

   Al termine, le impostazioni saranno 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 implementare solo in Azure, selezionare Archiviazione di Azure. - Per usare SQL come archiviazione primaria e Archiviazione di Azure come archiviazione secondaria, selezionare SQL e Archiviazione di Azure e consultare 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 sta implementando in un'area di Azure, è comunque necessario un account di archiviazione di Azure, che viene 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>	Account di archiviazione di Azure da usare per le transazioni di archiviazione. Questo nome di risorsa deve essere univoco tra aree e deve avere tra 3 e 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 implementato la risorsa dell'app per la logica. Per maggiori informazioni, vedere Proteggere il traffico tra app per la logica Standard e reti virtuali di Azure con gli 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 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 interessato 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:

   Abilita aggiunta 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 il tracciamento per il flusso di lavoro dell'app per la logica.

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

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

10. Dopo che Azure convalida le impostazioni dell'app per la logica, nella schedaRivedere + creare selezionare Creare, ad esempio:

    

    Nota

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

    Al termine della distribuzione di Azure, la risorsa dell'app per la logica è automaticamente attiva, 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 menù delle risorse dell'app per la logica selezionare Flussi di lavoro. Sulla barra degli strumenti Flussi di lavoro selezionare Aggiungi.

   

2. Dopo che si è 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 menù 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, pertanto è 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 attende l'arrivo di tali chiamate o richieste in ingresso. Le operazioni predefinite vengono eseguite in nativamente e direttamente all'interno del runtime di App per la logica di Azure.

1. Nella 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 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 compare il trigger nella finestra di progettazione, si apre il riquadro informazioni del trigger che mostra 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 di 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 nativamente 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.

   Si apre il riquadro Aggiungi un'azione in modo da poter 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 selezionare Accedi per 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 "Non riuscito con l’errore: 'Il browser è chiuso.'. Accedi di nuovo", controllare 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 siano bloccati quando si lavora in questa 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, nella finestra di progettazione compare l'azione, selezionata per impostazione predefinita, Invia un messaggio di posta elettronica. 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 il proprio indirizzo di posta elettronica a scopo di test. Questo esempio usa l'indirizzo 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ì	Un saluto dal flusso di lavoro di esempio	Contenuto del corpo del messaggio di posta elettronica

   Nota

   Quando si apportano modifiche nel riquadro informazioni in Impostazioni, Risultato statico o Esegui dopo, assicurarsi di selezionare Fine per eseguire il commit di tali modifiche prima di passare a un’altra scheda o alla 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 tutte le connessioni di trigger o azione esistenti nel flusso di lavoro. Per trovare i nomi di dominio completi, consultare 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 i seguenti passaggi:

• Selezionare l'elemento, aprire il menù di scelta rapida dell'elemento (Shift+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 il menù dei puntini di sospensione (...) e selezionare Elimina. Per confermare, scegliere OK.

  

  Suggerimento

  Se il menù con i puntini di sospensione non è visibile, espandere la finestra del browser in modo che il riquadro delle informazioni mostri il pulsante dei puntini di sospensione (...) nell'angolo superiore destro.

Trovare i nomi di dominio per l'accesso al firewall

Prima di implementare 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 di firewall per qualsiasi connessione di trigger o azione del flusso di lavoro esistente 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 i seguenti passaggi:

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

2. Nella pagina della 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 menù dell'app per la logica, in Flussi di lavoro, selezionare Connessioni. Nella scheda Connessioni API selezionare il nome della risorsa della connessione, ad esempio:

   

2. Espandere il browser in modo che, quando compare visualizzazione JSON nell'angolo in alto a destra del browser, si riesca a 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 di richiesta riceve una richiesta in ingresso, che viene inviata all'URL per l'endpoint creato dal trigger. App per la logica di Azure ha generato automaticamente questo URL al primo salvataggio del flusso di lavoro. Quindi, prima di poter inviare la richiesta per attivare il flusso di lavoro, è necessario trovare questo URL.

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

2. Dopo l'apertura del riquadro informazioni, nella scheda Parametri, individuare la proprietà HTTP POST URL. Per copiare l'URL generato, selezionare (l'icona copia file) Copia URL e salvare l'URL da qualche parte. L'URL presenta 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*>

   

   L'URL di questo esempio è simile a questo:

   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 del flusso di lavoro.

   1. Nel menù della risorsa, selezionare Panoramica.
   2. Nel riquadro Panoramica trovare la proprietà URL del 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 e attivando il flusso di lavoro, aprire lo strumento o l'app preferiti e seguire le istruzioni per la creazione e l'invio di richieste HTTP.

   Per questo esempio, usare il metodo GET con l'URL copiato, simile all'esempio seguente:

   GET 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

   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. Nel portale di Azure la cronologia di esecuzione del flusso di lavoro e la cronologia dei trigger vengono visualizzate a livello di flusso di lavoro, non a livello di risorsa dell'app per la logica. Per maggiori 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 rivedere la cronologia dei trigger per ogni esecuzione, incluso lo stato del trigger insieme agli input e output, separatamente dalla cronologia di esecuzione del flusso di lavoro. Nel portale di Azure la cronologia dei trigger e di esecuzione vengono visualizzate a livello di flusso di lavoro, non a livello di app per la logica. Per maggiori informazioni, vedere Esaminare la cronologia dei trigger.

Inviare nuovamente il flusso di lavoro con gli stessi input

Per l'esecuzione di un flusso di lavoro con stato esistente, è possibile eseguire nuovamente 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 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. Nel portale di Azure, aprire la risorsa dell’app per la logica Standard.

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

3. Nella scheda Impostazioni applicazione selezionare Nuova impostazione applicazione.

4. Nella casella Nome, nel riquadro Aggiungi/Modifica impostazioni dell’applicazione, immettere il seguente nome dell'opzione dell'operazione:

   Flussi di lavoro.{yourWorkflowName}.OperationOptions

5. Nella casella Valore immettere il valore seguente: WithStatelessRunHistory

   

6. Per terminare 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 Flusso di lavoro.{your-workflow-name}. 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 e altri eventi. È possibile usare questi dati di telemetria per 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, è facoltativamente possibile abilitare la registrazione e la traccia diagnostica 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 implementata

1. Nel portale di Azure trovare l'app per la logica implementata.

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

3. Nel riquadro Application Insights selezionare Attiva Application Insights.

4. Dopo l’aggiornamento del riquadro, nella parte inferiore, selezionare Applica>Sì.

5. Nel riquadro Application Insights, selezionareVisualizza dati di Application Insights.

   All’apertura della 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 menù delle risorse di Application Insights, in Monitoraggio, selezionare Metriche o log.

Apri Application Insights

1. Nel portale di Azure trovare l'app per la logica implementata.

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

3. Nel riquadro Application Insights, selezionareVisualizza dati di Application Insights.

   All’apertura della 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 menù 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 vere e proprie risorse separate 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 che vengono eseguiti nativamente e sono basati sul runtime di App per la logica di Azure a 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.

Risoluzione dei problemi e degli errori

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

App per la logica di Azure a tenant singolo supporta azioni predefinite per operazioni di funzioni di Azure, operazioni liquide e operazioni XML, come ad esempio Convalida XML e Trasformazione XML. Tuttavia, per le app per la logica create in precedenza, queste azioni potrebbero non comparire nella finestra di progettazione da 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 tramite il portale di Azure, non alle app per la logica create e implementate tramite Visual Studio Code e l'estensione App per la logica di Azure (Standard). Vedere Trigger e azioni supportati non sono presenti nella finestra di progettazione in Visual Studio Code.

1. Nel 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 menù dell'app per la logica, in Strumenti di sviluppo selezionare Strumenti avanzati.

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

4. Sulla barra degli strumenti Kudu, aprire il menù Console di debug e selezionare CMD.

   Si apre una finestra della console, che permette di 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 le 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 come "autorizzazione negata" o "file in uso", aggiornare la pagina nel browser e riprovare i passaggi precedenti fino all'eliminazione della cartella.

7. Nel portale di Azure, tornare alla pagina Panoramica dell'app per la logica e selezionareRiavvia.

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

Passaggi successivi

• Monitorare lo stato di 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