Ação Criar ou atualizar registro

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Crie ou atualize um registro em uma tabela ServiceNow usando uma única operação. Atualize um registro existente ou crie um registro usando os valores fornecidos.

    Identificação de registros existentes

    A ação Criar ou Atualizar Registro identifica os registros existentes pesquisando valores correspondentes nos campos selecionados como identificadores exclusivos. Por exemplo, você pode especificar que a descrição resumida e os campos de prioridade identifiquem exclusivamente um incidente. Quando a ação encontra um incidente com uma descrição resumida e prioridade correspondentes, ela atualiza o registro correspondente em vez de criar um novo registro.

    Nota:
    • Se nenhum campo for selecionado como um identificador exclusivo, a ação criará um registro com os valores de campos fornecidos.
    • Se mais de um registro corresponder ao valor dos identificadores exclusivos, a ação não atualizará nenhum registro e exibirá uma mensagem de erro nos detalhes de execução do fluxo.

    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 de que o fluxo precisa. Para adicionar valores dinâmicos, você também pode arrastar e soltar pilhas do painel de dados ou selecioná-las no seletor de pilhas.

    Tabela
    Tipo de dados: Table Name

    Tabela na qual um registro será criado ou atualizado.

    Campos
    Tipo de dados: Template Values

    Valores de campo a serem definidos ou atualizados para o registro. Por exemplo, para definir a descrição resumida com um determinado valor, selecione Descrição resumida e defina o valor desejado.

    Importante:
    O sistema não oferece suporte à atualização de vários campos de diário, como comentários adicionais ou anotações de trabalho de um registro de tarefa.

    Se estiver adicionando a ação a um subfluxo, você pode Criar uma entrada de valor de modelo. Valores de campo definidos dinamicamente podem acionar regras de validação do lado do servidor, mas não podem acionar políticas de IU.

    Determina exclusividade
    Tipo de dados: True/False

    Opção para selecionar o campo como um identificador exclusivo, que determina quando atualizar ou criar um registro. Um registro é atualizado quando o valor do campo de entrada corresponde a um valor de campo de registro existente. Um registro é criado quando o valor do campo de entrada não corresponde a um valor de campo de registro existente. Esta opção aparece quando o nome da tabela e os campos necessários são selecionados.

    Saídas

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

    Registro
    Tipo de dados: Record

    Referência ao registro criado ou atualizado.

    Tabela
    Tipo de dados: Table Name

    Tabela em que o registro foi criado ou atualizado.

    Status
    Tipo de dados: Choice

    Status de conclusão da ação. A página de detalhes de execução do fluxo exibe um desses valores.

    • Criado [criado]: a ação criou um registro.
    • Atualizado [atualizado]: a ação atualizou um registro.
    • Erro [error]: a ação produziu um erro.
    Mensagem de erro
    Tipo de dados: String

    Mensagem de erro produzida quando a operação de registro falha.

    Atualizar registro de problema a partir do e-mail de entrada

    Figura 1. Entradas usadas para criar ou atualizar registro de problema
    Entradas usadas para criar ou atualizar o registro de problema.