Etapa do construtor de carga

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 de nome-valor a serem incluídos na carga. Clique no ícone de mais para adicionar pares de nome-valor. Arraste as cápsulas de dados para qualquer campo para produzir cargas dinâmicas.

    O Nome se torna uma chave em JSON e um elemento em XML. Por exemplo, suponha que você crie este par nome-valor.
    • Nome: short_description
    • Valor: [action]->[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 de excluir um par de 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 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 O namespace XML a ser aplicado a cada elemento. Por exemplo, quando o namespace é definido como incident:
    <incident:short_description>[action]->[short_description]</incident:short_description>
    Nota:
    Este campo só fica visível quando o Formato de saída está definido como XML.
    Incluir Estruturas Externas

    A opção de incluir ou excluir um contêiner de nível superior apropriado para o formato de saída. Quando o formato de saída é JSON, as chaves contêm os pares de nome-valor. Quando o formato de saída for XML, um elemento XML especificado conterá os pares de 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 a opção Omitir se vazio para cada par de nome-valor e todos os pares de nome-valor na carga produzem valores vazios.
    Nó primário O nome do elemento XML que contém os pares de nome-valor. O elemento de nó primário padrão é xml.
    Nota:
    Este campo só está visível quando o Formato de saída está definido como XML e a opção para Incluir estrutura externa está habilitada.
    Visualização A carga somente leitura produzida pela etapa.

    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.