Observador de campo

A ferramenta do observador de campo rastreia e exibe todas as ações que o sistema executa em um campo de formulário selecionado.

Nota:

O observador de campo não é compatível com Next Experience em Utah. Para obter mais informações sobre recursos compatíveis em Next Experience, consulte Considerações para ativar a Próxima experiência.

Os administradores podem usar o observador de campo para descobrir o que acontece com o campo e como o valor do campo muda quando ocorre um evento, como o acionamento de uma regra de negócio ou a imposição de uma política de dados. Os administradores também podem representar usuários não administradores para depurar o que acontece quando esses usuários fazem mudanças em uma instância. Somente um campo pode ser observado por vez. Usuários não administradores com a função de representante têm acesso ao recurso de observador de campo.

Como o observador de campo funciona

A ferramenta Observador de campo registra a atividade quando qualquer um dos seguintes eventos ocorre em um campo:

• O valor padrão é definido no campo.
• Os direitos de acesso do usuário para o campo mudam devido a uma configuração de ACL ou dicionário.
• Uma política de dados impede que o valor seja definido.
• Uma consulta de qualificador de referência do valor do campo é executada.
• Uma política de IU muda um campo para ou de somente leitura, visível, obrigatório ou editável.
• Um valor dependente em outro campo restringe as escolhas de campo.
• O valor do campo é definido ou alterado com base em:
  • Regras de atribuição
  • Ações de um mecanismo, como o mecanismo de fluxo de trabalho
  • Regras de negócio
  • Entradas dos usuários
  • Scripts de cliente
  • Ações de IU

Nota:

O observador de campo funciona somente em campos de formulário. Não pode ser usado em campos de lista. Além disso, o observador de campo não está disponível em campos protegidos por senha ou campos criptografados. O observador de campo só está disponível no quadro de IU. A opção de observar um campo não aparecerá no menu de contexto se você abrir um registro fora do quadro de IU, por exemplo, em uma nova guia.

Usar observador de campo

Acesse informações de depuração no nível de campo usando o observador de campo.

Antes de Iniciar

Função necessária: nenhuma

Procedimento

1. Navegue até o formulário para o qual você deseja exibir informações de depuração no nível de campo.
2. Ative o observador de campo clicando com o botão direito do mouse em qualquer rótulo de campo em um formulário e selecione Observar - '<field name> ' .

   O ícone de depuração ( ) aparece ao lado do rótulo do campo. A partir deste ponto, o observador de campo registra todas as ações realizadas no campo selecionado. Por exemplo, se você estiver observando um campo de Prioridade, se a prioridade for alterada de Moderada para Baixa e o registro for atualizado, o observador de campo exibirá informações sobre essa mudança.

3. Exiba o log do observador de campo clicando no ícone de depuração.
   Um novo painel é aberto na parte inferior da tela, mostrando uma guia do observador de campo. Também pode mostrar guias para Registro em log JavaScript e Depurador JavaScript.
4. Clique na guia Observador de campo, se necessário.
5. Interrompa a observação de um campo clicando com o botão direito do mouse no campo e selecionando Desobservar -<field name> .
   Para observar outro campo, clique com o botão direito do mouse nesse campo e selecione Observar -<field name> .
6. Limpe o log do observador de campo clicando no botão Limpar log ( ).
7. Redimensione o painel do observador de campo arrastando a barra divisora para cima ou para baixo.
   Arrastar a barra divisora para a parte inferior da tela fecha o painel do observador de campo. Reabra o painel clicando no ícone de depuração novamente.

Detalhes da guia do observador de campo

O observador de campo exibe informações de campo e opções de configuração.

O lado esquerdo da guia Observador de campo mostra as seguintes informações do campo observado.

