Aggiungere ed eseguire codice JavaScript inline con flussi di lavoro per App per la logica di Azure

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

Per eseguire attività di integrazione personalizzate inline con il flusso di lavoro in App per la logica di Azure, è possibile aggiungere ed eseguire direttamente frammenti di codice JavaScript semplici dal flusso di lavoro nel portale di Azure. Per questa attività, usare l'azione Codice inline denominata Esegui codice JavaScript. Questa azione restituisce il risultato del frammento di codice in modo da poter usare tale output nelle azioni successive del flusso di lavoro. Questa azione presenta anche limiti differenti, a seconda che si disponga di un flusso di lavoro A consumo o Standard, e funziona meglio per i frammenti di codice con gli attributi seguenti:

Per eseguire codice che non rientra in questi attributi, è possibile creare e chiamare una funzione usando Funzioni di Azure.

Questa guida illustra il funzionamento dell'azione in un flusso di lavoro di esempio che inizia con un trigger di Office 365 Outlook. Il flusso di lavoro viene eseguito quando arriva una nuova email nell'account di posta elettronica di Outlook associato. Il frammento di codice di esempio estrae tutti gli indirizzi di posta elettronica esistenti nel corpo del messaggio di posta elettronica e restituisce gli indirizzi come output che è possibile usare in un'azione successiva.

Il diagramma seguente mostra le evidenziazioni del flusso di lavoro di esempio:

Prerequisiti

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

• Flusso di lavoro dell'app per la logica in cui si vuole aggiungere il frammento di codice. Il flusso di lavoro deve già iniziare con un trigger.

  Questo esempio di articolo usa il trigger di Office 365 Outlook denominato Quando arriva un nuovo messaggio di posta elettronica.

  Se non si dispone di un flusso di lavoro, vedere la documentazione seguente:

  • A consumo: creare un flusso di lavoro dell'app per la logica A consumo di esempio

  • Standard: creare flussi di lavoro di app per la logica Standard di esempio

• In base al fatto che si disponga di un flusso di lavoro di app per la logica A consumo o Standard, esaminare i requisiti seguenti:

  • Flusso di lavoro A consumo

    • Node.js versione 8.11.10

    • Collegarsi a un account di integrazione, vuoto o di altro tipo, dalla risorsa dell'app per la logica.

      Importante

      Assicurarsi di usare un account di integrazione appropriato per il caso d'uso o lo scenario.

      Ad esempio, gli account di integrazione di livello gratuito sono destinati solo agli scenari esplorativi e ai carichi di lavoro, non agli scenari di produzione, sono limitati nell'utilizzo e nella velocità effettiva e non sono supportati da un contratto di servizio (SLA).

      Altri livelli di account di integrazione comportano costi, ma includono il supporto del contratto di servizio, offrono una maggiore velocità effettiva e hanno limiti più elevati. Altre informazioni su livelli, limiti e prezzi degli account di integrazione.

  • Flusso di lavoro Standard

    • Node.js versioni 16.x.x

    • Nessun account di integrazione necessario.

Aggiungere l'azione Esegui codice JavaScript

Output di trigger e azioni di riferimento usando l'oggetto workflowContext

Dall'interno del frammento di codice nella finestra di progettazione, è possibile usare l'elenco di contenuto dinamico per selezionare un token che fa riferimento all'output del trigger o a qualsiasi azione precedente. Quando si seleziona il token, l'azione Esegui codice JavaScript risolve tale token in un oggetto JSON workflowContext di sola lettura. Questo oggetto consente al codice di accedere agli output dal trigger, alle azioni precedenti e al flusso di lavoro. L'oggetto usa la struttura seguente e include le proprietà actions, trigger e workflow, che sono anche oggetti:

{
   "workflowContext": {
      "actions": {
         "<action-name-1>": @actions('<action-name-1>'),
         "<action-name-2>": @actions('<action-name-2>')
      },
      "trigger": {
         @trigger()
      },
      "workflow": {
         @workflow()
      }
   }
}

La tabella seguente contiene altre informazioni su queste proprietà:

Nell'esempio di questo articolo, l'oggetto JSON workflowContext potrebbe avere le proprietà e i valori di esempio seguenti del trigger di Outlook:

