Histórico da Página

Este documento apresenta a funcionalidade Este documento presenta la funcionalidad Geofence (Cerca Virtual) e demonstra como efetuar a configuraçãovirtual) y muestra cómo efectuar la configuración. 

Geofence consiste em indicar uma restrição nas marcações se o funcionário estiver fora do perímetro permitido do endereço. As marcações não serão rejeitadas caso ele esteja fora do perímetro informado. As ações deverão ser tomadas no sistema de RH utilizado pelo en indicar una restricción en los registros si el empleado estuviera fuera del perímetro permitido de la dirección. Los registros no se rechazarán si este estuviera fuera del perímetro informado. Las acciones deben tomarse en el sistema de RRHH utilizado por el cliente.

O Geofence pode puede ser configurado de três formastres maneras:

• Endereço da Dirección de la empresa: Baseado na empresa ligado ao
• Basado en la empresa conectada al dispositivo, TOTVS
RH
• RRHH Clock-In
vai fazer a notação se a marcação ocorrer fora do
• va a observar si el registro ocurre fuera del perímetro configurado.
Endereço do funcionário:Baseado no endereço do funcionário do usuário logado no
• Dirección del empleado:
• Basado en la dirección del empleado del usuario conectado en el dispositivo, TOTVS
RH
• RRHH Clock-In
vai indicar se a marcação ocorrer fora do
• indicará si el registro ocurriera fuera del perímetro configurado.
• Locais Locales de acessoacceso:
• Os locais de acesso permitem definir endereços e geolocalizações habilitados para a localização em questão, e o dispositivo possui um local que ele pertence. Baseado nesses dados, TOTVS RH Clock-In vai fazer a notação se a marcação ocorrer fora dos perímetros configurado.

A seguir será apresentado os detalhes da configuração.

02. CONFIGURAÇÃO DA CERCA VIRTUAL

A configuração do Geofence pode ocorrer de três formas, definindo a localização baseado na localização da empresa, na localização residencial e outras localizações do funcionário ou através de locais específicos. Abaixo segue o detalhe dessas configurações:

Settings do Backoffice:

• Los locales de acceso permiten definir direcciones y geolocalizaciones habilitadas para la referida ubicación, y el dispositivo tiene un local al cual este pertenece. Basado en estos datos, TOTVS RRHH Clock-In realizará la observación si el registro ocurriera fuera de los perímetros configurados.

A continuación se muestran los detalles de la configuración.

02. CONFIGURACIÓN DE LA CERCA VIRTUAL

La configuración del Geofence puede ocurrir de tres maneras, definiendo la ubicación basada en la localización de la empresa, en la ubicación residencial y otras ubicaciones del empleado o por medio de lugares específicos. A continuación se muestran detalles de estas configuraciones:

Settings del Backoffice:

Las configuraciones de Geofence se inician en el Settings del Backoffice donde debe definirse qué reglas que se seguirán para el uso de la Cerca virtual. Para acceder a las configuraciones de Geofence basta acceder As configurações da Geofence se iniciam no Settings do Backoffice onde deverá ser definido quais as regras que serão seguidas para o uso da Cerca Virtual. Para acessar as      configurações da Geofence basta acessar a Plataforma Carol > Carol Apps > Backoffice. Na tela principal do Backoffice na Plataforma Carol deverá se selecionada a pasta Settings que contém todas as configurações do Clockin. Abaixo os campos e qual o En la pantalla principal del Backoffice en la Plataforma Carol debe seleccionarse la carpeta Settings que contiene todas las configuraciones del Clockin. A continuación se muestran los campos y cuál es el objetivo de cada campo de configuraçãoconfiguración:

• Geofence Nível Nivel Empresa:  al habilitar este campo quando habilitado indica que o ambiente irá utilizar Cerca Virtual por Empresa ou seja baseado no endereço da empresa ligado ao dispositivo onde está sendo efetuada a marcação
• Geofence Nível Empregado: este campo quando habilitado indica que o ambiente irá utilizar Cerca Virtual por Funcionário ou seja os endereços para considerar o perímetro da cerca serão considerados os cadastrados no cadastro de funcionário que está efetuando a marcação
• Geofence Nível Localização: este campo quando habilitado indica que o ambiente irá utilizar Cerca Virtual por Localização ou seja baseado no endereço da localização associada ao dispositivo onde está sendo feita a marcação.
• Geofence Raio Empresa: informar o raio que deve ser considerado para que o funcionário seja indicado como dentro da cerca. O valor desse campo é considerado em metros. Por exemplo se for informado 800 o Clockin irá considerar a marcação como feita dentro de cerca caso o funcionário tenha a efetuado no limite do raio de 800 metros considerando os endereços válidos para a empresa do dispositivo.
• Geofence Raio Empregado: informar o raio que deve ser considerado para que o funcionário seja indicado como dentro da cerca. O valor desse campo é considerado em metros. Por exemplo se for informado 800 o Clockin irá considerar a marcação como feita dentro de cerca caso o funcionário tenha a efetuado no limite do raio de 800 metros considerando os endereços válidos para o funcionário que está efetuando a marcação.
• Geofence: Mensagem Comprovante: informar aqui a mensagem que irá ser demonstrada tanto no aplicativo mobile e no comprovante de marcação quando o dispositivo estiver fora do perímetro considerado para a cerca
• Geofence Validação:
  • Desabilitado: quando informado não efetua a validação de cerca nas marcações
  • Rótulo: quando informado cria um rótulo na marcação indicando se ela está dentro ou fora de cerca conforme configuração
• Geofence: Validar coordenadas: quando este parâmetro estiver habilitado, o app irá validar se há coordenadas para geofence e caso não haja, a marcação será considerada fora da cerca virtual. Quando este parâmetro não estiver habilitado, o app irá considerar a marcação dentro da cerca virtual quando não há coordenadas.

A partir desse momento usuários ou funcionários poderão ser habilitados para utilizar as regras de Cerca Virtual da seguinte forma:

Cadastro de Funcionário:

• No cadastro de funcionário existe o campo "Geofence" onde para habilitar esse campo é necessário que o ambiente tenha o campo "Geofence Nível Empregado" no Settings habilitado. Quando esse funcionário efetuar a marcação de ponto o aplicativo mobile irá verificar qual a geolocalização atual do funcionário e comparar com os endereços cadastrados no registro desse funcionário considerando o valor do raio informado no campo "Geofence Raio Empregado" informado no Settings.

Cadastro de Usuário:

No cadastro de usuários existem 2 campos:

• Habilitar o nível de empresa da cerca geográfica: para habilitar esse campo é necessário que o campo Geofence Nível Empresa do Settings esteja marcado. Quando o funcionário efetuar a marcação no dispositivo relacionado a empresa, o aplicativo mobile irá verificar qual a geolocalização atual do funcionário e compara com o endereço da empresa + cei informado relacionados ao dispositivo, considerando o valor do raio informado no campo "Geofence Raio Empresa" informado no Settings.   
• Habilitar o nível de localização da cerca geográfica: para habilitar esse campo é necessário que o campo Geofence Nível Localização do Settings esteja marcado. Quando o funcionário efetuar a marcação no dispositivo, o aplicativo mobile irá verificar qual a geolocalização atual do funcionário e compara com os endereços da localização. relacionada ao dispositivo, considerando para cada endereço o raio informado para calcular se está dentro ou fora de cerca.  

03. CADASTROS DE ENDEREÇOS PARA A CERCA VIRTUAL

Após as configurações efetuadas no item 2 desta documentação o próximo passo e a realização dos cadastros das cercas conforme o passo a passo abaixo:

     Cadastro de Empresa:

• el entorno utilizará Cerca virtual por empresa, es decir basado en la dirección de la empresa conectada al dispositivo donde se está efectuado el registro
• Geofence Nivel Empleado: al habilitar este campo indica que el entorno utilizará Cerca virtual por empleado, es decir las direcciones para considerar el perímetro de la cerca se basarán en el registro del empleado que está efectuando el registro
• Geofence Nivel Ubicación: al habilitar este campo indica que el entorno utilizará Cerca virtual por ubicación, es decir basado en la dirección de la ubicación vinculada al dispositivo donde se está realizando el registro.
• Geofence Radio Empresa: informe el radio que debe considerarse para que se indique al empleado como dentro de la cerca. El valor de este campo se considera en metros. Por ejemplo si se informara 800 el Clockin considerará el registro como realizado dentro de la cerca si el empleado lo hubiera efectuado en el límite del radio de 800 metros considerando las direcciones válidas del dispositivo para la empresa.
• Geofence Radio Empleado: informe el radio que debe considerarse para que se indique el empleado como dentro de la cerca. El valor de este campo se considera en metros. Por ejemplo si se informara 800 el Clockin considerará el registro como realizado dentro de la cerca si el empleado lo hubiera efectuado en el límite del radio de 800 metros considerando las direcciones válidas del dispositivo para el empleado que está efectuando el registro.
• Geofence: Mensaje comprobante: informe aquí el mensaje que se mostrará tanto en la aplicación mobile y en el comprobante de registro cuando el dispositivo estuviera fuera del perímetro considerado para la cerca
• Geofence Validación:
• Deshabilitado: al informarse no efectúa la validación de cerca en los registros
• Rótulo: al informarse crea un rótulo en el registro indicando si este está dentro o fuera de la cerca de acuerdo con la configuración
• Geofence: Validar coordenadas: si este parámetro estuviera habilitado, el app validará si existen coordenadas para geofence y si no hubiera, el registro se considerará fuera de la cerca virtual. Si este parámetro no estuviera habilitado, el app considerará el registro dentro de la cerca virtual si no hubiera coordenadas.

A partir de este momento los usuarios o empleados podrán ser habilitados para utilizar las reglas de Cerca virtual de la siguiente manera:

Registro de empleados:

• En el registro de empleados existe el campo "Geofence" donde para habilitar este campo es necesario que el entorno tenga habilitado el campo "Geofence Nivel Empleado" en el Settings. Cuando este empleado efectúe el registro de reloj registrador, la aplicación mobile verificará cuál es la geolocalización actual del empleado y comparar con las direcciones registradas en el registro de este empleado considerando el valor del radio informado en el campo "Geofence Radio Empleado" informado en el Settings.

Registro de usuarios:

En el registro de usuarios existen 2 campos:

• Habilitar el nivel de empresa de la cerca geográfica: para habilitar este campo es necesario que el campo Geofence Nivel Empresa del Settings esté marcado. Cuando el empleado efectúe el registro en el dispositivo vinculado a la empresa, la aplicación mobile verificará cuál es la geolocalización actual del empleado y compara con la dirección de la empresa + cei informado vinculados al dispositivo, considerando el valor del radio informado en el campo "Geofence Radio Empresa" informado en el Settings.
• Habilitar el nivel de ubicación de la cerca geográfica: para habilitar este campo es necesario que el campo Geofence Nivel Ubicación del Settings esté marcado. Cuando el empleado efectúe el registro en el dispositivo, la aplicación mobile verificará cuál es la geolocalización actual del empleado y compara con las direcciones de la ubicación, vinculada al dispositivo, considerando para cada dirección el radio informado para calcular si está dentro o fuera de la cerca.  

03. REGISTROS DE DIRECCIONES PARA LA CERCA VIRTUAL

Después de las configuraciones efectuadas en el ítem 2 de esta documentación, el próximo paso es la realización de los registros de las cercas de acuerdo con el siguiente paso a paso:

     Registro de Empresa:

• Al efectuar el registro de dirección es necesario que la empresa informe la dirección completa, es decir, nombre de la calle, número, barrio, ciudad, estado/prov/reg, CP y país de las empresas. La dirección se complementa a medida que se informa.
• Es posible informar una dirección para cada empresa
• La geolocalización (latitud y longitud) también podrá informarse en el formato del ejemplo
• Ao efetuar o cadastro de endereço é necessário da empresa informar o endereço completo, ou seja nome da rua, número, bairro , cidade, estado, CEP e país das empresas. O endereço é complementado a medida que é informado.
• É possível informar um endereço para cada empresa
• A geolocalização (latitude e longitude) também poderá ser informada no formato conforme o exemplo: -23.60583026146627, -47.2106922265625.
• O El dispositivo considera a la empresa ligada ao conectada al dispositivo (valores de CNPJ e RCPJ y CEI).

...

 Registro del empleado:

• Al efectuar el registro de dirección del empleado es necesario informar la dirección completa, es decir nombre de la calle, número, barrio, ciudad, estado/prov/reg, CP y país. La dirección se complementa a medida que se informa.
• Si el entorno tiene integración con el ERP RM y tiene habilitado el campo "Habilitar dirección(es) de los empleados" en el Settings, la dirección del empleado se integra al registro del empleado con el tipo como "Default". Si el entorno no debe integrar la dirección del empleado en el entorno, entonces este campo debe deshabilitarse. 
• La geolocalización (latitud y longitud) también podrá informarse en el formato del ejemplo
• Ao efetuar o cadastro de endereço do funcionário é necessário informar o endereço completo, ou seja nome da rua, número, bairro, cidade, estado, CEP e país. O endereço é complementado a medida que é informado.
• Se ambiente possui integração com ERP RM e possui o campo "Habilitar endereço(s) dos empregados" habilitado no Settings, o endereço do funcionário é integrado no cadastro do funcionário com o tipo como "Default". Caso o ambiente não deva integrar o endereço do funcionário no ambiente então este campo deverá ser desabilitado. 
• A geolocalização (latitude e longitude) também poderá ser informada no formato conforme o exemplo: -23.60583026146627, -47.2106922265625.

...

 Ubicaciones:

• Ao efetuar o cadastro de endereços da localização é necessário informar o endereço completo, ou seja nome da rua, número, bairro, cidade, estado, CEP e país. O endereço é complementado a medida que é informado.
• Possível informar vários endereços (completos).
• Possível informar várias localizações por latitude x longitude.
• Cada endereço ou  geolocalização recebe um valor de raio.
• Ao efetuar o de reconhecimento do Dispositivos é necessário informar a localização que será considerada para o dispositivo para o controle de cerca virtual

• Al efectuar el registro de direcciones de la ubicación, es necesario informar la dirección completa, es decir nombre de la calle, número, barrio, ciudad, estado/prov/reg, CP y país. La dirección se complementa a medida que se informa.
• Es posible informar varias direcciones (completas).
• Es posible informar varias ubicaciones por latitud vs. longitud.
• Cada dirección o geolocalización recibe un valor de radio.
• Al efectuar el reconocimiento de Dispositivos es necesario informar la ubicación que se considerará en el dispositivo para el control de cerca virtual

04.

...

UTILIZACIÓN DE REGLAS AGRUPADAS

05. GEOFENCE

...

EN LA APLICACIÓN MOBILE

Uma vez feito as configurações anteriores, é possível verificar marcações dentro e fora da Una vez realizadas las configuraciones anteriores, es posible verificar registros dentro y fuera de la cerca virtual. Para isso, você deve se deslocar dentro e fora da ello, debe desplazarse dentro y fuera del área anteriormente especificada.

Imagem demonstrando a mensagem que o aplicativo demonstra quando o dispositivo está num local fora da Imagen presentando el mensaje que la aplicación muestra cuando el dispositivo está en un lugar fuera de la cerca virtual, assim como também demonstra um ícone no botão de confirmação que a marcação está fora de cerca. A marcação é permitida mas será sinalizada como fora da así como también muestra un ícono en la opción de confirmación que el registro está fuera de la cerca. El registro se permite pero se señalará como fuera del área de Geofence (Cerca virtual).

06.

...

CONSULTA DE DATOS EN EL BACKOFFICE

Los registros realizados dentro o fuera del Geofence pueden consultarse y filtrarse en el mapa de registros del Backoffice. Para mostrar el campo en la consulta de registros en el "Engranaje" para la inclusión de campos en la consulta es posible seleccionar el As marcações realizadas dentro ou fora do Geofence podem ser consultadas e filtradas no mapa de marcações do Backoffice. Para demonstrar o campo na consulta de marcações na "Engrenagem" para a inclusão de campos na consulta é possível selecionar o campo "Geofence" para que seja demonstrada uma coluna contendo a informação se a marcação se muestre una columna con la información si el registro está "Dentro" ou o "ForaFuera" do del perímetro informado. 

Também é possível realizar um filtro pelo También es posible realizar un filtro por el campo "Geofence" através da opção por medio de la opción de filtro "Consulta Avançadaavanzada". Basta selecionar o seleccionar el campo "0: geocerca desativadadesactivada, 1: dentro da de la geocerca, 2: fora da fuera de la geocerca" e informar no en el campo o el tipo de informação información que deseja informar conforme o descritivo do desea informar de acuerdo con la descripción del campo. 

07.

...

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 en los entornos:

• Es necesario que el entorno tenga integración para limpieza de direcciones. Este es un servicio estándar en la

...

Abaixo é listado alguns pontos de atenção na configuração do Geofence nos ambientes:

• É necessário que o ambiente tenha integração para limpeza de endereços. Este é um serviço padrão na plataforma Carol, para validar que esta tudo todo está configurado corretamente, você deve abrir a correctamente, abra la lista de Data Model e verificar o ícone y verifique el ícono de "Globo" nos en los data models Company, Employee, e y Location:
• Os endereços dos funcionários e empresas devem possuir a geolocalização (latitude e longitude). Esses valores são atribuídos automaticamente pela plataforma durante o processamento dos dados, caso o parâmetro especificado no item anterior esteja ativado.
• Verifique se o usuário não possui uma configuração especial quanto aos modos do Geofence. Caso ele tenha algo informado, este sobrescreverá as configurações do ambiente.
• Las direcciones de los empleados y empresas deben tener la geolocalización (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 anterior estuviera activado.
• Verifique si el usuario no tiene una configuración especial con respecto a los modos de Geofence. Si este tuviera algo informado, este sobrescribirá las configuraciones del entorno.
• Verifique la conexión entre los datos para obtención de las direcciones y locales (geolocalizacionesVerifique a conexão entre os dados para obtenção dos endereços e locais (geolocalizações):

• Dispositivo: O El dispositivo permite o acesso à el acceso a la empresa (taxID + CEI) e aos locais de acesso y a los locales de acceso (locationCode).
• Usuário Logado: O usuário logado permite o acesso ao funcionário (através do Usuario conectado: El usuario conectado permite el acceso al empleado (por medio del atributo personID que simboliza o CPFel RCPF). Desta forma obtém-se o registro de funcionário relacionado ao usuário logado. Contratos desligados são ignorados. Mais detalhes na conexão entre usuário e funcionário está descrito nesta página: 4. Dicas utilização De esta manera se obtiene el registro del empleado vinculado al usuario conectado. Contratos desvinculados son ignorados. Más detalles en la conexión entre usuario y empleado está descrito en esta página: 4. Sugerencias de utilización Clock-In

08.

...

APLICACIÓN PARA VERIFICACIÓN DE LAS GEOLOCALIZACIONES

Para efectuar la verificación para saber si la aplicación efectuó el cálculo de forma correcta, usualmente se utiliza el

...

Para efetuar a conferência para saber se o aplicativo efetuou o cálculo de forma correta normalmente é utilizado o 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.