Integración del controlador SDK

El controlador SDK debe estar instalado en el cliente para que la integración con dispositivos que utilizan el SDK se realice correctamente. Este controlador monitoriza la comunicación (online u offline) con todos los dispositivos conectados a él, les envía datos e información y realiza los trámites necesarios para su integración con el sistema.

Para obtener el controlador SDK:

1. Regístrese en la pantalla de inicio de sesiónconductores y seleccione el elementoSDK en el campoTipo de conductor;
2. Luego accede a la pantallaDescargas para descargar este controlador;
3. Descomprima el controlador;
4. Para que el controlador pueda iniciarse y detenerse utilizando los archivos start-service.bat y stop-service.bat, respectivamente, cree este servicio en Windows utilizando el archivo create-service.bat. La ejecución de este archivo .bat debe realizarse como usuario administrador de Windows.

Un controlador SDK también puede requerir el registro de cierta información, según los dispositivos que admitirá. Este registro deberá realizarse en elpropiedades extensibles y luego seleccionado en la pantalla de controladores. Para obtener más información sobre las propiedades requeridas, consulte la documentación del fabricante del dispositivo.

La configuración del controlador se realiza en el archivo config.properties, que se encuentra en el directorio donde se descomprimió el controlador. Este archivo también se puede obtener haciendo clic en el botónDescargar archivo de configuración desde la pantalla del conductor. El archivo ya tiene la configuración predeterminada completada, pero si es necesario cambiar alguno de sus campos, use un editor de texto (el Bloc de notas, por ejemplo) para abrirlo.

Enlaces utilizados por el SDK de Proxy:

• http://sam.senior.com.br/download/driver_sdk/version.properties
• http://sam.senior.com.br/download/driver_sdk/last/SDKProxy.zip
• wss://sam-api.senior.com.br/websocket/pendency
• https://sam-api.senior.com.br/sdk/v1

• puerto.controlador.proxy: puerto que detecta conexiones de controladores;
• sdk.host: dirección de acceso a Ronda senior X seguida del puerto y otros parámetros, que hacen referencia a los complementos de conexión del controlador. Esta información puede cambiarse con la creación de nuevos complementos. El valor predeterminado de esta clave es "https://sam-api.senior.com.br/sdk/v1" y se puede cambiar si Ronda senior X se ejecuta localmente o en un servidor de nube privado;
• tiempo de espera de conexión sdk: tiempo máximo, en milisegundos, que espera el conductor para establecer conexión con el Ronda senior X;
• sdk.request.tiempo de espera: tiempo máximo, en milisegundos, desde el intervalo de consulta pendiente del conductor hasta Ronda senior X. El valor mínimo es 5000 usando websocket, o 10000 sin websocket;
• sdk.api_response.timeout: tiempo máximo, en milisegundos, que el conductor espera respuesta de un servicio solicitado a Ronda senior X;
• sdk.driver0.driver_key: token de conductor (disponible en el registro de conductor). El proxy utiliza este token para identificar al conductor dentro de Ronda senior X. Si no encuentra la clavesdk.driver0.driver_key, el proxy supone que no hay ningún controlador configurado.

El proxy admite la gestión de múltiples controladores, siempre comenzando con la clavesdk.driver0.driver_key, incrementando el índice para encontrar una nueva clave. Por ejemplo,sdk.driver1.driver_key, sdk.driver2.driver_key , y así sucesivamente, hasta que no se encuentre el siguiente índice.

Estas configuraciones se envían a los dispositivos cuando se inicia el controlador SDK y cuando se ejecuta el comando.Configurar dispositivo se envía al sistema.

La información sobre personas, credenciales, ubicaciones y permisos de acceso se envía al dispositivo cada vez que se agrega, cambia o elimina estos datos. Los "permisos de acceso" corresponden a todos los datos que definen si una persona puede acceder a un dispositivo: roles, niveles, franjas horarias y similares. Sólo se envían las personas que tienen acceso permitido en el dispositivo y no están bloqueadas.

Al enviar esta información y configuraciones a los dispositivos, si la comunicación está fuera de línea, estos datos se enviarán en el momento en que se restablezca la comunicación.

Los procedimientos realizados por el controlador SDK (Software Development Kit) quedan registrados en archivosregistro, al que se puede acceder desde la carpeta donde está instalado el controlador. Cada mensaje deregistro tiene una clasificación entre las siguientes:

• FATAL: mensajes que interrumpen el funcionamiento de la aplicación, obligando a reiniciar el servicio o ejecutable;
• ERROR: mensajes de mal funcionamiento de la aplicación, los cuales deben ser analizados por el equipo técnico de Senior, sin embargo, el servicio o ejecutable continúa ejecutándose;
• WARN: mensajes que indican fallo en registros o configuraciones del sistema. Deben ser analizados por el administrador del sistema;
• INFO: mensajes de funcionamiento normal del sistema, como evento recibido, problema pendiente enviado, etc., con fines informativos;
• DEBUG: mensajes sobre el funcionamiento interno de los componentes del sistema (comoTemporizador iniciadas, parámetros leídos, etc.) con fines informativos al equipo técnico Senior. este nivel deregistro sólo debe habilitarse en caso de problemas con el medio ambiente;
• TRACE: mensajes sobre el funcionamiento interno de los componentes del sistema, con detalle de los datos que se están procesando.

Las aplicaciones generan un archivo en la carpeta LOG que contiene los registros deregistro. Al alcanzar los 10 MB, este archivo se comprime automáticamente y se coloca en una carpeta.respaldo, creando un nuevo archivo de registro en la carpeta LOG.

La carpetarespaldo creado cambia su nombre a la fecha actual de compresión del archivo.registro y, al ser cíclico, guarda un máximo de diez archivos asignados, reemplazando el archivo más antiguo cuando hay un archivo nuevo que supera la capacidad máxima.