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(ous999) 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.00ou avec un suffixe commeC 73.00.aouF 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
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 valeurstrueetfalse; - 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.2vaut exactement0.3, et3est é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: … ».
- Exemple :
- 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é, etfiled('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,ltetlecomparent 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,
sumifvaut 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.


À 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.


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
sumifsans 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éfixetintroduit 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).
- un intervalle :
- Des options se placent dans les accolades :
default: 0donne la valeur utilisée quand une cellule est absente ;interval: trueouinterval: 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 defiled(). 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} endifwith {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 ».