Contenido
KONTROLID – Cédulas es un complemento móvil que ofrece una alternativa robusta y eficiente para la lectura de Códigos PDF417 presente en las cédulas de ciudadanía.
Los Códigos PDF417 son códigos matriciales tipo 2D que se encuentran en el reverso de los documentos de identidad tipo Cédula de Ciudadanía, Tarjetas de Propiedad, Licencias de Conducción, etc.
Un requisito básico para que este complemento funcione de forma eficiente es que el dispositivo Android (Celular o Tableta) donde se instale la aplicación, debe tener una buena cámara que tenga la propiedad de autoenfoque.
El complemento KontroliD – Cédulas se instala en el dispositivo directamente desde la tienda de aplicaciones de Google Play, buscando como kontrolid y seleccionado del listado.
La aplicación sólo se ejecuta desde KontrolID y no tiene ningún efecto si se hace click en el icono de la misma.
Para usarse desde Kontrolid deberá incluir dentro de un formulario en plantilla Excel un grupo con apariencia field-list y en la columna body::intent incluir el llamado al complemento así:
com.kontrolid.pdf417.scanner(token=’xxxxx’,direct='true', camera='true')
A diferencia de otros complementos que se colocan en apariencia y empiezan con ex:com… en este caso cuando va en la columna body::intent va sin éste prefijo ex:
Debido a que la referencia al complemento va en una columna body::intent, sólo es posible diseñar el formulario desde una plantilla de Excel, ya que este valor no es visible desde el editor web.
Otro asunto a considerar es que en este caso también token debe escribirse directamente ya que en body::intent no acepta las referencias como preguntas. O sea token = ${token} no es posible.
Parámetros
Este complemento tiene 3 parámetros o variables de entrada:
token (Obligatorio)
Corresponde a la llave (Contraseña) requerida para que la aplicación se ejecute. Este token es único por cada aplicación u organización, por lo tanto, sólo es necesario incluirlo una vez en el formulario.
Ejemplo de token:
‘E6J5JOLBHaweVI6Rthdld1/hGFMsCbS/sJH76/jbx0YxDhbclGMCn0oHJc/SW5tvOeYedWf04OWHXJ9pl7KpMw’
direct (Opcional)
direct= ‘true’: Si está definido permite que el resultado se entregue directamente a kontrolid sin tener que hacer click en el botón de Enviar.
camera (Opcional)
camera= ‘true’: Si está definido permite que la cámara se active automáticamente para leer el código PDF417.
Dentro del grupo se colocan los parámetros de la cédula que se necesiten recibir. Estos deben ir tal cual como están escritos en la columna name y pueden ir en cualquier orden sólo los que necesite obtener información.
El siguiente es un ejemplo de formulario:
Puede descargar un ejemplo en Excel: Aquí.
En el ejemplo de arriba se hace la activación directa del complemento ya que tiene auto=yes en parameters. Si estuviera vacío o estuviera definido como auto=no, aparecería un botón Iniciar.
Cuando se usa este complemento la primera vez después de la instalación, el sistema Android le pedirá el permiso para acceder a la cámara.
El complemento es muy intuitivo ya que le muestra una máscara con la imagen de un símbolo PDF417 para ubicar allí el código a leer. Si la lectura es exitosa, rellena todos los valores de las preguntas dentro del grupo con la información obtenida. En el caso de la ciudad de nacimiento (munNacCod) trae el código oficial del municipio según la registraduría. En este caso para traer el nombre deberá usar la función pulldata con un archivo csv que contenga los códigos de municipios de la registraduría.
El siguiente video muestra un ejemplo de lectura de cédulas.
Para varias lecturas de cédula en el mismo formulario, se coloca el grupo dentro de un grupo de repetición:
El siguiente es el video que muestra el ejemplo:
- Puede descargar el ejemplo en Excel con varias cédulas Aquí.
