Histórico da Página

01. 

...

VISIÓN GENERAL

Este documento tem tiene como objetivo orientar sobre os pontos los puntos de atenção que devem ser observados quando ocorre divergência no indicador de Geofence na marcação do Funcionário. Essa divergência ela pode ser no sentido de a Cerca Virtual estar habilitada porém o indicador na marcação não estar preenchido corretamenteatención que deben observarse cuando ocurre divergencia en el indicador de Geofence en el registro del Empleado. Esta divergencia puede ser en el sentido de que la Cerca virtual está habilitada, sin embargo, el indicador en el registro no está completado correctamente. 

02.

...

PUNTOS DE ATENCIÓN EN LA CONFIGURACIÓN DEL GEOFENCE

A continuación se listan algunos puntos de atención en la configuración del Geofence y es importante validarse para entender si el problema de divergencias puede ser por causa de la configuración inadecuada. A continuación se muestran los puntos principales para validarse

...

Abaixo é listado alguns pontos de atenção na configuração do Geofence e é importante serem validados para entender se o problema de divergências poderá ser por conta configuração inadequada. Segue baixo os pontos principais a serem validados: 

02.1

...

 El usuario debe ser registrado en el BackOffice o generado por el registro automático

Para que o processo el proceso de Geofence funcione de forma correta para os usuários logados é necessário que este usuário seja cadastrado pelo BackOficce ou gerado automaticamente pelo processo de criação automática de usuário. Quando esse processo é feito, é possível visualizar na consulta de Usuários da Plataforma Carol que foi gerado o correcta para los usuarios conectados, es necesario que este usuario sea registrado por el BackOficce o generado automáticamente por el proceso de creación automática de usuario. Cuando este proceso se realiza, es posible visualizar en la consulta de Usuarios de la Plataforma Carol que se generó el registro de "User metadata" que no es nada mais é do que as informações cadastradas no Usuário do BackOffice. O aplicativo Mobile  utiliza essas informações para verificar se a Geofence está habilitada e o más que las informaciones registradas en el Usuario del BackOffice. La aplicación Mobile utiliza estas informaciones para verificar si la Geofence está habilitada y el grupo de Data Access Level que relacionado vinculado.

02.2  

...

Direcciones de los registros de Empresa,

...

Empleado y Ubicación deben tener coordenada generada 

Las direcciones de los empleados y empresas deben tener las coordenadas (latitud y longitud). Estos valores son atribuidos automáticamente por la plataforma durante el procesamiento de los datos, si el parámetro especificado en el ítem 02.1 estuviera activado,  así como el ítem

...

Os endereços dos funcionários e empresas devem possuir as coordenadas (latitude e longitude). Esses valores são atribuídos automaticamente pela plataforma durante o processamento dos dados, caso o parâmetro especificado no item 02.1 esteja ativado assim como o item 02.2

Para validar se as coordenadas estão geradas é necessário acessar a Plataforma Carol e na opção de Menu Explore acessar os seguintes si las coordenadas están generadas es necesario acceder a la Plataforma Carol y en la opción Menú Explore acceder a los siguientes Data Model: Company, Employee e y Location.

Para cada Data Model é possível extrair um Excel no es posible extraer un Excel en el Explore, acessando accediendo "..." no en el canto superior direito da derecho de la consulta, depois selecionado después seleccionado "Exporte e y por ultimo selecionar último seleccionar "Excel". A plataforma irá criar uma processo de geração que é possível acessar para baixar o relatório através das notificações (ícone do "sino") e acessando o processo solicitado. No detalhe do processo terá uma opção para "download" do Excel.La plataforma creará un proceso de generación que es posible acceder para descargar el informe por medio de las notificaciones (ícono de la "campana") y accediendo al proceso solicitado. En el detalle del proceso habrá una opción para "download" del Excel.

