Grammaire des contrôles

La définition des contrôles et des indicateurs suit une grammaire stricte mais riche. L’éditeur du formulaire vérifie la formule dès que vous quittez le champ : il souligne l’endroit de chaque erreur, l’explique en clair et, si une coordonnée est ambiguë, liste les cellules candidates (voir Comment créer un nouveau contrôle). En mode Assisté, il propose les templates, lignes, colonnes et feuilles du dictionnaire DPM pendant la saisie.

Coordonnée d’un datapoint

Chaque cellule d’un template réglementaire s’écrit entre accolades :

  • {TEMPLATE, LIGNE, COLONNE, FEUILLE ?}, par exemple {C 01.00, r0010, c0010}

Par exemple, {C 01.00, r0010, c0010} fait référence à la cellule suivante :

  • le template « COREP C 01.00 » : Adéquation des fonds propres – Définition des fonds propres ;
  • la ligne r0010 ;
  • la colonne c0010.

La feuille (s0001, …) peut être omise : la plupart des templates n’ont pas de feuilles.

Règles d’écriture :

  • La ligne, la colonne et la feuille commencent par une lettre minuscule (r, c, s), suivie de chiffres.
  • Pour un template à lignes ouvertes ou à feuilles multiples, r999 (ou s999) désigne toutes les lignes (ou toutes les feuilles) déclarées. Le contrôle est alors dupliqué pour chacune d’elles, et les résultats sont regroupés sous la mention [r999].
  • Le code du template peut s’écrire C 01.00, C_01.00 ou avec un suffixe comme C 73.00.a ou F 18.00.a.

Définir des formules simples

Les formules sont faites de membres. Dans la formule {C 01.00, r0010, c0010} == {C 01.00, r0010, c0030} :

  • le membre de gauche est {C 01.00, r0010, c0010} ;
  • le membre de droite est {C 01.00, r0010, c0030} ;
  • l’opérateur est ==.

Opérateurs de comparaison

Opérateur Signification Exemple
== égalité [membre] == [membre]
!= ou <> différence [membre] <> [membre]
<, >, <=, >= inégalité [membre] >= 0
in appartenance à une liste {C 17.01.a, r0940, c0040} in (empty, 0)
not in non-appartenance à une liste {C 17.01.a, r0940, c0040} not in (empty, 0)

Les listes s’écrivent entre parenthèses ( … ) ou entre crochets [ … ]. Elles contiennent des nombres, des textes entre apostrophes ('Bond') ou d’autres listes.

Seuls == et != / <> tiennent compte du seuil, et seulement pour un contrôle de type de correspondance Seuil.

Formules simples et composées

La plateforme prend en charge les formules simples et composées :

  • Les formules simples sont de la forme [membre] opérateur [membre].
  • Les formules composées combinent plusieurs formules avec les opérateurs logiques && (ET) et || (OU), et des parenthèses si besoin :
    • {C 01.00, r0010, c0010} > 0 && {C 01.00, r0020, c0010} > 0
    • {C 01.00, r0010, c0010} > 0 || {C 01.00, r0020, c0010} > 0
    • ({C 01.00, r0010, c0010} > 0 && {C 01.00, r0020, c0010} > 0) || {C 01.00, r0030, c0010} == 0
Avertissement

Les mots AND et OR ne sont pas reconnus comme opérateurs logiques : utilisez && et ||.

Écriture des membres

Les membres peuvent contenir :

  • des coordonnées, des nombres (0, 0.05, -1), des textes entre apostrophes, et les valeurs true et false ;
  • les opérateurs arithmétiques +, -, *, /, et le signe - devant une coordonnée.
    • Exemple : {C 01.00, r0010, c0010} + {C 01.00, r0010, c0020}.
    • Les montants sont calculés en décimal exact : 0.1 + 0.2 vaut exactement 0.3, et 3 est égal à 3.0. Une division est arrondie à 34 chiffres significatifs.
    • Attention : une division par zéro empêche l’évaluation. Le contrôle obtient le statut Impossible d’évaluer, avec le message « Division by zero: … ».
  • des fonctions qui prennent des membres en arguments : fonction(membre_1, …, membre_n).
