Guida introduttiva: Creare e gestire le definizioni del flusso di lavoro delle app per la logica con App per la logica di Azure multi-tenant e Visual Studio Code

Articolo
01/04/2024

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

Questa guida introduttiva illustra come creare e gestire flussi di lavoro di app per la logica che consentono di automatizzare attività e processi che integrano app, dati, sistemi e servizi in organizzazioni e aziende usando App per la logica di Azure multi-tenant e Visual Studio Code. È possibile creare e modificare le definizioni del flusso di lavoro sottostanti, che usano JavaScript Object Notation (JSON) per le app per la logica tramite un'esperienza basata su codice. È anche possibile usare le app per la logica esistenti già distribuite in Azure. Per altre informazioni sul modello multi-tenant rispetto al modello a tenant singolo, vedere Ambiente del servizio single-tenant e multi-tenant e integrazione.

Anche se è possibile eseguire queste stesse attività nel portale di Azure e in Visual Studio, quando si ha già familiarità con le app per la logica e si vuole lavorare direttamente nel codice, Visual Studio Code permette di iniziare più velocemente. È ad esempio possibile disabilitare, abilitare, eliminare e aggiornare le app per la logica già create. Inoltre, è possibile lavorare con app per la logica e account di integrazione da qualsiasi piattaforma di sviluppo che supporta l'esecuzione di Visual Studio Code, ad esempio Linux, Windows e Mac.

Per questo articolo è possibile creare la stessa app per la logica da questa guida di avvio rapido, che è maggiormente incentrata sui concetti di base. È anche possibile imparare a creare l'app di esempio in Visual Studio e imparare a creare e gestire app tramite l'interfaccia della riga di comando di Azure. In Visual Studio Code l'app per la logica è simile a questo esempio:

Example logic app workflow definition

Prerequisiti

Prima di iniziare, verificare di disporre degli elementi seguenti:

Se non si ha una sottoscrizione di Azure e un account, iscriversi per creare un account Azure gratuito.
Conoscenza di base delle definizioni dei flussi di lavoro delle app per la logica e relativa struttura come descritto con JSON

Se non si ha familiarità con App per la logica di Azure, provare questa guida introduttiva, che crea il primo flusso di lavoro dell'app per la logica nel portale di Azure e si concentra maggiormente sui concetti di base.
Accesso al Web per accedere ad Azure e alla sottoscrizione di Azure
Scaricare e installare questi strumenti, se non sono già disponibili:
- Visual Studio Code versione 1.25.1 o successiva, disponibile gratuitamente
- Estensione Visual Studio Code per App per la logica di Azure
  
  È possibile scaricare e installare questa estensione da Visual Studio Marketplace o direttamente dall'interno di Visual Studio Code. Assicurarsi di ricaricare Visual Studio Code dopo l'installazione.
  
  Per verificare che l'estensione sia stata installata correttamente, selezionare l'icona di Azure visualizzata nella barra degli strumenti di Visual Studio Code.
  
  Per altre informazioni, vedere Extension Marketplace (Marketplace delle estensioni). Per contribuire a questa versione open source dell'estensione, visitare la pagina dell'estensione di App per la logica di Azure per Visual Studio Code su GitHub.
Se l'app per la logica deve comunicare tramite un firewall che limita il traffico a indirizzi IP specifici, tale firewall deve consentire l'accesso sia per gli indirizzi IP in ingresso che in uscita usati da App per la logica di Azure o runtime nell'area di Azure in cui è presente l'app per la logica. Se l'app per la logica usa anche connettori gestiti, ad esempio il connettore di Office 365 Outlook o il connettore SQL o usa connettori personalizzati, il firewall deve anche consentire l'accesso a tutti gli indirizzi IP in uscita del connettore gestito nell'area di Azure dell'app per la logica.

Accedere ad Azure da Visual Studio Code

