Modellare i dati nei workflow per App per la logica di Azure

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

Per lavorare con vari dati nei tuoi flussi di lavoro, usa le azioni integrate di Data Operations così non devi scrivere il tuo codice.

Questa guida introduce e mostra come utilizzare ogni azione:

Azione Descrizione
Compose. Costruisci una stringa o un oggetto JavaScript Object Notation (JSON) da più input. Usa questa stringa o oggetto come un unico input così non devi inserire ripetutamente gli stessi input multipli.
Analizza JSON Crea token amichevoli dalle proprietà JSON. Usa questi token per fare facilmente riferimento a queste proprietà nel tuo flusso di lavoro.
Creare una tabella CSV o
Crea tabella HTML		 Costruisci una tabella da un array.
Array di filtri Crea un array di sottoinsieme basato su un filtro o una condizione.
Seleziona Costruisci un array partendo dalle proprietà di tutti gli oggetti in un altro array.
Join. Crea una stringa da elementi dell'array.

Prerequisiti

  • Un account e una sottoscrizione di Azure. Ottenere un account Azure gratuito.

  • Flusso di lavoro dell'app per la logica in cui si vuole eseguire l'operazione sui dati.

    Prima di utilizzare un'operazione dati, il tuo flusso di lavoro deve includere un trigger come primo passo. Dopo questo trigger, includi eventuali altre azioni necessarie per creare gli output che l'operazione sui dati usa come input.

Azioni dell'operazione sui dati

Le sezioni seguenti riepilogano le operazioni sui dati che è possibile usare. Le operazioni sono organizzate in base ai tipi di dati di origine su cui funzionano le operazioni, ma ogni descrizione viene visualizzata alfabeticamente. Seleziona il nome di qualsiasi azione per andare direttamente a un esempio passo dopo passo.

Azioni per JSON

Le seguenti azioni consentono di operare sui dati in formato JSON (JavaScript Object Notation).

Azione Descrizione
Componi Creare un messaggio o una stringa da più input che possono avere vari tipi di dati. Usa questa stringa come un unico input, invece di dover inserire ripetutamente gli stessi input. Ad esempio, è possibile creare un singolo messaggio JSON da vari input.
Analizza JSON Creare token di dati descrittivi per le proprietà in contenuto JSON, in modo da poter usare più facilmente le proprietà nelle app per la logica.

Per creare trasformazioni JSON più complesse, vedere Eseguire trasformazioni JSON avanzate con un modello Liquid.

Azioni per le matrici

Queste azioni consentono di operare sui dati in matrici.

Azione Descrizione
Crea tabella CSV Creare una tabella di valori delimitati da virgole (CSV) da una matrice.
Crea tabella HTML Creare una tabella HTML da una matrice.
Filtra matrice Creare un subset di matrice da una matrice in base al filtro o alla condizione specificati.
Join Creare una stringa da tutti gli elementi in una matrice e separare gli elementi con il carattere specificato.
Seleziona Creare una matrice dalle proprietà specificate per tutti gli elementi in una matrice diversa.

Azione compose

Usa l'azione Compose per creare un unico output, come un oggetto JSON, da più ingressi. I tuoi input possono avere vari tipi, come interi, booleani, array, oggetti JSON e qualsiasi altro tipo nativo supportato da App per la logica di Azure, inclusi binario e XML. Puoi usare l'output nelle azioni che seguono l'azione Compose . L'azione Componi consente anche di evitare l'immissione ripetitiva degli stessi input durante la creazione del flusso di lavoro dell'app per la logica.

Ad esempio, è possibile costruire un messaggio JSON da più variabili, ad esempio variabili stringa che archiviano nomi e cognomi delle persone e una variabile integer che archivia le età. In questo esempio, l'azione Compose accetta gli input seguenti:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

E crea l'output seguente:

{"age":35,"fullName":"Owens,Sophia"}