Para las dos parametrizaciones informadas en los ítems 06.2 y 02.1, en caso de no estar habilitados, la dirección de la coordenada no se generará y por consiguiente las coordenadas no se considerarán para la validación de la geofence, ocasionando el indicador fuera de la cerca en el registroPara as duas parametrizações informadas nos itens 06.2 e 02.1, em caso de não estarem habilitados, o endereço da coordenada não será gerado e por consequência as coordenadas não serão consideradas para a validação da geofence, ocasionando o indicador fora de cerca na marcação.

02.3 Verificar

...

la conexión entre los datos para la obtención de las coordenadas:

Para que seja efetuado o controle da que se efectúe el control de la Geofence de forma correta é necessário validar as configurações abaixocorrecta es necesario validar las siguientes configuraciones:

• Configuração Configuración por Empresa:O
• El campo "Geofence:
Nível
• Nivel: Empresa"
do
• del Settings
do
• del Backoffice
precisa
• debe estar habilitado 
O CNPJ
• El RCPJ + CEI/CNO
da
• de la Empresa
deve
• debe estar
associado no
• vinculado al dispositivo 
O usuário logado ao dispositivo precisa estar com o
• El usuario conectado al dispositivo debe estar con el campo Habilitar Geofence Empresa habilitado.
A conferência deverá ser feita no registro de Metadados do Usuários da
• La verificación debe realizarse en el registro de Metadatos del Usuarios de Carol.
O
• El dispositivo
precisa
• debe estar
cadastrado
• registrado (
não pode
• no puede estar como
não reconhecido
• no reconocido).
O Aplicativo
• La Aplicación Mobile verifica
o CNPJ
• el RCPJ/CEI
da empresa relacionado ao
• de la empresa vinculado al dispositivo para buscar
as informações de endereços cadastrados
• las informaciones de direcciones registradas. 
• Configuração LocalizaçãoConfiguración Ubicación:o
• El campo "Geofence:
Nível
• Nivel:
Localização
• Ubicación"
do
• del Settings
do
• del Backoffice
precisa
• debe estar habilitado
o
• el campo Código
Localização do Cadastro de Localização deve estar relacionado ao dispositivo 
• O usuário logado ao dispositivo precisa estar com o campo Habilitar Geofence Localização habilitado. A conferência deverá ser feita no registro de Metadados do Usuários da Carol.
• ubicación del Registro de ubicación debe estar vinculado al dispositivo 
• El usuario conectado al dispositivo debe estar con el campo Habilitar Geofence Ubicación habilitado. La verificación debe realizarse en el registro de Metadatos del Usuarios de Carol.
• El dispositivo debe estar registrado (no puede estar como no reconocido). La Aplicación Mobile verifica el código de la ubicación vinculado al dispositivo para buscar las informaciones de direcciones registradas en la ubicación.
• Configuración Empleado:
• El campo "Geofence: Nivel: Empleado" debe estar habilitado en el Settings del Backoffice.
• El campo Geofence habilitado en el Registro del empleado
• O dispositivo precisa estar cadastrado (não pode estar como não reconhecido). O Aplicativo Mobile verifica o código da localização relacionado ao dispositivo para buscar as informações de endereços cadastrados na localização.
Configuração Empregado:
• O campo "Geofence: Nível: Empregado" precisa estar habilitado no Settings do Backoffice.
O campo Geofence habilitado no Cadastro do Funcionário
• . 

02.4 Verificar

...

el contenido del campo de

...

historial de la Geofence en el registro:

Por medio de la Plataforma Carol es posible realizar una verificación del historial del  lo ocurrido en el registro del reloj registrador con relación a la Geofence, consultando el

...

Através da Plataforma Carol é possível realizar uma verificação do histórico do ocorrido na marcação do ponto em relação a Geofence consultando o Data Model Clock in Records, campo "Employee Geofence Coordinates (Optional)".

