Certificats

Les certificats sont des PDF immuables générés à partir des données d’une fiche. Vous concevez une seule fois un formulaire de certificat réutilisable — un arrière-plan PDF ou image comportant des zones de données positionnées — puis vous l’utilisez pour générer des certificats pour toute fiche dont les données répondent aux exigences du formulaire. Une fois délivré, un certificat constitue une copie permanente : toute modification ultérieure de la fiche ou du formulaire ne change jamais un PDF déjà délivré.

Qui peut faire quoi

Les aperçus de certificat, les vérifications préalables et la génération utilisent uniquement les champs, les identifiants et les ressources d’image que vous êtes autorisé à consulter. Le partage d’une fiche n’accorde pas l’accès à ses ressources privées, et une simple référence à une ressource n’accorde pas l’autorisation de l’intégrer.

Les listes de certificats, leurs détails et leurs téléchargements respectent également la confidentialité du fichier PDF. Connaître l’ID d’un certificat n’accorde pas l’accès à un PDF privé. La conception des formulaires de certificat exige une appartenance actuelle à l’équipe propriétaire.

L’accès dépend de votre rôle dans l’équipe active :

Les administrateurs d’équipe gèrent les formulaires : création, modification du modèle et des liaisons de champs, importation et archivage.
Tous les membres de l’équipe peuvent parcourir les formulaires et utiliser ceux qui sont actifs pour générer des certificats PDF à partir des données des fiches.

Formulaires de certificat

Ouvrez Formulaires de certificat depuis la barre latérale (/app/certificates/forms). Les formulaires sont des « modèles réutilisables qui intègrent les données d’une fiche aux certificats PDF générés ». La liste affiche le nom, le statut, le nombre de liaisons et la date de dernière mise à jour de chaque formulaire ; utilisez Afficher les formulaires archivés pour inclure les formulaires archivés.

Depuis la liste, vous pouvez créer un formulaire (Nouveau formulaire — donnez-lui un nom ; vous ajouterez ensuite le modèle), Copier le formulaire, Importer une définition de formulaire précédemment exportée, ainsi qu’Archiver ou Restaurer un formulaire. Le statut d’un formulaire est soit Actif, soit Archivé — seuls les formulaires actifs sont proposés lors de la génération.

L’éditeur de formulaires

L’ouverture d’un formulaire lance l’éditeur de formulaires de certificat. Un formulaire comporte deux éléments :

Un modèle — téléversez un PDF ou une image (Téléverser le modèle (PDF ou image)) à utiliser comme arrière-plan du certificat. Un modèle est requis avant de pouvoir positionner des champs. Le remplacement ultérieur du modèle supprime tous les champs positionnés ainsi que leurs positions ; les certificats déjà délivrés ne sont pas affectés.
Des champs positionnés — des zones que vous placez sur le modèle en cliquant, chacune étant liée à une source de données.

Pour afficher des valeurs réalistes pendant la conception, choisissez un contexte du modèle (« Concevoir à partir de ») : soit une fiche (données d’aperçu réelles), soit un modèle de fiche (noms de champs uniquement) pour initialiser les liaisons. Changer de contexte ne modifie jamais les champs que vous avez déjà positionnés.

Sources des champs

Chaque zone positionnée extrait sa valeur de l’une des quatre sources suivantes :

Champs de la fiche — pastilles répertoriant les champs de la fiche ou du modèle à partir duquel vous concevez le formulaire. Les champs déjà couverts par le formulaire sont signalés, et vous pouvez ajouter le nom d’un champ comme alias à une zone existante au lieu de le positionner à nouveau.
Sources système — valeurs que DICE renseigne lors de la génération : Nom de la fiche, Description de la fiche, Miniature de la fiche, UUID de la fiche, Identifiants de la fiche, Date de délivrance, Nom de l’équipe émettrice, ainsi que le prénom, le nom de famille et le nom complet de l’émetteur. Les sources système peuvent également être associées à une zone de champ comme valeurs de secours, « utilisées dans l’ordre lorsqu’aucun champ de la fiche ne correspond ».
Champ personnalisé — saisissez un nom de champ (ainsi que des alias facultatifs et un type) pour les données qui ne figurent pas encore dans le contexte du modèle.
Texte statique — texte littéral, « imprimé exactement tel qu’il est écrit — sans être extrait de la fiche ».

Les types de champs sont Texte, Nombre, Date, Booléen et Image, et une zone peut être rendue sous forme de Texte brut ou de code : QR, Code 128, Code 39 ou PDF417. Les zones possèdent une position et une taille en millimètres, une police, une taille de police, une couleur, un alignement, une rotation, une opacité et, pour les dates, un format de date. Les zones de texte acceptent également les styles gras, italique et souligné — ces options s’appliquent à l’ensemble de la zone.

Toute zone QR peut comporter un logo central : choisissez une image (PNG, JPEG ou WebP) dans les propriétés de la zone, et DICE la dessine au centre du code sur une marge de la couleur d’arrière-plan de la zone. La taille et la position du logo sont définies automatiquement, et le niveau de correction d’erreur du QR augmente afin que le code reste lisible par scan — aucun réglage n’est nécessaire.

Zones QR Vlink stables

Ajoutez la source système URL Vlink lorsqu’un certificat nécessite un code QR permanent. Vous pouvez la positionner plusieurs fois. Chaque positionnement reçoit son propre Vlink lors de la génération du certificat ; deux zones QR peuvent ainsi mener vers des destinations différentes et être gérées indépendamment par la suite.