Per provare l'azione Componi, seguire questa procedura usando la finestra di progettazione del flusso di lavoro. Oppure, se preferisci lavorare nell'editor della visualizzazione codice, puoi copiare da questa guida l'esempio dell'azione Compose e le definizioni delle variabili per l'azione Initialize variables nella definizione del flusso di lavoro sottostante della tua app per la logica: Esempi di codice per le operazioni sui dati - Compose. Per altre informazioni sull'azione Componi nella definizione del flusso di lavoro JSON sottostante, vedere l'azione Componi.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci il Nome, il Tipo e il Valore di una variabile e poi selezioni + Aggiungi una variabile per inserire la successiva.

    In questo esempio, crei due variabili stringa e una variabile intera.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: firstNameVar
    - Tipo: stringa
    - Valore: Sophia
    Inizializzare variabili - Nome: lastNameVar
    - Tipo: stringa
    - Valore: Owens
    Inizializzare variabili - Nome: ageVar
    - Tipo: numero intero
    - Valore: 35

    Screenshot che mostra il portale Azure, il designer del workflow Consumption e il workflow di esempio per l'azione Compose.

  2. Seguire questi passaggi generali per aggiungere l'azione Operazioni sui dati denominata Componi.

  3. Nella finestra di progettazione selezionare l'azione Componi, se non è già selezionata.

  4. Nella casella Input, immettere gli input da usare per la creazione dell'output.

    Per questo esempio, seguire questa procedura:

    1. Nella casella Input, immettere l'oggetto JSON di esempio seguente, inclusa la spaziatura come illustrato:

      {
    "age": ,
    "fullName": " , "
}

    2. Nell'oggetto JSON, posizionare il cursore nelle posizioni corrispondenti, selezionare l'elenco di contenuto dinamico (icona a forma di fulmine) e quindi selezionare la variabile corrispondente nell'elenco:

      Proprietà JSON Variabile
      age ageVar
      fullName "cognomeVar, primoNomeVar"

      L'esempio seguente mostra le definizioni aggiunte per due variabili e il processo per aggiungere la terza variabile:

      Schermata che mostra un flusso di lavoro Consumption, un'azione Compose, un elenco di contenuti dinamici e gli input selezionati da usare.

  5. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Testare il flusso di lavoro

Per verificare se l'azione Componi crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Componi.

  1. Nel flusso di lavoro, aggiungere un'azione che può inviare i risultati dall'azione Componi.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2):This example continua using the Office 365 Outlook action named Send an email (V2):

    Screenshot che mostra il designer del workflow e l'aggiunta dell'azione Office 365 Outlook chiamata Invia un'email (V2).

  2. In questa azione, per ogni casella in cui si desidera visualizzare i risultati, selezionare all'interno di ogni casella e quindi selezionare l'elenco di contenuto dinamico (icona a forma di fulmine).

  3. Dalla lista dei contenuti dinamici, sotto l'azione Comporre , seleziona Outputs.

    Per questo esempio, il risultato viene visualizzato nel corpo del messaggio di posta elettronica, quindi si aggiunge il campo Output alla casella Corpo :

    Screenshot che mostra l'azione Invia un'email (V2) e l'output dall'azione Compose precedente.

  4. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione di operazione Compose data.

Azione Crea tabella CSV

Per creare una tabella di valori delimitati da virgole (CSV) contenente proprietà e valori dagli oggetti JSON (JavaScript Object Notation) in una matrice, usare l'azione denominata Crea tabella CSV. È quindi possibile usare la tabella risultante nelle azioni successive all'azione Crea tabella CSV.

Per provare l'azione Crea tabella CSV, seguire questa procedura usando la finestra Progettazione flussi di lavoro. Oppure, se preferisci lavorare nell'editor di code view, puoi copiare l'esempio Crea l'azione di tabella CSV e le definizioni di variabili per l'azione Inizializza le variabili da questa guida nella definizione del workflow sottostante della tua app logica: Esempi di codice di operazioni dati - Crea tabella CSV. Per altre informazioni sull'azione Crea tabella CSV nella definizione del flusso di lavoro JSON sottostante, vedere l'azione Tabella.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    L'azione Create CSV Table è impostata per creare una variabile in cui il valore iniziale è un array che possiede alcune proprietà e valori in formato JSON.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: myJSONArray
    - Tipo: matrice
    - Valore: [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    Schermata che mostra un flusso di lavoro di consumo e l'azione denominata Crea tabella CSV.

  2. Seguire questi passaggi generali per aggiungere l'azione Operazioni sui dati denominata Crea tabella CSV.

  3. Nella finestra di progettazione selezionare l'azione Crea tabella CSV, se non è già selezionata. Nella casella Da, immettere la matrice o l'espressione da usare per la creazione della tabella.

    Per questo esempio, selezionare all'interno della casella Da e selezionare l'elenco di contenuto dinamico (icona a forma di fulmine). Nell'elenco, selezionare la variabile myJSONArray:

    Schermata che mostra un flusso di lavoro di consumo, l'azione Crea tabella CSV e l'input selezionato da usare.

    Suggerimento

    Per creare token descrittivi per le proprietà negli oggetti JSON, in modo da poter selezionare le proprietà come input, usare Analizza JSON prima di usare l'azione Crea tabella CSV.

    Lo screenshot seguente mostra l'azione Crea tabella CSV di esempio completata:

    Screenshot che mostra un flusso di lavoro di Consumo e un'azione completata chiamata Crea tabella CSV.

  4. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Personalizza colonne e header delle tabelle CSV

Di default, nell'azione Crea tabella CSV , la proprietà Columns crea automaticamente le colonne della tabella basate sugli elementi dell'array. Per specificare intestazioni e valori personalizzati, seguire questa procedura:

  1. Se la proprietà Colonne non viene visualizzata nella casella delle informazioni sull'azione, nell'elenco Parametri avanzati selezionare Colonne.

    Screenshot che mostra un flusso di lavoro Standard con il parametro Columns selezionato nella lista dei parametri avanzati.

  2. Aprire l'elenco Colonne e selezionare Personalizzata.

  3. Nella proprietà Header , inserisci il testo personalizzato dell'header da utilizzare.

  4. Nella proprietà Value , inserisci il valore personalizzato da utilizzare.

Per restituire valori dall'array, usa la item() funzione con l'azione Crea tabella CSV . In un ciclo For_each, utilizza la items() funzione.

Si supponga, ad esempio, di volere colonne di tabella con solo i valori delle proprietà e non i nomi delle proprietà di una matrice. Per restituire solo questi valori, seguire questa procedura per lavorare nella visualizzazione della finestra di progettazione o nella visualizzazione codice.

In questo esempio viene restituito il risultato seguente:

Apples,1
Oranges,2

Lavorare nella visualizzazione della finestra di progettazione

Nell'azione Crea tabella CSV, mantenere vuota la colonna Intestazione. In ogni riga della colonna Valore, dereferenziare ogni proprietà della matrice desiderata. Ogni riga in Valore restituisce tutti i valori per la proprietà della matrice specificata e diventa una colonna nella tabella.

  1. Per ogni proprietà della matrice desiderata, nella colonna Valore, selezionare all'interno della casella di modifica e quindi selezionare l'icona della funzione, che apre l'editor di espressioni. Assicurarsi che l'elenco Funzioni sia selezionato.

    Screenshot che mostra un flusso di lavoro Standard con il parametro Columns e l'editor di espressioni di funzione aperti per il campo Value della colonna.

  2. Nell'editor di espressioni immettere l'espressione seguente, ma sostituire <array-property-name> con il nome della proprietà della matrice per il valore desiderato. Una volta completata l’espressione, selezionare Aggiungi.

    Sintassi: item()?['<array-property-name>']

    Valori di esempio:

    • item()?['Description']
    • item()?['Product_ID']

    Screenshot che mostra il designer del workflow, l'azione chiamata Crea tabella CSV e come dereferenziare la proprietà dell'array chiamata Description.

    Per altre informazioni, vedere item() function.

  3. Ripetere i passaggi precedenti per ogni proprietà della matrice. Al termine, l'azione avrà un aspetto simile al seguente esempio:

    Screenshot che mostra l'azione chiamata Create CSV table e la funzione chiamata item().

  4. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Lavorare nella visualizzazione codice

Nella definizione JSON dell'azione Create CSV table, all'interno dell'array columns , imposta la header proprietà su una stringa vuota. Per ogni proprietà value, dereferenziare ogni proprietà della matrice desiderata.

  1. Sulla barra degli strumenti della finestra di progettazione selezionare Visualizzazione codice.

  2. Nell'editor di codice trovare la matrice dell'azione columns. Per ogni colonna di valori di matrice desiderati, aggiungere una proprietà vuota header e l'espressione seguente per la proprietà value:

    Sintassi:

    {
   "header": "",
   "value": "@item()?['<array-property-name>']"
}

    Esempio:

    "Create_CSV_table": {
   "type": "Table",
   "inputs": {
      "columns": [
         { 
            "header": "",
            "value": "@item()?['Description']"
         },
         { 
            "header": "",
            "value": "@item()?['Product_ID']"
         }
      ],
      "format": "CSV",
      "from": "@variables('myJSONArray')"
   }
}

    Note

    Se si copia l'esempio nel codice, assicurarsi di includere l'azione runAfter alla fine della Create_CSV_table definizione.

  3. Torna alla finestra di progettazione per rivedere i risultati.

Testare il flusso di lavoro

Per verificare se l'azione Crea tabella CSV crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Crea tabella CSV.

  1. Nel flusso di lavoro, aggiungere un'azione che può inviare i risultati dall'azione Crea tabella CSV.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2).

  2. In questa azione, per ogni casella in cui si desidera visualizzare i risultati, selezionare all'interno di ogni casella, che apre l'elenco di contenuto dinamico. In tale elenco, sotto l'azione Crea tabella CSV selezionare Output.

    Screenshot che mostra un flusso di lavoro con l'azione Invia un'email (V2). La proprietà Corpo contiene il campo chiamato Output dall'azione precedente chiamato Crea tabella CSV.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione chiamata Crea tabella CSV.

Note

Se la tabella viene restituita con formattazione errata, vedere come controllare la formattazione dei dati della tabella.

Azione Crea tabella HTML

Per creare una tabella HTML contenente proprietà e valori dagli oggetti JSON (JavaScript Object Notation) in una matrice, usare l'azione Crea tabella HTML. È quindi possibile usare la tabella risultante nelle azioni successive all'azione Crea tabella HTML.

