Converte texto ou arquivo que contenha uma estrutura em formado de lista JSON para uma lista.
![](/download/attachments/234670080/blocoJsonParaLista.png?version=1&modificationDate=1682618709000&api=v2)
Figura 1 - Bloco JSON para lista
Compatibilidade
- Bloco servidor: cronapi.json.Operations.toList()
Retorno
Retorna uma lista.
Parâmetros
Valor a ser lido
Texto ou arquivo (retorno do bloco Abrir arquivo para leitura) a ser convertido para uma lista.
Exemplo
Na função abaixo, a variável "item" recebe uma string contendo uma lista em formato de texto com duas sublistas. O primeiro bloco de repetição para cada item na lista percorre a variável "item" e imprime no console do depurador o resultado obtido. No segundo bloco de repetição, inserimos o bloco JSON para lista, que converte a variável "item" para um objeto lista e em seguida imprime no console do depurador cada item obtido. Na Figura 2.1 vemos a diferença dos resultados obtidos.
![](/download/attachments/234670080/blocoJsonParaListaExemplo.png?version=1&modificationDate=1682692202000&api=v2)
Figura 2 - Exemplo de uso do bloco JSON para lista
Na figura a seguir, os valores acima da linha tracejada correspondem ao resultado obtido pelo primeiro bloco de repetição da função da Figura 2. Neste caso, o bloco não identificou a variável "item" como um objeto lista e, por isso, não foi possível obter como resultado as sublistas que a compõem. Já no segundo resultado, abaixo da linha tracejada, foi utilizado o bloco JSON para lista. Este bloco converte uma string em lista, permitindo que as sublistas sejam acessadas e iteradas corretamente pelo bloco de repetição. Dessa forma, conseguimos obter como resultado as duas sublistas da lista principal.
![](/download/attachments/234670080/blocoJsonParaListaResultado.png?version=1&modificationDate=1682692210000&api=v2)
Figura 2.1 - Resultado exibido a partir das configurações da Figura 2