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 |
| |||
| 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 |
| |||
| 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 |
| ||||||
| 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 |
| |||||||||
| 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 |
| ||||||
| 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
- Visão geral das expressões: todas as funções de expressão.