Per provare l'azione Crea tabella HTML, seguire questa procedura usando la finestra di progettazione flussi di lavoro. Oppure, se preferisci lavorare nell'editor di code view, puoi copiare l'esempio Crea tabella , azione HTML e definizioni variabili per l'azione Inizializzare variabili da questa guida nella definizione del workflow sottostante della tua app logica: Esempi di codice di operazioni dati - Crea tabella HTML. Per altre informazioni sull'azione Crea tabella HTML nella definizione del flusso di lavoro JSON sottostante, vedere azione Tabella.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    L'azione è configurata per la creazione di una variabile il cui valore iniziale è una matrice con proprietà e valori in formato JSON.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: myJSONArray
    - Tipo: matrice
    - Valore: [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    Screenshot che mostra il portale Azure, il flusso di lavoro Consumo e l'azione chiamata Crea tabella HTML.

  2. Seguire questa procedura generale per aggiungere l'azione Operazionisui dati denominata Crea tabella HTML.

  3. Nella finestra di progettazione selezionare l'azione Crea tabella HTML, se non è già stata selezionata. Nella casella Da, immettere la matrice o l'espressione da usare per la creazione della tabella.

    Per questo esempio, selezionare all'interno della casella Da e selezionare l'elenco di contenuto dinamico (icona a forma di fulmine). Nell'elenco, selezionare la variabile myJSONArray:

    Screenshot che mostra un flusso di lavoro di consumo, un'azione chiamata Crea tabella HTML e l'input selezionato da utilizzare.

    Suggerimento

    Per creare token descrittivi per le proprietà negli oggetti JSON, in modo da poter selezionare le proprietà come input, usare Analizza JSON prima di usare l'azione Crea tabella HTML.

    Lo screenshot seguente mostra l'azione Crea tabella HTML completata:

    Uno screenshot che mostra un flusso di lavoro di Consumo e un'azione completata chiamata Crea tabella HTML.

  4. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Personalizza colonne e intestazioni di tabelle HTML

Di default, nell'azione Crea tabella HTML , la proprietà Colonne crea automaticamente le colonne della tabella basandosi sugli elementi dell'array. Per specificare intestazioni e valori personalizzati, seguire questa procedura:

  1. Se la proprietà Colonne non viene visualizzata nella casella delle informazioni sull'azione, nell'elenco Parametri avanzati selezionare Colonne.

  2. Aprire l'elenco Colonne e selezionare Personalizzata.

  3. Nella proprietà Header , inserisci il testo personalizzato dell'header da utilizzare.

  4. Nella proprietà Value , inserisci il valore personalizzato da utilizzare.

Per restituire valori dall'array, usa la item() funzione con l'azione Crea tabella HTML . In un ciclo For_each, utilizza la items() funzione.

Si supponga, ad esempio, di volere colonne di tabella con solo i valori delle proprietà e non i nomi delle proprietà di una matrice. Per restituire solo questi valori, seguire questa procedura per lavorare nella visualizzazione della finestra di progettazione o nella visualizzazione codice.

In questo esempio viene restituito il risultato seguente:

Apples,1
Oranges,2

Lavorare nella visualizzazione della finestra di progettazione

Nell'azione Crea tabella HTML mantenere vuota la colonna Intestazione. In ogni riga della colonna Valore, dereferenziare ogni proprietà della matrice desiderata. Ogni riga in Valore restituisce tutti i valori per la proprietà della matrice specificata e diventa una colonna nella tabella.

  1. Per ogni proprietà della matrice desiderata, nella colonna Valore, selezionare all'interno della casella di modifica e quindi selezionare l'icona della funzione, che apre l'editor di espressioni. Assicurarsi che l'elenco Funzioni sia selezionato.

  2. Nell'editor di espressioni immettere l'espressione seguente, ma sostituire <array-property-name> con il nome della proprietà della matrice per il valore desiderato. Una volta completata l’espressione, selezionare Aggiungi.

    Sintassi: item()?['<array-property-name>']

    Esempi:

    • item()?['Description']
    • item()?['Product_ID']

    Uno screenshot che mostra un flusso di lavoro, un'azione chiamata Crea tabella HTML e come dereferenziare la proprietà dell'array chiamata Descrizione.

    Per altre informazioni, vedere item() function.

  3. Ripetere i passaggi precedenti per ogni proprietà della matrice. Al termine, l'azione avrà un aspetto simile al seguente esempio:

    Screenshot che mostra l'azione chiamata Crea tabella HTML e una funzione chiamata item().

Lavorare nella visualizzazione codice

Nella definizione JSON dell'azione Create HTML table , all'interno dell'array columns , imposta la header proprietà su una stringa vuota. Per ogni proprietà value, dereferenziare ogni proprietà della matrice desiderata.

  1. Sulla barra degli strumenti della finestra di progettazione selezionare Visualizzazione codice.

  2. Nell'editor di codice trovare la matrice dell'azione columns. Per ogni colonna di valori di matrice desiderati, aggiungere una proprietà vuota header e l'espressione seguente per la proprietà value:

    Sintassi:

    {
   "header": "",
   "value": "@item()?['<array-property-name>']"
}

    Esempio:

    "Create_HTML_table": {
   "type": "Table",
   "inputs": {
      "columns": [
         { 
            "header": "",
            "value": "@item()?['Description']"
         },
         { 
            "header": "",
            "value": "@item()?['Product_ID']"
         }
      ],
      "format": "HTML",
      "from": "@variables('myJSONArray')"
   }
}

    Note

    Se si copia l'esempio nel codice, assicurarsi di includere l'azione runAfter alla fine della Create_HTML_table definizione.

  3. Torna alla visuale del designer per esaminare i risultati.

Testare il flusso di lavoro

Per verificare se l'azione Crea tabella HTML crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Crea tabella HTML.

  1. Nel flusso di lavoro, aggiungere un'azione che può inviare i risultati dall'azione Crea tabella HTML.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2).

  2. In questa azione, per ogni casella in cui si desidera visualizzare i risultati, selezionare all'interno di ogni casella e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Nell'elenco selezionare Output nell'azione Crea tabella HTML.

    Screenshot che mostra un flusso di lavoro con l'azione Invia un'email (V2). La proprietà Corpo contiene il campo Output dall'azione precedente chiamata Crea tabella HTML.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione chiamata Crea tabella HTML.

