Certificados

Los certificados son archivos PDF inmutables generados a partir de los datos de una ficha. Diseñas una sola vez un formulario de certificado reutilizable —un fondo en formato PDF o imagen con zonas de datos colocadas— y, después, generas certificados a partir de él para cualquier ficha cuyos datos satisfagan el formulario. Una vez emitido, el certificado es una copia permanente: editar posteriormente la ficha o el formulario nunca cambia un PDF ya emitido.

Quién puede hacer cada cosa

Las vistas previas, las comprobaciones previas y la generación de certificados solo utilizan los campos, los identificadores y los recursos de imagen que tienes permiso para ver. Una ficha compartida no concede acceso a sus recursos privados, y una referencia a un recurso por sí sola no concede permiso para incluirlo.

Las listas, los detalles y las descargas de certificados también respetan la privacidad del archivo PDF. Conocer el ID de un certificado no concede acceso a un PDF privado. Los diseños de formularios de certificado requieren pertenencia vigente al Equipo propietario.

El acceso depende de tu rol en el Equipo activo:

Los administradores del Equipo gestionan los formularios: pueden crearlos, editar el diseño y las vinculaciones de campos, importarlos y archivarlos.
Todos los miembros del equipo pueden explorar los formularios y usar los que estén activos para generar archivos PDF de certificados a partir de los datos de las fichas.

Formularios de certificado

Abre Formularios de certificado desde la barra lateral (/app/certificates/forms). Los formularios son «diseños reutilizables que incorporan datos de las fichas en los PDF de certificados generados». La lista muestra el nombre, el estado, el número de vinculaciones y la última actualización de cada formulario; usa Mostrar archivados para incluir los formularios archivados.

Desde la lista puedes crear un formulario (Nuevo formulario —asígnale un nombre; añadirás el diseño a continuación—), Copiar formulario, Importar la definición de un formulario exportado anteriormente y Archivar o Restaurar un formulario. El estado de un formulario puede ser Activo o Archivado; al generar certificados solo se ofrecen los formularios activos.

El editor de formularios

Al abrir un formulario, se inicia el Editor de formularios de certificado. Un formulario consta de dos elementos:

Un diseño —carga un PDF o una imagen (Cargar diseño (PDF o imagen)) para usarlo como fondo del certificado. Se necesita un diseño antes de poder colocar campos. Si sustituyes el diseño posteriormente, se eliminan todos los campos colocados y sus posiciones; los certificados ya emitidos no se ven afectados.
Campos colocados —zonas que colocas sobre el diseño haciendo clic, cada una vinculada a una fuente de datos.

Para ver valores realistas mientras diseñas, elige un contexto del diseño («Diseñando con»): una ficha (datos reales en la vista previa) o una plantilla de ficha (solo nombres de campos) a partir de la cual crear las vinculaciones. Cambiar de contexto nunca modifica los campos que ya has colocado.

Fuentes de los campos

Cada zona colocada obtiene su valor de una de estas cuatro fuentes:

Campos de la ficha —etiquetas que muestran los campos de la ficha o la plantilla con la que estás diseñando. Los campos ya incluidos en el formulario aparecen marcados, y puedes añadir el nombre de un campo como alias de una zona existente en lugar de volver a colocarlo.
Fuentes del sistema —valores que DICE rellena en el momento de la generación: Nombre de la ficha, Descripción de la ficha, Miniatura de la ficha, UUID de la ficha, Identificadores de la ficha, Fecha de emisión, Nombre del equipo emisor y el nombre, los apellidos y el nombre completo del emisor. Las fuentes del sistema también se pueden asociar como valores alternativos a la zona de un campo y «se utilizan en orden cuando ningún campo de la ficha coincide».
Campo personalizado —introduce un nombre de campo (además de alias opcionales y un tipo) para los datos que el contexto del diseño todavía no muestra.
Texto estático —texto literal que se «imprime exactamente como está escrito, sin obtenerlo de la ficha».

Los tipos de campo son Texto, Número, Fecha, Booleano e Imagen, y una zona puede representarse como Texto sin formato o como un código: QR, Code 128, Code 39 o PDF417. Las zonas tienen posición y tamaño en milímetros, fuente, tamaño, color, alineación, rotación, opacidad y, en el caso de las fechas, un formato de fecha. Las zonas de texto también admiten los estilos negrita, cursiva y subrayado; los controles se aplican a toda la zona.

Cualquier zona QR puede incluir un logotipo central: elige una imagen (PNG, JPEG o WebP) en las propiedades de la zona y DICE la dibujará sobre el centro del código, en un área de relleno del color de fondo de la zona. El tamaño y la posición del logotipo se ajustan automáticamente, y aumenta el nivel de corrección de errores del QR para que el código siga siendo escaneable; no es necesario configurar nada.

Zonas QR de Vlink estables

Añade la fuente del sistema URL de Vlink cuando un certificado necesite un código QR permanente. Puedes colocarla más de una vez. Cada ubicación recibe su propio Vlink cuando se genera el certificado, por lo que dos zonas QR pueden dirigir a destinos diferentes y gestionarse de forma independiente posteriormente.

