Condividi tramite


Funzioni ColumnNames e Column

Si applica a: App Canvas App basate su modello Power Platform CLI

Recupera nomi e valori della colonna da un oggetto non tipizzato.

Descrzione

La funzione ColumnNames restituisce i nomi di tutte le colonne da un record non tipizzato, restituendo una tabella con tutti i nomi di quel record.

La funzione Colonna restituisce il valore di una proprietà da un record non tipizzato con il nome della colonna specificato. Il valore viene restituito come un oggetto non tipizzato.

Le funzioni ColumnNames e Column restituiscono errori se l'oggetto non tipizzato non rappresenta un record (ovvero se rappresenta una tabella o un valore scalare o primitivo).

Sintassi

Nomicolonna( Record non tipizzato )

Colonna( Record non tipizzato, NomeColonna )

  • UntypedRecord – Obbligatorio. Un oggetto non tipizzato che rappresenta un record.
  • ColumnName - Obbligatorio. Il nome della colonna da recuperare dal record specificato.

Esempi

Accesso ai valori dei campi

Data la seguente stringa JSON in una variabile denominata JsonString

{ "name": "Seattle", "population": 737000 }
  1. La formula seguente restituisce una tabella a colonna singola con una colonna Value contenete i seguenti valori: "nome", "popolazione":

    ColumnNames( ParseJSON( JsonString ) )
    
  2. La formula seguente restituisce il numero 737000:

    Value( Column( ParseJSON( JsonString ), "population" ) )
    

    2.1. Da notare che questo è simile all'operatore . per record non tipizzati, ma non è necessario che il nome della colonna sia noto in anticipo.

  3. La formula seguente restituisce il valore di testo "name: Seattle, population: 737000":

    With(
        { untyped: ParseJSON( JsonString ) },
        Concat(
            ColumnNames( untyped ),
            $"{Value}: {Column( untyped, Value )}",
            ", "))
    

Valori vuoti

Data la seguente stringa JSON in una variabile denominata JsonString

{ "text": "text value" , "number": 567, "empty": null }
  1. Nel tentare di accedere a campi inesistenti, viene restituito Blank(). La formula seguente restituisce true:
    IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
    
  2. I valori JSON null vengono considerati Blank(). La formula seguente restituisce true:
    IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
    

Nonrecords

La chiamata delle funzioni Column o ColumnNames con oggetti non tipizzati che non rappresentano record restituisce un errore. Tutte le espressioni seguenti sono errate:

Formula Motivo dell'errore
NomiColonne( ParseJSON( "[1, 2, 3]" ) ) Oggetto non tipizzato che rappresenta una matrice
Colonna( ParseJSON( "23.45" ), "Valore" ) Oggetto non tipizzato che rappresenta un numero
ColumnNames( ParseJSON ( """ciao""" ) ) Oggetto non tipizzato che rappresenta un testo
Colonna( ParseJSON ( "{""a"":false}" ).a, "a" ) Oggetto non tipizzato che rappresenta un valore booleano