Este campo demonstra as muestra las coordenadas que foram utilizadas se utilizaron para comparar com a coordenada da marcação, assim como o raio utilizado e a distância calculada para apoiar nas conferências quando ocorre situações em que a coordenada não está de acordo com o que foi informado pelo funcionário que efetuou a marcação. con la coordenada del registro, así como el radio utilizado y la distancia calculada para apoyar en las verificaciones cuando ocurren situaciones donde la coordenada no está de acuerdo con lo que fue informado por el empleado que efectuó el registro. 

La consulta es posible de realizarse efectuando el login en la Plataforma Carol, accediendo el Explore y el A consulta é possível de realizar efetuando o login na Plataforma Carol, acessando o Explore e o Data Model "Clock in Records" . A partir daí é possível realizar um filtro da marcação onde ocorreu a situação divergente e clicar no registro para consultar o detalhe dos campos. Para avaliar o campo o ideal é copiar para um local onde possa ser avaliar todos o conteúdo do campo. de aquí es posible realizar un filtro del registro donde ocurrió la situación divergente y hacer clic en el registro para consultar el detalle de los campos. Para evaluar el campo lo ideal es copiar a un local donde pueda evaluarse todo el contenido del campo.

Si el campo tuviera las informaciones de las coordenadas utilizadas tenemos una descripción del significado de las palabras contenidas en este campo para apoyarlos en los análisisPara quando o campo tem as informações das coordenadas utilizadas temos uma descritivo do significado das palavras contidas nesse campo para apoiá-los nas análises:

