ColumnNames i Column funkcje

Dotyczy: Aplikacje kanwy Copilot Studio Aplikacje oparte na modelu Funkcje interfejsu wiersza polecenia platformy Power Platform Dataverse

Pobiera nazwy kolumn i wartości z wartości dynamicznej.

Podpis

Funkcja ColumnNames zwraca nazwy wszystkich kolumn z rekordu dynamicznego, zwracając tabelę ze wszystkimi nazwami z tego rekordu.

Funkcja Column zwraca wartość właściwości z rekordu dynamicznego o podanej nazwie kolumny. Wartość jest zwracana jako wartość dynamiczna.

Funkcje ColumnNames i Column zwracają błędy, jeśli wartość dynamiczna nie reprezentuje rekordu (czyli jeśli reprezentuje tabelę lub wartość skalarną lub pierwotną).

Składnia

ColumnNames( DynamicRecord )

• DynamicRecord — wymagane. Wartość dynamiczna reprezentująca rekord.

Column( DynamicRecord, ColumnName )

• DynamicRecord — wymagane. Wartość dynamiczna reprezentująca rekord.
• ColumnName - Wymagane. Nazwa kolumny, która ma zostać pobrana z danego rekordu.

Przykłady

Dostęp do wartości pól

Na względu na następujący ciąg JSON w zmiennej o nazwie JsonString

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

1. Następująca formuła zwraca tabelę z jedną kolumną, której kolumna Value zawiera następujące wartości: "name", "population":

   ColumnNames( ParseJSON( JsonString ) )
   

2. Poniższa formuła zwraca numer 737000:

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

   • Zwróć uwagę, że ta formuła jest podobna do . operatora rekordów dynamicznych, ale nazwa kolumny nie musi być wcześniej znana.

3. Następująca formuła zwraca wartość tekstową "name: Seattle, population: 737000":

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

Wartości puste

Na względu na następujący ciąg JSON w zmiennej o nazwie JsonString

{ "text": "text value" , "number": 567, "empty": null }

1. Próba uzyskania dostępu do żadnego pola nie zwraca wartości Puste(). Następująca formuła zwraca wartość true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. Wartości JSON null są uważane za Blank(). Następująca formuła zwraca wartość true:

   IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
   

Elementy niereprezentujące rekordów

Column Wywoływanie funkcji or ColumnNames z wartościami dynamicznymi, które nie reprezentują rekordów, zwraca błąd. Wszystkie te wyrażenia na poniższej liście są błędne: