Différences

Ci-dessous, les différences entre deux révisions de la page.

--- mod:pdcertificate:technique:placeholders [2026/03/19 00:52] – [Les emplacements de variables] admin
+++ mod:pdcertificate:technique:placeholders [2026/03/31 10:21] (Version actuelle) – [Intégration générique de données provenant de plugins compatibles (PRO uniquement)] admin
@@ Ligne 81: / Ligne 81: @@
    * <nowiki>{{info:course_idnumber}}</nowiki> : Identifiant externe du cours
    * <nowiki>{{info:course_grade}}</nowiki> : Note obtenue du cours
-   * <nowiki>{{info:module_grade_<cmid>}}</nowiki> : Note obtenue sur l'id de module indiqué (PRO uniquement)
+   * <nowiki>{{info:module_grade_<cmid>}}</nowiki> : Note obtenue sur l'id de module indiqué **(PRO uniquement)**
@@ Ligne 99: / Ligne 99: @@
    * <nowiki>{{info:user_enrolment_end_date}}</nowiki> : Date de fin d'inscription au cours
    * <nowiki>{{info:completion_date}}</nowiki> : Date d'achèvement du cours. :!: nouveau
-   * <nowiki>{{info:legalstartdate}}</nowiki> : Date de départ administrative de la formation. :!: nouveau
+   * <nowiki>{{info:legalstartdate}}</nowiki> : Date de départ administrative de la formation. **(PRO uniquement)** :!: nouveau
-   * <nowiki>{{info:legalenddate}}</nowiki> : Date de fin administrative de la formation. :!: nouveau
+   * <nowiki>{{info:legalenddate}}</nowiki> : Date de fin administrative de la formation. **(PRO uniquement)** :!: nouveau
-   * <nowiki>{{info:module_completion_date_<cmid>}}</nowiki> : Date d'achèvement d'un module de cours spécifique donné par ID. (PRO Uniquement)
+   * <nowiki>{{info:module_completion_date_<cmid>}}</nowiki> : Date d'achèvement d'un module de cours spécifique donné par ID. **(PRO Uniquement)**
 === Données spécifique en cas d'usage de la solution plateau de révision ===
@@ Ligne 117: / Ligne 118: @@
     * <nowiki>{{info:course_total_time}}</nowiki> : Temps total passé dans le cours, selon les calculs du bloc [[:blocks:usestats]]
+==== Intégration générique de données provenant de plugins compatibles (PRO uniquement) ====
+Il est désormais possible, pour les plugins qui ont développé l'API d'interrogation de données du PDCertificate, d'aller puiser dans un plugin des données exposées pour les certificats. La nature des données dépend de chaque plugin dont les développeurs déterminent la sémantique des données exportées et les clefs correspondantes.
+La forme générale d'une balise de récupération de données d'un plugin quelconque est :
+   {{plugin:<pluginname>:<datakey>:<contextinfo>}}
+   * **pluginname** est le nom moodle du plugin (par exemple ''local_onboarding'')
+   * **datakey** est une clef de données, généralement formée par un token simple. Il est possible, lorque le plugin le propose d'aller chercher une donnée 'membre" d'une structure avec une syntaxe à "pipe" (par ex. ''session|idnumber'' ou ''institution|name''). (Voir note ci-dessous)
+   * **contextinfo** En général l'API invoquée dans le plugin demande une instance et un userid. Le PDcertificate fournit sa propre identité, et le ''userid'' du document certificat en cours de réalisation. Si cela ne suffit pas, il sera possible d'ajouter une information de contexte statique lors de l'appel à l'API du plugin.
+La définition des récupérées dans le plugin est documentée dans le plugin.
+Plugins compatibles :
+   * [[local:onboarding|Plugin d'enregistrement d'inscriptions locales (Onboarding)]]
+//Note : pourquoi pas une syntaxe à point ''nom1.nom2'' ? Le point utilisé dans des templates mustache a sa propre signification pour mustache. Son usage rentre en collision avec la syntaxe de définition d'une donnée simple pour l'injection dans le certificat. L'usage du "pipe" (|) est neutre pour mustache.//
 ====Données liée à version PRO : Gestion des absences====