Durante la generación, DICE muestra una tarjeta de configuración por cada ubicación de Vlink. Cada tarjeta puede dirigir a la página pública de la ficha, utilizar una URL HTTP(S) personalizada o quedarse sin configurar como borrador. La página pública se selecciona de forma predeterminada cuando existe una, pero no es necesaria para las demás ubicaciones. Los códigos QR de la vista previa son representativos y distintos; sus URL permanentes de Vlink solo se crean cuando haces clic en Generar.

Cómo se resuelven los campos: por nombre, no por plantilla

Un formulario no está vinculado a una plantilla de ficha. En el momento de la generación, el nombre y los alias del campo de cada zona se comparan con los nombres de los campos de la ficha sin distinguir entre mayúsculas y minúsculas: «Name», «name» y «NAME» se resuelven como el mismo campo. Cualquier ficha cuyos nombres de campo coincidan puede utilizar el formulario, independientemente de la plantilla que la haya creado, si se utilizó alguna.

Marcar una zona como Obligatoria «impide la generación cuando este valor no se puede resolver». Las zonas no obligatorias simplemente aparecen vacías cuando no hay ninguna coincidencia.

Mientras se selecciona una ficha como contexto del diseño, la vista previa señala las zonas que no se resolverán, con motivos como sin valor, tipo incompatible, ambiguo, no se resolverá o no se puede codificar (en el caso de los formatos de código), y muestra un aviso con los campos obligatorios que «no se resolverán con esta ficha».

Comprobación previa

Cada vez que eliges un formulario para una ficha, DICE ejecuta una comprobación previa: indica cuántos campos obligatorios se resuelven («Se resuelven 3 de 4 campos obligatorios») y ofrece un resultado general de Compatible o No compatible. Los campos satisfechos mediante un alias aparecen marcados con el alias coincidente. La generación solo se permite cuando se supera la comprobación previa.

Generar un certificado para una ficha

Abre la ficha y busca su tarjeta Certificados («Archivos PDF inmutables generados a partir de los datos de esta ficha»).
Haz clic en Generar certificado. En el cuadro de diálogo, elige un formulario de certificado o selecciona ＋ Nuevo formulario a partir de esta ficha… para crear un formulario inicial con los campos de esta ficha.
Revisa el resultado de la comprobación previa del formulario seleccionado con esta ficha.
Si quieres, establece un nombre del certificado: «se muestra en la lista de certificados y se utiliza como nombre del archivo descargado». De forma predeterminada, se usa el nombre del formulario. Si el formulario contiene zonas QR de Vlink, configura cada destino de forma independiente. Haz clic en Vista previa del certificado para inspeccionar primero el PDF generado.
Haz clic en Generar. Si se completa correctamente, verás Certificado emitido, y el certificado aparecerá en la tarjeta con su fecha de emisión.

En la tarjeta, cada certificado ofrece las opciones Descargar (el PDF) y Anular.

Generación por lotes

Para emitir el mismo certificado para muchas fichas a la vez:

En la lista de Fichas, selecciona varias fichas y elige Generar certificados. Se abrirá Generar certificados por lotes (/app/certificates/batch) con tu selección en cola. Cada lote está limitado a 100 fichas.
Selecciona un formulario de certificado. DICE realiza una comprobación previa de cada ficha en cola y marca cada una como Conforme, No conforme (con una lista de los campos que faltan) o No visible (no puedes ver esa ficha en este contexto). Utiliza la acción de volver a comprobar después de corregir los datos de la ficha.
Haz clic en Emitir N conformes. Los certificados se «emiten de uno en uno»; cada fila pasa por Emitiendo… → Emitido o Error.
Después, utiliza Reintentar N con errores para los errores, elimina filas con Quitar del lote y usa Exportar CSV para obtener un registro de la ejecución.

Anular un certificado

Los certificados emitidos no se pueden editar ni eliminar, pero se pueden anular. «La anulación indica que ya no se debe considerar válido el certificado. El PDF y su hash no cambian».

En la tarjeta Certificados de la ficha, haz clic en Anular junto al certificado.
Elige un Motivo: Emitido por error, Datos incorrectos de la ficha, Formulario equivocado, Certificado duplicado u Otro.
Si quieres, añade una Nota interna (privada) y, después, confirma con Anular.

Los certificados anulados permanecen en la lista marcados como Anulados y se pueden seguir descargando para tus registros.

Consejos sobre el ciclo de vida de los formularios

Archivar retira un formulario sin afectar a los certificados ya emitidos a partir de él; Restaurar vuelve a habilitarlo. Los formularios archivados no aparecen en el cuadro de diálogo de generación.
Copiar formulario duplica un formulario (incluidos su diseño y sus vinculaciones) para que puedas seguir trabajando en él sin alterar el original.
Exporta un formulario desde el editor e impórtalo desde la lista de formularios para trasladar un diseño entre Equipos; un formulario debe tener un diseño y un nombre para poder exportarse.

Fichas —los datos a partir de los cuales se generan los certificados
Primeros pasos —orientación para usuarios nuevos
Preguntas frecuentes —disponibilidad de módulos y resolución de problemas

Informar de un problema en la documentación