Azione Filtra matrice

Usa l'azione Filter array per creare un array di sottoinsieme da un array esistente in cui gli elementi del sottoinsieme soddisfano criteri specifici. Puoi quindi utilizzare l'array filtrato risultante nelle azioni che seguono l'azione Filter array .

Per provare l'azione Filtra matrice, seguire questa procedura usando la finestra di progettazione del flusso di lavoro. Oppure, se preferisci lavorare nell'editor della visualizzazione codice, puoi copiare da questa guida l'azione di esempio Filter array e le definizioni delle variabili per l'azione Initialize variables nella definizione del flusso di lavoro sottostante della tua app per la logica: Esempi di codice per operazioni sui dati - Filter array. Per altre informazioni sull'azione Filtra matrice nella definizione del flusso di lavoro JSON sottostante, vedere l'azione Query.

Note

Per qualsiasi testo di filtro usato nella condizione viene fatta distinzione tra maiuscole e minuscole. Inoltre, questa azione non può modificare il formato o i componenti degli elementi nella matrice.

Affinché le azioni possano usare l'output della matrice dall'azione Filtra matrice, tali azioni devono accettare le matrici come input oppure potrebbe essere necessario trasformare la matrice di output in un altro formato compatibile.

Se si chiama un endpoint HTTP e si riceve una risposta JSON, usare l'azione Analizza JSON per elaborare la risposta JSON. In caso contrario, l'azione Filtra matrice può leggere solo il corpo della risposta e non la struttura del payload JSON.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    L'azione è configurata per creare un valore iniziale costituito da un array con alcuni valori interi di esempio.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: myIntegerArray
    - Tipo: matrice
    - Valore: [1,2,3,4]

    Note

    Anche se questo esempio usa una matrice di interi semplice, questa azione è particolarmente utile per matrici di oggetti JSON, che è possibile filtrare in base alle proprietà e ai valori degli oggetti.

    Screenshot che mostra il portale Azure, il flusso di lavoro di consumo e l'azione chiamata Filter array.

  2. Seguire questi passaggi generali per aggiungere l'azione Operazioni sui dati denominata Filtra matrice.

  3. Nella finestra di progettazione selezionare l'azione Filtra matrice, se non è già selezionata. Nella casella Da, immettere la matrice o l'espressione da usare come filtro.

    Per questo esempio, selezionare all'interno della casella Da e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Nell'elenco selezionare la variabile creata in precedenza:

    Schermata che mostra un flusso di lavoro Consumption, un'azione denominata Filter array e l'input selezionato da usare.

  4. Per la condizione, specificare gli elementi della matrice da confrontare, selezionare l'operatore di confronto e specificare il valore di confronto.

    Questo esempio usa la funzione Item() per l'accesso a ogni elemento della matrice durante la ricerca degli elementi di matrice con valore maggiore di 1 tramite l'azione Filtra matrice. Lo screenshot seguente mostra l'azione Filtra matrice di esempio completata:

    Screenshot che mostra un flusso di lavoro Consumption e l'azione completata denominata Filter array.

  5. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Testare il flusso di lavoro

