JSON функция

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

Создает текстовую JSON строку для таблицы, записи или значения.

Описание

Функция JSON возвращает нотацию объектов JavaScript (JSON) представление структуры данных в виде текста, чтобы она была подходит для хранения или передачи по сети. [ECMA-404](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf и IETF RFC 8259 описывают формат, который широко используется в JavaScript и других языках программирования.

Приложения на основе холста поддерживают типы данных, что в этой таблице перечислены со сведениями об их текстовом представлении:

Укажите необязательный аргумент Format, управляющий тем, насколько читаемым является результат и как обрабатываются неподдерживаемые и двоичные типы данных. По умолчанию выходные данные настолько компактны, насколько это возможно, без лишних пробелов или новых строк, а неподдерживаемые типы данных и двоичные данные не допускаются. Вы можете объединить несколько форматов, если укажите оператор &.

Используйте функции ShowColumns и DropColumns для управления тем, какие данные включает в себя результат, и для удаления неподдерживаемых типов данных.

Так как JSON это может быть объем памяти и вычислительных ресурсов, эту функцию можно использовать только в функциях поведения. Результат можно записать в JSONпеременную, которую затем можно использовать в потоке данных.

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

Синтаксис

JSON( DataStructure [, Format ] )

• DataStructure – Обязательно. Структура данных для преобразования JSONв . Таблицы, записи и примитивные значения поддерживаются с произвольным уровнем вложения.
• Формат - Необязательно. Значение JSONFormat перечисление. Значением по умолчанию является JSONFormat.Compact, который не добавляет новые строки или пробелы и блокирует двоичные данные и неподдерживаемые столбцы.

Примеры

Иерархические данные

1. Вставьте элемент управления Button и задайте следующую формулу в качестве значения свойства OnSelect:

   ClearCollect( CityPopulations,
       { City: "London",    Country: "United Kingdom", Population: 8615000 },
       { City: "Berlin",    Country: "Germany",        Population: 3562000 },
       { City: "Madrid",    Country: "Spain",          Population: 3165000 },
       { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
       { City: "Barcelona", Country: "Spain",          Population: 1602000 },
       { City: "Munich",    Country: "Germany",        Population: 1494000 }
   );
   ClearCollect( CitiesByCountry, GroupBy( CityPopulations, "Country", "Cities" ) )
   

2. Удерживая нажатой клавишу ALT, выберите эту кнопку.

   Коллекция CitiesByCountry создается с этой структурой данных, которую вы можете показать, выбрав пункт Коллекции в меню Файл, затем выбрав название коллекции.

   

   Вы также можете показать эту коллекцию, выбрав Настройки>Предстоящие функции>Включить просмотр результатов строки формул, выбрав имя коллекции в строке формул, а затем щелкнув стрелку вниз рядом с именем коллекции под строкой формул.

   

3. Вставьте другую кнопку и задайте следующую формулу в качестве значения свойства OnSelect:

   Set( CitiesByCountryJSON, JSON( CitiesByCountry ) )
   

   Эта формула задает глобальной переменной CitiesByCountryJSONJSON представление для CitiesByCountryCountry.

4. Удерживая нажатой клавишу ALT, выберите эту кнопку.

5. Вставьте элемент управления Label и задайте в качестве значения свойства Text следующую эту переменную.

   CitiesByCountryJSON
   

   Метка показывает этот результат, все в одной строке без пробелов, подходящих для передачи по сети:

   [
     {
       "Cities": [{ "City": "London", "Population": 8615000 }],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         { "City": "Berlin", "Population": 3562000 },
         { "City": "Hamburg", "Population": 1760000 },
         { "City": "Munich", "Population": 1494000 }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         { "City": "Madrid", "Population": 3165000 },
         { "City": "Barcelona", "Population": 1602000 }
       ],
       "Country": "Spain"
     }
   ]
   

6. Измените формулу второй кнопки, чтобы сделать вывод более читабельным.

   Set( CitiesByCountryJSON, JSON(CitiesByCountry, JSONFormat.IndentFour ))
   

7. Выберите вторую кнопку, удерживая нажатой клавишу ALT.

   Метка показывает более читаемый результат.

   [
     {
       "Cities": [
         {
           "City": "London",
           "Population": 8615000
         }
       ],
       "Country": "United Kingdom"
     },
     {
       "Cities": [
         {
           "City": "Berlin",
           "Population": 3562000
         },
         {
           "City": "Hamburg",
           "Population": 1760000
         },
         {
           "City": "Munich",
           "Population": 1494000
         }
       ],
       "Country": "Germany"
     },
     {
       "Cities": [
         {
           "City": "Madrid",
           "Population": 3165000
         },
         {
           "City": "Barcelona",
           "Population": 1602000
         }
       ],
       "Country": "Spain"
     }
   ]
   

Изображения и мультимедиа в base64

1. Добавьте элемент управления Image.

   Этот элемент управления приносит SampleImage с ним.

2. Добавьте элемент управления Button и задайте следующую формулу в качестве значения свойства OnSelect.

   Set( ImageJSON, JSON( SampleImage, JSONFormat.IncludeBinaryData ) )
   

3. Удерживая нажатой клавишу ALT, выберите эту кнопку.

4. Добавьте метку и установите в ее свойстве Text эту переменную.

   ImageJSON
   

5. Измените размер элемента управления и уменьшите размер шрифта по мере необходимости, чтобы показать большую часть результата.

   Метка показывает текстовую строку, записанную JSON функцией.

   "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmVyc2lvbj0iMS4xIg0KCSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4bWxuczphPSJodHRwOi8vbnMuYWRvYmUuY29tL0Fkb2JlU1ZHVmlld2VyRXh0ZW5zaW9ucy8zLjAvIg0KCSB4PSIwcHgiIHk9IjBweCIgd2lkdGg9IjI3MHB4IiBoZWlnaHQ9IjI3MHB4IiBlbmFibGUtYmFja2dyb3VuZD0ibmV3IDAgMCAyNzAgMjcwIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBjbGFzcz0ic3QwIj4NCgkJPHJlY3QgeT0iMC43IiBmaWxsPSIjRTlFOUU5IiB3aWR0aD0iMjY5IiBoZWlnaHQ9IjI2OS4zIi8+DQoJCTxwb2x5Z29uIGZpbGw9IiNDQkNCQ0EiIHBvaW50cz0iMjc3LjksMTg3LjEgMjQ1LDE0My40IDE4OC42LDIwMi44IDc1LDgwLjUgLTQuMSwxNjUuMyAtNC4xLDI3MiAyNzcuOSwyNzIiLz4NCgkJPGVsbGlwc2UgZmlsbD0iI0NCQ0JDQSIgY3g9IjIwMi40IiBjeT0iODQuMSIgcng9IjI0LjQiIHJ5PSIyNC4zIi8+DQoJPC9nPg0KPC9zdmc+"
   

Таблицы значений

Эта формула:

JSON( [1,2,3] )

создает текстовую строку [{"Value":1},{"Value":2},{"Value":3}].

Та же формула с параметром JSONFormat.FlattenValueTables:

JSON( [1,2,3], JSONFormat.FlattenValueTables )

создает текстовую строку [1,2,3].

Обратите внимание, что параметр FlattenValueTables не влияет на использование JSON с коллекциями CityPopulations или CitiesByCountry , так как эти таблицы не являются таблицами value. Таблица значений имеет один столбец, и он должен называться "Значение".