Blank, Coalesce, IsBlanke IsEmpty funções

Functions	Aplica-se a
Blank	Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos baseados em modelo funções do Power Platform CLI Dataverse
Coalesce IsEmpty	Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages
IsBlank	Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages

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 "sem valor" ou "valor desconhecido". Por exemplo, a propriedade Selected de um controle de caixa de combinação estará 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, também pode estar 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.

Cadeia de caracteres vazia refere-se a uma cadeia de caracteres 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 do aplicativo, o teste de funções e Coalesce de IsBlank funções para valores em branco ou cadeias de caracteres vazias.

No contexto da função, vazioIsEmpty é 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.

Blank

A Blank função 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

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 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 para um uso if(Value = Blank(), ... de valor em branco 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 por IsBlankIsBlankOrError 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 alterar o comportamento dos aplicativos existentes que continuam a ser usados IsBlank.

O valor retornado é IsBlank um valor booliano verdadeiro ou falso.

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. 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 estiverem em branco ou em cadeias de caracteres vazias, 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 exige que value1 e value2 sejam avaliados duas vezes. A função If retornará em branco se não houver nenhuma 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 caracteres de texto. O valor retornado é Coalesce desse tipo comum.

IsEmpty

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

O valor retornado é IsEmpty um valor booliano verdadeiro ou falso.

Sintaxe

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Value(s) – obrigatório. Valores a serem testados. 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 esse ponto não são avaliados.

IsBlank( Valor )

• Value – 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

Blank

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 caracteres, é uma cadeia de caracteres vazia e IsBlank( FirstName.Text ) é verdadeira. 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:

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 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 false, e CountRows(IceCream) retorna 2.

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

   Clear( IceCream )

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 true, e CountRows(IceCream) retorna 0.

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