Условные конструкции

функциональный

Окрашивайте ячейки в зависимости от их значения для одного запроса: правила подсветки, цветовые шкалы и полосы данных.

Условная директива раскрашивает ячейки по их значениям — только в этом запросе: красный текст, когда статус говорит Failed, розовая заливка, когда баланс уходит в минус, зелёно-красная шкала по столбцу задержки или полоска данных за каждой цифрой выручки. Пишите одно правило на строку — и сколько угодно строк на столбец.

Синтаксис

-- sqlly conditional: column=<name>; <effect>[; <style>…]

Правило применяется к каждому столбцу результата с таким именем, сопоставление без учёта регистра. Действие может быть одним из:

ЭффектЗначение
when=nullЯчейка NULL.
when=not nullЯчейка не является NULL.
when=> NЧисло больше N.
when=< NЧисло меньше N.
when=between A and BЧисло от A до B, включая обе границы. Границы можно указать в любом порядке.
when=is TEXTТекст, равный TEXT, без учёта регистра.
when=contains TEXTТекст, содержащий TEXT, без учёта регистра.
scale=#RRGGBB..#RRGGBBЦветовая шкала: фон плавно изменяется от первого цвета при минимальном значении столбца до второго при максимальном. Для числовых столбцов.
bar=#RRGGBBПолоса данных: полоса длиной по значению, нарисованная за текстом. Для числовых столбцов.

A when= правило требует хотя бы один стиль:

СтильЗначение
text=#RRGGBBЦвет текста.
fill=#RRGGBBЦвет фона.
boldЖирный текст.

Цвета записываются как #RRGGBB, или #RRGGBBAA с альфа-каналом для прозрачной заливки. Текст после when= не может содержать ;.

Примеры

-- 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;

Несколько правил для одного столбца читаются сверху вниз. Здесь большой итог — жирный зелёный, отрицательный — красный, и каждое значение вдобавок получает полосу данных:

-- sqlly conditional: column=Total; when=> 10000; text=#1E7B34; bold
-- sqlly conditional: column=Total; when=< 0; text=#B00020
-- sqlly conditional: column=Total; bar=#5B9BD5

Какое правило побеждает

  • Первое совпавшее when= правило для столбца форматирует ячейку; последующие совпадающие правила пропускаются.
  • Совпавшее правило своим fill перебивает цветовую шкалу, в любом месте, где проходит линия шкалы. Цвет текста и полужирное начертание из правила по-прежнему сочетаются со шкалой и полосой данных.
  • Одна цветовая шкала и одна полоска данных на столбец: когда их несколько, применяется первое из каждого.
  • Правила директив имеют приоритет над правилами из диалогового окна «Условное форматирование» - чтобы запрос мог переопределить ваши обычные цвета для своих столбцов.

Условия для чисел, цветовые шкалы и полоски данных учитывают только те ячейки, которые база данных вернула как числа; текст, выглядящий как число, остаётся без изменений. Столбец, в котором все значения одинаковы, закрашивает средний цвет своей шкалы и полоски на всю длину.

Правила переносятся в Экспорт в Excel как собственное условное форматирование Excel, в том же порядке, поэтому книга раскрашена как сетка и обновляется вслед за значениями в ней.

Пусть блокировка выполнит запись. Задайте правила в диалоге «Условное форматирование», затем нажмите на замок перед именем результата: SQLly записывает conditional: строку для каждого правила, которое действует на столбцы результата. См. Заблокировать сетку.