Guida introduttiva: Creare e gestire le definizioni del flusso di lavoro delle app logiche con Azure Logic Apps multi-tenant e Visual Studio Code

Si applica a: App per la logica di Azure (a 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 sui modelli multi-tenant rispetto ai modelli a tenant singolo, vedere Tenant singolo e multi-tenant in App per la logica di Azure.

Sebbene sia possibile eseguire queste stesse attività nella portale di Azure, è possibile iniziare più rapidamente in Visual Studio Code quando si ha già familiarità con le definizioni di app per la logica e si vuole lavorare direttamente nel codice. È 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 e gestire app tramite l'interfaccia della riga di comando di Azure. In Visual Studio Code l'app per la logica è simile all'esempio seguente:

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 di Visual Studio Code per Azure Logic Apps

    È 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 alla versione open-source di questa estensione, visita Azure Logic Apps Extension per Visual Studio Code su GitHub.

• Se l'app 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 per quelli in uscita usati sia dalle Azure Logic Apps sia dal runtime nell'area di Azure in cui si trova l'app 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

1. Apri Visual Studio Code. Sulla barra degli strumenti di Visual Studio Code selezionare l'icona di Azure.

   

2. 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 richiede più tempo del solito, Visual Studio Code chiede 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.

      

3. 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.

4. 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

1. 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.

2. In Visual Studio Code, sotto App per la logica, apri il menu di scelta rapida della sottoscrizione e seleziona Crea app per la logica.

   

   Verrà visualizzato un elenco che mostra i gruppi di risorse di Azure nella sottoscrizione.

3. 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.

   

4. Specificare un nome per il gruppo di risorse di Azure e quindi premere INVIO.

   

5. Selezionare l'area di Azure in cui salvare i metadati dell'app per la logica.

   

6. 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 schematico per la logic app. 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 workflow di un'applicazione logica di esempio, che inizia con un trigger RSS e un'azione di Outlook di Office 365. 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": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

7. Al termine, salvare il file della definizione del flusso di lavoro dell'app per la logica. (menu File > Salva), o premi Ctrl+S

8. Quando viene richiesto di caricare l'app per la logica nella sottoscrizione di Azure, selezionare Carica.

   Questo passaggio pubblica l'app per la logica nel portale di Azure, che rende il flusso di lavoro attivo e in esecuzione in Azure.

   

Visualizzare l'app di logica nel designer

In Visual Studio Code è possibile aprire l'app per la logica nella 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, apri il menu di scelta rapida della tua app per la logica e scegli Apri nel Progettista.

La finestra di progettazione di sola lettura si apre in una finestra separata e mostra il flusso di lavoro della tua app logica, ad esempio:

Visualizzare nel portale di Azure

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

1. Accedere al portale di Azure usando lo stesso account e la stessa sottoscrizione di Azure associati all'app per la logica.

2. Nella casella di ricerca del portale di Azure, immettere il nome dell'applicazione logica. Dall'elenco dei risultati selezionare l'app per la logica.

   

Modificare l'applicazione logica implementata

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.

1. 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.

2. Nella finestra di Azure, sotto App Logiche, espandi la tua sottoscrizione di Azure e seleziona l'app logica desiderata.

3. Aprire il menu dell'app per la logica e selezionare Apri nell'editor. Oppure, accanto al nome dell'app di logica, seleziona l'icona di modifica.

   

   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.

   

4. Apportare le modifiche alla definizione del flusso di lavoro dell'app per la logica.

5. Al termine, salvare le modifiche. (menu File > Salva), o premi Ctrl+S

6. 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

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.

1. Nella finestra di Azure, in Logic Apps di Azure, espandi la tua sottoscrizione di Azure per visualizzare tutte le Logic Apps in quella sottoscrizione.

2. 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.

   

3. 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).

4. 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 non causare interruzioni nell'app per la logica nell'ambiente di produzione e ridurre al minimo i problemi, 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.

• Azure Logic Apps completa tutte le esecuzioni in corso e in sospeso finché non finiscono. In base al volume o al backlog, il completamento di questo processo potrebbe richiedere tempo.

• Azure Logic Apps non creano né eseguono nuove istanze del flusso di lavoro.

• Il trigger non verrà attivato la volta successiva in cui vengono soddisfatte le condizioni.

• Lo stato di attivazione ricorda il punto in cui la Logic App è stata arrestata. Se si riattiva l'app per la logica viene attivato il trigger per tutti gli elementi non elaborati dopo l'ultima esecuzione.

  Per arrestare l'attivazione del trigger su elementi non elaborati dall'ultima esecuzione, cancellare lo stato del trigger prima di riattivare l'applicazione 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'Logic App.

• Quando un flusso di lavoro è disabilitato, è comunque possibile inviare nuovamente le esecuzioni.

1. 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.

2. Nella finestra di Azure, sotto Logic Apps, espandere la sottoscrizione di Azure per visualizzare tutte le Logic Apps nella sottoscrizione.

   1. Per disabilitare l'app logica desiderata, apri il menu dell'app logica e seleziona 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:

• Azure Logic Apps compie il massimo sforzo per annullare le esecuzioni in corso e quelle 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 avviate, mentre il servizio completa il processo di annullamento.

• Azure Logic Apps non crea né 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 salvare nuovamente 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 errore Unauthorized. 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.

1. 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.

2. Nella finestra di Azure, in App logiche, espandete la vostra sottoscrizione di Azure per visualizzare tutte le app logiche in quella sottoscrizione.

3. 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