Aprire Visual Studio Code. Sulla barra degli strumenti di Visual Studio Code selezionare l'icona di Azure.
Nella finestra di Azure, in App per la logica selezionare Accedi ad Azure. Quando la pagina di accesso di Microsoft lo richiede, accedere con l'account Azure.
1. Se l'accesso impiega più tempo del previsto, Visual Studio Code richiede di accedere tramite un sito Web di autenticazione Microsoft fornendo un codice del dispositivo. Per accedere con il codice, selezionare Use Device Code (Usa codice del dispositivo).
2. Per copiare il codice, selezionare Copy & Open (Copia e apri).
3. Per aprire una nuova finestra del browser e passare al sito Web di autenticazione, selezionare Apri il collegamento.
4. Nella pagina Accesso all'account immettere il codice di autenticazione e selezionare Avanti.
Selezionare l'account Azure. Dopo aver effettuato l'accesso, è possibile chiudere il browser e tornare a Visual Studio Code.

Nel riquadro di Azure le sezioni App per la logica e Account di integrazione mostrano ora le sottoscrizioni di Azure associate all'account. Tuttavia, se non vengono visualizzate le sottoscrizioni previste o se le sezioni mostrano troppe sottoscrizioni, seguire questa procedura:
1. Spostare il puntatore del mouse sull'etichetta App per la logica. Quando viene visualizzata la barra degli strumenti, selezionare Seleziona sottoscrizioni (icona filtro).
2. Nell'elenco selezionare le sottoscrizioni che devono essere visualizzate.
In App per la logica selezionare la sottoscrizione desiderata. Il nodo della sottoscrizione si espande e mostra tutte le app per la logica presenti nella sottoscrizione.

Suggerimento

In Account di integrazione, la selezione della sottoscrizione mostra tutti gli account di integrazione presenti nella sottoscrizione.

Creare una nuova app per la logica

Se non è stato effettuato l'accesso all'account e alla sottoscrizione di Azure da Visual Studio Code, seguire la procedura descritta in precedenza per effettuare l'accesso adesso.
In Visual Studio Code aprire il menu di scelta rapida della sottoscrizione in App per la logica e scegliere Crea app per la logica.

Verrà visualizzato un elenco che mostra i gruppi di risorse di Azure nella sottoscrizione.
Nell'elenco dei gruppi di risorse, selezionare Crea un nuovo gruppo di risorse o selezionare un gruppo di risorse esistente. Per questo esempio, creare un nuovo gruppo di risorse.
Specificare un nome per il gruppo di risorse di Azure e quindi premere INVIO.
Selezionare l'area di Azure in cui salvare i metadati dell'app per la logica.
Assegnare un nome all'app per la logica e quindi premere INVIO.

La nuova app per la logica vuota viene ora visualizzata nella finestra di Azure, nella sottoscrizione di Azure corrente. Visual Studio Code apre anche un file JSON (.logicapp.json), che include una definizione del flusso di lavoro scheletro per l'app per la logica. A questo punto è possibile iniziare a creare manualmente la definizione del flusso di lavoro dell'app per la logica in questo file JSON. Per informazioni di riferimento tecniche sulla struttura e la sintassi per una definizione del flusso di lavoro, vedere Schema del linguaggio di definizione del flusso di lavoro per App per la logica di Azure.

Ad esempio, di seguito è riportata una definizione del flusso di lavoro dell'app per la logica di esempio, che inizia con un trigger RSS e un'azione di Office 365 Outlook. In genere gli elementi JSON vengono visualizzati in ordine alfabetico in ogni sezione. Questo esempio però mostra questi elementi approssimativamente nell'ordine in cui i passaggi dell'app per la logica vengono visualizzati nella finestra di progettazione.

Importante

Se si vuole riutilizzare questa definizione di app per la logica di esempio, è necessario un account aziendale, ad esempio @fabrikam.com. Assicurarsi di sostituire l'indirizzo di posta elettronica fittizio con il proprio indirizzo di posta elettronica. Per usare un connettore di posta elettronica diverso, ad esempio Outlook.com o Gmail, sostituire l'azione Send_an_email_action con un'azione simile disponibile da un connettore di posta elettronica supportato da App per la logica di Azure.

Se si vuole usare il connettore Gmail, solo gli account G Suite Business possono usare questo connettore senza restrizioni nelle app per la logica. Se si dispone di un account Gmail consumer, è possibile usare questo connettore solo con servizi approvati da Google specifici oppure è possibile creare un'app client Google da usare per l'autenticazione con il connettore Gmail. Per altre informazioni, vedere Informative sulla privacy e sulla sicurezza dei dati per i connettori Google in App per la logica di Azure.
```
{
 "$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": {}
}
```
Al termine, salvare il file della definizione del flusso di lavoro dell'app per la logica. (menu File) > Salva o premi CTRL+S)
Quando viene richiesto di caricare l'app per la logica nella sottoscrizione di Azure, selezionare Carica.