Fonction Rôle Exemple
abs(x) valeur absolue abs({C 01.00, r0010, c0010})
min(x, y, …), max(x, y, …) minimum, maximum (voir Les fonctions min et max) max({C 01.00, r0010, c0010}, 0)
sum(x, y, …) somme sum({C 01.00, r0020, c0010}, {C 01.00, r0030, c0010}) == {C 01.00, r0010, c0010}
iif(condition, a, b) vaut a si la condition est vraie, b sinon iif({C 01.00, r0010, c0010} > 0, {C 01.00, r0020, c0010}, 0) >= 0
and(a, b), or(a, b) ET et OU logiques sous forme de fonction and({C 01.00, r0010, c0010} > 0, {C 01.00, r0020, c0010} > 0)
filed('TEMPLATE') vrai si le template, ou l’un de ses sous-templates, a été déclaré dans le reporting (voir La fonction filed) filed('C 03.00') && {C 03.00, r0010, c0010} > 0
empty(x) vrai si la valeur est absente empty({C 73.00.a, r0140, c0050}) == true
sumtop(x, n) somme des n plus grandes valeurs d’une colonne à lignes ouvertes sumtop({C 14.00, r999, c0060}, 5)
sumif(cellule, filtre, critère, …) somme d’une colonne à lignes ouvertes, filtrée sur d’autres colonnes des mêmes lignes sumif({C 01.00, r999, c0010}, {c0060}, 10) == 100
length(x) longueur d’un texte length({C 06.02, r999, c0010}) > 0
memberPart(x) partie située après « : » d’un code de membre, par exemple FR pour eba_GA:FR memberPart({…}) == 'FR'

La fonction iif est la seule forme de condition : if(…) n’est pas évalué.

Les fonctions min et max

min et max acceptent autant d’arguments que nécessaire. Un argument vide est ignoré, au lieu de compter pour 0. Une cellule absente n’est vide que si sa coordonnée porte l’annotation (*) : sinon, elle est remplacée par 0 (voir Remplacement des datapoints nuls).

  • min(5, {C 01.00, r0010, c0010}(*)) vaut 5 quand la cellule est absente ;
  • min(5, {C 01.00, r0010, c0010}) vaut 0 quand la cellule est absente, car elle est remplacée par 0 ;
  • le résultat n’est vide que si tous les arguments sont vides.

La fonction filed

filed('TEMPLATE') compare des segments entiers du code du template : suites de lettres et suites de chiffres, quel que soit le séparateur (espace, . ou _). F41, F 41 et F_41 sont donc équivalents.

  • filed('J05.00') est vrai si J 05.00.b est déclaré : il suffit que l’un des sous-templates le soit.
  • filed('F 1') n’est pas vrai quand seul F 17 est déclaré, et filed('F 17') ne correspond pas à F 170.

La fonction sumif

sumif(colonne, filtre_1, critère_1, filtre_2, critère_2, …) additionne les valeurs de colonne sur les lignes ouvertes qui satisfont tous les critères. Il faut au moins un couple filtre et critère. Dans un contrôle, une coordonnée réduite à une colonne ({c0060}) reprend le template et la ligne du premier argument.

Un critère peut prendre les formes suivantes :

Critère Lignes retenues
valeur ou ['eq', valeur] la valeur filtrée est égale à valeur
['in', [v1, v2, …]] la valeur filtrée est l’une des valeurs de la liste
['ne', valeur] la valeur filtrée est différente de valeur
['gt', valeur], ['ge', valeur] la valeur filtrée est supérieure (gt), ou supérieure ou égale (ge), à valeur
['lt', valeur], ['le', valeur] la valeur filtrée est inférieure (lt), ou inférieure ou égale (le), à valeur

