Tipi di dati delle variabili

Quando crei variabili nei flussi, Power Automate le converte in un tipo specifico in base al loro contenuto.

Alcuni di questi tipi di dati sono ampiamente utilizzati in tutta l'applicazione, ad esempio i numeri, mentre altri, come le istanze del browser, richiedono azioni o gruppi di azioni esplicite.

Tipi di dati semplici

I tipi di dati semplici rappresentano valori singoli, come testi e numeri. È possibile utilizzare questi tipi di dati in modo indipendente o utilizzarli per creare strutture di dati più complesse, come elenchi e tabelle di dati.

Valore del testo

Questo tipo di dati rappresenta qualsiasi tipo di testo, dagli indirizzi di posta elettronica al contenuto di testo di un file .txt.

Proprietà del tipo di dati testo

Per creare una variabile Valore testo, usare l'azione Imposta variabile e immettere il testo desiderato senza alcuna notazione.

Screenshot di un'azione Imposta variabile che crea una variabile Valore di testo.

Valore numerico

Numerico è il tipo applicato ai numeri. Solo questo tipo di dati può essere utilizzato nelle operazioni matematiche.

Per creare una variabile valore numerico, usa l'azione Imposta variabile e immetti un numero senza alcuna notazione.

Ad eccezione dei valori numerici hardcoded, è possibile utilizzare espressioni matematiche con variabili all'interno di segni di percentuale. Per altre informazioni sulle espressioni matematiche, vedere Usare le variabili e la notazione %.

Screenshot di un'azione Imposta variabile che crea una variabile Valore numerico.

Valore booleano

Il valore può essere Vero o Falso.

Per creare una variabile valore booleano , usare l'azione Imposta variabile e immettere le espressioni %True% o %False% nel parametro di input.

È anche possibile creare espressioni complesse usando operatori logici, variabili e notazione percentuale. Per altre informazioni sulle espressioni logiche, vedere Usare le variabili e la notazione %.

Screenshot di un'azione Imposta variabile che crea una variabile di valore booleano.

Tipi di dati avanzati

I tipi di dati avanzati rappresentano strutture di dati complesse. Funzionano come raccolte di altri tipi di dati a cui puoi accedere come un'unica entità.

Elenco

Gli elenchi sono raccolte di elementi. A seconda dei tipi delle singole voci di elenco, possono essere presenti elenchi di valori di testo, elenchi di valori numerici e così via. Il tipo di dati elenco è l'equivalente di un array monodimensionale in termini di programmazione.

Puoi creare un elenco tramite l'azione Crea nuovo elenco e aggiungere un elemento all'elenco tramite l'azione Aggiungi elemento all'elenco.

Screenshot di un flusso che crea un elenco.

È inoltre possibile creare un elenco tramite azioni che generano elenchi come output. Ad esempio, l'azione Leggi testo da file può restituire un elenco di valori di testo e l'azione Ottieni file nella cartella restituisce un elenco di file.

Per recuperare una voce specifica di un elenco, utilizza la seguente notazione: %VariableName[ItemNumber]%

Nell'esempio seguente, il flusso memorizza il primo numero dell'elenco visualizzato in precedenza in una nuova variabile. Tieni presente che l'indice deve essere 0 per il primo elemento dell'elenco.

Screenshot di un'espressione che accede al primo elemento di un elenco.

Una pratica comune è usare l'azione For each per scorrere gli elementi di un elenco.

Se è necessario accedere solo a una parte specifica di un elenco, utilizza la notazione %VariableName[StartIndex:StopIndex]%. Ad esempio, l'espressione %List[2:4]% recupera il terzo e il quarto elemento dell'elenco. L'elemento nella posizione StopIndex è il limite dello slicing e non viene restituito.

Per estrarre una porzione di un elenco dall'inizio a un elemento specifico, non impostare un valore StartIndex, ad esempio %List[:4]%. Per estrarre una porzione di un elenco da un indice specifico fino alla fine, non impostare un valore StopIndex, ad esempio %List[2:]%.

Proprietà del tipo di dati elenco

Datatable

Le tabelle dati contengono i dati in formato tabulare e sono l'equivalente delle matrici bidimensionali in termini di programmazione.

Un datatable contiene righe e colonne che descrivono la posizione di ogni elemento in modo univoco. È possibile considerare le tabelle dati come elenchi contenenti datarows come elementi.