Lors de la génération, DICE affiche une carte de configuration pour chaque positionnement de Vlink. Chaque carte peut rediriger vers la page publique de la fiche, utiliser une URL HTTP(S) personnalisée ou rester non configurée à l’état de brouillon. La page publique est sélectionnée par défaut lorsqu’il en existe une, mais elle n’est pas requise pour les autres positionnements. Les codes QR d’aperçu sont représentatifs et distincts ; leurs URL Vlink permanentes ne sont créées que lorsque vous cliquez sur Générer.

Résolution des champs — par nom, et non par modèle

Un formulaire n’est pas lié à un modèle de fiche. Lors de la génération, le nom de champ et les alias de chaque zone sont comparés aux noms des champs de la fiche sans tenir compte de la casse — « Name », « name » et « NAME » correspondent tous au même champ. Toute fiche dont les noms de champs correspondent peut utiliser le formulaire, quel que soit le modèle qui l’a créée, le cas échéant.

Marquer une zone comme Requise « bloque la génération lorsque cette valeur ne peut pas être résolue ». Les zones non requises restent simplement vides lorsqu’aucune correspondance n’est trouvée.

Lorsqu’une fiche est sélectionnée comme contexte du modèle, l’aperçu signale les zones qui ne pourront pas être résolues, avec des motifs tels que aucune valeur, incompatibilité de type, ambigu, ne pourra pas être résolu ou ne pourra pas être encodé (pour les formats de code), ainsi qu’une bannière répertoriant les champs requis qui « ne pourront pas être résolus à partir de cette fiche ».

Vérification préalable

Chaque fois que vous choisissez un formulaire pour une fiche, DICE exécute une vérification préalable : elle indique combien de champs requis sont résolus (« 3 champs requis sur 4 sont résolus ») et affiche un résultat global Compatible ou Non compatible. Les champs résolus grâce à un alias sont accompagnés de l’alias correspondant. La génération n’est autorisée que si la vérification préalable réussit.

Générer un certificat pour une fiche

Ouvrez la fiche et trouvez sa carte Certificats (« PDF immuables générés à partir des données de cette fiche. »).
Cliquez sur Générer un certificat. Dans la boîte de dialogue, choisissez un formulaire de certificat — ou sélectionnez ＋ Nouveau formulaire à partir de cette fiche… pour créer un formulaire initialisé avec les champs de cette fiche.
Examinez le résultat de la vérification préalable du formulaire sélectionné par rapport à cette fiche.
Vous pouvez définir un nom de certificat — il est « affiché dans la liste des certificats et utilisé comme nom du fichier téléchargé » et reprend par défaut le nom du formulaire. Si le formulaire contient des zones QR Vlink, configurez chaque destination indépendamment. Cliquez sur Prévisualiser le certificat pour examiner d’abord le PDF rendu.
Cliquez sur Générer. En cas de réussite, le message Certificat délivré s’affiche, et le certificat apparaît sur la carte avec sa date de délivrance.

Depuis la carte, chaque certificat propose les actions Télécharger (le PDF) et Invalider.

Génération par lots

Pour délivrer simultanément le même certificat pour plusieurs fiches :

Dans la liste des fiches, sélectionnez plusieurs fiches et choisissez Générer des certificats. Cela ouvre Générer des certificats par lots (/app/certificates/batch) avec votre sélection placée dans la file d’attente. Un lot est limité à 100 fiches.
Sélectionnez un formulaire de certificat. DICE exécute une vérification préalable pour chaque fiche en attente et attribue à chacune le libellé Conforme, Non conforme (avec la liste des champs manquants) ou Non consultable (vous ne pouvez pas consulter cette fiche dans ce contexte). Utilisez l’action de nouvelle vérification après avoir corrigé les données de la fiche.
Cliquez sur Délivrer les N conformes. Les certificats sont « délivrés un par un » ; chaque ligne passe de Délivrance en cours… à Délivré ou Échec.
Ensuite, utilisez Réessayer les N échecs pour les échecs, supprimez des lignes avec Retirer du lot et utilisez Exporter au format CSV pour conserver une trace de l’exécution.

Invalidation d’un certificat

Les certificats délivrés ne peuvent être ni modifiés ni supprimés — ils peuvent être invalidés. « L’invalidation indique qu’il n’est plus possible de se fier à la validité du certificat. Le PDF et son hachage restent inchangés. »

Sur la carte Certificats de la fiche, cliquez sur Invalider à côté du certificat.
Choisissez un motif : Délivré par erreur, Données de fiche incorrectes, Formulaire incorrect, Certificat en double ou Autre.
Vous pouvez ajouter une note interne (privée), puis confirmer avec Invalider.

Les certificats invalidés restent dans la liste avec la mention Invalidé et demeurent téléchargeables pour vos archives.

Conseils sur le cycle de vie des formulaires

Archiver retire un formulaire sans affecter les certificats déjà délivrés à partir de celui-ci ; Restaurer le remet à disposition. Les formulaires archivés n’apparaissent pas dans la boîte de dialogue de génération.
Copier le formulaire duplique un formulaire, y compris son modèle et ses liaisons, afin que vous puissiez le faire évoluer sans perturber l’original.
Exportez un formulaire depuis l’éditeur et importez-le depuis la liste des formulaires pour déplacer un modèle entre des équipes — un formulaire doit comporter un modèle et un nom avant de pouvoir être exporté.

Fiches — données à partir desquelles les certificats sont générés
Bien démarrer — présentation destinée aux nouveaux utilisateurs
FAQ — disponibilité des modules et dépannage

Signaler un problème dans la documentation