• company: Quando existe conteúdo no colchetes
• Cuando existe contenido en los corchetes, significa que existe
cadastro da coordenada da empresa e o usuário da marcação
• registro de la coordenada de la empresa y el usuario del registro está configurado para controlar Geofence por Empresa.
Ex
• Ej: ,"company":[{"geofence":{"x":-13.355368,"y":-39.055994},"deviceCoordinate":{"x":-13.3549346,"y":-39.0561692},"radius":600,"distance":51.56814956665039,"transition":"enter"}
Caso o colchetes não venha com o conteúdo significa que não foi encontrado endereço da empresa do usuário ou não está configurado a Geofence Empresa para esse usuário. Ex
• Si los corchetes no vinieran con el contenido, significa que no se encontró la dirección de la empresa del usuario o no está configurada la Geofence Empresa para este usuario. Ej: "company":[]. 
• employee:Quando existe conteúdo no colchetes
• Si existiera contenido en los corchetes, significa que existe
cadastro da coordenada no funcionário  e funcionário
• registro de la coordenada en el empleado y el empleado está habilitado para
o controle da
• el control de la Geofence.
Ex
• Ej: ,"employee":[{"geofence":{"x":-13.355368,"y":-39.055994},"deviceCoordinate":{"x":-13.3549346,"y":-39.0561692},"radius":600,"distance":51.56814956665039,"transition":"enter"}
Caso não venha com o conteúdo no colchetes significa que não foi encontrado endereço para o funcionário ou não está configurado a Geofence Empregado no cadastro de Funcionário. Ex
• Si no viniera con el contenido en los corchetes, significa que no se encontró la dirección para el empleado o no está configurada la Geofence Empleado en el registro de Empleado. Ej: "employee":[]. 
• location:Quando existe conteúdo no colchetes
• Si existiera contenido en los corchetes, significa que existe
cadastro da coordenada na localização relacionado ao dispositivo do usuário e o usuário está habilitado para o controle da Geofence por Localização. Ex
• registro de la coordenada en la ubicación vinculada al dispositivo del usuario y el usuario está habilitado para el control de la Geofence por Ubicación. Ej: ,"location":[{"geofence":{"x":-13.355368,"y":-39.055994},"deviceCoordinate":{"x":-13.3549346,"y":-39.0561692},"radius":600,"distance":51.56814956665039,"transition":"enter"}
Caso não venha com o conteúdo no colchetes significa que não foi encontrado endereço para a locatlização relacionado ao dispositivo do usuário ou não está configurado a Geofence Localização no Usuário. Ex
• Si no viniera con el contenido en los corchetes, significa que no se encontró la dirección para la ubicación vinculada al dispositivo del usuario o no está configurada la Geofence Ubicación en el Usuario. Ej: "location":[]. 
• geofence:O conteúdo nas chaves é
• El contenido en las claves es referente a la coordenada
da marcação
• del registro
• deviceCoordinate:O conteúdo nas chaves é
• El contenido en las claves es referente a la(s) coordenada(s) encontrada(s)
no cadastro dependendo da configuração:
• en el registro dependiendo de la configuración:
• Si fuera
Se for
• company, significa que
a informação é do cadastro
• la información es del registro de empresa
ligado
• vinculado a la empresa
do
• del dispositivo.
Se for
• Si fuera location, significa que
a
• la(s)
informação
• información(
ões
• es)
é
• es(
são
• son)
do cadastro de localização ligado a localização do dispositivoSe for
• del registro de ubicación vinculado a la ubicación del dispositivo
• Si fuera employee, significa que
a
• la(s)
informação
• información(
ões
• es)
é
• es(
são
• son)
do cadastro de funcionário ligado a funcionário que está efetuando a marcação
• del registro de empleado vinculado al empleado que está efectuando el registro
• radius: es el radio encontrado para aquella configuración 
• distance: es la distancia calculada entre la coordenada del registro con relación a la
• radius: é o raio encontrado para aquela configuração 
• distance: é a distancia calculada entre a coordenada da marcação em relação a(s) coordenada(s) encontrada(s). Sempre deve Siempre debe ser menor que o raio el radio para considerar como dentro da de la geofence
• transition: poderá puede ser "exit" que significa "fora fuera de la cerca" ou o "enter" que significa "dentro de la cerca". Se houver pelo menos uma Si hubiera por lo menos una coordenada como "enter" significa que foi encontrada uma localização onde a marcação foi feita se encontró una ubicación donde el registro fue realizado "dentro de la cerca", então a marcação será considerada entonces el registro se considerará como "dentro de la cerca" (no en el registro de marcação do DM Clock in Records a coluna la columna "is user inside"   será igual a "1").

Si la aplicación no consigue encontrar las Quando o aplicativo não consegue encontrar as coordenadas este campo fica queda como "no coordinates". Essa situação pode significar os seguintes Esta situación puede significar los siguientes casos:

• O cadastro das coordenadas não foi feito para as configurações realizadas. Então devem ser revisadas todas as configurações da Geofence.
• O cadastro ainda não foi atualizado no aplicativo Mobile - O aplicativo possui "jobs" que efetuam a atualização da informação de 4 e 4 horas. Pode ter ocorrido essa atualização entre os períodos e a informação ainda não estar atualizada. Desta forma como medida paliativa poderá ser feita atualização clicando no Botão Atualizar Funcionários do Aplicativo.
• Caso exista o cadastro as configurações estejam ok e tenha sido feita a atualização através do botão e mesmo assim esse campo fica como "no coordinates" é necessário abrir um ticket para avaliação.

02.5  Sem Coordenadas na marcação - Acuracidade acima do Parâmetro do Settings

Como por vezes o GPS é impreciso em alguma momentos, ocorrem falhas na obtenção do das coordenadas da marcação, quer na localização quer na informação que é dada ao aplicativo Mobile.  Na documentação temos mais detalhes dessas situações e dicas de como melhorar a localização e utilização do GPS nos dispositivos.

O Clock in disponibiliza uma forma de identificar a questão da precisão do GPS que é o campo "Acuracidade" que refere-se a proximidade entre o resultado de uma medição e o valor real. O campo Acuracidade do local da marcação está sendo atualizada em metros. Então quanto menor a quantidade de metros mais preciso o GPS está sendo.

Em muitos casos a Acuracidade é muito alta e isso indica que a localização fica muito imprecisa fazendo com que que o indicado da geofence fique como "Fora" sendo que deveria ser dentro. Para esses casos o Aplicativo Mobile  não atualiza a coordenada da marcação mantendo o campo sem as coordenadas. 

Para controlar o nível de precisão a ser considerada para que o campo coordenadas venha em branco deverá ser configurado o campo "Precisão Mínima das coordenadas" deverá ser preenchido com um valor em metros. O valor padrão para quando não é informado é de 500 metros. Isso significa que se a Acuracidade da coordenada da marcação for acima de 500 metros então a coordenada da marcação ficará em branco.

02.6  Sem coordenadas - Nível do GPS 

Além do Acuracidade na marcação temos outro indicador para verificar porque a marcação está sem coordenada que é o Nível GPS. Este campo indica qual status que o GPS se encontrava no momento da obtenção da coordenada. Esta consulta é possível ser realizada no Backoffice na opção de "Marcações". É possível selecionar o campo Nível GPS  na "Engrenagem" da consulta. A seguir está descrito o significado de cada status: 

• El registro de las coordenadas no se realizó para las configuraciones realizadas. Entonces deben revisarse todas las configuraciones de la Geofence.
• El registro aún no se actualizó en la aplicación Mobile - La aplicación tiene "jobs" que efectúan la actualización de la información de 4 en 4 horas. Puede haber ocurrido esta actualización entre los períodos y la información aún no está actualizada. De esta manera, como medida paliativa podrá realizarse la actualización haciendo clic en la Opción Actualizar Empleados de la Aplicación.
• Si existiera el registro, las configuraciones estén ok y se haya realizado la actualización por medio de la opción y aún así este campo queda como "no coordinates", es necesario abrir un ticket para evaluación.

02.5  Sin Coordenadas en el registro - Precisión superior al Parámetro del Settings

Como algunas veces el GPS es impreciso en algunos momentos, ocurren fallas en la obtención de las coordenadas del registro, ya sea en la ubicación o en la información dada a la aplicación Mobile.  En la documentación tenemos más detalles de estas situaciones y sugerencias de cómo mejorar la ubicación y utilización del GPS en los dispositivos.

El Clock in pone a disposición una forma de identificar la cuestión de la precisión del GPS que es el campo "Precisión" que se refiere a la proximidad entre el resultado de una medición y el valor real. El campo Precisión del local del registro se está actualizando en metros. Entones, cuanto menor fuera la cantidad de metros, más preciso es el GPS.

En muchos casos la Precisión es muy alta y eso indica que la ubicación queda muy imprecisa, haciendo que que lo indicado de la geofence quede como "Fuera" siendo que debería ser dentro. En estos casos la Aplicación Mobile no actualiza la coordenada del registro manteniendo el campo sin las coordenadas. 

Para controlar el nivel de precisión que se considerará para que el campo coordenadas venga en blanco, debe configurarse el campo "Precisión mínima de las coordenadas" y debe completarse con un valor en metros. El valor estándar para cuando no se informa es de 500 metros. Esto significa que si la Precisión de la coordenada del registro fuera superior a 500 metros, entonces la coordenada del registro quedará en blanco.

02.6  Sin coordenadas - Nivel del GPS 

Además de la Precisión en el registro tenemos otro indicador para verificar porqué el registro está sin coordenada que es el Nivel GPS. Este campo indica cuál es el estatus en el cual el GPS se encontraba en el momento de la obtención de la coordenada. Esta consulta es posible de realizarse en el Backoffice en la opción "Registros". Es posible seleccionar el campo Nivel GPS en el "Engranaje" de la consulta. A continuación se describe el significado de cada estatus: 

• Cuando el registro está con la coordenada informada:
• 0 - Posición disponible - significa que es posible que el GPS obtenga la ubicación para el registro. La coordenada se actualiza en el registro y la precisión del dispositivo está como Alta precisión.
• Cuando el registro está sin coordenada:
• 0 - Posición disponible y el
• Quando o registro de marcação está com a coordenada informada:
  • 0 - Posição Disponível - significa que foi possível o GPS obter a localização para a marcação. A coordenada é atualizada na marcação e a precisão do dispositivo está como Alta Precisão.
Quando o registro de marcação está sem coordenada:0 - Posição Disponível e o
• campo "Georeferencestate" está como "Empty" - significa que
naquele momento da coleta a obtenção da coordenada ocorreu a mais
• en aquel momento de la recolección, la obtención de la coordenada ocurrió hace más de 10 minutos,
então pode
• entonces puede ser
uma
• una coordenada
inválida. Temos uma segunda tentativa
• no válida. Tenemos un segundo intento de buscar
a
• la coordenada
correta
• correcta para
a marcação
• el registro que
ocorre segundos depois da marcação do funcionário, porém se o aplicativo é fechado logo após a marcação do ponto esse processo pode não ter sido concluído e por isso a marcação fica sem
• ocurre segundos después del registro del empleado, sin embargo, si la aplicación se finaliza inmediatamente después del registro del reloj registrador, este proceso puede no haber sido finalizado y por eso el registro queda sin coordenadas. 
• 1 -
Precisão Baixa (Acuracidade Acima do Limite
• Precisión baja (Precisión superior al límite) - significa que
a precisão do
• la precisión del local está
baixa. Essa situação é possível visualizar através do campo "Acuracidade" que neste campo é maior que o Limite da Precisão informado no
• baja. Esta situación es posible visualizar por medio del campo "Precisión" que en este campo es mayor que el Límite de la precisión informado en el Settings. 
• 2 -
Posição Indisponível
• Posición indisponible - significa que
não foi possível obter o posicionamento pelo
• no es posible obtener la posición por el GPS. 
• 3 -
  Tempo do
•  Tiempo del GPS expirado - significa que
o GPS não conseguiu obter a localização por ter ocorrido um timeout no processo
• el GPS no consiguió obtener la ubicación por haber ocurrido un timeout en el proceso. 
• 4 - Google Play Services
indisponível
• indisponible -
serviço do
• servicio del Google Play
indisponível
• indisponible. 
• 5 -
Serviço
• Servicio de
localização não
• ubicación no está
ativado
• activado - significa que
foi possível obter a localização porém o dispositivo não está com a localização ativada
• es posible obtener la ubicación, sin embargo el dispositivo no está con la ubicación activada.
• Null -
Não disponível na versão, ou seja, a versão do Aplicativo não contém a implementação
• No disponible en la versión, es decir, la versión de la Aplicación no contiene la implementación.

02.5  Utilizar

...

la aplicación WaBis para

...

verificación de las coordenadas:

Para efetuar a conferência para saber se o aplicativo efetuou o cálculo de forma correta normalmente é utilizado o efectuar la verificación para saber si la aplicación efectuó el cálculo de forma correcta, usualmente se utiliza el Google Maps para realizar essa conferência. Porém o Google Maps não tem a mesma fórmula para o cálculo entre duas coordenadas utilizado pelos aplicativo Mobile Android. Então indicamos que seja usado aplicativo esta verificación. Sin embargo el Google Maps no tiene la misma fórmula para el cálculo entre dos coordenadas utilizado por la aplicación Mobile Android. Entonces indicamos que se utilice la aplicación Walter Bislin's Blog-En para realizar a conferência la verificación (http://walter.bislins.ch/bloge/index.asp?page=WGS84+Distance%2C+Azimuth+and+Radius+Calculator).

Segue exemplos Ejemplos de Coordenadascoordenadas:

• -18.6217959, -46.5004788
• -18.622464, -46.501165

A distância entre as duas coordenadas é exibida no La distancia entre las dos coordenadas se muestra en el campo DIST.

Image RemovedImage Added