{
   "workflowContext": {
      "trigger": {
         "name": "When_a_new_email_arrives",
         "inputs": {
            "host": {
               "connection": {
                  "name": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Web/connections/office365"
               }
            },
            "method": "get",
            "path": "/Mail/OnNewEmail",
            "queries": {
               "includeAttachments": "False"
            }
         },
         "outputs": {
            "headers": {
               "Pragma": "no-cache",
               "Content-Type": "application/json; charset=utf-8",
               "Expires": "-1",
               "Content-Length": "962095"
            },
            "body": {
               "Id": "AAMkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgBGAAAAAABmZwxUQtCGTqSPpjjMQeD",
               "DateTimeReceived": "2019-03-28T19:42:16+00:00",
               "HasAttachment": false,
               "Subject": "Hello World",
               "BodyPreview": "Hello World",
               "Importance": 1,
               "ConversationId": "AAQkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgAQ",
               "IsRead": false,
               "IsHtml": true,
               "Body": "Hello World",
               "From": "<sender>@<domain>.com",
               "To": "<recipient-2>@<domain>.com;<recipient-2>@<domain>.com",
               "Cc": null,
               "Bcc": null,
               "Attachments": []
            }
         },
         "startTime": "2019-05-03T14:30:45.971564Z",
         "endTime": "2019-05-03T14:30:50.1746874Z",
         "scheduledTime": "2019-05-03T14:30:45.8778117Z",
         "trackingId": "1cd5ffbd-f989-4df5-a96a-6e9ce31d03c5",
         "clientTrackingId": "08586447130394969981639729333CU06",
         "originHistoryName": "08586447130394969981639729333CU06",
         "code": "OK",
         "status": "Succeeded"
      },
      "workflow": {
         "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>",
         "name": "<logic-app-workflow-name>",
         "type": "Microsoft.Logic/workflows",
         "location": "<Azure-region>",
         "run": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>/runs/08586453954668694173655267965CU00",
            "name": "08586453954668694173655267965CU00",
            "type": "Microsoft.Logic/workflows/runs"
         }
      }
   }
}

Aggiungere dipendenze come parametri a un'azione Esegui codice JavaScript

In alcuni scenari potrebbe essere necessario richiedere in modo esplicito che l'azione Esegui codice JavaScript includa output dal trigger o dalle azioni a cui fa riferimento il codice come dipendenze. Ad esempio, è necessario eseguire questo passaggio aggiuntivo quando il codice fa riferimento agli output che non sono disponibili in fase di esecuzione del flusso di lavoro. Durante la creazione del flusso di lavoro, il motore di App per la logica di Azure analizza il frammento di codice per determinare se il codice fa riferimento a qualsiasi output di trigger o azione. Se tali riferimenti esistono, il motore include automaticamente tali output. In fase di esecuzione del flusso di lavoro, se l'output del trigger o dell'azione a cui si fa riferimento non viene trovato nell'oggetto workflowContext, il motore genera un errore. Per risolvere questo errore, è necessario aggiungere tale trigger o azione come dipendenza esplicita per l'azione Esegui codice JavaScript. Un altro scenario che richiede di eseguire questo passaggio è quando l'oggetto workflowContext fa riferimento a un trigger o un nome di azione che usa l'operatore punto (.).

Per aggiungere un trigger o un'azione come dipendenza, aggiungere i parametri Trigger o Azioni come applicabile all'azione Esegui codice JavaScript. È quindi possibile aggiungere i nomi di trigger o azione così come vengono visualizzati nella definizione JSON sottostante del flusso di lavoro.

Si supponga, ad esempio, che l'azione Invia messaggio di posta elettronica di approvazione del connettore Office 365 Outlook preceda il frammento di codice nel flusso di lavoro di esempio. Il frammento di codice di esempio seguente include un riferimento all'output SelectedOption di questa azione.

Per questo esempio, è necessario aggiungere solo il parametro Azioni e quindi aggiungere il nome JSON dell'azione, Send_approval_email, al parametro. In questo modo, si specifica che l'azione Esegui codice JavaScript include in modo esplicito l'output dell'azione Invia messaggio di posta elettronica di approvazione.

Trovare il nome JSON del trigger o dell'azione

Prima di iniziare, è necessario il nome JSON per il trigger o l'azione nella definizione del flusso di lavoro sottostante.

• I nomi nella definizione del flusso di lavoro usano un carattere di sottolineatura (_), non uno spazio.

• Se un nome di azione usa l'operatore dot (.), includere tale operatore, ad esempio:

  My.Action.Name

Aggiungere il nome del trigger o dell'azione all'azione Esegui codice JavaScript

1. Nell'azione Esegui codice JavaScript aprire l'elenco Aggiungi nuovo parametro.

2. Nell'elenco dei parametri selezionare i parametri seguenti in base alle esigenze dello scenario.

   Parametro	Descrizione
   Azioni	Includere gli output delle azioni precedenti come dipendenze. Quando si seleziona questo parametro, vengono richieste le azioni da aggiungere.
   Trigger	Includere gli output dal trigger come dipendenze. Quando si seleziona questo parametro, viene richiesto se includere i risultati del trigger. Quindi, nell'elenco Trigger selezionare Sì.

3. Per questo esempio, selezionare il parametro Azioni.

   

4. Nella casella Elemento Azioni - 1 immettere il nome JSON dell'azione.

   

5. Per aggiungere un altro nome di azione, selezionare Aggiungi nuovo elemento.

6. Al termine, salvare il flusso di lavoro.

Riferimento azione

Per altre informazioni sulla struttura e sulla sintassi dell'azione Esegui codice JavaScript nella definizione del flusso di lavoro sottostante usando il linguaggio di definizione del flusso di lavoro, vedere la sezione di riferimento di questa azione.

Passaggi successivi

• Connettori gestiti per app per la logica di Azure
• Connettori predefiniti per App per la logica di Azure