Etapa de criação ou atualização de registro
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 etapa Criar ou atualizar registro identifica registros existentes pesquisando valores correspondentes nos campos que você seleciona como identificadores exclusivos. Por exemplo, você pode especificar que os campos Descrição resumida e Prioridade identifiquem exclusivamente um incidente. Quando a etapa encontra um incidente com uma descrição resumida e prioridade correspondentes, ela atualiza o registro correspondente em vez de criar um novo registro.
- Se nenhum campo for selecionado como identificador exclusivo, a etapa criará um registro com os valores de campo fornecidos.
- Se mais de um registro corresponder ao valor dos identificadores exclusivos, a etapa não atualizará nenhum registro e exibirá uma mensagem de erro nos detalhes da execução do fluxo.
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.
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.
- Tabela
- Tipo de dados: Table Name
Tabela na qual criar ou atualizar um registro.
- 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 para 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ê poderá Crie 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 obrigatórios são selecionados.
- 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. Esta opção não tem efeito na saída Status da etapa. As opções incluem:
- Não interrompa a ação e vá para a próxima etapa Continua executando a ação na próxima etapa.
- Vá para Avaliação de erro : Interrompe a execução da ação e vai para a seção Avaliação de erro.
Saídas
Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em sua ação.
- 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.
- Mensagens de erro
- Tipo de dados: String
Mensagem de erro produzida quando a operação de registro falha.
- Status
- Tipo de dados: Choice
Status de conclusão da ação. A página de detalhes da 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.
- Status da etapa
- Tipo de dados: Object
Cápsula de dados do objeto que contém detalhes de tempo de execução sobre a etapa. Cada etapa em uma ação retorna um Status da etapa.
- Código de status da etapa
- Tipo de dados: Integer Cápsula de dados inteiros que indica se a etapa produziu um erro. Uma etapa retorna um valor de 1 quando produz um erro por qualquer motivo. Por exemplo, uma etapa pode produzir um erro se não tiver dados de entrada obrigatórios ou retornar uma saída no tipo de dados incorreto. Uma etapa retorna um valor de 0 quando é executada com sucesso. Esses códigos não podem ser personalizados.
- Sucesso [0]: A etapa foi bem-sucedida.
- Erro [1]: A etapa produziu um erro.
- Mensagem de status da etapa
- Tipo de dados: String
Cápsula de dados da cadeia de caracteres que contém a mensagem de erro produzida pela etapa ou operação do sistema. Você não pode personalizar a mensagem de status da etapa.
Criar ou atualizar um registro de problema
Esta ação tem duas entradas. Há uma entrada de cadeia de caracteres para uma descrição e uma entrada de referência para um registro de usuário. A etapa Criar ou atualizar registro usa essas entradas para criar ou atualizar um registro de problema. A declaração do problema e os campos Aberto por determinam a exclusividade. Quando os valores de entrada correspondem, a etapa executa uma operação de atualização em vez de uma operação de criação.