• Tabela: tabela à qual o campo pertence.
• Elemento: rótulo do campo.
• Tipo: tipo de dados armazenados no campo.
• Dependente: campo do qual o campo atual depende.
• Referência: tabela da qual o valor do campo se origina, se aplicável.
• Qualificador de referência: qualificadores de referência que podem estar restringindo os dados no campo.
• Atributos: atributos no campo conforme especificado na entrada de dicionário desse campo.

No lado direito da guia Observador de campo, selecione os tipos de informações de atividade que você deseja ver para o campo selecionado. Desmarque a caixa de seleção para qualquer tipo de informação que não seja necessária.

Observação de um campo oculto

Os administradores podem precisar observar um campo oculto.

Procedimento

1. Use o dicionário para determinar o nome da coluna do campo.
2. Eleve privilégios para a função security_admin.
3. Navegar até Definição do Sistema > Segundo Plano de Scripts.
4. Em Executar script (JavaScript executado no servidor), insira o seguinte comando:

   gs.getSession ( ). setWatchField ( "hidden_field" ) ;

   Substitua Hidden_field pelo nome da coluna do campo oculto.

5. Navegue até o formulário que contém o campo ausente.

   A saída da guia Observador de campo contém informações sobre o campo oculto.

Exibição de informações do campo observado

Quando as informações de um campo observado são alteradas e o registro é atualizado, a guia do observador de campo exibe informações relevantes na parte inferior.

Figura 1. Dados de exibição do observador de campo

As informações do observador de campo incluem:

• Carimbo de data/hora: hora em que o campo foi alterado usando o formato HH:MM:SS (ms).
  • Texto laranja: mudanças do lado do servidor, como ACLs.
  • Texto azul: mudanças do lado do cliente, como client scripts.
• Tipo de objeto que mudou o campo e seu nome associado: o tipo de item que mudou no campo; por exemplo, CLIENT SCRIPT, REGRA DE NEGÓCIOou ACL. No caso de scripts, regras de negócio ou outros campos do tipo configuração, o observador de campo exibe o nome do script ou regra de negócio que alterou o campo, se houver. Clique no nome para ir diretamente para o registro desse item.
• Valores antigos e novos: os valores antigos e novos do campo, se o valor for alterado0. O observador de campo não registra o valor se ele tiver sido inserido no formulário por padrão no momento em que o registro foi criado.
• Informações adicionais: informações de rastreamento de chamadas, como o nome do mecanismo de script ou fluxo de trabalho que alterou o campo. Clique no ícone de mais para expandir a seleção.
  • Texto laranja: indica atividade do lado do servidor.
  • Texto em azul: indica atividade do lado do cliente.

Exemplo: observação da prioridade do incidente

O exemplo a seguir mostra o que acontece com o campo Prioridade no formulário de incidente quando os campos Impacto e Urgência são alterados.

O formulário de Incidente tem duas pesquisas de dados do lado do cliente para mudar a prioridade. Além disso, as ACLs do lado do servidor e o mecanismo de pesquisa de dados são acionados quando o registro é salvo. Por fim, uma política de IU do lado do cliente define o campo Prioridade novamente como somente leitura, que é a configuração padrão.

Tabela 1. Observando a prioridade do incidente

Valores originais
Prioridade: 1 - Crítico Impacto:1 - Alto Urgência:1 - alta
Primeira mudança
O usuário muda o valor do Impacto para 3 - Baixo. A prioridade muda automaticamente para 3 - Moderada com base na definição de pesquisa de dados de pesquisa de prioridade usada por padrão em ServiceNow incidentes. Nota: Neste ponto, o registro não foi salvo.
Segunda mudança
O usuário muda o valor de Urgência para 2 - Médio. A prioridade muda automaticamente para 4 - Baixa com base na mesma definição de pesquisa de dados da Pesquisa de prioridade. O usuário salva o registro clicando com o botão direito do mouse no cabeçalho do formulário e escolhendo Salvar.

Figura 2. Exemplo de observador de campo

Nota:

Os valores que mudam de 1 para 3 e, em seguida, de 3 para 4, referem-se aos valores numéricos na lista de seleção.