Функция за JSON

Отнася се за: Приложения за платно Приложения, управлявани от модел Power Pages

Генерира JSON текстов низ за таблица, запис или стойност.

Описание

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

Приложенията за платно поддържат типове данни, които тази таблица съдържа списък с подробности за тяхното представяне на текст:

Посочете незадължителния аргумент формат за контрол на това, колко е четим резултатът и как се обработват неподдържани и бинарни типове данни. По подразбиране изходът е възможно най-компактен, без излишни интервали или нови редове, а неподдържаните типове данни и двоичните данни не са позволени. Можете да комбинирате няколко формата, ако посочите оператора & .

Използвайте ShowColumns and DropColumns функции за контрол на кои данни включва резултата и премахване на неподдържани типове данни.

Тъй като JSON може да бъде както памет, така и изчисляване, можете да използвате тази функция само в функции на поведение. Можете да уловите резултата от JSON в променлива, които след това можете да използвате в потока от данни.

Ако една колона има както име на дисплей, така и логическо име, резултатът съдържа логическото име. Показваните имена отразяват езика на потребителя на приложението и следователно са неподходящи за трансфер на данни към обща услуга.

Синтаксис

JSON( Структура на данни[, Формат ] )

• DataStructure – Задължително. Структурата на данните за конвертиране в JSON. Поддържат се таблици, записи и примитивни стойности, произволно вложени.
• Формат - По избор. JSONFormat стойност на изброяване. Стойността по подразбиране е JSONFormat.Compact, която не добавя нови редове или интервали и блокира двоични данни и неподдържани колони.

Примери

Йерархични данни

1. Вмъкнете контрола бутон и задайте свойството й 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 ) )
   

   Тази формула задава глобалната променлива CitiesByCountryJSON на репрезентацията на JSON за CitiesByCountry.

4. Изберете бутона, докато държите клавиша Alt.

5. Вмъкнете контрола Етикет и задайте свойството й Текст на тази променлива.

   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. Добавете контрола бутон и задайте свойството й OnSelect на тази формула.

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

3. Изберете бутона, докато държите клавиша Alt.

4. Добавете етикет и задайте свойството му Текст на тази променлива.

   ImageJSON
   

5. Преоразмерете контрола и намалете размера на шрифта според нуждите, за да покажете по-голямата част от резултата.

   Етикетът показва текстовия низ, който JSON функция улови.

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

Таблици със стойности

Тази формула:

JSON( [1,2,3] )

създава текстовия низ [{"Стойност":1},{"Стойност":2},{"Стойност":3}].

Същата формула с опцията JSONFormat.FlattenValueTables:

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

Създава текстовия низ [1,2,3].

Имайте предвид, че опцията FlattenValueTables няма влияние при използване на JSON с колекциите CityPopulations или CitiesByCountry , тъй като тези таблици не са таблици със стойности. Таблицата със стойности има една колона и трябва да бъде наречена "Стойност".