Nesta página

Funções de tratamento de valores nulos

Funções para trabalhar com valores nulos ou ausentes.

Entendendo valores nulos

No ProcessMind, null representa dados ausentes ou indefinidos. Isso pode ocorrer quando:

  • Um campo está vazio nos dados de origem
  • Um cálculo resultou em um valor indefinido, como em uma divisão por zero
  • Uma consulta ou referência não encontrou correspondência

As funções de tratamento de valores nulos ajudam você a lidar com esses casos de forma segura.

Padrões comuns

  • Fornecer um valor padrão:

    ifNull(Department, "Unassigned")
  • Verificar vários campos em busca de valores:

    coalesce(PreferredName, FirstName, "Guest")
  • Filtrar valores de preenchimento:

    nullIf(Status, "N/A")    // Returns null if Status is "N/A"
  • Lógica condicional para valores nulos:

    if(isNull(Manager), "Self-managed", Manager)

isNull

(value)

Verifica se um valor é nulo.

Parâmetros
value any Valor a ser verificado
Retorno booleano
Exemplos
isNull(Department) true se Department for nulo
isNull(null) true
isNull("value") false
Veja também

isNotNull

(value)

Verifica se um valor não é nulo.

Parâmetros
value any Valor a ser verificado
Retorno booleano
Exemplos
isNotNull(Department) true se Department tiver um valor
isNotNull(null) false
isNotNull("value") true
Veja também

ifNull

(value, fallback)

Retorna o primeiro valor quando ele não é nulo; caso contrário, retorna o valor alternativo.

Parâmetros
value any Valor a ser verificado
fallback any O valor a retornar se for nulo
Retorno qualquer
Exemplos
ifNull(Department, "Unknown") Valor de Department ou "Unknown"
ifNull(null, "default") padrão
ifNull("value", "default") valor
Veja também

coalesce

(value1, value2, ...?)

Retorna o primeiro valor não nulo de uma lista de valores.

Parâmetros
value1 any Primeiro valor
value2 any Segundo valor
... (opcional) any Valores adicionais, até 6 no total
Retorno qualquer
Exemplos
coalesce(PreferredName, FirstName, "Guest") Primeiro valor não nulo
coalesce(null, null, "fallback") alternativo
coalesce("first", "second") primeiro
Veja também

nullIf

(value1, value2)

Retorna nulo quando dois valores são iguais; caso contrário, retorna o primeiro valor.

Parâmetros
value1 any O valor a retornar
value2 any O valor de comparação
Retorno qualquer
Exemplos
nullIf(Status, "N/A") nulo se Status for "N/A"

Útil para substituir valores de preenchimento por nulo

nullIf("value", "N/A") valor
nullIf("N/A", "N/A") nulo
Veja também

Tópicos relacionados