Screenshot del contenuto di una variabile tabella dati.

Power Automate fornisce l'azione Crea nuova tabella dati per generare nuove tabelle dati. Dopo aver distribuito l'azione, puoi utilizzare il generatore visivo per popolare i valori e rinominare le intestazioni di colonna.

Screenshot del generatore visivo dell'azione Crea nuova tabella dati.

Oltre all'azione Crea nuova tabella dati, altre tre azioni producono tabelle dati per archiviare i dati estratti: le azioni Leggi dal foglio di lavoro Excel, Esegui istruzione SQL e Estrai dati dalla pagina Web.

È anche possibile creare una datatable usando l'azione Imposta variabile e la notazione array di programmazione. Questa notazione è composta da più array monodimensionali separati da virgole e racchiusi tra parentesi graffe. L'espressione finale deve avere il seguente formato: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Screenshot di un'azione Imposta variabile che crea una tabella dati.

Se si desidera aggiungere intestazioni di colonna durante la creazione di una nuova tabella dati usando la notazione della matrice, usare l'espressione ^['ColumnName1', 'ColumnName2'] per la prima riga.

Screenshot di un'azione Imposta variabile che crea una nuova tabella dati con intestazioni di colonna.

Per aggiungere una nuova riga a una tabella esistente, utilizza l'azione Inserisci riga nella tabella di dati. In alternativa, crea un'espressione contenente il nome della variabile della tabella dati, il segno più (+) e i valori che vuoi aggiungere tra parentesi.

Screenshot di un'azione Imposta variabile che aggiunge una nuova riga a una tabella dati.

Oltre a inserire righe nelle datatables, i flussi desktop offrono varie azioni che le modificano. È possibile trovare un elenco completo di queste azioni nel riferimento alle azioni delle variabili.

Per recuperare un elemento specifico da una tabella dati, usare la notazione seguente: %VariableName[RowNumber][ColumnNumber]%. Tieni presente che RowNumber e ColumnNumber devono essere 0 per il primo elemento (riga o colonna).

Ad esempio, supponiamo che un flusso recuperi il contenuto di un foglio di lavoro Excel e lo memorizzi nella variabile ExcelData. Per accedere alla prima cella della seconda riga della tabella recuperata, usare l'espressione visualizzata nell'immagine seguente.

Screenshot di un'espressione che accede alla seconda cella della prima riga di un file Excel letto.

Nota

La variabile ExcelData contiene una tabella di valori estratti da un foglio di lavoro Excel utilizzando l'azione Leggi da Excel foglio di lavoro. Contiene alcuni valori di un foglio di lavoro specifico e non l'intero file Excel.

Se si desidera accedere a una colonna specifica in una tabella dati contenente intestazioni di colonna, usare la %ExcelData[rowNumber]['ColumnName']% notazione.

Se si esegue un ciclo attraverso una tabella dati usando un'azione For Each, la variabile che contiene i dati dell'iterazione corrente viene considerata una riga di dati.

Analogamente agli elenchi, si usa la notazione %VariableName[StartRow:StopRow]% per accedere a una parte specifica di una tabella dati. L'espressione recupera solo le righe definite dai due indici, mentre la posizione StopRow è il confine della selezione e non viene recuperata.

Per estrarre una porzione di una datatable dalla prima riga a una riga specifica, non utilizzare un valore StartRow, ad esempio %Datatable[:4]%. Analogamente, per sezionare una tabella dati da una riga specifica alla fine, non usare un valore StopRow , ad esempio %Datatable[2:]%.

Proprietà del tipo di dati Datatable

Riga di dati

Una riga di dati contiene i valori di una singola riga di una tabella di dati. Quando usi un'azione For Each per analizzare in modo ciclico un datatable, la variabile contenente i dati dell'iterazione corrente è un datarow.

Per recuperare un elemento specifico di un datarow, usa la seguente notazione: %VariableName[ItemNumber]%

In alternativa, puoi usare la notazione %VariableName['ColumnName']%. Il nome di ogni colonna è definito dal datatable da cui è stato recuperato il datarow.

Proprietà del tipo di dati datarow

Screenshot del contenuto di una variabile DataRow.

Oggetto personalizzato

Contiene coppie di proprietà e valori, che è possibile convertire facilmente in formato JSON.

Per creare un nuovo oggetto Personalizzato vuoto, usare l'azione Imposta variabile e immettere l'espressione %{{ }}%. Per creare un nuovo oggetto Custom e inizializzarlo con proprietà e valori, usare un'espressione con la struttura seguente: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Screenshot di un'azione Imposta variabile che crea un nuovo oggetto personalizzato.

Importante

Non è possibile usare parole chiave riservate come proprietà dell'oggetto personalizzato. Per l'elenco completo delle parole chiave riservate, vedere Parole chiave riservate nei flussi desktop.

Per aggiornare il valore di una proprietà esistente o aggiungerne una nuova, aggiungere un'azione Imposta variabile, immettere il nome della proprietà nel campo Imposta e immetterne il valore nel campo A.

Screenshot di un'azione Imposta variabile che aggiunge una nuova proprietà a un oggetto personalizzato.

Oltre ai valori letterali, è possibile usare le variabili per impostare dinamicamente le proprietà e i valori degli oggetti personalizzati. Ad esempio, il flusso seguente utilizza due variabili per aggiungere una nuova proprietà a un nuovo oggetto personalizzato vuoto.

Screenshot di un flusso che usa le variabili per aggiungere una nuova proprietà a un oggetto personalizzato.

oggetto connettore

Gli oggetti connettore memorizzano le informazioni dai connettori cloud e funzionano in modo simile agli oggetti personalizzati. Le loro proprietà in genere contengono elenchi di altri oggetti connettore. L'accesso ai valori funziona come negli oggetti personalizzati, sebbene l'accesso ai valori nidificati potrebbe richiedere espressioni più complicate.

Screenshot di una variabile oggetto personalizzato nel visualizzatore delle variabili.

Elenco di informazioni di tabella PDF

È possibile creare una variabile di questo tipo di dati solo tramite l'azione Estrai tabelle da PDF .

Ciascun elemento dell'elenco descrive una tabella estratta e fornisce tutte le informazioni essenziali. Per accedere a un elemento informativo specifico di una tabella dati, utilizza la notazione %VariableName[ItemNumber]%.

Schermata di un elenco di informazioni della tabella PDF.

Ogni voce di elenco fornisce quattro proprietà che è possibile usare per ottenere dettagli specifici. Le proprietà disponibili sono le seguenti:

  • DataTable: restituisce la tabella estratta.
  • TableStartingPage: restituisce l'indice della pagina del file che contiene l'inizio della tabella.
  • TableEndingPage: restituisce l'indice della pagina del file che contiene la fine della tabella.
  • TableOrderInPage: restituisce l'ordine della tabella nella pagina.

Per altre informazioni sulle proprietà di questo tipo di dati, vedere Proprietà del tipo di dati Variabili.

Schermata delle proprietà di un elenco di informazioni sulla tabella PDF.

Per accedere al valore di una proprietà specifica usa la notazione %VariableName[ItemNumber].PropertyName%. Ad esempio, l'espressione seguente restituisce il valore datatable del primo elemento della variabile ExtractedPDFTables.

Screenshot della tabella dati contenuta in un elenco di variabili con informazioni sulle tabelle PDF.

Problemi noti e limitazioni

  • Problema: quando una cella datatable o datarow contiene una voce su più righe, il visualizzatore variabili visualizza solo la prima riga.
  • Soluzioni alternative: Nessuna.

Istanze

Connessioni

Altri tipi di dati

Questa sezione presenta tutti i tipi di dati disponibili che non appartengono a nessuna delle categorie precedenti.

Valore generale

  • Valore generale: usare questo tipo di dati durante la fase di progettazione quando Power Automate non è in grado di definire il tipo di dati di una variabile o di un parametro di input. I valori generali vengono convertiti in altri tipi di dati durante il runtime in base ai dati che contengono.

Active Directory

  • Voce di Active Directory: contiene una connessione a un server Active Directory stabilita tramite l'azione Connettiti al server.
  • Informazioni sul gruppo: contiene il nome, nome visualizzato, una descrizione e i membri di un gruppo di Active Directory specificato.
  • Membro del gruppo: rappresenta un membro di un gruppo Active Directory specificato.
  • Info utente: contiene informazioni su un utente di Active Directory specifico, come nome e cognome, iniziali e nome distinto, dettagli di lavoro (azienda, reparto e titolo), informazioni di contatto (numero di telefono, interno ed e-mail) e posizione (paese/area geografica, città, stato, indirizzo e codice postale).