Questo passaggio consente di pubblicare l'app per la logica nel portale di Azure, affinché sia disponibile e in esecuzione in Azure.

Visualizzare l'app per la logica nella finestra di progettazione

In Visual Studio Code è possibile aprire l'app per la logicanella visualizzazione Progettazione di sola lettura. Sebbene non sia possibile modificare l'app per la logica nella finestra di progettazione, è possibile controllare visivamente il flusso di lavoro dell'app per la logica tramite la visualizzazione Progettazione.

Nella finestra di Azure, in App per la logica aprire il menu di scelta rapida dell'app per la logica e scegliere Open in Designer (Apri nella finestra di progettazione).

Verrà visualizzata la finestra di progettazione di sola lettura in una finestra separata in cui viene mostrato il flusso di lavoro dell'app per la logica, ad esempio:

View logic app in read-only designer

Visualizzare nel portale di Azure

Per esaminare l'app per la logica in portale di Azure, seguire questa procedura:

Accedere al portale di Azure usando lo stesso account e la stessa sottoscrizione di Azure associati all'app per la logica.
Nella casella di ricerca del portale di Azure immettere il nome dell'app per la logica. Nell'elenco dei risultati selezionare l'app per la logica.

Modificare l'app per la logica distribuita

In Visual Studio Code è possibile aprire e modificare la definizione del flusso di lavoro per un'app per la logica già distribuita in Azure.

Importante

Prima di modificare un'app per la logica attivamente in esecuzione nell'ambiente di produzione, per evitare il rischio di interrompere l'app per la logica e ridurre al minimo le interruzioni di servizio, è prima necessario disabilitare l'app per la logica.

Se non è stato effettuato l'accesso all'account e alla sottoscrizione di Azure da Visual Studio Code, seguire la procedura descritta in precedenza per effettuare l'accesso adesso.
Nella finestra di Azure, in App per la logica espandere la sottoscrizione di Azure e selezionare l'app per la logica desiderata.
Aprire il menu dell'app per la logica e selezionare Apri nell'editor. oppure selezionare l'icona di modifica accanto al nome dell'app per la logica.

Visual Studio Code apre il file logicapp.json nella cartella temporanea locale per consentire la visualizzazione della definizione del flusso di lavoro dell'app per la logica.
Apportare le modifiche alla definizione del flusso di lavoro dell'app per la logica.
Al termine, salvare le modifiche. (menu File) > Salva o premi CTRL+S)
Quando viene richiesto di caricare le modifiche e sovrascrivere l'app per la logica esistente nel portale di Azure, selezionare Carica.

Questo passaggio consente di pubblicare gli aggiornamenti apportati all'app per la logica nel portale di Azure.

Visualizzare o alzare di livello altre versioni

In Visual Studio Code è possibile aprire ed esaminare le versioni precedenti dell'app per la logica. È anche possibile alzare di livello una versione precedente alla versione corrente.

Importante

Nella finestra di Azure, in App per la logica espandere la sottoscrizione di Azure per visualizzare tutte le app per la logica nella sottoscrizione.
Nella sottoscrizione espandere l'app per la logica ed espandere Versioni.

L'elenco Versioni mostra le versioni precedenti dell'app per la logica, se presenti.
Per visualizzare una versione precedente, selezionare una delle procedure seguenti:
- Per visualizzare la definizione JSON, in Versioni selezionare il numero di versione per la definizione corrispondente. In alternativa, aprire il menu di scelta rapida della versione e selezionare Apri nell'editor.
  
  Verrà aperto un nuovo file nel computer locale e verrà visualizzata la definizione JSON della versione.
- Per visualizzare la versione nella visualizzazione Progettazione di sola lettura, aprire il menu di scelta rapida della versione e selezionare Open in Designer (Apri nella finestra di progettazione).
Per alzare di livello una versione precedente alla versione corrente, seguire questa procedura:
1. In Versioni aprire il menu di scelta rapida della versione precedente e selezionare Alza di livello.
2. Per continuare dopo la richiesta di conferma di Visual Studio Code, selezionare Sì.
  
  Visual Studio Code alza di livello la versione selezionata alla versione corrente e assegna un nuovo numero alla versione alzata di livello. La versione corrente precedente è ora visualizzata sotto la versione alzata di livello.

