BlankFunzioni , CoalesceIsBlank, , e IsEmpty

Functions	Si applica a:
Blank	App Canvas Copilot Studio Flussi desktop Colonne formula di Dataverse App basate su modello Funzioni dell'interfaccia della riga di comando di Power Platform
Coalesce IsEmpty	App canvas Flussi desktop di Copilot Studio App basate su modello Funzioni power platform dell'interfaccia della riga di comando di Power Platform Power Pages
IsBlank	App Canvas Copilot Studio Flussi desktop Colonne formula di Dataverse App basate su modello Funzioni powerverse dell'interfaccia della riga di comando di Power Platform Power Pages

Verificano se un valore è blank oppure se una tabella non contiene alcun record e consentono di creare valori blank.

Panoramica

Blankè un segnaposto per "nessun valore" o "valore sconosciuto". Ad esempio, la proprietà Selected di un controllo Casella combinata è vuota se l'utente non ha effettuato una selezione. Molte origini dati possono archiviare e restituire valori NULL, che sono rappresentati in Power Apps come blank.

Ogni proprietà o valore calcolato in Power Apps può essere blank. Ad esempio, un valore booleano in genere ha uno dei due valori true o false. Ma oltre a questi due, può anche essere vuoto a indicare che lo stato non è noto. Ciò è simile a Microsoft Excel, dove una cella di un foglio di lavoro parte da uno stato blank senza contenuti, ma può contenere i valori TRUE o FALSE, tra gli altri. In qualsiasi momento, è possibile rimuovere di nuovo il contenuto della cella, riportandola a uno stato blank.

Una stringa vuota si riferisce a una stringa che non contiene caratteri. La funzione funzione Len restituisce zero per tale stringa e può essere scritta in formule come due virgolette doppie senza nulla tra "". Alcuni controlli e origini dati utilizzano una stringa vuota per indicare una condizione "nessun valore". Per semplificare la creazione dell'app, le IsBlank funzioni e Coalesce testano sia i valori vuoti che le stringhe vuote.

Nel contesto della IsEmpty funzione , empty è specifico per le tabelle che non contengono record. La struttura della tabella potrebbe essere intatta, completa di nomi di colonna, ma non contenere dati. Una tabella può iniziare vuota, accettare record e non essere più vuota, ma se i record vengono rimossi, la tabella sarà di nuovo vuota.

Blank

La Blank funzione restituisce un valore vuoto . Usarla per archiviare un valore NULL in un'origine dati che supporta questi valori, rimuovendo effettivamente qualsiasi valore dal campo.

IsBlank

La IsBlank funzione verifica un valore vuoto o una stringa vuota. Il test include stringhe vuote per semplificare la creazione dell'app perché alcune origini dati e controlli usano una stringa vuota quando non è presente alcun valore. Per testare in modo specifico un valore vuoto , usare if(Value = Blank(), ... anziché IsBlank. La IsBlank funzione considera le tabelle vuote come non vuote e IsEmpty deve essere usata per testare una tabella.

Quando si abilita la gestione degli errori per le app esistenti, è consigliabile sostituire IsBlank con IsBlankOrError per mantenere il comportamento esistente dell'app. Prima dell'aggiunta della gestione degli errori, un valore vuoto è stato utilizzato per rappresentare sia i valori null dai database che i valori di errore. La gestione degli errori separa queste due interpretazioni di blank, che potrebbero modificare il comportamento delle app esistenti che continuano a usare IsBlank.

Il valore restituito per IsBlank è un valore booleano true o false.

Coalesce

La Coalesce funzione valuta gli argomenti in ordine e restituisce il primo valore che non è vuoto o una stringa vuota. Usare questa funzione per sostituire un valore blank o una stringa vuota con un valore diverso, senza modificare i valori non blank e le stringhe non vuote. Se tutti gli argomenti sono stringhe vuote o vuote, la funzione restituisce blank, rendendo Coalesce un buon modo per convertire le stringhe vuote in valori vuoti .

Coalesce( value1, value2 ) è l'equivalente più conciso di If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) e non richiede che valore1 e valore2 vengano valutati due volte. La funzione If restituisce vuoto se non è presente alcuna formula "else", come nel caso qui.

Tutti gli argomenti di devono Coalesce essere dello stesso tipo, ad esempio non è possibile combinare numeri con stringhe di testo. Il valore restituito da Coalesce è di questo tipo comune.

IsEmpty

La IsEmpty funzione verifica se una tabella contiene record. È equivalente all'uso della funzione CountRows e del controllo dei valori zero. È possibile verificare la presenza di errori di origine dati combinando IsEmpty con la funzione Errors .

Il valore restituito per IsEmpty è un valore booleano true o false.

Sintassi

Blank()

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

• Valori – Obbligatorio. Valori da testare. Ogni valore viene valutato in ordine fino a quando non viene trovato un valore non vuoto e non una stringa vuota. I valori dopo questo punto non vengono valutati.

IsBlank( Valore )

• Valore – Obbligatorio. Valore in cui verificare la presenza di un valore blank o una stringa vuota.

IsEmpty( Tabella )

• Tabella - Obbligatorio. Tabella in cui verificare la presenza di record.

Esempi

Blank

1. Creare un'applicazione da zero e aggiungere un controllo Button.

