Políticas basadas en Checks Avanzados
Últ. revisión: 06 ago 2018
Viafirma documents permite agregar políticas basadas en el uso de evidencias electrónicas del tipo Check Avanzado. Resultarán útiles para capturar aceptaciones voluntarias del usuario destacando clásulas o condiciones críticas o de especial importancia, por ejemplo, aquellas cláusulas recomendadas por GDPR, MIFID II, etc.
Podrás agregarlas directamente desde el diseñador visual de politicas para referenciarlas a partir de un identificador único de política, o bien podrás definirla al vuelo en tu servicio consumido vía API.
Uso de Checks Avanzados
Configuración
Consumo vía API
Entre la lista de evidencias disponibles en las políticas debes agregar una evidencia del tipo GENERIC y formatearla a las necesidades de cada caso.
| Atributo | Descripción |
|---|---|
| evidences.type | hasta la fecha están soportadas tres tipos de evidencias: "IMAGE","SIGNATURE","FINGERPRINT y "GENERIC". Para las evidencias del tipo CHECK que nos ocupa en esta documentación usaremos el tipo "GENERIC" |
| evidences.helpText | título de la cláusula o propiedad que queremos definir; se usará en las cabeceras de las ventanas emergentes |
| evidences.helpDetail | subtítulo de la cláusula o propiedad que queremos definir, que podremos usar a modo de "asunto"; se usará en la segunda línea de las cabeceras de las ventanas emergentes |
| evidences.metadalist.providerId | Check |
| evidences.metadalist.requiredValue | Opcional; sólo lo usaremos si queremos forzar un valor en concreto: true o false. En caso de no usar este atributo el usuario podrá marcar o no marcar el check, a su criterio. |
| evidences.metadalist.groupCode | Opcional; se usa para agrupar un conjunto de Checks avanzados dentro de la misma política, mostrándose todos ellos en un mismo pop-up facilitando la marcación múltiple por parte del usuario. |
| evidences.metadalist.groupTitle | Opcional; en caso de usar agrupaciones de ckecks avanzados, y se usa para el título del grupo. |
| evidences.positions | Opcional si se usa "positionsKey"; lista de posiciones en la que imprimiremos la marca "checked" sobre el contenido del PDF. Podemos evitar el uso de posiciones si el PDF cuenta con marcas del tipo Acrofields, en cuyo caso usaremos el atributo positionsKey explicado más abajo. Cada posición debe informar lo siguiente: |
| evidences.positions.rectangle | define el área de la marca a incrustar, indicando posición (x,y) y su tamaño (widht,height) |
| evidences.positions.page | podrás definir hasta tres valores: "0" para imprimirla en todas las páginas, "1" para imprirmirla sólo en la primera página, "-1" para imprimirla sólo en la última y "-2" para imprimir la marca en una página en blanco insertada al final del documento original |
| evidences.typeFormatSign | la evidencia se construye y envuelve en un formato XML, el cual es firmado con certificado digital. Con typeFormatSign definimos el formato de la firma, pudiendo usar los distintos valores: "XADES_B" y "XADES_LTA", este último consume sello de tiempo, el cual debería estar previamente configurado en las propiedades generales del servicio |
| evidences.positionsKey | Opcional si se usan posiciones manuales (ver atributo "positions"); podemos evitar el uso de posiciones si el PDF cuenta con marcas del tipo Acrofields, en cuyo caso usaremos este atributo para indicar el nombre del acroField que usaremos para imprimir la marca "checked" |
| evidences.base64Image | Es opcional, y se usará para indicar la imagen que usaremos como marca "checked", en formato base64. Si no informamos este atributo, la imagen utilizada para la marca checked será la asignada en la configuración del estilo asignado al grupo propietario de la petición. |
Ejemplo de EVIDENCIA PARA CHECKS AVANZADOS
{
"type" : "GENERIC",
"helpText" : "Art. 22.- Uso Datos Biométricos.",
"helpDetail" : "Confidencialidad de los datos biométricos y protección de la información conforme al GDPR.",
"metadataList" : [ {
"key" : "providerId",
"value" : "Check"
}, {
"key" : "text",
"value" : "El tratamiento de los datos personales que resulte de la utilización del sistema de firma digitalizada con datos biométricos cumple y se ajusta a lo dispuesto en el Reglamento (UE) 2016/679 (GDPR). El uso por los clientes del sistema de firma digitalizada con captura de datos biométricos implicará que VIAFIRMA pueda tratar los datos personales consignados a los efectos de la verificación de la firma."
}, {
"key" : "requiredValue",
"value" : "true"
} ],
"typeFormatSign" : "XADES_B",
"positionsKey" : "check_place"
}
nota: el positionsKey "ckeck_place" hace referencia a un Acrofield insertado en el PDF utilizado; en caso de no utilizar acrofields en tus plantillas, la posición del check avanzado se fijará de forma absoluta, sustituyendo el atributo "positionsKey" por el objeto "positions", tal y como se muestra en el siguiente ejemplo:
"positions" : [ {
"rectangle" : {
"x" : 68,
"y" : 415,
"width" : 51,
"height" : 38
},
"page" : 1
} ]
Monta tu propia plantilla
Aquí te dejamos los recursos para que puedas crear tu nueva plantilla basada en esta evidencia y puedas probarla.
results matching ""
No results matching ""