Règles :

  • gt, ge, lt et le comparent des nombres. Une ligne dont la valeur filtrée est un texte non numérique n’est pas retenue.
  • Une ligne dont la valeur filtrée est absente n’est jamais retenue, y compris avec ne.
  • Les pourcentages sont des décimaux : 10 % s’écrit 0.1.
  • Quand aucune ligne n’est retenue, sumif vaut 0.

Par exemple, sumif({C 28.00, r999, c0040}, {c0230}, ['ge', 0.1]) additionne les grands risques d’au moins 10 % des fonds propres Tier 1.

Définition de formules dépendantes du temps

Il est parfois nécessaire de comparer les mêmes coordonnées à deux dates de reporting différentes. Pour cela, ajoutez l’annotation [T] à vos datapoints :

  • {C 01.00, r0010, c0010}[T] - {C 01.00, r0010, c0010}[T-1] > 0

Exécutée dans un contexte donné, cette formule vérifie que la valeur à T est supérieure à la valeur à T-1. On peut aussi viser une période postérieure, par exemple [T+1].

Seules les formes [T], [T+n] et [T-n] sont admises, où n est un nombre entier. Les espaces sont permis, par exemple [ T-1 ]. L’annotation fonctionne aussi pour une cellule qui contient un texte, une date ou un booléen : {…}[T] renvoie alors cette valeur.

Le contexte est défini lors de l’exécution du plan de contrôle :

  • la date de référence, qui est la date de T ;
  • le type de période, c’est-à-dire l’écart entre deux périodes : « Mois », « Trimestre », « Semestre » ou « Année ».

Pour qu’une formule [T-1] soit évaluée, il faut sélectionner à l’exécution les fichiers des deux dates.

Remplacement des datapoints nuls

Les datapoints d’un reporting peuvent être nuls ou absents, quand l’établissement n’a pas à les renseigner. Dans ce cas, l’évaluation de la formule peut échouer.

Par exemple, soit la formule {C 01.00, r0010, c0010} + {C 01.00, r0010, c0020} > 0 avec :

  • {C 01.00, r0010, c0010} = null
  • {C 01.00, r0010, c0020} = 1000

Cette formule est évaluée, car le moteur remplace automatiquement null par 0. Pour empêcher ce remplacement, ajoutez l’annotation (*) à la coordonnée :

  • {C 01.00, r0010, c0010}(*) + {C 01.00, r0010, c0020}(*) > 0

La formule échoue alors, ce qui peut être le résultat attendu, car l’une des coordonnées est nulle. L’annotation se combine avec le temps, et se place après celui-ci : {C 01.00, r0010, c0010}[T-1](*).

Avec l’annotation, une valeur absente est ignorée par min et max (voir Les fonctions min et max).

Travailler avec des dimensions supplémentaires

Certains templates contiennent des datapoints qui nécessitent des dimensions supplémentaires. Par exemple, le template FINREP F 20.04 est ventilé par pays : chaque pays est déclaré dans un template dédié, avec ses propres chiffres.

Pour préciser une dimension supplémentaire, ajoutez-la à la fin du datapoint, après une barre verticale :

  • {F 20.04, r0110, c0012 | RCP=eba_GA:FR}
  • {F 20.04, r0110, c0012 | RCP=eba_GA:DK}

Si plusieurs dimensions sont nécessaires, séparez-les par un point-virgule :

  • {F 20.04, r0110, c0012 | XXX=eba_dim1:val1; YYY=eba_dim2:val2}

Ce type de datapoint s’utilise dans un contrôle ou un indicateur comme n’importe quel autre.

Un contrôle avec une dimension supplémentaire

Un indicateur avec une dimension supplémentaire

À l’exécution du plan de contrôle ou du tableau de bord, seule la valeur correspondant à la dimension spécifiée est utilisée et affichée.

Résultat d’un plan de contrôle sur une coordonnée avec dimension

Résultat de tableau de bord sur une coordonnée avec dimension

Formules des indicateurs

La formule d’un indicateur ne contient qu’un seul membre, sans opérateur de comparaison. Elle utilise les mêmes coordonnées, opérateurs arithmétiques et fonctions :

  • {C 01.00, r0010, c0010} / {C 02.00, r0010, c0010}

