Conditionnel
fonctionnelColoriez les cellules selon leurs valeurs pour une requête : règles de mise en surbrillance, échelles de couleurs et barres de données.
La directive conditionnelle colore les cellules en fonction de leurs valeurs, pour cette requête uniquement : texte en rouge quand un statut indique Failed, un remplissage rose quand un solde devient négatif, une échelle de couleurs du vert au rouge sur une colonne de latence, ou une barre de données derrière chaque chiffre de revenu. Écrivez une règle par ligne, avec autant de lignes par colonne que vous voulez.
Syntaxe
-- sqlly conditional: column=<name>; <effect>[; <style>…]
Une règle s'applique à chaque colonne de résultat portant ce nom, sans tenir compte de la casse. L'effet est l'un des suivants :
| Effet | Sens |
|---|---|
when=null | La cellule est NULL. |
when=not null | La cellule n'est pas NULL. |
when=> N | Un nombre supérieur à N. |
when=< N | Un nombre inférieur à N. |
when=between A and B | Un nombre de A à B, bornes incluses. Les bornes peuvent être données dans un ordre quelconque. |
when=is TEXT | Texte égal à TEXTE, en ignorant la casse. |
when=contains TEXT | Texte contenant TEXTE, en ignorant la casse. |
scale=#RRGGBB..#RRGGBB | Une échelle de couleurs : l'arrière-plan passe de la première couleur pour la valeur la plus basse de la colonne à la seconde pour la plus haute. Colonnes numériques. |
bar=#RRGGBB | Une barre de données : une barre de la longueur de la valeur, dessinée derrière le texte. Colonnes numériques. |
A when= règle nécessite au moins un style :
| Style | Sens |
|---|---|
text=#RRGGBB | Couleur du texte. |
fill=#RRGGBB | Couleur de l'arrière-plan. |
bold | Texte en gras. |
Les couleurs sont inscrites #RRGGBB, ou #RRGGBBAA avec un canal alpha pour un remplissage transparent. Le texte après when= ne peut pas contenir un ;.
Exemples
-- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
-- sqlly conditional: column=Latency; scale=#63BE7B..#F8696B
-- sqlly conditional: column=Revenue; bar=#5B9BD5
-- sqlly conditional: column=ClosedAt; when=null; fill=#FFF4CE80
SELECT Status, Balance, Latency, Revenue, ClosedAt FROM accounts;
Plusieurs règles sur une même colonne se lisent de haut en bas. Ici, un total élevé est en vert gras, un négatif en rouge, et chaque valeur reçoit aussi une barre de données :
-- sqlly conditional: column=Total; when=> 10000; text=#1E7B34; bold
-- sqlly conditional: column=Total; when=< 0; text=#B00020
-- sqlly conditional: column=Total; bar=#5B9BD5
Quelle règle l'emporte
- La première correspondance
when=règle pour une colonne stylise la cellule ; les règles correspondantes sont ensuite ignorées. - Dans une règle correspondante, le
fillvaut mieux qu'une échelle de couleurs, où que se trouve la ligne de l'échelle. La couleur du texte et le gras selon la règle se combinent toujours avec l'échelle et avec une barre de données. - Une échelle de couleurs et une barre de données par colonne : lorsqu'il y en a plusieurs, le premier de chaque groupe s'applique.
- Les règles de directive viennent avant les règles enregistrées dans la boîte de dialogue Mise en forme conditionnelle - ainsi une requête peut remplacer vos couleurs habituelles pour ses propres colonnes.
Les règles numériques, les échelles de couleurs et les barres de données ne regardent que les cellules que la base de données renvoie comme nombres ; le texte qui ressemble à un nombre est laissé tel quel. Une colonne dont toutes les valeurs sont identiques prend la couleur centrale de son échelle et des barres pleine longueur.
Les règles se transfèrent dans un Export Excel comme mise en forme conditionnelle native d'Excel, dans le même ordre, de sorte que le classeur est coloré comme la grille et se met à jour quand les valeurs y changent.
conditional: une ligne pour chaque règle qui s'applique aux colonnes du résultat. Voir Verrouiller la grille.