Ação do produtor de registro

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

    • Crie um registro de tarefa a partir de um item do catálogo do produtor de registros [sc_cat_item]. O registro de tarefa herda os valores das variáveis do item do catálogo.

    Funções e disponibilidade

    Disponível como uma ação principal de Workflow Studio ServiceNow. Usuários com a função flow_designer ou admin podem adicionar uma ação a um fluxo e definir detalhes de configuração.

    Entradas

    Forneça um valor para cada entrada necessária para sua ação. Para adicionar valores dinâmicos, você também pode arrastar e soltar pilhas do painel de dados ou selecioná-las no seletor de pilhas.

    Entrada Tipo de dados Descrição
    Item do catálogo Registro Referência ao item do catálogo usado para criar um registro de tarefa.
    Entradas do Item do catálogo Cadeia de caracteres Variáveis do catálogo associadas ao item do catálogo escolhido. Você pode exibir variáveis do catálogo associadas para Itens do catálogo de Catálogo de serviços > Definições de Catálogo > Produtores de Registros.
    Não falha em erro Verdadeiro/Falso Variável do catálogo que indica se há falha em caso de erro.

    Saídas

    Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em seu fluxo.

    Saída Tipo de dados Descrição
    Tabela Nome da tabela Tabela em que o registro de tarefa foi criado.
    Registro Registro Referência ao registro de tarefa criado.
    Mensagens de erro Cadeia de caracteres Mensagem de erro produzida quando a operação de registro falha.
    Status Escolha Status de conclusão da ação. A página de detalhes da execução do fluxo exibe um desses valores numéricos.
    • Sucesso [0]: A ação foi bem-sucedida.
    • Erro [1]: A ação produziu um erro.

    Mensagens de erro

    Se ocorrer um erro com esta ação, as seguintes mensagens de erro serão exibidas no detalhes da execução página.

    Mensagem de erro Descrição
    Falha na geração de registro. Verifique os logs para obter mais informações. Esse erro normalmente ocorre quando seu fluxo ou ação contém lógica para inserir um registro ou registros em outras tabelas. Quando esta lógica existe, a ação Produtor de registro anula a inserção do registro na tabela.

    Considerações de design

    Siga estas considerações de design ao criar fluxos que contêm ações do Produtor de registro.

    Escape as aspas das cápsulas de dados de cadeia de caracteres com a função de transformação Substituir cadeia de caracteres
    Variáveis de cadeia de caracteres complexas são convertidas no formato JSON quando armazenadas no sistema. Para evitar erros de formatação JSON, você pode usar uma função Substituir transformação de cadeia de caracteres para escapar das aspas presentes em qualquer cápsula de dados de cadeia de caracteres que você usa para variáveis de catálogo. Consulte Funções de transformação de cadeia de caracteres.
    Use funções de transformação para validar cápsulas de dados
    Sempre que você usar uma cápsula de dados para fornecer dados para uma entrada de ação, poderá usar uma função de transformação para validar os dados. Consulte Funções de transformação para obter uma lista de funções de transformação disponíveis.