Etapa do construtor de carga

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • Permita que os designers de ação criem facilmente pares de nome-valor em cargas JSON e XML usando dados dinâmicos.

    Funções e disponibilidade

    Disponível como uma etapa de ação de Workflow Studio. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.
    Nota:
    Para JSON, esta etapa foi descontinuada e substituída por Etapa do Construtor JSON.

    Campos

    Campos Descrição
    Nomear pares de valor

    Os pares nome-valor a serem incluídos na carga. Clique no ícone de mais para adicionar pares nome-valor. Arraste cápsulas de dados para qualquer um dos campos para produzir cargas dinâmicas.

    . Nome Torna-se uma chave em JSON e um elemento em XML. Por exemplo, suponha que você crie este par nome-valor.
    • Nome : short_description
    • Valor : [ação]->[short_description]
    Quando o sistema formata o par nome-valor como JSON:
    "short_description": "[action]->[short_description]"

    Quando o sistema formata o par nome-valor como XML:

    <short_description>[action]->[short_description]</short_description>
    Omitir se vazio A opção para excluir um par nome-valor se o valor estiver vazio ou nulo.
    Nota:
    Este campo só fica visível depois de clicar na seta para baixo para exibir as opções avançadas.
    Formatos de Saída O formato do arquivo de carga.
    • JSON : Selecione para formatar a carga como um documento JSON.
    • XML : Selecione para formatar a carga como um documento XML.
    Namespace Namespace XML a ser aplicado a cada elemento. Por exemplo, quando o namespace está definido como incidente :
    <incident:short_description>[action]->[short_description]</incident:short_description>
    Nota:
    Este campo só fica visível quando Formato de saída está definido como XML .
    Incluir Estruturas Externas

    A opção para incluir ou excluir um contêiner de nível superior apropriado para o formato de saída. . Formato de saída JSON, chaves contêm os pares nome-valor. . Formato de saída XML, um elemento XML especificado contém os pares nome-valor.

    Por exemplo, quando o sistema formata o par nome-valor como JSON:

    {
  "short_description": "[action]->[short_description]"
}

    Quando o sistema formata o par nome-valor como XML:

    <xml>
  <short_description>[action]->[short_description]</short_description>
</xml>
    Enviar Estrutura Vazia

    A opção para enviar estruturas JSON ou XML válidas quando a carga está vazia. Habilite esta opção para incluir texto estrutural JSON ou XML na carga.

    Por exemplo, quando o sistema formata uma estrutura vazia como JSON:
    {}

    Quando o sistema formata uma estrutura vazia como XML:

    <xml></xml>

    Desabilite esta opção para produzir uma carga vazia.

    Cargas vazias podem ocorrer quando você seleciona Omitir se estiver vazio cada par nome-valor e todos os pares nome-valor na carga produzem valores vazios.
    Nó primário O nome do elemento XML que contém os pares nome-valor. O elemento do nó primário padrão é xml .
    Nota:
    Este campo só fica visível quando Formato de saída está definido como XML e a opção para Incluir Estrutura Externa habilitado.
    Visualização A carga somente leitura que a etapa produz.

    Avaliação de erro de ação

    Se esta etapa falhar
    Tipo de dados: Choice

    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 Avaliação de erro de ação.