Ação do Produtor de registro

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 as variáveis do catálogo associadas aos Itens do catálogo em Catálogo de serviços > Definições de Catálogo > Produtores de Registros.
    Não falha em erro Verdadeiro/falso Variável de 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 da tarefa foi criado.
    Registro Registro Referência ao registro de tarefa criado.
    Mensagem 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 de 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 na página de detalhes da execução.

    Mensagem de erro Descrição
    Falha na geração do registro. Verifique os logs para obter mais informações. Este erro normalmente ocorre quando o fluxo ou a ação contém lógica para inserir um registro ou registros em outras tabelas. Quando essa lógica existe, a ação do 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.

    Escapar aspas de cápsulas de dados de cadeia de caracteres com a função de transformação Substituição de cadeia de caracteres
    Variáveis de cadeia de caracteres complexas são convertidas para o formato JSON quando armazenadas no sistema. Para evitar erros de formatação JSON, você pode usar uma função de transformação Substituir cadeia de caracteres para escapar das aspas presentes em todas as cápsulas de dados de cadeia de caracteres usadas para variáveis do 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.