Attributs personnalisés des attestations numériques

Temps de lecture : 8 minutes

Aperçu

Les attributs personnalisés vous permettent d'attacher des champs de données spécifiques à votre domaine aux attestations numériques au niveau de la catégorie. Définissez des champs comme « Score », « Formateur », « Heures de formation » ou « Numéro de permis » — puis remplissez-les pour chaque titulaire d'attestation. Les valeurs apparaissent dans les PDF générés et sur la page de vérification publique.

Exemples d'utilisation :

• Un fournisseur de formation Python ajoute les champs « Score » et « Formateur » à sa catégorie « Formation Python »
• Un certificateur en salubrité alimentaire ajoute « Numéro de permis » et « Autorité émettrice » à sa catégorie de conformité
• Une organisation de conditionnement physique ajoute « Heures complétées » et « Nom du formateur » à chaque attestation

Requis : forfait Pro

Comment fonctionne la fonctionnalité

Les attributs personnalisés suivent un processus en quatre étapes :

1. Définissez les champs sur une catégorie (Admin, forfait Pro)
2. Saisissez les valeurs lors de la création ou de la modification d'attestations individuelles
3. Placez les jetons dans la conception de votre attestation pour imprimer les valeurs dans les PDF
4. La page de vérification affiche publiquement les valeurs lorsqu'une personne consulte une attestation

Partie 1 : Définir des champs personnalisés sur une catégorie

Requis : rôle Admin et forfait Pro

Étape 1 : Accédez aux Catégories

1. Connectez-vous à CertLister à https://app.certlister.com
2. Cliquez sur Catégories dans la navigation de gauche

Étape 2 : Ouvrez la boîte de dialogue Champs personnalisés

1. Trouvez la catégorie à laquelle vous voulez ajouter des champs
2. Cliquez sur l'icône de curseurs dans la rangée de cette catégorie — cela ouvre la boîte de dialogue Champs personnalisés
3. Si votre organisation utilise le forfait Gratuit ou De base, vous verrez une icône de cadenas et un bouton de mise à niveau au lieu de l'éditeur de champs

Étape 3 : Ajoutez des champs

1. Cliquez sur Ajouter un champ
2. Remplissez les trois propriétés pour chaque champ :

3. Ajoutez autant de champs que nécessaire — il n'y a aucune limite
4. Cliquez sur Enregistrer les champs une fois terminé

Exemple de configuration pour une catégorie « Formation Python » :

Important : renommer ou supprimer des clés de champ

Un avertissement apparaît dans la boîte de dialogue si vous renommez ou supprimez une clé qui contient déjà des valeurs enregistrées sur des attestations existantes. Modifier la clé ne supprime pas les données stockées — mais les valeurs ne s'afficheront plus tant que la clé d'origine ne sera pas restaurée. Renommez les clés avec prudence et seulement avant que des attestations n'aient été créées dans cette catégorie.

Partie 2 : Saisir les valeurs lors de la création d'une attestation

Une fois qu'une catégorie comporte des champs personnalisés, ces champs apparaissent automatiquement dans les boîtes de dialogue Ajouter une attestation et Modifier lorsque cette catégorie est sélectionnée.

Créer une attestation avec des champs personnalisés

1. Allez à Attestations → cliquez sur Ajouter une attestation (ou Importer pour un import en lot)
2. Remplissez les champs standards (nom du titulaire, titre, dates)
3. Sélectionnez une catégorie qui comporte des champs personnalisés définis
4. Les champs personnalisés apparaissent sous la section standard — remplissez-les
5. Les champs obligatoires sont marqués d'un astérisque (*) et doivent être complétés avant l'enregistrement
6. Cliquez sur Enregistrer

Modifier des attestations existantes

1. Ouvrez une attestation appartenant à une catégorie avec des champs personnalisés
2. Cliquez sur Modifier
3. Les champs personnalisés apparaissent avec les valeurs précédemment enregistrées
4. Mettez à jour les valeurs au besoin et enregistrez

Note : L'ajout de champs personnalisés à une catégorie ne remplit pas rétroactivement les valeurs des attestations existantes. Vous pouvez modifier chaque attestation individuellement pour ajouter les valeurs, ou réimporter avec un fichier CSV qui inclut les colonnes supplémentaires (voir Partie 5 ci-dessous).

Partie 3 : Utiliser les jetons dans les conceptions d'attestation

Les jetons d'attributs personnalisés suivent le format {{custom.fieldkey}}. Placez-les dans le Studio de conception pour imprimer les valeurs personnalisées dans les PDF générés.

Étape 1 : Ouvrez le Studio de conception

1. Cliquez sur Studio de conception dans la navigation de gauche
2. Ouvrez la conception que vous voulez mettre à jour — ou créez-en une nouvelle

Étape 2 : Trouvez les jetons de champs personnalisés dans le panneau Attributs

1. Cliquez sur l'icône Attributs dans la barre d'outils de gauche
2. Faites défiler jusqu'à la section Champs personnalisés dans le panneau de sélection
3. Vos jetons de champs personnalisés apparaissent comme des boutons cliquables — un par clé de champ unique, parmi toutes les catégories de votre organisation
4. Si deux catégories ont un champ avec la même clé mais des étiquettes différentes (par exemple, « Score » dans l'une et « Score du test » dans l'autre), les deux étiquettes sont affichées fusionnées sur le bouton

Étape 3 : Ajoutez un jeton au canevas

• Cliquez sur un bouton de jeton pour l'ajouter au canevas à une position par défaut
• Glissez le bouton de jeton directement sur le canevas pour le placer exactement où vous le souhaitez
• Stylisez l'élément de jeton comme tout autre élément de texte : police, taille, couleur, alignement

Étape 4 : Enregistrez la conception

Cliquez sur Enregistrer en haut à droite. La conception est maintenant prête à générer des PDF avec des valeurs personnalisées.

Au moment de la génération :

• {{custom.score}} → remplacé par le score réel pour chaque titulaire (par exemple, « 92 % »)
• {{custom.instructor}} → remplacé par le nom du formateur (par exemple, « Dr Smith »)
• Si une attestation n'a aucune valeur pour un jeton, le jeton est remplacé par une chaîne vide (espace vide)

Partie 4 : Attributs personnalisés sur la page de vérification publique

Lorsqu'une personne consulte une attestation sur votre page de vérification publique, une section Détails supplémentaires apparaît sous l'information standard de l'attestation — mais seulement si l'attestation a des valeurs d'attributs personnalisés et que votre organisation est sur le forfait Pro.

Exemple de ce que voient les visiteurs :

Détails supplémentaires

Score              92 %
Formateur          Dr Smith
Heures de formation 16 heures

Seuls les champs ayant une valeur enregistrée sont affichés. Les champs sans valeur sont omis. Les adresses courriel, les notes internes et autres données privées ne sont jamais exposées sur la page de vérification.

Partie 5 : Importer des attributs personnalisés via CSV

Lorsque vous importez des attestations via CSV, toute colonne qui n'est pas un champ standard de CertLister est automatiquement traitée comme un attribut personnalisé. Aucune configuration supplémentaire n'est nécessaire.

Comment ça fonctionne

Les champs standards reconnus par l'importateur : Credential Number, Title, Recipient Name, Recipient Email, Issue Date, Expiry Date, Status, Category

Tout nom de colonne en dehors de cette liste est mappé à {{custom.columnname}}. Par exemple, une colonne nommée score devient {{custom.score}} dans les PDF générés.

Exemple de CSV

Credential Number,Title,Recipient Name,Recipient Email,Issue Date,Expiry Date,Status,Category,score,instructor
,Python Training,Sarah Johnson,sarah@email.com,2026-01-15,2027-01-15,active,Python Training,92%,Dr. Smith
,Python Training,Michael Chen,mchen@company.com,2026-01-15,2027-01-15,active,Python Training,87%,Dr. Smith

Les colonnes score et instructor sont enregistrées comme valeurs d'attributs personnalisés et seront affichées dans les PDF via les jetons {{custom.score}} et {{custom.instructor}}.

Notes :

• Les noms de colonnes dans le CSV sont utilisés tels quels comme clé d'attribut. Gardez-les en minuscules et sans espaces pour qu'ils correspondent aux clés de champs de votre catégorie.
• L'importateur ne valide pas les colonnes personnalisées du CSV par rapport au schéma défini de la catégorie. Les valeurs sont stockées peu importe.
• Le schéma de la catégorie (défini dans la boîte de dialogue Champs personnalisés) contrôle les noms d'affichage, la validation des champs obligatoires et la résolution des jetons — pas l'import.

