Condividi tramite

Funzione DataSourceInfo

  • Articolo

Si applica a: App Canvas App basate su modello

Restituisce informazioni su un'origine dati.

Descrizione

Le origini dati possono offrire un'ampia gamma di informazioni per ottimizzare l'esperienza dell'utente.

È possibile usare informazioni a livello di colonna per convalidare l'input utente e inviare feedback immediato all'utente prima di usare la funzione Patch. La funzione Validate usa le stesse informazioni.

È possibile usare le informazioni a livello di origine dati, ad esempio per disabilitare o nascondere i pulsanti Modifica e Nuovo agli utenti che non hanno autorizzazioni per creare e modificare record.

Le origini dati variano in base alla quantità di informazioni che offrono e potrebbero anche non includere alcuna informazione. Le raccolte non forniscono alcuna informazione. Se non viene specificata alcuna informazione, viene usata l'impostazione predefinita o viene restituito blank.

Nota

Attualmente, la funzione DataSourceInfo non è supportata negli elenchi. Microsoft

Descrzione

Informazioni colonna

Puoi usare la funzione DataSourceInfo per ottenere informazioni su una determinata colonna di un'origine dati:

Argomento delle informazioni Tipi di risultato Descrizione
Informazioni sulla fonte dati.Nome visualizzato String Il nome visualizzato della colonna. Se non è definito alcun nome visualizzato, restituisce il nome della colonna.
DataSourceInfo.LunghezzaMassima Numero Il numero massimo di caratteri che la colonna può contenere. Si applica solo alle colonne che contengono stringhe. Se non viene impostato un valore massimo, restituisce blank.
Informazioni origine dati.Valore massimo Numero Il valore numerico massimo che può essere incluso in una colonna. Si applica solo alle colonne che contengono numeri. Se non viene impostato un valore massimo, restituisce blank.
Informazioni sulla fonte dati.Valore minimo Numero Il valore numerico minimo che può essere incluso in una colonna. Si applica solo alle colonne che contengono numeri. Se non viene impostato un valore minimo, restituisce blank.
DataSourceInfo.Obbligatorio Boolean È un valore obbligatorio per questa colonna? Se non è impostato dall'origine dati, restituisce false.

Il terzo argomento è il nome di una colonna di tipo stringa. Ad esempio, la colonna Phone nella raccolta People verrebbe passata come "Phone", incluse le virgolette doppie.

Informazioni sull'origine dati

È possibile usare la funzione DataSourceInfo per ottenere informazioni su un'origine dati intera:

Argomento delle informazioni Tipi di risultato Descrizione
Informazioni sulla fonte dati.Valori consentiti Boolean Quali tipi di autorizzazioni è possibile concedere agli utenti per questa origine dati? Se non è impostato dall'origine dati, restituisce blank.
Informazioni sulla fonte dati.Crea autorizzazione Boolean L'utente corrente ha le autorizzazioni per creare record in questa origine dati? Se non è impostato dall'origine dati, restituisce true.
DataSourceInfo.EliminaPermesso Boolean L'utente corrente ha le autorizzazioni per eliminare record in questa origine dati? Se non è impostato dall'origine dati, restituisce true.
DataSourceInfo.ModificaPermesso Boolean L'utente corrente ha le autorizzazioni per modificare record in questa origine dati? Se non è impostato dall'origine dati, restituisce true.
Autorizzazione di lettura dei dati SourceInfo Boolean L'utente corrente ha le autorizzazioni per leggere record in questa origine dati? Se non è impostato dall'origine dati, restituisce true.

Nota

DataSourceInfo restituisce true se non riesce a determinare se l'utente corrente ha l'autorizzazione richiesta. Le autorizzazioni verranno nuovamente verificate dal server quando viene eseguita l'effettiva operazione e verrà visualizzato un errore se non era consentita. In questo momento, il controllo delle autorizzazioni con DataSourceInfo è possibile solo quando si utilizza Microsoft Dataverse.

Sintassi

DataSourceInfo( DataSource, Informazioni [, ColumnName] )

  • DataSource – Obbligatorio. L'origine dati da usare.
  • Informazioni – Obbligatorio. Il tipo di informazioni che si vuole recuperare.
  • ColumnName – Facoltativo. Il nome della colonna per la quale ripristinare le informazioni a livello di colonna. Per informazioni a livello di origine dati, non può essere usato l'argomento ColumnName.

Nota

Nelle Power Apps precedenti alla versione 3.24042, i nomi delle colonne erano specificati con una stringa di testo utilizzando virgolette doppie e se collegati a un origine dati dovevano anche essere nomi logici. Ad esempio, è stato utilizzato il nome logico "cr43e_name" con virgolette doppie al posto di nome visualizzato Nome senza virgolette. Per SharePoint e le origini dati Excel che contengono nomi di colonne con spazi, ogni spazio è stato specificato con "_x0020_", ad esempio "Nome colonna" come "Nome_colonna_x0020". Dopo questa versione, tutte le app sono state aggiornate automaticamente alla nuova sintassi descritta in questo articolo.

Esempi

Gli esempi di questa sezione usano un'origine dati, denominata IceCream:

Esempio Icecream.

L'origine dati include anche le informazioni seguenti:

  • Il nome visualizzato per Quantity è "Quantity on Hand".
  • La lunghezza massima di Flavor è di 30 caratteri.
  • La colonna Flavor deve contenere un valore. La colonna Quantity non è obbligatoria.
  • Il valore minimo di Quantity è 0.
  • Il valore massimo di Quantity è 100.
  • L'utente corrente può leggere e modificare i record dell'origine dati IceCream, ma non può creare o eliminare record.
Formula Descrizione Risultato
DataSourceInfo(Gelato, DataSourceInfo.DisplayName, Quantità) Restituisce il nome visualizzato per la colonna Quantity dell'origine dati IceCream. "Quantity on Hand"
DataSourceInfo(IceCream, DataSourceInfo.MaxLength, Sapore) Restituisce la lunghezza massima della stringa per la colonna Flavor dell'origine dati IceCream. 30
DataSourceInfo(Gelato, DataSourceInfo.Obbligatorio, Gusto) La colonna Flavor dell'origine dati IceCream è obbligatoria? VERO
DataSourceInfo(Gelato, DataSourceInfo.Required, Quantità) La colonna Quantity dell'origine dati IceCream è obbligatoria? falso
DataSourceInfo(Gelato, DataSourceInfo.MaxValue, Quantità) Restituisce il valore numerico massimo per la colonna Quantity dell'origine dati IceCream. 100
DataSourceInfo(Gelato, DataSourceInfo.MinValue, Quantità) Restituisce il valore numerico minimo per la colonna Quantity dell'origine dati IceCream. 0
DataSourceInfo(IceCream, DataSourceInfo.ReadPermission) L'utente corrente può leggere record nell'origine dati IceCream? VERO
DataSourceInfo(IceCream, DataSourceInfo.EditPermission) L'utente corrente può modificare record nell'origine dati IceCream? VERO
DataSourceInfo(IceCream, DataSourceInfo.CreatePermission) L'utente corrente può creare record nell'origine dati IceCream? falso
DataSourceInfo(IceCream, DataSourceInfo.DeletePermission) L'utente corrente può eliminare record nell'origine dati IceCream? falso