---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Observador de campo

# Observador de campo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

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](https://www.servicenow.com/docs/access?context=next-experience-adoption-paths&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US).

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
  {#c_FieldWatcher__ul_jbl_wqd_qp}

{#c_FieldWatcher__ul_hl5_nqd_qp}  
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 {#ariaid-title2}

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 ( ![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](https://servicenow-prod.fluidtopics.net/VtZ92UigSg0_Lk3YBcpn7A#c_WritingToTheDebugLog "Para gravar no log de depuração em suas políticas JavaScript ou de IU do lado do cliente, faça uma chamada para a função global jslog().") 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 ( ![O 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 {#ariaid-title3}

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 dereferê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.
{#c_SettingUpTheFieldWatcherTab__ul_s14_t5d_qp}

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 {#ariaid-title4}

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 SistemaSegundo 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 {#ariaid-title5}

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:

* Carimbode 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.
  {#c_ViewInfoWatchedField__ul_thf_nwd_qp}
* 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: osvaloresantigos 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çõesde 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.
  {#c_ViewInfoWatchedField__ul_yh5_swd_qp}
{#c_ViewInfoWatchedField__ul_c2n_jwd_qp}

## Exemplo: observação da prioridade do incidente {#ariaid-title6}

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.{#c_ExWatchingTheIncidentPriority__table_psz_5n2_qp__entry__1}

| Valores originais |
|-|
| * Prioridade: 1 - Crítico * Impacto:1 - Alto * Urgência:1 - alta {#c_ExWatchingTheIncidentPriority__ul_ezq_wn2_qp} |
| Primeira mudança |
| 1. O usuário muda o valor do Impacto para 3 - Baixo. 2. 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. {#c_ExWatchingTheIncidentPriority__ol_qhc_zn2_qp} Nota: Neste ponto, o registro não foi salvo. |
| Segunda mudança |
| 1. O usuário muda o valor de Urgência para 2 - Médio. 2. A prioridade muda automaticamente para 4 - Baixa com base na mesma definição de pesquisa de dados da Pesquisa de prioridade. 3. O usuário salva o registro clicando com o botão direito do mouse no cabeçalho do formulário e escolhendo Salvar. {#c_ExWatchingTheIncidentPriority__ol_lbm_242_qp} |
[Tabela 1. Observando a prioridade do incidente]

{#c_ExWatchingTheIncidentPriority__table_psz_5n2_qp} 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.