Funkcja ParseJSON

Dotyczy: Aplikacje kanwy Copilot Studio Oparte na modelu aplikacje interfejsu wiersza polecenia platformy Power Platform Funkcje usługi PowerVerse w usłudze Power Pages

Interpretuje ciąg JSON i zwraca wartość dynamiczną lub określoną wartość typową, jeśli podano typ.

Podpis

Funkcja ParseJSON analizuje prawidłowy ciąg JSON i zwraca wartość dynamiczną reprezentującą strukturę JSON.

Opcjonalnie można użyć drugiego argumentu, aby przekonwertować JSON na typowany obiekt, który może być bezpośrednio użyty w formułach Power Fx. To sprawia, że wynik jest łatwiejszy do przyswojenia, ponieważ konwersje i wymuszenia w miejscu użycia nie są już wymagane. Kod JSON bez typu jest mapowany na typ z następującymi regułami:

• Kolumny w typie, które nie są obecne w kodzie JSON, są wypełniane pustymi polami.
• Kolumny w kodzie JSON, które nie są obecne w typie, są ignorowane.
• W kolumnach, które znajdują się zarówno w typie, jak i w formacie JSON, wartość JSON musi być możliwa do przekształcenia na typ.

Funkcja ParseJSON może zwracać błędy, jeśli tekst nie jest prawidłowy w formacie JSON zgodnie z formatem JavaScript Object Notation (JSON) opisanym w ecMA-404 i IETF RFC 8259.

Składnia

ParseJSON( JSONString [ , Type ] )

• JSONString – wymagane. Struktura JSON reprezentowana przez tekst.
• Typ - Opcjonalny. Definicja typu Power Fx dla struktury JSON. Bez tego argumentu ParseJSON zwraca wartość dynamiczną, a funkcja zwraca określoną wartość typową.

Konwertowanie wartości dynamicznych

Bez drugiego argumentu zwraca wartość dynamiczną, ParseJSON która wymaga jawnej konwersji wartości pól w obsługiwanych typach danych. W poniższej tabeli wymieniono typy danych w usłudze Power Apps i odpowiadający im typ danych JSON oraz sposób ich konwersji.

Przykłady

Dostęp do wartości pól

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

{ "parent": { "child": "text value" }, "number": 567 }

1. Poniższa formuła zwraca tekst text value:

   Text( ParseJSON( JsonString ).parent.child )
   

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

   Value( ParseJSON( JsonString ).number )
   

Jeśli nazwa pola składa się z nieprawidłowej nazwy identyfikatora, nazwy pól można umieścić w pojedynczych cudzysłowach. Na względu na następujący ciąg JSON w zmiennej o nazwie JsonString

{ "0": { "child-field": "text value" } }

1. Poniższa formuła zwraca tekst text value:

   Text( ParseJSON( JsonString ).'0'.'child-field' )
   

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 pól innych niż istniejące zwraca wartość Blank(). Następująca formuła zwraca wartość true:

   IsBlank( Text( ParseJSON( JsonString ).parent.child ) )
   

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

   IsBlank( Text( ParseJSON( JsonString ).empty ) )
   

Proste tablice

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

{ "array": [1, 2, 3] }

1. Uzyskiwanie dostępu do drugiej liczby w jednokolumnach tabeli pól tablicy wartości dynamicznych i konwertowanie na liczbę przy użyciu funkcji Value() zwraca wartość 2:

   Value( Index( ParseJSON( JsonString ).array, 2 ) )
   

2. Konwertowanie jednokolumna tabeli wartości dynamicznych w polu tablicy na jedną kolumnę tabeli liczb { Value: 1 }, { Value: 2 }, { Value: 3 }:

   ForAll( ParseJSON( JsonString ).array, Value( ThisRecord ) )
   

Rekordy tablic

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

{ "array": [
    { "id": 1, "name": "One"},
    { "id": 2, "name": "Two"}
    ] }

1. Konwertowanie na typową tabelę rekordów bezpośrednio za pomocą funkcji ForAll() można wykonać za pomocą metody ThisRecord.[fieldname] w celu uzyskania dostępu do pól dynamicznych i przekonwertowania ich na określone typy:

   ForAll( ParseJSON( JsonString ).array, { id: Value(ThisRecord.id), name: Text(ThisRecord.name) })
   

Tablica do tabeli

1. Konwertowanie wartości dynamicznych na tabelę przy użyciu funkcji Table() powoduje utworzenie jednokolumny tabeli wartości dynamicznych . Następnie dostęp do obiektu należy uzyskać, korzystając z kolumny Value (pojedynczej) i przekonwertować na typy, jak uprzednio o wyjaśniono.

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

{ "array": [1, 2, 3] }

Funkcja Table() zwraca jednokolumniową tabelę wartości dynamicznych z wartością jednokolumną dla liczby w tablicy...

 Set(untypedTable, Table( ParseJSON( JsonString ).array ));
 
 Value( Index(untypedTable, 1).Value.Value )
 ```

Given the following JSON string in a variable named `JsonString`
```JSON
{ "array": [
 { "id": 1, "name": "One"},
 { "id": 2, "name": "Two"}
 ] }

Funkcja Table() zwraca jednokolumny tabelę wartości dynamicznych reprezentujących każdy obiekt json w tablicy.

  Set(untypedTable, Table( ParseJSON( JsonString ).array ) );
  
  Text( Index(untypedTable, 1).Value.name )