Condicional

funcional

Colorir as células pelos valores delas em uma consulta: regras de destaque, escalas de cores e barras de dados.

A diretiva condicional colore células de acordo com seus valores, apenas para esta consulta: texto vermelho quando um status diz Failed, preenchimento rosa quando um saldo fica negativo, uma escala de cor do verde ao vermelho em uma coluna de latência, ou uma barra de dados atrás de cada valor de receita. Escreva uma regra por linha, quantas linhas por coluna você quiser.

Sintaxe

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

Uma regra vale para toda coluna de resultado com esse nome, sem diferenciar maiúsculas de minúsculas. O efeito é um dos seguintes:

EfeitoSignificado
when=nullA célula é NULL.
when=not nullA célula não é NULL.
when=> NUm número maior que N.
when=< NUm número menor que N.
when=between A and BUm número de A a B, ambos incluídos. Os limites podem vir em qualquer ordem.
when=is TEXTTexto igual a TEXT, ignorando maiúsculas e minúsculas.
when=contains TEXTTexto que contém TEXT, ignorando maiúsculas e minúsculas.
scale=#RRGGBB..#RRGGBBUma escala de cores: o fundo faz a transição da primeira cor, no menor valor da coluna, até a segunda, no maior. Colunas numéricas.
bar=#RRGGBBUma barra de dados: uma barra do tamanho do valor, desenhada atrás do texto. Colunas numéricas.

A when= regra precisa de pelo menos um estilo:

EstiloSignificado
text=#RRGGBBCor do texto.
fill=#RRGGBBCor de fundo.
boldTexto em negrito.

As cores são escritas #RRGGBB, ou #RRGGBBAA com um canal alfa para um preenchimento translúcido. O texto depois de when= não pode conter um ;.

Exemplos

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

Várias regras em uma coluna são aplicadas de cima para baixo. Aqui, um total grande fica em verde negrito, um negativo fica em vermelho, e cada valor também recebe uma barra de dados:

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

Qual regra prevalece

  • A primeira correspondência when= regra para uma coluna estiliza a célula; as regras seguintes são ignoradas.
  • Na regra correspondente, o fill vence uma escala de cores, independentemente de onde a linha da escala estiver. A cor do texto e o negrito da regra continuam se combinando com a escala e com uma barra de dados.
  • Uma escala de cores e uma barra de dados por coluna: quando há várias, a primeira de cada uma se aplica.
  • As regras da diretiva vêm antes das regras salvas no diálogo de Formatação Condicional - para que uma consulta possa sobrepor suas cores do dia a dia nas próprias colunas dela.

Condições numéricas, escalas de cores e barras de dados olham apenas para células que o banco de dados retornou como números; textos com aparência numérica são deixados de lado. Uma coluna cujos valores são todos iguais pinta a cor do meio de sua escala e barras de comprimento completo.

As regras vão para um Exportação para Excel como formatação condicional nativa do Excel, na mesma ordem, de modo que a planilha fica colorida como a grade e se mantém atualizada quando os valores mudam lá.

Deixe o cadeado escrever. Configure regras no diálogo de Formatação Condicional, depois clique no cadeado na frente do nome do resultado: o SQLly escreve um conditional: linha para cada regra que se aplica às colunas do resultado. Veja Bloquear grade.