Une valeur d’indicateur est unique. Une coordonnée à lignes ouvertes (r999) n’y est donc admise qu’en argument direct de sum, sumtop, sumif ou length, par exemple sumtop({C 28.00, r999, c0040}, 5). Si la même coordonnée est aussi lue seule ailleurs dans la formule, la formule n’est pas valide.

Dans un indicateur, la colonne de filtre de sumif s’écrit en entier : la forme courte {c0230} n’est valable que dans les contrôles. Par exemple :

  • sumif({C 28.00, r999, c0040}, {C 28.00, r999, c0230}, ['ge', 0.1]) / {C 04.00, r0860, c0010}

Messages d’erreur d’évaluation

Quand une formule ne peut pas être évaluée, le résultat obtient le statut Impossible d’évaluer. Le message nomme la fonction ou la valeur en cause, par exemple :

  • « Division by zero: … » : une division par zéro ;
  • « Cannot apply function … to … » : une fonction appliquée à une valeur qu’elle ne sait pas traiter ;
  • « Formula is not allowed: … » : une construction qui ne fait pas partie de la grammaire des contrôles ;
  • « filter() function should have at least 1 filter » : un sumif sans couple filtre et critère.

Lire une règle DPM-XL (EGDQ-XL et VR-XL)

Les contrôles des bibliothèques EGDQ-XL et VR-XL sont écrits dans le langage DPM-XL de l’EBA, tels que publiés par la BCE et par l’EBA. Ils sont exécutés tels quels. Ce langage ne sert pas à écrire vos propres contrôles, mais il est utile de savoir le lire.

Sélection de cellules

  • {tF_01.01, r0010, c0010} désigne une cellule. Le préfixe t introduit le code de la table, ici F 01.01. Une feuille éventuelle se place en dernier : , s0002.
  • Une sélection peut couvrir plusieurs cellules :
    • un intervalle : c0010-0080 ;
    • toutes les valeurs d’un axe : r*, c*, s* ;
    • une liste : (r0010, r0020).
  • Des options se placent dans les accolades :
    • default: 0 donne la valeur utilisée quand une cellule est absente ;
    • interval: true ou interval: false.
  • with {tC_17.01.a, c0010-0080}: … fixe un contexte. Les références qui suivent n’indiquent alors que ce qui manque, par exemple {r0010}.
  • {v_F_01.01} vaut vrai si la table F 01.01 a été déclarée dans le reporting. C’est l’équivalent de filed(). Les conditions préalables des règles EGDQ-XL et VR-XL sont presque toutes de cette forme.

Opérateurs et fonctions

Catégorie Écriture
Arithmétique +, -, *, /
Comparaison = (égalité, avec un seul signe), !=, <, <=, >, >=
Logique and, or, xor, not( … )
Appartenance in {0, 1}
Condition if … then … else … endif (la partie else est facultative)
Numériques abs, exp, ln, sqrt, power(a, b), log(a, b), max(a, b, …), min(a, b, …)
Valeurs absentes isnull(x), nvl(x, valeur_par_défaut)
Textes match(x, 'expression régulière'), len(x), concaténation &
Agrégats sum, count, avg, median, max_aggr, min_aggr, éventuellement avec group by
Valeurs littérales nombres, pourcentages (10%), textes, true, false, null, dates (#2026-03-31#), codes de membres ([eba_GA:FR])

Exemples :

  • {tF_18.00.a, r0010, c*} >= 0 : toutes les colonnes de la ligne 0010 doivent être positives.
  • with {tF_01.01, c0010}: if {r0010} > 0 then {r0020} = {r0030} endif
  • with {tF_01.01, default: 0}: {r0010, c0010} > {r0020, c0010}

Quelques constructions du langage ne sont pas encore évaluées par la plateforme : les références à des variables ou opérations, rename, les propriétés et les affectations. Une règle qui les utilise obtient le statut Impossible d’évaluer, avec le message « unsupported operand ».