ColumnNames și Column funcții

Se aplică la: Aplicații pânză Copilot Studio Aplicații bazate pe modele Power Platform CLI Dataverse

Regăsește numele coloanelor și valorile dintr-o valoare dinamică.

Descriere

Funcția ColumnNames returnează numele tuturor coloanelor dintr-o înregistrare dinamică, returnând un tabel cu toate numele din acea înregistrare.

Funcția Column returnează valoarea unei proprietăți dintr-o înregistrare dinamică cu numele de coloană dat. Valoarea este returnată ca valoare dinamică.

Funcțiile ColumnNames și Column returnează erori dacă valoarea dinamică nu reprezintă o înregistrare (adică, dacă reprezintă un tabel sau o valoare scalară sau primitivă).

Sintaxă

ColumnNames( Înregistrare dinamică )

Column( DynamicRecord, ColumnName )

  • DynamicRecord - obligatoriu. O valoare dinamică care reprezintă o înregistrare.
  • ColumnName - Obligatoriu. Numele coloanei care urmează să fie preluată din înregistrarea dată.

Exemple

Accesarea valorilor câmpurilor

Având în vedere următorul șir JSON într-o variabilă numită JsonString

{ "name": "Seattle", "population": 737000 }

  1. Următoarea formulă returnează un tabel cu o singură coloană cu o coloană Value conținând următoarele valori: „nume”, „populație”:

    ColumnNames( ParseJSON( JsonString ) )

  2. Următoarea formulă returnează numărul 737000:

    Value( Column( ParseJSON( JsonString ), "population" ) )
    • Observați că această formulă este similară . cu operatorul pentru înregistrări dinamice, dar numele coloanei nu trebuie cunoscut în prealabil.

  3. Următoarea formulă returnează valoarea textului "name: Seattle, population: 737000":

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

Blanks

Având în vedere următorul șir JSON într-o variabilă numită JsonString

{ "text": "text value" , "number": 567, "empty": null }
  1. Încercarea de a accesa câmpuri inexistente returnează Blank(). Următoarea formulă returnează true: 
    IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
  2. Valorile JSON null sunt considerate Blank(). Următoarea formulă returnează true: 
    IsBlank( Column( ParseJSON( JsonString ), "empty" ) )

Non-înregistrări

Apelarea funcțiilor Column sau ColumnNames cu valori dinamice care nu reprezintă înregistrări returnează o eroare. Toate aceste expresii din următoarea listă sunt eronate:

Formula Motivul erorii
ColumnNames( ParseJSON ( "[1, 2, 3]" ) Valoarea dinamică reprezintă o matrice
Column( ParseJSON ( "23,45" ), "Valoare" ) Valoarea dinamică reprezintă un număr
ColumnNames( ParseJSON ( ""salut"" ) ) Valoarea dinamică reprezintă un text
Column( ParseJSON ( "{""a"":false}" ).a, "a" ) Valoarea dinamică reprezintă o valoare booleană
  • Last updated on