Condividi tramite

ColumnNamesfunzioni e Column

Si applica a: App Canvas- App basate su modello di Copilot Studio Funzioni di Dataverse dell'interfaccia della riga di comando di Power Platform

Recupera i nomi e i valori delle colonne da un valore dinamico.

Descrzione

La ColumnNames funzione restituisce i nomi di tutte le colonne di un record dinamico, restituendo una tabella con tutti i nomi di tale record.

La Column funzione restituisce il valore di una proprietà da un record dinamico con il nome di colonna specificato. Il valore viene restituito come valore dinamico.

Le ColumnNames funzioni e Column restituiscono errori se il valore dinamico non rappresenta un record , ovvero se rappresenta una tabella o un valore scalare o primitivo.

Sintassi

ColumnNames( DynamicRecord )

Column( DynamicRecord, ColumnName )

  • DynamicRecord : obbligatorio. Valore dinamico 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" ) )
    • Si noti che questa formula è simile all'operatore . per i record dinamici, ma il nome della colonna non deve essere 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 alle Column funzioni o ColumnNames con valori dinamici che non rappresentano record restituiscono un errore. Tutte queste espressioni nell'elenco seguente sono errate:

Formula Motivo dell'errore
ColumnNames( ParseJSON ( "[1, 2, 3]" ) ) Il valore dinamico rappresenta una matrice
Column( ParseJSON ( "23.45" ), "Value" ) Il valore dinamico rappresenta un numero
ColumnNames( ParseJSON ( """hello""" ) ) Il valore dinamico rappresenta un testo
Column( ParseJSON ( "{""a":false}" ).a, "a" ) Il valore dinamico rappresenta un valore booleano
  • Last updated on