Funções Blank, Coalesce, IsBlank e IsEmpty

Aplica-se a: Aplicativos Canvas Fluxos de desktop Dataverse Colunas de fórmula Aplicativos baseados em modelo Power Pages Power Platform CLI

Testa se um valor está em branco ou se uma tabela não contém nenhum registro e fornece uma maneira de criar valores em branco.

Visão Geral

Blank é um espaço reservado para "nenhum valor" ou "valor desconhecido". Por exemplo, a propriedade Selected de um controle Combo box ficará em branco se o usuário não tiver feito uma seleção. Muitas fontes de dados podem armazenar e retornar valores NULL, que são representados em Power Apps como em branco.

Qualquer propriedade ou valor calculado no Power Apps pode ficar em branco. Por exemplo, um valor booliano normalmente tem um dos dois valores: true ou false. Mas, além desses dois, ele também pode ficar em branco, indicando que o estado não é conhecido. Isso é semelhante ao Microsoft Excel, em que uma célula de planilha começa em branco sem conteúdo, mas pode conter os valores TRUE ou FALSE (entre outros). A qualquer momento, o conteúdo da célula pode ser novamente limpo, retornando-o para um estado em branco.

String vazia refere-se a uma string que não contém caracteres. A função Len retorna zero para essa cadeia de caracteres e pode ser gravada em fórmulas como duas aspas duplas sem nada entre elas "". Alguns controles e fontes de dados usam uma cadeia de caracteres vazia para indicar uma condição de "nenhum valor". Para simplificar a criação de aplicativos, as funções IsBlank e Coalesce são testadas para valores em branco ou cadeias de caracteres vazias.

No contexto da função IsEmpty, vazio é específico para tabelas que não contêm registros. A estrutura da tabela pode estar intacta, completa com nomes de coluna, mas sem dados contidos nela. Uma tabela pode ser iniciada como vazia, utilizar registros e não estar mais vazia e, em seguida, os registros podem ser removidos e ela ficar novamente vazia.

Em branco

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos Dataverse Colunas de fórmula

A função Blank retorna um valor em branco. Use isso para armazenar um valor NULL em uma fonte de dados que dá suporte a esses valores, removendo efetivamente qualquer valor do campo.

IsBlank

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

A função IsBlank testa um valor em branco ou uma cadeia de caracteres vazia. O teste inclui cadeias de caracteres vazias para facilitar a criação do aplicativo, pois algumas fontes de dados e controles usam uma cadeia de caracteres vazia quando não há nenhum valor presente. Para testar especificamente um valor em branco, use if( Value = Blank(), ... em vez de IsBlank. A função IsBlank considera tabelas vazias como não vazias, e IsEmpty deve ser usado para testar uma tabela.

Ao habilitar o tratamento de erros para aplicativos existentes, considere substituir IsBlank por IsBlankOrError para preservar o comportamento do aplicativo existente. Antes da adição de tratamento de erros, um valor em branco foi usado para representar valores nulos de bancos de dados e valores de erro. O tratamento de erros separa essas duas interpretações de em branco, o que pode mudar o comportamento de aplicativos existentes que continuam a usar IsBlank.

O valor retornado para IsBlank é um booliano true ou false.

Coalesce

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

A função Coalesce avalia seus argumentos na ordem e retorna o primeiro valor que não está em branco ou uma cadeia de caracteres vazia. Use esta função para substituir um valor em branco ou uma cadeia de caracteres vazia por um valor diferente, sem alterar os valores de cadeia de caracteres não em branco e não vazios. Se todos os argumentos forem em branco ou cadeias de caracteres vazias, então a função retornará em branco, tornando Coalesce uma boa maneira de converter cadeias de caracteres vazias em valores em branco.

Coalesce( value1, value2 ) é o equivalente mais conciso de If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) e não requer que valor1 e valor2 sejam avaliados duas vezes. A função If retornará blank se não houver fórmula "else", como é o caso aqui.

Todos os argumentos de Coalesce devem ser do mesmo tipo; por exemplo, não é possível combinar números com cadeias de texto. O valor de retorno de Coalesce é desse tipo comum.

IsEmpty

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

A função IsEmpty testa se uma tabela contém algum registro. É equivalente a usar a função CountRows e a verificação de zero. Você pode verificar se há erros na fonte de dados ao combinar IsEmpty com a função Errors.

O valor retornado para IsEmpty é um booliano true ou false.

Sintaxe

Em branco()

Coalescer( Valor1 [, Valor2, ... ] )

• Valores – Obrigatório. Valores a serem testados. Cada valor é avaliado na ordem até que um valor que não esteja em branco e que não seja uma cadeia de caracteres vazia seja encontrado. Os valores após esse ponto não são avaliados.

Está em branco( Valor )

• Valor – Obrigatório. Valor para testar um valor em branco ou uma cadeia de caracteres vazia.

IsEmpty( Tabela )

• Tabela - Obrigatório. Tabela a ser testada quanto a registros.

Exemplos

Em branco

1. Crie um aplicativo do zero e adicione um controle Button.

2. Defina a propriedade OnSelect do botão como esta fórmula:

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

4. No menu Arquivo, clique ou toque em Coleções.

   A coleção Cities é exibida, mostrando um registro com “Seattle” e “Rainy”:

   

5. Clique ou toque na seta para voltar para retornar ao workspace padrão.

6. Adicione um controle Label e defina sua propriedade Text com esta fórmula:

   IsBlank( First( Cities ).Weather )
   

   O rótulo mostra false porque o campo Weather contém um valor (“Rainy”).

7. Adicione um segundo botão e defina sua propriedade OnSelect com esta fórmula:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

   O campo Weather do primeiro registro de Cities é substituído por um blank, removendo “Rainy” que estava no campo.

   

   O rótulo mostra true porque o campo Weather não contém mais um valor.

Coalesce

IsBlank

1. Crie um aplicativo do zero, adicione um controle de entrada de texto e nomeie-o FirstName.

2. Adicione um rótulo e defina sua propriedade Text como esta fórmula:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Por padrão, a propriedade Text de um controle de entrada de texto é definida como “Entrada de texto”. Como a propriedade contém um valor, ela não está em branco e o rótulo não exibe mensagens.

3. Remova todos os caracteres do controle de entrada de texto, incluindo os espaços.

   Como a propriedade Text não contém mais nenhum caractere, ela é uma cadeia de caracteres vazia e IsBlank (FirstName. Text) será true. Será exibida a mensagem de campo obrigatório.

Para obter informações sobre como realizar a validação usando outras ferramentas, consulte a função Validate e Trabalhando com fontes de dados.

Outros exemplos:

IsEmpty

1. Crie um aplicativo do zero e adicione um controle Button.

2. Defina a propriedade OnSelect do botão como esta fórmula:

   Coletar( Sorvete, { Sabor: "Morango", Quantidade: 300 }, { Sabor: "Chocolate", Quantidade: 100 } )

3. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

   Uma coleção chamada IceCream é criada e ela contém estes dados:

   

   Essa coleção tem dois registros e não está vazia. IsEmpty( IceCream ) retorna falso e CountRows( IceCream ) retorna 2.

4. Adicione um segundo botão e defina sua propriedade OnSelect com esta fórmula:

   Claro (Sorvete)

5. Visualize o aplicativo, clique ou toque no segundo botão e, em seguida, feche Visualizar.

   A coleção agora está vazia:

   

   A função Clear remove todos os registros de uma coleção, resultando em uma coleção vazia. IsEmpty( IceCream ) retorna verdadeiro e CountRows( IceCream ) retorna 0.

Você também pode usar IsEmpty para testar se uma tabela calculada está vazia, como mostram os exemplos: