Freigeben über


ParseJSON-Funktion

Gilt für: Canvas-Apps Modellgesteuerte Apps Power Pages Power Platform CLI

Interpretiert eine JSON-Zeichenfolge und gibt ein nicht typisiertes Objekt zurück.

Beschreibung

Die ParseJSON-Funktion analysiert eine gültige JSON-Zeichenfolge und gibt ein nicht typisiertes Objekt zurück, das die JSON-Struktur darstellt.

Die ParseJSON-Funktion gibt möglicherweise Fehler zurück, wenn der Text kein gültiges JSON-Format gemäß dem in ECMA-404 und IETF-RFC 8259 beschriebenen JSON-Format (JavaScript Object Notation) ist.

Syntax

ParseJSON( JSONString )

  • JSONString – Erforderlich. Die als Text dargestellte JSON-Struktur.

Konvertieren des nicht typisierten Objektdatentyps

ParseJSON gibt ein nicht typisiertes Objekt zurück, was eine explizite Konvertierung von Feldwerten in unterstützte Datentypen erfordert. Die folgende Tabelle listet die Datentypen in Power Apps und einen entsprechenden JSON-Datentyp auf und wie man ihn konvertiert.

Datentyp JSON-Beispiele Beschreibung Beispielkonvertierung
Boolesch { "bool": true } Boolean ist ein expliziter Typ in JSON und kann direkt konvertiert werden. boolesch( ParseJSON("{ ""bool"": true }").bool )
Color { "color": "#102030" }
{ "r": 255, "g": 128, "b": 0, "a": 0.5 }
Es gibt keinen Farbtyp in JSON. Farbwerte können aus RGBA-Ganzzahlen oder hexadezimalen Zeichenfolgen erstellt werden. Farbwert(ParseJSON( "{ ""Farbe"": ""102030"" }" ).Farbe )
Mit ( { uo: ParseJSON ( "{ ""r"": 255, ""g"": 128, ""b"": 0, ""a"": 0,5 }" ) }, RGBA (Wert ( uo.r ), Wert ( uo.g ), Wert ( uo.b ), Wert ( uo.a ) ) )
Währung, Zahl { "numbervalue": 123.5 } Zahlen werden in JSON direkt mit einem Punkt ( .) als Dezimaltrennzeichen getrennt. Wert (ParseJSON("{ ""Zahlenwert"": 123,5 }").Zahlenwert)
Datum, DateTime und Uhrzeit { "start": "2022-05-10" }
{ "start": "23:12:49.000" }
JSON hat keinen Datums- oder Uhrzeittyp und kann daher Datums- und Uhrzeitangaben nur als Zeichenfolgen darstellen. Ein nicht typisiertes Objekt kann direkt von einer Zeichenfolge im ISO 8601-Format in ein Datum, eine Uhrzeit oder eine Datumszeit konvertiert werden. Konvertieren Sie für andere Formate zuerst das JSON-Feld mithilfe der Text()-Funktion in Text und verwenden Sie dann die Funktion DateValue(), TimeValue() oder DateTimeValue(), die standardmäßig die Sprache der aktuellen Benutzereinstellungen verwendet. Datumswert (ParseJSON("{ ""Termin"": ""2022-05-10"" }").Termin)
DateValue( Text( ParseJSON("{ ""Termin"": ""5. Mai 2022"" }").Termin ) )
GUID { "id": "123e4567-e89b-12d3-a456-426655440000" } JSON hat keinen Datentyp für GUIds, sodass sie nur als Zeichenfolgen dargestellt werden können. GUID( ParseJSON("{ ""id"": ""123e4567-e89b-12d3-a456-426655440000"" }").id )
HyperLink, Bild und Medien { "URI": "https://northwindtraders.com/logo.jpg" } Diese Datentypen sind Textdatentypen und können in Text konvertiert und dann in Power Apps verwendet werden. Text( ParseJSON("{ ""URI"": ""https://northwindtraders.com/logo.jpg"" }").URI )
Auswahl { "status": 1 }
{ "status": "Closed" }
Auswahlmöglichkeiten werden als lokalisierte Zeichenfolgen dargestellt, die von einer Zahl unterstützt werden. Die JSON()-Funktion serialisiert eine Auswahl zu ihrer unterstützenden Zahl. Es gibt keine direkte Umwandlung von Zahl oder Zeichenfolge in eine Auswahl, aber die Funktionen Switch() oder If() können auf den Text- oder Zahlenwert angewendet werden. Schalter(Wert(ParseJSON( "{ ""Status"": 1 }" ).status ), 0, Status.Offen, 1, Status.Geschlossen )
Datensatz { "field": "value" } Es gibt keine direkte Konvertierung von einem JSON-Objekt in eine Datensatzstruktur, aber einzelne Felder können aus dem nicht typisierten Objekt abgerufen werden, um einen Datensatz zu bilden. { Feld: Text(ParseJSON( "{ ""Feld"": ""Wert"" }" ).Feld ) }
Datensatzverweis Nicht zutreffend Datensatzverweise sind für Datenquellen eindeutig und können nicht serialisiert oder deserialisiert werden. Feldwerte, die eindeutige Schlüssel darstellen, könnten in JSON verwendet werden, um Datensätze zu identifizieren, die dann nachgeschlagen werden können. Nicht zutreffend
Table [ { "id": 1, "name": "one" }, { "id": 2, "name": "two" } ]
[1, 2, 3]
JSON kann Arrays enthalten, die in Tabellen umgewandelt werden können. Diese Werte können Arrays von Datensätzen oder Arrays von Werten sein, die effektiv einspaltige Tabellen sind. ParseJSON() Arrays können nur in eine einspaltige Tabelle mit untypisierten Objekten konvertiert werden und können als solche verwendet oder mit ForAll() in typisierte Datensatztabellen konvertiert werden. FürAlle(Tabelle(ParseJSON("[ { ""id"": 1, ""name"": ""eins"" }, { ""id"": 2, ""name"": ""zwei"" } ]")), { id: Wert(ThisRecord.Value.id), Name: Text(ThisRecord.Value.name) } )
Text { "stringField": "this is text" } Text ist ein expliziter Typ in JSON und kann direkt konvertiert werden. Text( ParseJSON( "{ ""stringField"": ""das ist Text"" }").stringField )
Zwei Optionen { "available": true }
{ "available": "Yes" }
Zwei Optionen werden als lokalisierte Zeichenfolgen dargestellt, die von einem Boolean unterstützt werden. Die JSON()-Funktion serialisiert zwei Optionen zu ihrem booleschen Wert. Es gibt keine direkte Umwandlung von Boolean, Zahl oder Zeichenfolge in zwei Optionen, aber die Funktionen Switch() oder If() können auf den Text-, Zahlen- oder booleschen Wert angewendet werden. Schalter( boolesch( ParseJSON( "{ ""verfügbar"": true }" ).verfügbar ), falsch, Availability.No, wahr, Verfügbarkeit.Ja )

