Instalado com geolocalização

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura
  • Vários componentes são instalados com o aplicativo Geolocalização.

    O plug-in Geolocalização adiciona um campo chamado Geolocalização rastreada à tabela Usuário [sys_user]. Esse campo permite que o sistema rastreie usuários individuais por suas coordenadas geográficas.

    Regras de negócio instaladas com geolocalização

    As regras de negócio são adicionadas com a ativação de Geolocalização.

    Nome Tabela Descrição
    Dados de geolocalização atualizados Usuário

    [sys_user]

    Preenche os campos Latitude e Longitude na tabela Histórico de geolocalização [geo_history] quando os campos Latitude e Longitude são atualizados na tabela Usuário [sys_user].

    Scripts de cliente instalados com geolocalização

    Os scripts de cliente são adicionados com a ativação de Geolocalização.

    Nome Tabela Descrição
    Atualizar Geolocalização na Tarefa Tarefa

    [task]

    Preenche os campos de Latitude e Longitude em um registro do usuário com coordenadas GPS quando esse usuário carrega qualquer registro na tabela de tarefas ou em uma tabela que estende a tarefa. Isso ocorre somente quando o rastreamento de geolocalização está habilitado para o usuário.

    Propriedades instaladas com geolocalização

    A geolocalização fornece as seguintes propriedades configuráveis em Geolocalização > Administração > Propriedades da Geolocalização.

    O plug-in Google Maps fornece propriedades de mapa adicionais usadas para implementar e controlar recursos de geolocalização específicos. Você deve ter uma chave privada para a API do Google Maps para Empresas para aproveitar as propriedades listadas aqui.
    Tabela 1. Propriedades
    Nome Descrição
    glide.geolocation.allow.toll.roads Permitir que estradas com pedágios sejam usadas. Permite que o sistema use estradas com pedágio ao rotear automaticamente ou otimizar rotas de tarefa para os agentes.
    • Tipo: verdadeiro|falso
    • Valor padrão: verdadeiro
    glide.geolocation.default.start.time Hora de início padrão para todos os agentes quando não houver uma programação definida. Esse valor define a hora de início de um dia diferente do dia atual, quando nenhuma tarefa programada existe ou é continuada do dia anterior. Essa propriedade usa um relógio de 24 horas.
    • Tipo: cadeia de caracteres
    • Valor padrão: 08:00
    glide.geolocation.evening.rush.hours Período do horário de rush da tarde, no formato 14:30-16:00. Todos os horários são expressos como um intervalo, separados por um hífen sem espaços. As horas que não estão usando esse formato são ignoradas. Essa propriedade deve ser usada com as propriedades work.management.morning.rush.hours e work.management.rush.travel.buffer e usa um relógio de 24 horas.
    • Tipo: cadeia de caracteres
    • Valor padrão: 0
    glide.geolocation.history.cleanup Número de dias para manter os dados do histórico. ServiceNow mantém registros de histórico de geolocalização do agente para o número de dias especificado por esse valor.
    • Tipo: inteiro
    • Valor padrão: 30
    glide.geolocation.morning.rush.hours Período do horário de rush da manhã, no formato 06:30-08:00. Essa propriedade usa um relógio de 24 horas. Todos os horários são expressos como um intervalo, separados por um hífen sem espaços. As horas que não estão usando esse formato são ignoradas. Essa propriedade deve ser usada com as propriedades work.management.evening.rush.hours e work.management.rush.travel.buffer.
    • Tipo: cadeia de caracteres
    • Valor padrão: 0
    glide.geolocation.proximity A distância mínima à qual um agente deve se mover para se considerar que ele está em um novo local (em metros). Essa configuração estabelece um perímetro de geolocalização que impede ServiceNow de criar registros de histórico desnecessários quando um agente tem várias tarefas na mesma vizinhança. Um exemplo disso pode ser quando um agente tem várias tarefas em um edifício. O sistema pressupõe que toda a atividade da tarefa dentro do raio especificado faz parte de um único registro e não cria registros adicionais quando o agente passa de uma tarefa para outra no edifício.
    • Tipo: inteiro
    • Valor padrão: 500
    Nota:
    A versão iOS do app atualiza a geolocalização somente quando o dispositivo móvel detecta uma mudança de local significativa, que é determinada pelo sistema operacional do seu dispositivo. Quando o sistema operacional atualiza o local, seu app é atualizado com essa mudança de local. Os valores das propriedades de distância e tempo não são aceitos para a versão iOS de aplicativos ServiceNow.
    glide.geolocation.proximity.location A distância máxima à qual um agente deve estar de um determinado local para se considerar nesse mesmo local (em metros). Essa configuração define a distância máxima à qual um agente deve estar de um determinado local para se considerar nesse mesmo local pelo sistema.
    • Tipo: inteiro
    • Valor padrão: 200
    glide.geolocation.rush.travel.buffer Porcentagem a ser adicionada a todas as viagens na hora do rush. O sistema usa essa porcentagem para calcular cronogramas ao rotear automaticamente um agente. Use essa propriedade quando os horários de rush da manhã e da noite forem definidos. Um exemplo de porcentagem de buffer de tempo válido é 15.
    • Tipo: inteiro
    • Valor padrão: 0
    glide.geolocation.tracking.frequency Define a duração do intervalo recorrente, em segundos, que o sistema espera entre as tentativas de atualizar as coordenadas geográficas de um usuário. O sistema atualiza as coordenadas geográficas somente para usuários com rastreamento de geolocalização habilitado.
    Quantidade mínima de tempo entre atualizar o local do usuário (em segundos). Essa configuração define quanto tempo o sistema espera antes de atualizar o local de um agente, independentemente da atividade da tarefa ou da viagem. Isso evita que ServiceNow crie registros de histórico desnecessários se um agente em um local exibir uma tarefa várias vezes.
    • Tipo: inteiro
    • Valor padrão: 300
    Observe o seguinte:
    • A versão Android do app atualiza os dados de geolocalização em intervalos de 15 minutos. O app coleta a localização de um usuário usando o intervalo definido nessa propriedade, mas esses dados ainda são carregados para sua instância a cada 15 minutos.
    • A versão iOS do app atualiza a geolocalização somente quando o dispositivo móvel detecta uma mudança de local significativa, que é determinada pelo sistema operacional do seu dispositivo. Quando o sistema operacional atualiza o local, seu app é atualizado com essa mudança de local. Os valores das propriedades de distância e tempo não são aceitos para a versão iOS de aplicativos ServiceNow.
    glide.geolocation.travel.buffer Porcentagem a ser adicionada a todos os horários de viagem. Um exemplo de valor de porcentagem válido é 15.
    • Tipo: inteiro
    • Valor padrão: 0
    glide.geolocation.work.spacing Quantidade de tempo (em minutos) para adicionar entre o final de uma tarefa e o início da próxima viagem. Um exemplo de valor de tempo válido é 10.
    • Tipo: inteiro
    • Valor padrão: 0

    Inclusões de script instaladas com geolocalização

    As inclusões de script são adicionadas com a ativação de Geolocalização.

    Nome Descrição
    GeolocalizaçãoAJAX Utilitários que o sistema usa ao fazer chamadas AJAX de geolocalização.
    GeolocationUtils Utilitários principais para funcionalidade de geolocalização.