2. Impostare la proprietà OnSelect del pulsante su questa formula:

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

3. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.

4. Nel menu File scegliere o toccare Raccolte.

   Viene visualizzata la raccolta Cities, che mostra un solo record con "Seattle" e "Rainy" (Piovoso):

   

5. Scegliere o toccare la freccia Indietro per tornare all'area di lavoro predefinita.

6. Aggiungi un controllo Label e impostane la proprietà Text sulla formula seguente:

   IsBlank( First( Cities ).Weather )
   

   L'etichetta mostra false perché il campo Weather contiene un valore ("Rainy").

7. Aggiungere un secondo pulsante e impostare la relativa proprietà OnSelect su questa formula:

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

8. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.

   Il campo Weather del primo record in Cities viene sostituito con un valore blank, rimuovendo il precedente valore "Rainy".

   

   L'etichetta mostra true perché il campo Weather non contiene più un valore.

Coalesce

Formula	Descrizione	Risultato
Coalesce( Blank(), 1 )	Verifica il valore restituito dalla Blank funzione, che restituisce sempre un valore vuoto . Poiché il primo argomento è blank, la valutazione continua con l'argomento successivo, fino a quando non viene trovato un valore non blank e una stringa non vuota.	1
Coalesce( "", "2" )	Verifica il primo argomento, ovvero una stringa vuota. Poiché il primo argomento è una stringa vuota, la valutazione continua con l'argomento successivo, fino a quando non viene trovato un valore non blank e una stringa non vuota.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce inizia all'inizio dell'elenco di argomenti e valuta ogni argomento a sua volta fino a quando non viene trovata una stringa non vuota e non vuota. In questo caso i primi quattro argomenti restituiscono tutti blank o una stringa non vuota, quindi la valutazione continua fino al quinto argomento. Il quinto argomento è di tipo non blank e una stringa non vuota, quindi la valutazione si interrompe. Viene restituito il valore del quinto argomento e il sesto argomento non viene valutato.	3
Coalesce( "" )	Verifica il primo argomento, ovvero una stringa vuota. Poiché il primo argomento è una stringa vuota e non ci sono altri argomenti, la funzione restituisce blank.	vuoto

IsBlank

1. Creare un'app da zero, aggiungere un controllo input di testo e denominarlo FirstName.

2. Aggiungi un'etichetta e impostane la proprietà Text sulla formula seguente:

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

   Per impostazione predefinita, la proprietà Text di un controllo text-input è impostata su "Input di testo". Dato che la proprietà contiene un valore, non è blank e l'etichetta non visualizza alcun messaggio.

3. Rimuovere tutti i caratteri dal controllo text-input, inclusi gli spazi.

   Poiché la proprietà Text non contiene più caratteri, è una stringa vuota e IsBlank( FirstName.Text ) è true. Viene visualizzato il messaggio del campo obbligatorio.

Per informazioni su come eseguire la convalida usando altri strumenti, vedere la funzione Validate e come usare le origini dati.

Altri esempi:

Formula	Descrizione	Risultato
IsBlank( Blank() )	Verifica il valore restituito dalla Blank funzione, che restituisce sempre un valore vuoto .	VERO
IsBlank( "" )	Una stringa che non contiene caratteri.	VERO
IsBlank( "Hello" )	Una stringa che contiene uno o più caratteri.	falso
IsBlank( AnyCollection )	Poiché la raccolta esiste, non è blank, anche se non contiene alcun record. Per verificare la presenza di una raccolta vuota, usare IsEmpty invece .	falso
IsBlank( Mid( "Hello", 17, 2 ) )	Il carattere iniziale per Mid si trova oltre la fine della stringa. Il risultato è una stringa vuota.	VERO
IsBlank( If( false, false ) )	Una funzione If senza ElseResult. Poiché la condizione è sempre false, la funzione If restituisce sempre blank.	VERO

IsEmpty

1. Creare un'applicazione da zero e aggiungere un controllo Button.

2. Impostare la proprietà OnSelect del pulsante su questa formula:

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 100} )

3. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.

   Viene creata una raccolta denominata IceCream contenente i seguenti dati:

   

   Questa raccolta ha due record e non è vuota. IsEmpty( IceCream ) restituisce false e CountRows( IceCream ) restituisce 2.

4. Aggiungi un secondo pulsante e impostare la relativa proprietà OnSelect su questa formula:

   Chiaro (gelato)

5. Visualizzare un'anteprima dell'app, scegliere o toccare il secondo pulsante e quindi chiudere l'anteprima.

   La raccolta è ora vuota:

   

   La funzione Clear rimuove tutti i record da una raccolta e restituisce una raccolta vuota. IsEmpty( IceCream ) restituisce true e CountRows( IceCream ) restituisce 0.

È anche possibile usare IsEmpty per verificare se una tabella calcolata è vuota, come illustrato negli esempi seguenti:

Formula	Descrizione	Risultato
IsEmpty( [ 1, 2, 3 ] )	La tabella a colonna singola contiene tre record, quindi non è vuota.	falso
IsEmpty( [ ] )	La tabella a colonna singola non contiene alcun record, quindi è vuota.	VERO
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	La tabella a colonna singola non contiene valori maggiori di 5. Il risultato del filtro non contiene alcun record, quindi è vuoto.	VERO