Etapa do Construtor JSON

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Crie uma carga JSON para usar em outra etapa. Insira valores ou use cápsulas de dados para produzir uma carga dinâmica. Esta etapa oferece suporte a vários tipos de dados, incluindo objetos e matrizes para estruturas aninhadas.

    Funções e disponibilidade

    Disponível como uma etapa de ação de Designer de ações. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.

    Campos

    Campo Descrição
    Nome Parte do nome de um par nome-valor. Insira um valor ou use uma cápsula de dados para produzir uma carga dinâmica.
    Valor

    Parte do valor de um par nome-valor. Insira um valor ou use uma cápsula de dados para produzir uma carga dinâmica.

    Você pode usar uma cápsula de objeto complexo para preencher uma linha com um tipo de dados de objeto, mas isso excluirá todos os secundários que a cápsula de objeto complexo já tenha.

    Tipo
    Tipo de dados para o par nome-valor. Se você estiver usando uma cápsula de dados para o nome ou valor, certifique-se de que o tipo de dados da cápsula corresponda ao tipo de dados selecionado aqui. As opções são:
    • Cadeia de caracteres
    • Objeto
    • Número
    • Booliano
    • Matriz

    Para matrizes e objetos, use o ícone de adição ( íconede adição ) para adicionar pares de nome-valor à matriz ou ao objeto.

    Em caso de valor vazio Opção para especificar o que fazer se um par nome-valor tiver um valor vazio ou nulo.
    • Deixar como está: mantém o valor vazio ou nulo como uma cadeia de caracteres vazia.
    • Omitir propriedade: exclui um par nome-valor se o valor estiver vazio ou for nulo.
    • Definir como nulo: retorna um valor vazio ou nulo como um tipo de dados nulo.
    • Lançar erro: retornará um erro se um par de nome-valor tiver um valor vazio ou nulo.
    Incluir Estruturas Externas Opção para incluir chaves para um contêiner JSON de nível superior.
    Omitir estrutura vazia

    Opção para omitir uma carga vazia.

    Cargas vazias podem ocorrer quando você seleciona a propriedade Omitir para o campo Em caso de valor vazio para cada par de nome-valor e todos os pares de nome-valor na carga produzem valores vazios.

    Visualização Carga somente leitura que a etapa produz.

    Campos de avaliação de erro de ação

    Campo Descrição
    Se esta etapa falhar Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Para usar o código de status da etapa ou a mensagem para uma condição de erro de ação personalizada, consulte Action error evaluation.

    Saída

    Campo Descrição Tipo de Dados
    Saída Carga JSON como uma cadeia de caracteres. Se você quiser usar a carga como um objeto, poderá usar a etapa do analisador JSON para analisar a cadeia de caracteres. Cadeia de caracteres
    Status da etapa Cápsula de dados do objeto que contém detalhes de tempo de execução sobre a etapa. Cada etapa em uma ação retorna um Status da etapa. Objeto
    Status da etapa > Código Cápsula de dados inteiros que indica se a etapa produziu um erro. Por padrão, um valor de 1 indica que a etapa produziu um erro. Um valor 0 indica que a etapa foi executada com sucesso. Você não pode personalizar esses códigos. Número inteiro
    Status da Etapa > Mensagem Cápsula de dados da cadeia de caracteres que contém a mensagem de erro produzida pela etapa ou operação do sistema. Você não pode personalizar esta mensagem. Cadeia de caracteres