Per confermare se l'azione Filter array crea i risultati attesi, invia una notifica che includa l'output dall'azione Filter array .

  1. Nel flusso di lavoro, aggiungere un'azione che può inviare i risultati dall'azione Filtra matrice.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2).

  2. In questa azione completare i passaggi seguenti:

    1. Per ogni casella in cui vuoi che compaiano i risultati, seleziona la casella, poi seleziona l'icona della funzione. L'icona apre l'editor delle espressioni. Assicurarsi che l'elenco Funzioni sia selezionato.

    2. Per ottenere l'output della matrice dall'azione Filtra matrice, immettere l'espressione seguente, che usa la funzione body() con il nome dell'azione Filtra matrice e quindi selezionare Aggiungi.

      body('Filter_array')

      Screenshot che mostra un flusso di lavoro con l'azione Invia un'email (V2). La proprietà Corpo contiene la funzione body(), che ottiene il contenuto del corpo dall'azione precedente chiamata Filter array.

      L'espressione risolta specifica di mostrare gli output dell'azione Filter_array nel corpo del messaggio di posta elettronica quando viene inviato:

      Screenshot che mostra un flusso di lavoro standard e l'azione completata per Invia un'email.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione chiamata Filter array.

Azione Aggiungi

Per creare una stringa che contenga tutti gli elementi di un array, usa l'azione Join e separa ogni elemento usando un carattere delimitatore specifico. Puoi usare questa stringa nelle azioni che seguono l'azione Join .

Per provare l'azione Join , segui questi passaggi nel workflow designer. Oppure, se preferisci lavorare nell'editor della visualizzazione codice, puoi copiare da questa guida l'azione di esempio Join e le definizioni delle variabili per l'azione Initialize variables nella definizione del flusso di lavoro sottostante della tua app per la logica: Esempi di codice per operazioni sui dati - Join. Per altre informazioni sull’azione Aggiungi nella definizione del flusso di lavoro sottostante, vedere l'azione Aggiungi.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    L'azione è configurata per creare un valore iniziale costituito da un array con alcuni valori interi di esempio.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: myIntegerArray
    - Tipo: matrice
    - Valore: [1,2,3,4]

    Screenshot che mostra il portale Azure, il flusso di lavoro Consumption e l'azione di esempio chiamata Join.

  2. Seguire questi passaggi generali per trovare l'azione Operazioni sui dati denominataAggiungi.

  3. Nella finestra di progettazione selezionare l'azione Aggiungi, se non è già selezionata.

  4. Nella casella Da specificare la matrice contenente gli elementi da aggiungere come stringa.

    Per questo esempio, selezionare all'interno della casella Da e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Nell'elenco selezionare la variabile creata in precedenza:

    Schermata che mostra un flusso di lavoro di tipo Consumo, un'azione denominata Join e l'output di matrice selezionato da unire come stringa.

  5. Nella casella Unisci con, immettere il carattere da usare per separare ogni elemento della matrice.

    In questo esempio vengono utilizzati due punti (:) come separatore per la proprietà Aggiungi con.

    Screenshot che mostra un flusso di lavoro di Consumo e l'azione finita chiamata Join.

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

Testare il flusso di lavoro

Per verificare se l'azione Aggiungi crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Aggiungi.

  1. Nell'app per la logica, aggiungere un'azione che può inviare i risultati dall'azione Aggiungi.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2).

  2. In questa azione, per ogni casella in cui si desidera visualizzare i risultati, selezionare all'interno di ogni casella e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. In tale elenco, sotto l'azione Aggiungi, selezionare Output.

    Screenshot che mostra un flusso di lavoro e un'azione completata chiamata Invia un'email per l'azione Join.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione Join.

Azione Analizza JSON

Per fare riferimento o accedere alle proprietà nei contenuti JavaScript Object Notation (JSON), crea campi o token user-friendly per tali proprietà utilizzando l'azione Parse JSON . Puoi selezionare queste proprietà dalla lista dei contenuti dinamici quando specifichi input per le azioni successive nel tuo workflow. Per questa azione, è possibile specificare uno schema JSON o generare uno schema JSON dal contenuto o dal payload JSON di esempio.

