ParseJSON функция

Применимо к: Приложения На основе холста Приложения Copilot Studio, управляемые моделью приложения Power Platform CLI Dataverse, функции Power Pages

Интерпретирует строку JSON и возвращает динамическое значение или определенное типизированное значение, если указан тип.

Description

Функция ParseJSON анализирует допустимую строку JSON и возвращает динамическое значение, представляющее структуру JSON.

При необходимости используйте второй аргумент для преобразования JSON в типизированный объект, который можно напрямую использовать в формулах Power Fx. Это упрощает восприятие результата, так как больше не требуются преобразования и принуждения в точке использования. Нетипизированный JSON сопоставляется с типом с помощью следующих правил:

• Столбцы в типе, отсутствующие в JSON, заполняются пустым значением.
• Столбцы в JSON, отсутствующие в типе, игнорируются.
• Для столбцов, которые находятся как в типе, так и в JSON, значение JSON должно быть приведено к типу.

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

Синтаксис

ParseJSON( JSONString [ , Type ] )

• JSONString – обязательно. Структура JSON представлена в виде текста.
• Type — необязательный параметр. Определение типа Power Fx для структуры JSON. Без этого аргумента ParseJSON возвращает динамическое значение. При этом функция возвращает определенное типизированное значение.

Преобразование динамических значений

Без второго аргумента возвращает динамическое значение, 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. Доступ ко второму числу в таблице одного столбца массива динамических значений и преобразованию в число, используя значение() возвращает 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() возвращает таблицу динамических значений с одним столбцом для числа в массиве...

 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 )