Campos Personalizados

Última revisión: 11 Agosto 2020

Se trata de configuración genérica que podrá usarse para distintos propósitos a nivel de grupo. Su uso está basado en parámetros de configuración compuestos por pares “clave/valor”, que podrán ser añadidos manualmente o bien importados desde fichero de importación basado en excel y cuya plantilla podrás descargar desde la propia pantalla de configuración.

Solo un ADMIN global podrá añadir campos “privados”, no visibles para usuarios ADMIN-GROUP. Para ello el ADMIN global solo tendrá que marcar el check “Admin” durante la creación del campo personalizado.

¿Cómo se añaden campos personalizados?

CLAVE: siempre debes indicar una clave en mayúsculas, y no debes usar espacios en blanco, tildes ni otros signos de puntuación o caracteres distintos a números y letras. Por ejemplo: “COD_DEPARTAMENTO”.
VALOR: podrás indicar el valor que corresponda y necesites para cada caso, teniendo en cuenta que para CLAVES internas de sistema el valor que necesitas usar debe ser explícitamente el que se indique en cada caso para conseguir una funcionalidad específica.
Admin: solo un usuario con rol ADMIN global verá un check “Admin” junto al botón “Añadir”. Si lo activa, ese campo personalizado quedará oculto para los usuarios administradores del grupo. Esta propiedad se suele usar para importar campos personalizados asociados a una configuración explícita del sistema que deba aplicarse solo a nivel de grupo. Por ejemplo, se podría utilizar para registrar las credenciales API de las integraciones con otros productos de la suite Viafirma, como Inbox o Fortress.

NOTA: consulta cuáles son las claves internas de sistema para conocer qué funcionalidades extra puedes automatizar.

¿Dónde puedo usar un campo personalizado?

Podrás hacer uso del campo personalizado como una variable dinámica a definir en los distintos puntos de configuración del sistema utilizando el prefijo SYS_GROUP_, tal y como te explicamos en los siguientes ejemplos.

Uso de campos personalizados en plantillas

Título y Descripción:, por ejemplo:

Contrato de alta asociado al departamento {{SYS_GROUP_COD_DEPARTAMENTO}}.

Notificaciones: en cualquiera de las configuraciones disponibles para todo el ciclo de vida de notificaciones del documento, por ejemplo:

Hola {{cliente}}, aquí tienes el contrato emitido por el departamento {{SYS_GROUP_COD_DEPARTAMENTO}} listo para su revisión y firma.

Políticas: cualquier evidencia, firma, adjunto o aprobación que permita incluir textos de ayuda podrán incluir variables dinámicas, y también variables asociadas a campos personalizados de grupo. Por ejemplo, en la firma desatendida con certificado digital se podría incluir el siguiente texto:

Aprobado por el departamento {{SYS_GROUP_COD_DEPARTAMENTO}}.

Configuración: podrás incluir campos personalizados de grupo como variables dinámicas en distintos elementos de configuración a nivel de plantilla, por ejemplo, definir la URL a la que se hará una petición POST una vez finalizada la operación de firma = ``````.

En ejemplo anterior, para un supuesto grupo “G1”, todas las plantillas asignadas a dicho grupo podría incluir en su configuración una URL de respuesta automática al CRM de la compañía. Y de esta forma, el “editor” de la plantilla no tendría que conocer cuál es exactamente el valor del la URL, solo tendría que indicar el campo personalizado, que haría uso del valor indicado por su administrador.

Funcionalidades específicas

Podrás hacer uso de campos personalizados especiales para activar ciertas funcionalidades en tu grupo. A continuación te listamos algunas de ellas:

CUSTOM_LOGO_TITLE=My Title Logo
CUSTOM_LOGO_URL=http://mycustomlogo.png
MAIL_CALLBACK_ATTACHMENT_AUDIT=true
MAIL_CALLBACK_ATTACHMENT_PDF=true

Configuración de integraciones con otras aplicaciones de la suite de Viafirma

Aquí podrás incluir parámetros de configuración de otras aplicaciones de Viafirma, como Viafirma Inbox o Viafirma Fortress, por ejemplo, credenciales API o código de worfklows.

Configuración de integraciones con Terceros

Si tu grupo hace uso de evidencias electrónicas que hacen uso de servicios externos como CIFIN, LISIM, Experian, Gradiant, Addalia, Rubricall, etc., aquí podrás agregar la parametrización necesaria y que te haya facilitado el proveedor. Para cada caso deberás usar el nombre del propiedad que te hayan confirmado debas usar. Consulta cuál es tu caso y recibirás información detallada.

Viafirma Inbox

inboxAddresses
inbox.apikey
inbox.apipass
inbox.crm.callback
inbox.crm.callback.authorization
inbox.crm.process
INBOXID
InboxId2
inbox.notificationUrl
inbox.restApiPathBase
inboxStampID
SenderIdInbox

LISIM (Colombia)

LISIM_SERVICE_URL=https://yourserviceprovider.com