JSON Função

Aplica-se a: Aplicativos do Canvas Aplicativos orientados por modelo do Copilot Studio Funções do Power Platform CLI Dataverse Power Pages

Gera uma JSON cadeia de caracteres de texto para uma tabela, um registro ou um valor.

Descrição

A JSON função retorna a representação JavaScript Object Notation (JSON) de uma estrutura de dados como texto para que seja adequada para armazenar ou transmitir através de uma rede. [ECMA-404](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf e IETF RFC 8259 descrevem o formato, que é amplamente utilizado por JavaScript e outras linguagens de programação.

As aplicações de tela suportam os tipos de dados que esta tabela lista com os detalhes sobre a respetiva representação de texto:

Especifique o argumento opcional Formato para controlar a legibilidade do resultado e como são tratados os tipos de dados não suportados e binários. Por predefinição, a saída é o mais compacta possível sem novas linhas ou espaços desnecessários, e não são permitidos dados binários e tipos de dados não suportados. Pode combinar vários formatos se especificar o operador &.

Utilize as funções ShowColumns e DropColumns para controlar que dados o resultado inclui e para remover tipos de dados não suportados.

Como JSON pode ser intensivo em memória e computação, você pode usar essa função somente em funções de comportamento. Você pode capturar o resultado de uma variável, que pode ser usada no fluxo de JSON dados.

Se uma coluna tiver um nome a apresentar e um nome lógico, o resultado contém o nome lógico. Os nomes a apresentar refletem a linguagem do utilizador da aplicação e, consequentemente, são inadequados para a transferência de dados para um serviço comum.

Sintaxe

JSON( DataStructure [, Formato ] )

• DataStructure – Obrigatório. A estrutura de dados a ser convertida em JSON. São suportados registos, tabelas e valores primitivos, encadeados arbitrariamente.
• Formato - Opcional. JSONFormat enumeração valor. O valor predefinido é JSONFormat.Compact, que não adiciona novas linhas ou espaços e bloqueia os dados binários e as colunas não suportadas.

Exemplos

Dados hierárquicos

1. Insira um controlo Button e defina a respetiva propriedade OnSelect para esta fórmula.

   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. Selecione o botão enquanto mantém premida a tecla Alt.

   A coleção CitiesByCountry é criada com esta estrutura de dados, que pode mostrar ao selecionar Coleções no menu Ficheiro e, em seguida, selecionar o nome da coleção.

   

   Também pode mostrar esta coleção selecionando Definições>Funcionalidades futuras>Ativar vista do resultado da barra de fórmulas, selecionando o nome da coleção na barra de fórmulas e, em seguida, selecionando a seta para baixo junto do nome da coleção sob a barra de fórmulas.

   

3. Insira outro botão e defina a respetiva propriedade OnSelect para esta fórmula:

   Set( CitiesByCountryJSON, JSON( CitiesByCountry ) )
   

   Esta fórmula define a variável global CitiesByCountryJSON como a JSON representação de CitiesByCountry.

4. Selecione o botão enquanto mantém premida a tecla Alt.

5. Insira um controlo Label e defina a respetiva propriedade Text para esta variável:

   CitiesByCountryJSON
   

   A etiqueta mostra este resultado, tudo isto numa única linha sem espaços, adequada para transmissão através de uma rede:

   [
     {
       "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. Altere a fórmula do segundo botão para tornar a saída mais legível.

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

7. Selecione o segundo botão enquanto mantém premida a tecla Alt.

   A etiqueta mostra o resultado mais legível.

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

Imagens e multimédia base64

1. Adicionar um controlo de Image.

   Este controlo traz SampleImage consigo.

2. Adicione um controlo Button e defina a respetiva propriedade OnSelect para esta fórmula.

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

3. Selecione o botão enquanto mantém premida a tecla Alt.

4. Adicione uma etiqueta e defina a respetiva propriedade Text para esta variável.

   ImageJSON
   

5. Redimensione o controlo e reduza o tamanho do tipo de letra conforme for necessário para mostrar a maior parte do resultado.

   O rótulo mostra a cadeia de caracteres de texto que a JSON função capturou.

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

Tabelas Valor

Esta fórmula:

JSON( [1,2,3] )

produz a cadeia de texto [{"Value":1},{"Value":2},{"Value":3}].

A mesma fórmula com a opção JSONFormat.FlattenValueTables:

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

produz a cadeia de texto [1,2,3].

Observe que a opção FlattenValueTables não tem impacto ao usar JSON com as coleções CityPopulations ou CitiesByCountry, pois essas tabelas não são tabelas de valor. Uma tabela Valor tem uma única coluna e tem de ter o nome "Valor".