Totvs Clock In - Espanhol

Árvore de páginas


01. VISIÓN GENERAL


Este documento tiene como objetivo orientar sobre los puntos de atenció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: 

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

Para que el proceso de Geofence funcione de forma 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 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 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 02.2

Para validar 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 y Location.

Para cada Data Model es posible extraer un Excel en el Explore, accediendo "..." en el canto superior derecho de la consulta, después seleccionado "Exporte y por último seleccionar "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 registro.

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

Para que se efectúe el control de la Geofence de forma correcta es necesario validar las siguientes configuraciones:

  • Configuración por Empresa:
    • El campo "Geofence: Nivel: Empresa" del Settings del Backoffice debe estar habilitado 
    • El RCPJ + CEI/CNO de la Empresa debe estar vinculado al dispositivo 
    • El usuario conectado al dispositivo debe estar con el campo Habilitar Geofence Empresa 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 RCPJ/CEI de la empresa vinculado al dispositivo para buscar las informaciones de direcciones registradas. 
  • Configuración Ubicación:
    • El campo "Geofence: Nivel: Ubicación" del Settings del Backoffice debe estar habilitado
    • el campo Código 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. 

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 Data Model Clock in Records, campo "Employee Geofence Coordinates (Optional)".

Este campo muestra las coordenadas que se utilizaron para comparar 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 Data Model "Clock in Records" . A partir 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álisis:

  • company: 
    • Cuando existe contenido en los corchetes, significa que existe registro de la coordenada de la empresa y el usuario del registro está configurado para controlar Geofence por Empresa. Ej: ,"company":[{"geofence":{"x":-13.355368,"y":-39.055994},"deviceCoordinate":{"x":-13.3549346,"y":-39.0561692},"radius":600,"distance":51.56814956665039,"transition":"enter"}
    • 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:
    • Si existiera contenido en los corchetes, significa que existe registro de la coordenada en el empleado y el empleado está habilitado para el control de la Geofence. Ej: ,"employee":[{"geofence":{"x":-13.355368,"y":-39.055994},"deviceCoordinate":{"x":-13.3549346,"y":-39.0561692},"radius":600,"distance":51.56814956665039,"transition":"enter"}
    • 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:
    • Si existiera contenido en los corchetes, significa que existe 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"}
    • 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:
    • El contenido en las claves es referente a la coordenada del registro
  • deviceCoordinate:
    • El contenido en las claves es referente a la(s) coordenada(s) encontrada(s) en el registro dependiendo de la configuración:
      • Si fuera company, significa que la información es del registro de empresa vinculado a la empresa del dispositivo.
      • Si fuera location, significa que la(s) información(es) es(son) del registro de ubicación vinculado a la ubicación del dispositivo
      • Si fuera employee, significa que la(s) información(es) es(son) 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(s) coordenada(s) encontrada(s). Siempre debe ser menor que el radio para considerar como dentro de la geofence
  • transition: puede ser "exit" que significa "fuera de la cerca" o "enter" que significa "dentro de la cerca". Si hubiera por lo menos una coordenada como "enter" significa que se encontró una ubicación donde el registro fue realizado "dentro de la cerca", entonces el registro se considerará como "dentro de la cerca" (en el registro de DM Clock in Records la columna "is user inside" será igual a "1").

 

Si la aplicación no consigue encontrar las coordenadas este campo queda como "no coordinates". Esta situación puede significar los siguientes casos:

  • 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 campo "Georeferencestate" está como "Empty" - significa que en aquel momento de la recolección, la obtención de la coordenada ocurrió hace más de 10 minutos, entonces puede ser una coordenada no válida. Tenemos un segundo intento de buscar la coordenada correcta para el registro que 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 - Precisión baja (Precisión superior al límite) - significa que la precisión del local está 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 - Posición indisponible - significa que no es posible obtener la posición por el GPS. 
    • 3 - Tiempo del GPS expirado - significa que el GPS no consiguió obtener la ubicación por haber ocurrido un timeout en el proceso. 
    • 4 - Google Play Services indisponible - servicio del Google Play indisponible. 
    • 5 - Servicio de ubicación no está activado - significa que es posible obtener la ubicación, sin embargo el dispositivo no está con la ubicación activada.
    • Null - 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 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 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 la verificación (http://walter.bislins.ch/bloge/index.asp?page=WGS84+Distance%2C+Azimuth+and+Radius+Calculator).

Ejemplos de coordenadas:

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

La distancia entre las dos coordenadas se muestra en el campo DIST.