Disabilitare o abilitare le app per la logica

In Visual Studio Code se si modifica un'app per la logica pubblicata e si salvano le modifiche, si sovrascrive l'app già distribuita. Per evitare di interrompere l'app per la logica nell'ambiente di produzione e ridurre al minimo le interruzioni, disabilitare prima l'app per la logica. È quindi possibile riattivare l'app per la logica dopo aver verificato che l'app per la logica funzioni ancora.

App per la logica di Azure continua tutte le esecuzioni in corso e in sospeso fino al termine. In base al volume o al backlog, il completamento di questo processo potrebbe richiedere tempo.
App per la logica di Azure non crea o esegue nuove istanze del flusso di lavoro.
Il trigger non verrà attivato la volta successiva in cui vengono soddisfatte le condizioni.
Lo stato del trigger ricorda il punto in cui l'app per la logica è stata arrestata. Pertanto, se si riattiva l'app per la logica, il trigger viene attivato per tutti gli elementi non elaborati dall'ultima esecuzione.

Per arrestare l'attivazione del trigger sugli elementi non elaborati dall'ultima esecuzione, deselezionare lo stato del trigger prima di riattivare l'app per la logica:
1. Nell'app per la logica modificare qualsiasi parte del trigger del flusso di lavoro.
2. Salva le modifiche. Questo passaggio reimposta lo stato corrente del trigger.
3. Riattivare l'app per la logica.
Quando un flusso di lavoro è disabilitato, è comunque possibile inviare nuovamente le esecuzioni.

Se non è stato effettuato l'accesso all'account e alla sottoscrizione di Azure da Visual Studio Code, seguire la procedura descritta in precedenza per effettuare l'accesso adesso.
Nella finestra di Azure, in App per la logica espandere la sottoscrizione di Azure per visualizzare tutte le app per la logica nella sottoscrizione.
1. Per disabilitare l'app per la logica desiderata, aprire il menu dell'app per la logica e selezionare Disabilita.
2. Quando si è pronti per riattivare l'app per la logica, aprire il menu dell'app per la logica e selezionare Abilita.

Eliminare le app per la logica

L'eliminazione di un'app per la logica influisce sulle istanze del flusso di lavoro nei modi seguenti:

App per la logica di Azure fa del meglio per annullare le esecuzioni in corso e in sospeso.

Anche con un volume o un backlog di grandi dimensioni, la maggior parte delle esecuzioni viene annullata prima del completamento o dell'avvio. Tuttavia, il processo di annullamento potrebbe richiedere tempo. Nel frattempo, alcune esecuzioni potrebbero essere prelevate per l'esecuzione mentre il servizio funziona tramite il processo di annullamento.
App per la logica di Azure non crea o esegue nuove istanze del flusso di lavoro.
Se si elimina un flusso di lavoro e quindi si ricrea lo stesso flusso di lavoro, il flusso di lavoro ricreato non avrà gli stessi metadati del flusso di lavoro eliminato. È necessario ricampionare qualsiasi flusso di lavoro che ha chiamato il flusso di lavoro eliminato. In questo modo, il chiamante ottiene le informazioni corrette per il flusso di lavoro ricreato. In caso contrario, le chiamate al flusso di lavoro ricreato hanno esito negativo con un Unauthorized errore. Questo comportamento si applica anche ai flussi di lavoro che usano artefatti negli account di integrazione e nei flussi di lavoro che chiamano funzioni di Azure.

Se non è stato effettuato l'accesso all'account e alla sottoscrizione di Azure da Visual Studio Code, seguire la procedura descritta in precedenza per effettuare l'accesso adesso.
Nella finestra di Azure, in App per la logica espandere la sottoscrizione di Azure per visualizzare tutte le app per la logica nella sottoscrizione.
Trovare l'app per la logica da eliminare, aprire il menu dell'app per la logica e selezionare Elimina.

Passaggi successivi

Creare flussi di lavoro di app per la logica basati su tenant singolo in Visual Studio Code