Beispiele

Zugreifen auf Feldwerte

Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

{ "parent": { "child": "text value" }, "number": 567 }
  1. Die folgende Formel gibt den Text text value zurück:
    Text( ParseJSON( JsonString ).parent.child )
    
  2. Die folgende Formel gibt die Zahl 567 zurück:
    Value( ParseJSON( JsonString ).number )
    

Falls ein Feldname aus einem ungültigen Bezeichnernamen besteht, können Sie die Feldnamen in einfache Anführungszeichen setzen. Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

{ "0": { "child-field": "text value" } }
  1. Die folgende Formel gibt den Text text value zurück:
    Text( ParseJSON( JsonString ).'0'.'child-field' )
    

Leerstellen

Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

{ "text": "text value" , "number": 567, "empty": null }
  1. Der Versuch, auf nicht vorhandene Felder zuzugreifen, gibt Blank() zurück. Die folgende Formel gibt true zurück:
    IsBlank( Text( ParseJSON( JsonString ).parent.child ) )
    
  2. JSON-null-Werte werden betrachtet als Blank(). Die folgende Formel gibt true zurück:
    IsBlank( Text( ParseJSON( JsonString ).empty ) )
    

Einfache Arrays

Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

{ "array": [1, 2, 3] }
  1. Der Zugriff auf die zweite Zahl in der einspaltigen Tabelle des nicht typisierten Objekts des Array-Felds und die Umwandlung in eine Zahl mit Value() gibt 2 zurück:
    Value( Index( ParseJSON( JsonString ).array, 2 ) )
    
  2. Das Konvertieren der einspaltigen Tabelle des nicht typisierten Objekts im Array-Feld in eine einspaltige Zahlentabelle { Value: 1 }, { Value: 2 }, { Value: 3 }:
    ForAll( ParseJSON( JsonString ).array, Value( ThisRecord ) )
    

Arrays von Datensätzen

Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

{ "array": [
    { "id": 1, "name": "One"},
    { "id": 2, "name": "Two"}
    ] }
  1. Konvertieren in eine typisierte Tabelle von Datensätzen direkt mit ForAll() kann durch die Verwendung von ThisRecord.[fieldname] erfolgen, um auf die Felder untypisiertes Objekt zuzugreifen und sie in bekannte Typen zu konvertieren:

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

Array für Tabelle

  1. Konvertieren von nicht typisiertem Objekt zu einer Tabelle, indem Sie die Ergebnisse der Tabelle() in eine einspaltige Tabelle von nicht typisierten Objekten verwenden. Auf das Objekt muss dann mit der Spalte Value (einzelne) Spalte zugegriffen und wie zuvor erläutert in Typen konvertiert werden.

Die folgende JSON-Zeichenfolge in einer Variablen mit dem Namen JsonString vorausgesetzt

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

Table() gibt eine einspaltige Tabelle mit nicht typisierten Objekten mit einem einspaltigen Wert für die Zahl im Array zurück...

 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"}
 ] }

Table() gibt eine einspaltige Tabelle mit untypisierten Objekten zurück, die jedes JSON-Objekt im Array darstellt.

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