Per provare l'azione Analizza JSON, seguire questa procedura usando la finestra di progettazione del flusso di lavoro. Oppure, se preferisci lavorare nell'editor di code view, puoi copiare l'esempio di definizione di azione Parse JSON e variabile per l'azione Initialize variables da questa guida nella definizione del workflow sottostante della tua app logica: Esempi di codice di operazioni dati - Parse JSON. Per altre informazioni su questa azione nella definizione del flusso di lavoro sottostante, vedere l'azione Analizza JSON.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    Questa azione viene configurata per creare una variabile il cui valore iniziale è l'oggetto JSON seguente con proprietà e valori:

    {
    "Member": {
        "Email": "Sophia.Owen@fabrikam.com",
        "FirstName": "Sophia",
        "LastName": "Owen"
    }
}

    Screenshot che mostra il portale Azure, il flusso di lavoro Consumption e l'azione di esempio chiamata Parse JSON.

  2. Seguire questi passaggi generali per trovare l'azione Operazioni dati denominata Analizza JSON.

  3. Nella finestra di progettazione selezionare l'azione Analizza JSON, se non è già selezionata. Nella casella Contenuto immettere l'oggetto JSON da analizzare.

    Per questo esempio, selezionare all'interno della casella Contenuto e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Nell'elenco selezionare la variabile creata in precedenza:

    Screenshot che mostra un flusso di lavoro di Consumo, un'azione chiamata Parse JSON e la variabile oggetto JSON selezionata da analizzare.

  4. Nella casella Schema, immettere lo schema JSON che descrive l'oggetto JSON o il payloadda analizzare.

    Per questo esempio, usare lo schema seguente per l'oggetto JSON di esempio:

    {
    "type": "object",
    "properties": {
        "Member": {
            "type": "object",
            "properties": {
                "Email": {
                    "type": "string"
                },
                "FirstName": {
                    "type": "string"
                },
                "LastName": {
                    "type": "string"
                }
            }
        }
    }
}

    Schermata che mostra un flusso di lavoro Consumption, un'azione denominata Parse JSON e uno schema JSON dell'oggetto JSON da analizzare.

    Se non si ha uno schema, è possibile generare lo schema dall'oggetto JSON:

    1. Nella casella Schema dell'azione Analizza JSON, selezionare Usa payload di esempio per generare lo schema.

    2. Nella casella Immettere o incollare un payload JSON di esempio, immettere il contenuto o l'oggetto JSON e quindi selezionare Fine, ad esempio:

      {
    "Member": {
       "Email": "Sophia.Owens@fabrikam.com",
       "FirstName": "Sophia",
       "LastName": "Owens"
    }
}

      Schermata che mostra un flusso di lavoro Consumption, un'azione denominata Parse JSON e una casella denominata Immetti o incolla un payload JSON di esempio, che contiene un JSON di esempio per generare lo schema.

  5. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Testare il flusso di lavoro

Per verificare se l'azione Analizza JSON crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Analizza JSON.

  1. Nel flusso di lavoro, aggiungere un'azione che può inviare i risultati dall'azione Analizza JSON.

    Questo esempio continua usando l'azione di Office 365 Outlook denominata Invia un messaggio di posta elettronica (V2).

  2. In questa azione, per ogni casella in cui si desidera visualizzare i risultati, selezionare all'interno di ogni casella di modifica e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Da tale elenco, nell'azione Analizza JSON selezionare le proprietà dall'oggetto JSON analizzato.

    Questo esempio seleziona le seguenti proprietà: Corpo Nome, Corpo Cognome e Corpo Email.

    Screenshot che mostra un flusso di lavoro Standard con proprietà JSON nell'azione chiamata Invia un'email.

    Al termine, l'azione Invia posta elettronica deve essere simile all'esempio seguente:

    Screenshot che mostra un flusso di lavoro con l'azione completata chiamata Invia un'email per l'azione chiamata Parse JSON.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione chiamata Parse JSON.

Seleziona azione

Per impostazione predefinita, l'azione Seleziona crea una matrice che contiene oggetti JSON compilati dai valori di una matrice esistente. Ad esempio, è possibile creare un oggetto JSON per ogni valore in una matrice integer. Specificare le proprietà che ogni oggetto JSON deve avere ed eseguire il mapping dei valori dalla matrice di origine alle proprietà. Sebbene sia possibile modificare i componenti in tali oggetti JSON, la matrice di output ha sempre lo stesso numero di elementi della matrice di origine. Affinché le azioni possano usare l'output della matrice dall'azione Seleziona, le azioni seguenti devono accettare le matrici come input oppure potrebbe essere necessario trasformare la matrice di output in un altro formato compatibile.

Per provare l'azione Seleziona, seguire questa procedura usando la finestra di progettazione flussi di lavoro. Oppure, se preferisci lavorare nell'editor di code view, puoi copiare l'esempio Seleziona le definizioni di azione e variabile per l'azione Inizializza le variabili da questa guida nella definizione del workflow sottostante della tua app logica: Esempi di codice operazione dati - Seleziona. Per altre informazioni su questa azione nella definizione del flusso di lavoro sottostante, vedere l'azione Seleziona.

Suggerimento

Per un esempio che crea un array con stringhe o numeri interi costruiti dai valori in un array di oggetti JSON, vedere le definizioni di azione Select e Initialize variable in Data operation code examples - Select.

  1. Nel portale di Azure o in Visual Studio Code, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

    Questo esempio utilizza il portale Azure e un flusso di lavoro di esempio con il trigger Recurrence seguito dall'azione Initialize variables. All'interno dell'azione Inizializzare variabili , inserisci Nome, Tipo e Valore di una variabile. Per inserire più variabili, seleziona + Aggiungi una variabile.

    L'azione è impostata per creare una variabile in cui il valore iniziale è un array che contiene alcuni interi campioni.

    Operazione Proprietà e valori
    Inizializzare variabili - Nome: myIntegerArray
    - Tipo: matrice
    - Valore: [1,2,3,4]

    Screenshot che mostra il portale Azure, il flusso di lavoro Consumption e l'azione di esempio chiamata Select.

  2. Seguire questi passaggi generali per trovare l'azione di Operazione sui dati denominata Seleziona.

  3. Nella finestra di progettazione selezionare l'azione Seleziona, se non è già selezionata. Nella casella Da immettere la matrice di origine da usare.

    Per questo esempio, selezionare all'interno della casella Da e quindi selezionare l'icona a forma di fulmine, che apre l'elenco di contenuto dinamico. Nell'elenco selezionare la variabile creata in precedenza:

    Schermata che mostra un flusso di lavoro di consumo, un'azione denominata Select e la variabile di matrice di origine selezionata da usare.

  4. Per la proprietà Mappa, nella colonna sinistra immettere un nome di proprietà per descrivere tutti i valori nella matrice di origine.

    Questo esempio usa Product_ID come nome della proprietà per i valori integer nella matrice di origine. Quindi, ogni valore, come 1, 2, 3 e 4, è un ID di prodotto.

  5. Nella colonna a destra immettere un'espressione che specifica il valore nella matrice di origine per il nome della proprietà nella colonna a sinistra.

    In questo esempio viene usata la funzione item() per scorrere e accedere a ogni elemento della matrice.

    1. Selezionare all'interno della colonna destra e quindi selezionare l'icona della funzione; si apre l'editor di espressioni. Assicurarsi che l'elenco Funzioni sia selezionato.

    2. Nell'editor di espressioni immettere la funzione denominata item()e quindi selezionare Aggiungi.

      Screenshot che mostra un flusso di lavoro Consumption, l'azione denominata Select e le proprietà e i valori dell'oggetto JSON per creare l'array di oggetti JSON.

    L'azione Seleziona appare ora simile all'esempio seguente:

    Schermata che mostra un flusso di lavoro di consumo e l'azione completata denominata Select.

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

Testare il flusso di lavoro

Per verificare se l'azione Seleziona crea i risultati previsti, inviare a se stessi una notifica che include l'output dall'azione Seleziona.

  1. Nell'app per la logica, aggiungere un'azione che può inviare i risultati dall'azione Seleziona.

  2. In questa azione completare i passaggi seguenti:

    1. Per ogni casella in cui vuoi che compaiano i risultati, seleziona la casella, poi seleziona l'icona della funzione. L'icona apre l'editor delle espressioni. Assicurarsi che l'elenco Funzioni sia selezionato.

    2. Per ottenere l'output della matrice dall'azione Seleziona, immettere l'espressione seguente, che usa la funzione body() con il nome dell'azione Select e selezionare Aggiungi:

      body('Select')

      Uno screenshot che mostra un flusso di lavoro con l'azione Invia una email (V2) e l'azione viene prodotta dall'azione Seleziona.

      L'espressione risolta specifica di visualizzare gli output dell'azione Seleziona nel corpo del messaggio di posta elettronica quando viene inviato:

      Screenshot che mostra un flusso di lavoro e un'azione completata chiamata Invia un'email per l'azione Seleziona.

  3. Salvare il flusso di lavoro e quindi eseguire manualmente il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Esegui>.

Se usi l'azione Office 365 Outlook - Invia un'email (V2), il seguente esempio mostra il risultato:

Screenshot che mostra un'email con i risultati dell'azione Seleziona.

Risolvere i problemi relativi alle operazioni sui dati

Correggere output di tabelle CSV o HTML formattate in modo errato

Se l'azione Crea tabella CSV o Crea tabella HTML restituisce dati formattati in modo errato, assicurati che i dati di input includano interruzioni tra le righe.

Formattazione errata:

Fruit,Number Apples,1 Oranges,2

Formattazione corretta:

Fruit,Number
Apples,1
Oranges,2

Per aggiungere interruzioni di riga tra righe, aggiungere una delle espressioni seguenti alla tabella:

replace(body('Create_CSV_table'),'\r\n','<br/>')

replace(body('Create_HTML_table'),'\r\n','<br/>')

Ad esempio:

{
   "Send_an_email": {
      "inputs": {
         "body": {
            "Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
            "Subject": "Create CSV table results",
            "To": "sophia.owen@fabrikam.com"
         }
      }
   }
}

Contenuti correlati

  • Last updated on