En savoir plus : Importer en lot des attestations à partir d'un CSV

Dépannage

La boîte de dialogue Champs personnalisés affiche une icône de cadenas

Cause : Votre organisation utilise le forfait Gratuit ou De base. Les attributs personnalisés requièrent le forfait Pro.

Solution : Mettez à niveau à https://app.certlister.com/billing

Les champs personnalisés n'apparaissent pas dans la boîte de dialogue d'attestation

Vérifiez :

1. Vous avez sélectionné une catégorie comportant au moins un champ défini — ouvrez la page Catégories, trouvez la catégorie, cliquez sur l'icône de curseurs et confirmez que les champs sont listés
2. Votre organisation est sur le forfait Pro
3. Vous sélectionnez la catégorie avant de chercher les champs (les champs se chargent lorsque la catégorie est sélectionnée)

Un jeton dans le PDF s'affiche comme {{custom.score}} au lieu d'une valeur réelle

Causes et solutions :

La page de vérification n'affiche pas les attributs personnalisés d'une attestation

Vérifiez :

• Votre organisation est sur le forfait Pro (l'API ne retourne pas les attributs personnalisés pour les organisations non-Pro)
• L'attestation a au moins une valeur d'attribut personnalisé enregistrée (modifiez l'attestation pour confirmer)
• La clé d'attribut dans la réponse de vérification correspond au schéma de la catégorie

L'aperçu de la conception affiche [score] au lieu d'une valeur réelle

C'est normal. L'aperçu du canevas du Studio de conception n'a pas de données d'attestation réelles. Les jetons personnalisés s'affichent sous la forme [fieldkey] dans l'aperçu pour montrer que le jeton est reconnu. La valeur réelle est substituée au moment de la génération du PDF.

Foire aux questions

Q : Combien de champs personnalisés puis-je ajouter par catégorie ?

R : Il n'y a aucune limite.

Q : Différentes catégories peuvent-elles avoir différents champs personnalisés ?

R : Oui — chaque catégorie a son propre schéma de champs indépendant. « Formation Python » peut avoir Score et Formateur ; « Salubrité alimentaire » peut avoir Numéro de permis et Région d'expiration. Ces schémas sont complètement séparés.

Q : Qu'arrive-t-il aux attestations existantes lorsque j'ajoute de nouveaux champs à une catégorie ?

R : Les attestations existantes ne sont pas affectées. Les nouveaux champs apparaissent vides pour les attestations existantes. La validation des champs obligatoires s'applique uniquement à la création de nouvelles attestations — modifier une attestation existante affichera le nouveau champ, mais ne vous obligera pas à le remplir.

Q : Puis-je utiliser la même clé de jeton dans plusieurs catégories ?

R : Oui. Le Studio de conception fusionne toutes les clés uniques de tous les schémas de catégories en une seule liste dans le panneau Attributs. Un jeton comme {{custom.score}} dans votre conception sera résolu à la valeur du score correspondant à la catégorie à laquelle l'attestation appartient.

Q : Les valeurs d'attributs personnalisés sont-elles consultables dans la liste des attestations ?

R : Pas pour l'instant. La recherche fonctionne sur le nom du titulaire, le numéro d'attestation et le titre.

Q : Les valeurs d'attributs personnalisés peuvent-elles être exportées vers CSV ?

R : Pas pour l'instant. L'exportation CSV standard inclut uniquement les champs principaux. L'exportation des attributs personnalisés pourrait être ajoutée dans une future mise à jour.

Q : Les attributs personnalisés fonctionnent-ils avec l'ancien générateur SVG d'attestations ?

R : Oui. L'ancien générateur SVG résout également les jetons {{custom.key}} lorsqu'ils apparaissent dans un modèle SVG.

Q : Qu'arrive-t-il aux données d'attributs personnalisés si je rétrograde du forfait Pro au forfait De base ?

R : Les valeurs stockées restent dans la base de données. Cependant, la page de vérification cessera d'afficher la section Détails supplémentaires, et la boîte de dialogue Champs personnalisés affichera une icône de cadenas. Les valeurs sont restaurées immédiatement si vous remettez votre forfait à niveau vers Pro.