Blank, Coalesce, IsBlank, e IsEmpty funções

Funções	Aplica-se a
Blank	Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse
Coalesce IsEmpty	Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages
IsBlank	Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia

Testa se um valor está em branco ou uma tabela não contém registos e oferece uma forma de criar valores blank.

Descrição Geral

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

Qualquer propriedade ou valor calculado no Power Apps pode ser blank. Por exemplo, um valor Booleano normalmente tem um dos dois valores: true ou false. Mas, além desses dois, também pode estar em branco , indicando que o estado não é conhecido. Isto é semelhante ao Microsoft Excel, em que uma célula da folha de cálculo começa em branco sem conteúdos, mas pode englobar os valores TRUE ou FALSE (entre outros). Em qualquer altura, os conteúdos da célula podem ser novamente limpos, devolvendo-o para um estado blank.

Cadeia de caracteres vazia refere-se a uma cadeia de caracteres que não contém caracteres. A função Len devolve zero para este tipo de cadeia de caracteres, que pode ser escrita numa fórmula como duas aspas duplas com nada entre "". Alguns controlos e origens de dados utilizam uma cadeia vazia para indicar uma condição "sem valor". Para simplificar a criação de aplicativos, as funções e Coalesce testam IsBlank valores em branco ou cadeias de caracteres vazias.

No contexto da IsEmpty função, vazio é específico para tabelas que não contêm registros. A estrutura da tabela pode estar intacta, completa com nomes de coluna, mas não existem dados na tabela. Uma tabela pode começar vazia, aceitar registos e deixar de estar vazia e, em seguida, remover os registos e voltar a estar vazia.

Blank

A Blank função retorna um valor em branco . Utilize esta opção para armazenar um valor NULO numa origem de dados que suporta estes valores, removendo efetivamente qualquer valor do campo.

IsBlank

A IsBlank função testa um valor em branco ou uma cadeia de caracteres vazia. O teste inclui cadeias de caracteres vazias para facilitar a criação de aplicativos, já que 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 IsBlank função considera tabelas vazias como não em branco e IsEmpty deve ser usada 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 do tratamento de erros, foi utilizado um valor em branco para representar valores nulos das bases de dados e valores de erro. O tratamento de erros separa essas duas interpretações de blank, o que pode alterar o comportamento de aplicativos existentes que continuam a usar IsBlanko .

O valor de retorno para IsBlank é um booleano true ou false.

Coalesce

A Coalesce função avalia seus argumentos em ordem e retorna o primeiro valor que não está em branco ou uma cadeia de caracteres vazia. Utilize esta função para substituir um valor em blank ou uma cadeia vazia por um valor diferente, mas deixar os valores de cadeia de caracteres não blank inalterados. Se todos os argumentos forem cadeias de caracteres vazias ou em branco, a função retornará em branco, criando Coalesce uma boa maneira de converter cadeias de caracteres vazias em valores em branco.

Coalesce( value1, value2 ) é o equivalente mais conciso e If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) não requer que value1 e value2 sejam avaliados duas vezes. A função If retorna em branco se não houver uma fórmula "else", como é o caso aqui.

Todos os argumentos devem Coalesce ser do mesmo tipo, por exemplo, você não pode misturar números com cadeias de texto. O valor de retorno de Coalesce é desse tipo comum.

IsEmpty

A IsEmpty função testa se uma tabela contém registros. É equivalente a utilizar a função CountRows e a verificação de zero. Você pode verificar erros de fonte de dados combinando IsEmpty com a função Erros .

O valor de retorno para IsEmpty é um booleano true ou false.

Sintaxe

Blank()

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

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

IsBlank( Valor )

• Valor – Obrigatório. Valor a testar para um valor blank ou cadeia vazia.

IsEmpty( Tabela )

• Tabela - Obrigatório. Tabela para testar os registos.

Exemplos

Blank

1. Crie uma aplicação a partir do zero e adicione um controlo Button.

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

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

3. Pré-visualize a sua aplicação, clique ou toque no botão que adicionou e, em seguida, feche a Pré-visualização.

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

   A coleção Cities é apresentada, mostrando um registo com "Seattle" e "Rainy":

   

5. Clique ou toque na seta para baixo para regressar à área de trabalho predefinida.

6. Adicione um controlo Label e defina a respetiva propriedade Text para esta fórmula:

   IsBlank( First( Cities ).Weather )
   

   A etiqueta mostra false porque o campo Weather contém um valor ("Rainy").

7. Adicione um segundo botão e defina a respetiva propriedade OnSelect para esta fórmula:

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

8. Pré-visualize a sua aplicação, clique ou toque no botão que adicionou e, em seguida, feche a Pré-visualização.

   O campo Weather do primeiro registo em Cities é substituído por blank, removendo o "Rainy" anterior.

   

   A etiqueta mostra true porque o campo Weather já não contém um valor.

Coalesce

IsBlank

1. Crie uma aplicação a partir do zero, adicione um controlo de entrada de texto e dê-lhe o nome FirstName.

2. Adicione uma etiqueta e defina a propriedade Text para esta fórmula:

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

   Por predefinição, a propriedade Text de um controlo de entrada de texto está definida como "Text input". Porque a propriedade contém um valor, não está em branco e a etiqueta não apresenta qualquer mensagem.

3. Remova todos os carateres do controlo da entrada de texto, incluindo quaisquer espaços.

   Como a propriedade Text não contém mais caracteres, é uma cadeia de caracteres vazia e IsBlank( FirstName.Text ) é true. É apresentada a mensagem de campo obrigatório.

Para obter informações sobre como realizar a validação com outras ferramentas, veja a função Validate e trabalhar com origens de dados.

Outros exemplos:

IsEmpty

1. Crie uma aplicação a partir do zero e adicione um controlo Button.

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

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

3. Pré-visualize a sua aplicação, clique ou toque no botão que adicionou e, em seguida, feche a Pré-visualização.

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

   

   Esta coleção tem dois registos e não está vazia. IsEmpty( IceCream ) retorna false, e CountRows( IceCream ) retorna 2.

4. Adicione um segundo botão e defina a respetiva propriedade OnSelect para esta fórmula:

   Clear( Sorvete )

5. Pré-visualize a sua aplicação, clique ou toque no segundo botão e, em seguida, feche a Pré-visualização.

   A coleção está agora vazia:

   

   A função Clear remove todos os registos de uma coleção, o que resulta numa recolha vazia. IsEmpty( IceCream ) retorna true, e CountRows( IceCream ) retorna 0.

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