Nesta página

Funções para tratamento de valores nulos

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

Entenda os valores nulos

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

  • Um campo está vazio nos dados de origem
  • Um cálculo resulta em um valor indefinido (por exemplo, uma divisão por zero)
  • Uma consulta ou referência não encontra correspondências

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

Padrões comuns

  • Definir um valor padrão:

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

    coalesce(PreferredName, FirstName, "Guest")
  • Filtrar valores usados como marcadores:

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

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

isNull

(value)

Verifica se um valor é nulo.

Parâmetros
value any Valor a verificar
Retorno boolean
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 verificar
Retorno boolean
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 se ele não for nulo; caso contrário, retorna o valor alternativo.

Parâmetros
value any Valor a verificar
fallback any Valor a retornar se for nulo
Retorno qualquer tipo
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.

Parâmetros
value1 any Primeiro valor
value2 any Segundo valor
... (opcional) any Valores adicionais, até 6 no total
Retorno qualquer tipo
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 se dois valores forem iguais; caso contrário, retorna o primeiro valor.

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

Útil para substituir valores provisórios por nulo

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

Tópicos relacionados

Melhore seus processos. Crie uma arquitetura conectada. Mantenha o controle.

Acesse na hora, sem cartão de crédito nem espera. Transforme a forma como sua organização trabalha em modelos de processo claros e conectados.

Crie sua arquitetura de processos, defina responsabilidades e controles e alinhe papéis e atribuições em todos os níveis.

Comece o teste grátis e crie uma base confiável para governar, gerenciar e melhorar seus processos continuamente.