Métadonnées et documentation

Les métadonnées permettent d’ajouter des informations supplémentaires à vos règles.

Certaines métadonnées sont standardisées et sont affichées sur les pages de documentation auto-générées. D’autres sont personnalisées et peuvent être utilisées pour ajouter des informations spécifiques à votre domaine d’application.

Elles sont définies directement en dessous de la règle, et sont de la forme clé: valeur.

prix:
    valeur: 10€
    titre: Prix HT

Pour écrire une métadonnée sur plusieurs lignes, il faut la précéder du symbole |.

prix:
    valeur: 10€
    description: |
        C'est le prix total à payer de l'article.
        Il n'inclut pas la TVA.

Documentation

La documentation automatique de publicodes génère une page web par règle. Cette règle contient l’explication des calculs, ainsi que des métadonnées standardisées qui sont définies directement dans le code :

• titre : si défini, il est utilisé à la place du nom de la règle dans l’interface utilisateur.
• description : elle est affichée comme paragraphe d’introduction sur la documentation
• note : on l’utilise pour ajouter des informations complémentaires à la règle, généralement les détails d’implémentation ou des informations techniques. Elle est affichée en bas de la page de documentation.
• références : utilisée pour ajouter des liens vers des sources externes. Elle est affichée en bas de la page de documentation.

Exemple :

pesanteur:
  valeur: 9.80665 m/s2
  titre: Accélération de la pesanteur terrestre
  description: |
    L'accélération de la pesanteur terrestre est la force exercée par la Terre sur un objet en chute libre.
  note: |
    On utilise une précision de 5 chiffres après la virgule, suffisante pour la plupart des applications.

Métadonnées personnalisées

Il est possible d’ajouter des métadonnées personnalisées à vos règles. Vous pouvez ainsi ajouter des informations spécifiques à votre domaine d’application.

notif zéro déchet:
  type: notification
  meta:
    message: "Vous avez atteint le zéro déchet !"

Accéder aux métadonnées dans le code

Les métadonnées sont accessibles dans le code via la clé rawRule :

const rule = engine.getRule('notif zéro déchet');
const metadata = rule.rawRule._NGC;