Observador de campo

A ferramenta 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 o Next Experience .

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ócios 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 representação têm acesso ao recurso observador de campo.

Como o observador de campo funciona

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

• O valor padrão é definido no campo.
• Os direitos de acesso do usuário para o campo mudam devido a uma ACL ou configuração de 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 opções 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. Ele não pode ser usado em campos de lista. 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 na estrutura de IU. A opção de observar um campo não aparecerá no menu de contexto se você abrir um registro fora da estrutura de IU, por exemplo, em uma nova guia.

Usar observador de campo

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

Antes de Iniciar

Função necessária: nenhuma

Procedimento

1. Navegue até o formulário cujas informações de depuração no nível do campo você deseja exibir.
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 "Watch - "<field name>" .

   O ícone de depuração ( ) aparece ao lado do rótulo do campo. A partir desse ponto, o observador de campo registra todas as ações realizadas no campo selecionado. Por exemplo, se você estiver assistindo a 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 observador de campo. Também pode mostrar guias para Registro em log do JavaScript E Depurador JavaScript.
4. Clique em Observador de campo , se necessário.
5. Para de observar um campo clicando com o botão direito do mouse no campo e selecionando Unwatch - <field name> .
   Para observar outro campo, clique com o botão direito do mouse nesse campo e selecione <field name> .
6. Limpe o log do observador de campo clicando no botão Limpar log ( ).
7. Redimensione o painel 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 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 no qual o campo atual depende.
• Referência tabela da qual o valor do campo se originou, se aplicável.
• Qual de referência : qualificadores de referência que podem estar restringindo dados no campo.
• Atributos atributos no campo conforme especificado em entrada do dicionário para esse 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 de qualquer tipo de informação que não seja necessária.

Observar um campo oculto

Os administradores podem precisar observar um campo oculto.

Procedimento

1. Use 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 > Plano de fundo dos 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.

Exibindo informações do campo observado

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

Figura 1. Observador de campo exibindo dados

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 no lado do servidor, como ACLs.
  • Texto azul mudanças no lado do cliente, como scripts de cliente.
• 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ÓCIO ou ACL . No caso de scripts, regras de negócios ou outros campos do tipo de configuração, o observador de campo exibe o nome do script ou regra de negócios que mudou 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 mudado0. O observador de campo não registra o valor se ele foi 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 do fluxo de trabalho que mudou o campo. Clique no ícone de mais para expandir a seleção.
  • Texto laranja : Indica atividade do lado do servidor.
  • Texto azul : Indica atividade do lado do cliente.

Exemplo: Observar a prioridade do incidente

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

O formulário Incidente tem duas pesquisas de dados do lado do cliente que mudam 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 Prioridade campo de volta para somente leitura, que é a configuração padrão.

Tabela 1. Observando a prioridade do incidente

Valores originais
Prioridade:1 - Crítica Impacto: 1 - Alto Urgência: 1 - Alta
Primeira mudança
O usuário muda Impacto valor para 3 - Baixo . A prioridade muda automaticamente para 3 - Moderado com base em Pesquisa de prioridade definição de pesquisa de dados usada por padrão em ServiceNow incidentes. Nota: Neste ponto, o registro não foi salvo.
Segunda mudança
O usuário muda Urgência valor para 2 - Médio . A prioridade muda automaticamente para 4 - Baixo com base no mesmo Pesquisa de prioridade definição de pesquisa de dados. 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, se referem aos valores numéricos na lista de seleção.