package JSON

O package JSON permite que você extraia e analise informações de fontes de dados JSON. Ele permite manipular os dados JSON, como adicionar ou atualizar valores em uma string JSON, analisar strings JSON em objetos usando o caminho do nó e converter strings JSON em dicionários e vice-versa.

O package JSON desempenha um papel fundamental na integração transparente de fluxos de automação com serviços da Web e APIs que utilizam JSON para troca de dados.

Benefícios

  • JSON (JavaScript Object Notation) é um formato extensível, leve e fácil de entender para armazenar, transportar e recuperar dados. JSON usa pares de dados de valores-chave e oferece intercâmbio de dados e resultados de serviços da web mais rápidos.
  • A maioria dos Serviços Web REST (APIs), alguns arquivos de configuração e muitos bancos de dados NoSQL, como o MongoDB, geralmente usam JSON devido ao seu formato flexível para troca de dados. É baseado em texto, leve e possui um formato de dados fácil de analisar, o que significa que não requer código adicional para compreender e interpretar os dados fornecidos.
  • Os arquivos JSON podem ser ótimos para armazenar e recuperar dados de configuração que sua automação pode fazer referência ao determinar detalhes de servidor, específicos do ambiente ou de compartilhamento de pasta.
  • A estrutura flexível do JSON acomoda com eficiência vários tipos de dados e hierarquias de dados complexas.

Tipos de dados JSON

Os valores em JSON devem ser do seguinte tipo de dados:
  • Strings
  • Números
  • Objeto (objeto JSON)
  • Matriz
  • Boolianos
Nota: O valor NULL não é compatível no Automation 360. Portanto, ao extrair dados do JSON e convertê-los em uma variável de dicionário, os valores nulos na string do JSON não são convertidos, pois as variáveis de dicionário não aceitam valores nulos. No entanto, se o JSON contiver uma string vazia (“”) em vez de nulo, ela será convertida com êxito em uma variável de dicionário.

Noções básicas sobre estruturas JSON

No JSON, os dados são armazenados, principalmente, em duas estruturas:
  • Objetos: Objetos em JSON são coleções de pares de chaves e valores entre chaves {}. Cada chave é uma string entre aspas (“”) seguida de dois pontos (:), e vírgulas (,) são usadas para separar os pares de chave e valor.
    Exemplo:
    {"name ": "John", "age": "30", "city": Detroit}
  • Matrizes: Matrizes são listas ordenadas de valores, entre colchetes []. Os valores dentro de uma matriz são separados por vírgulas (,).
    Exemplo:
    ["John", "Annie", "Shane"]

Como usar o package JSON

Use as actions no package JSON seguindo esta ordem:
  1. Inicie a sessão JSON usando a action Iniciar sessão. Use este nome da sessão para todas as actions correspondentes.
  2. Use as diferentes actions disponíveis no pacote JSON para automatizar tarefas relacionadas ao JSON.
  3. Encerre a sessão usando a action Encerrar sessão para concluir uma tarefa.

Actions no package JSON

O package JSON inclui as seguintes actions:
Nota: Ao criar uma automação na plataforma macOS, uma janela de confirmação solicita que você conceda permissões de aplicativo no macOS. Consulte este tópico para obter uma lista de mensagens de aviso e instruções sobre como gerenciar permissões de aplicativos.

Permissões de aplicativos no macOS

Action Descrição
Iniciar sessão Inicie uma nova sessão JSON com base na fonte de dados JSON especificada. Consulte action Iniciar sessão no JSON.
Adicionar valor do nó Adicione um novo nó ao JSON especificado na fonte de dados Iniciar sessão. Consulte Adicionar valor do nó.
Converter Dicionário em JSON Converte o conteúdo de uma variável de Dicionário para o formato JSON. Consulte Converter Dicionário em JSON.
Converter JSON para Dicionário Extraia o conteúdo da fonte de dados JSON para uma variável de Dicionário. Consulte Converter JSON para Dicionário.
Obter lista de nós Recupera a lista de nós para um caminho de nó. Consulte action Obter lista de nós no JSON.
Obter nós Extrai os valores das chaves da fonte JSON. Consulte Obter nós em JSON
Obter o valor do nó Recupera o valor de um nó da fonte JSON. Consulte action Obter valor do nó no JSON.
Atualizar valor do nó Atualiza o valor de um nó na fonte de dados JSON. Consulte Atualizar valor do nó.
Validar Valida a sintaxe, a estrutura e o esquema da fonte de dados JSON. Consulte Ação Validar
Encerrar sessão Encerra uma sessão JSON. Consulte action Encerrar sessão no JSON.

Mais recursos