Функция ParseJSON

Применимо к: Приложениям Canvas Приложениям на основе моделей Power Pages Power Platform CLI

Интерпретирует строку JSON и возвращает нетипизированный объект.

Description

Функция ParseJSON будет анализировать допустимую строку JSON и возвращать нетипизированный объект представляющий структуру JSON.

Функция ParseJSON может возвращать ошибки, если текст не является допустимым JSON в соответствии с форматом нотации объектов JavaScript (JSON), описанным в ECMA-404, а также IETF RFC 8259.

Синтаксис

ParseJSON( JSONString )

• JSONString – Обязательно. Структура JSON представлена в виде текста.

Преобразование типа данных нетипизированного объекта

ParseJSON возвращает нетипизированный объект, который требует явного преобразования значений полей в поддерживаемые типы данных. В следующей таблице перечислены типы данных в Power Apps, соответствующий тип данных JSON и способ его преобразования.

Примеры

Доступ к значениям полей

Учитывая следующую строку JSON в переменной с именем JsonString

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

1. Следующая формула возвращает текст text value:

   Text( ParseJSON( JsonString ).parent.child )
   

2. Следующая формула возвращает число 567:

   Value( ParseJSON( JsonString ).number )
   

Если имя поля состоит из недопустимого имени идентификатора, можно поместить имена полей в одинарные кавычки. Учитывая следующую строку JSON в переменной с именем JsonString

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

1. Следующая формула возвращает текст text value:

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

Пустые значения

Учитывая следующую строку JSON в переменной с именем JsonString

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

1. Попытка доступа к несуществующим полям возвращает Пустое значение(). Следующая формула возвращает значение true:

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

2. Значения JSON null считаются Пустыми. Следующая формула возвращает значение true:

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

Простые массивы

Учитывая следующую строку JSON в переменной с именем JsonString

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

1. Доступ ко второму числу в таблице нетипизированного объекта с одним столбцом в поле массива и преобразование в число с помощью Value() возвращает 2:

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

2. Преобразование таблицы нетипизированного объекта с одним столбцом в поле массива, в таблицу чисел с одним столбцом { Value: 1 }, { Value: 2 }, { Value: 3 }:

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

Массивы записей

Учитывая следующую строку JSON в переменной с именем JsonString

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

1. Преобразование в типизированную таблицу записей непосредственно с помощью функции ForAll() можно реализовать путем использования ThisRecord.[fieldname] для доступа к полям нетипизированного объекта и преобразования их в известные типы:

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

Массив в таблицу

1. Преобразование нетипизированного объекта в таблицу с помощью функции Table() позволяет получить одностолбцовую таблицу нетипизированных объектов. Затем к объекту необходимо осуществлять доступ с использованием (единственного) столбца Value и преобразовывать его в типы, как описано выше.

Учитывая следующую строку JSON в переменной с именем JsonString

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

Table() возвращает таблицу из одного столбца нетипизированных объектов с одним столбцом Value для числа в массиве...

 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() возвращает таблицу из одного столбца нетипизированных объектов , которая представляет каждый объект JSON в массиве.

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