Proprietà del tipo di dati di Active Directory

Amazon Web Services (AWS)

  • Client EC2: contiene una sessione EC2 creata tramite l'azione Crea sessione EC2.
  • Istanza EC2: rappresenta un'istanza EC2 recuperata.
  • Informazioni sulle istanze EC2: contiene informazioni su un'istanza EC2.
  • Modifica dello stato dell'istanza: contiene informazioni su un'istanza EC2 che è stata avviata o arrestata.
  • Snapshot EBS – Rappresenta uno snapshot EBS.
  • Volume EBS: rappresenta un volume EBS.

Proprietà del tipo di dati AWS

Azure

  • Client Azure: contiene una sessione Azure creata tramite l'azione Crea sessione.
  • Gruppo di risorse di Azure: rappresenta un gruppo di risorse di Azure recuperato.
  • Disco gestito di Azure: rappresenta un disco di Azure recuperato.
  • Snapshot di Azure – Rappresenta uno snapshot di Azure.
  • Macchina virtuale di Azure: rappresenta una macchina virtuale di Azure recuperata.
  • Informazioni sulla macchina virtuale di Azure: contiene informazioni su una macchina virtuale di Azure.
  • Sottoscrizione di Azure: rappresenta una sottoscrizione di Azure recuperata.

Proprietà del tipo di dati Azure

CMD

  • Sessione CMD: contiene una sessione CMD creata tramite l'azione Apri sessione CMD.

Proprietà del tipo di dati CMD

Credenziali

  • Credenziale – Contiene una credenziale recuperata tramite l'azione Ottieni credenziale.

Proprietà del tipo di dati credenziale

Date e ora

  • Datetime: contiene informazioni su data e ora. Per creare una variabile datetime tramite l'azione Imposta variabile , immettere il parametro di input con le espressioni %d"aaaa-MM-gg HH:mm:ss.ff+zzz"%, dove:

    Notazione Descrizione
    yyyy Anno
    MM Mese
    dd Giorno
    HH Ora
    mm Verbali
    ss Secondi
    ff Millisecondi
    zzz Offset UTC

    Ad esempio, %d"2022-03-25"% assegna la data del 25 marzo 2022 alla variabile di destinazione.

Proprietà del tipo di dati di data e ora

E-mail

  • Messaggio di posta elettronica – rappresenta un messaggio di posta elettronica. L'azione Recupera messaggi e-mail popola queste variabili.

Proprietà del tipo di dati e-mail

Exchange

  • Messaggio di posta di Exchange: rappresenta un messaggio di posta elettronica recuperato da un server Exchange. L'azione Recupera messaggi e-mail di Exchange popola queste variabili.

Proprietà del tipo di dati Exchange

File e cartelle

  • File: rappresenta un file.
  • Cartella: rappresenta una cartella.
  • FileSystemObject: rappresenta una cartella o un file. Questo tipo di dati viene utilizzato nei parametri di input che accettano cartelle e file.

Proprietà del tipo di dati di file e cartelle

FTP

  • File FTP: rappresenta un file FTP.
  • directory FTP – rappresenta una directory FTP.

Proprietà del tipo di dati FTP

OCR

  • Motore OCR - Contiene un motore OCR creato tramite l'azione Crea motore OCR.

Outlook

  • Messaggio di posta di Outlook: rappresenta un messaggio di posta elettronica di Outlook. L'azione Recupera messaggi e-mail da Outlook popola queste variabili.

Proprietà del tipo di dati Outlook

Valori sensibili

  • SensitiveValue – contiene un valore di testo contrassegnato come sensibile. Una variabile di ambiente segreta o la proprietà Password di una variabile di credenziali sono di tipo SensitiveValue.

Terminal

  • Sessione terminale: contiene una sessione terminale creata tramite l'azione Apri sessione terminale.

Proprietà del tipo di dati terminale

XML

  • Nodo XML: contiene il contenuto di un documento XML. L'azione Leggi XML da file popola queste variabili.

Proprietà del tipo di dati XML

Error

  • Errore: contiene informazioni sull'ultimo errore del flusso desktop. L'azione Ottieni l'ultimo errore crea questo tipo di variabile.

Proprietà dell'errore