DataSourceInfo funció

S'aplica a: Aplicacions de llenç Aplicacions basades en models

Proporciona informació sobre una font de dades.

Informació general

Les fonts de dades poden proporcionar una gran quantitat d'informació per optimitzar l'experiència de l'usuarisi.

Podeu utilitzar la informació de nivell de columna per validar les entrades de l'usuari i facilitar la resposta immediata a l'usuari abans d'utilitzar la funció Patch. La funció Validate utilitza aquesta mateixa informació.

Podeu utilitzar la informació del nivell de font de dades, per exemple, per inhabilitar o amagar els botons Edita i Nou per als usuaris que no tinguin permisos per editar i crear registres.

Les fonts de dades varien segons la quantitat d'informació que proporcionen i, fins i tot, pot ser que no en proporcionin. Les col·leccions no proporcionen informació. Si no es proporciona cap informació, s'utilitza un valor per defecte o es retorna en blanc.

Nota

Actualment, la funció no és compatible amb les DataSourceInfo llistes de Microsoft.

Descripció

Informació de la columna

Podeu utilitzar DataSourceInfo per obtenir informació sobre una columna concreta d'una font de dades:

Argument d'informació	Tipus de resultat	Descripció
DataSourceInfo. Nom de visualització	Cadena	Nom de visualització de la columna. Si no es defineix cap nom de visualització, retorna el nom de la columna.
DataSourceInfo. Longitud màxima	Número	Nombre màxim de caràcters que pot tenir la columna. Només s'aplica a les columnes que contenen cadenes. Si un màxim no està definit, retorna en blanc.
DataSourceInfo. Valor màxim	Número	Valor numèric màxim que pot tenir una columna. Només s'aplica a les columnes que contenen números. Si un màxim no està definit, retorna en blanc.
DataSourceInfo. Valor mínim	Número	Valor numèric mínim que pot tenir una columna. Només s'aplica a les columnes que contenen números. Si un mínim no està definit, retorna en blanc.
DataSourceInfo. Obligatori	booleà	Es necessita un valor per a aquesta columna? Si no s'ha definit per la font de dades, retorna fals.

El tercer argument és el nom d'una columna com a cadena. Per exemple, la columna Telèfon de la col·lecció Persones es passa com a "Telèfon" incloent-hi les cometes dobles.

Informació de la font de dades

També podeu utilitzar DataSourceInfo per obtenir informació sobre una font de dades en el seu conjunt:

Argument d'informació	Tipus de resultat	Descripció
DataSourceInfo. Valors permesos	booleà	Quins tipus de permisos es poden concedir als usuaris per a aquesta font de dades? Si no s'ha definit per la font de dades, retorna en blanc.
DataSourceInfo. CreatePermission	booleà	L'usuari actual té permisos per crear registres en aquesta font de dades? Si no s'ha definit per la font de dades, retorna cert.
DataSourceInfo. DeletePermission	booleà	L'usuari actual té permisos per suprimir registres en aquesta font de dades? Si no s'ha definit per la font de dades, retorna cert.
DataSourceInfo. Permís d'edició	booleà	L'usuari actual té permisos per editar registres en aquesta font de dades? Si no s'ha definit per la font de dades, retorna cert.
DataSourceInfo. Permís de lectura	booleà	L'usuari actual té permisos per llegir registres en aquesta font de dades? Si no s'ha definit per la font de dades, retorna cert.

Nota

DataSourceInfo Retorna true si no pot determinar si l'usuari actual té el permís sol·licitat. El servidor torna a comprovar els permisos quan es duu a terme l'operació real i es visualitza un error si no està permesa. En aquest moment, la comprovació de permisos només és possible quan DataSourceInfo s'utilitza el Microsoft Dataverse.

Sintaxi

DataSourceInfo( Font de dades, Informació [, NomColumna] )

• DataSource : obligatori. La font de dades per utilitzar.
• Informació : obligatòria. El tipus d'informació que voleu recuperar.
• ColumnName : opcional. El nom de la columna per a la qual es recupera la informació de nivell de columna. Per obtenir informació al nivell de font de les dades, l'argument ColumnName no es pot utilitzar.

Nota

Abans Power Apps de la versió 3.24042, els noms de columna s'especificaven amb una cadena de text entre cometes dobles, i si es connectaven a un font de dades també havien de ser noms lògics. Per exemple, es va utilitzar el nom lògic "cr43e_name" amb cometes dobles en lloc del nom de visualització Nom sense cometes. Per a SharePoint les fonts de dades de l'Excel que contenen noms de columna amb espais, cada espai s'ha especificat amb "_x0020_", per exemple "Nom de columna" Column_x0020_Name ". Després d'aquesta versió, totes les aplicacions s'actualitzaven automàticament a la nova sintaxi descrita en aquest article.

Exemples

Els exemples d'aquesta secció utilitzen aquesta font de dades, anomenada Gelat:

La font de dades també ha facilitat aquesta informació:

• El nom de visualització per a la Quantitat és "Quantitat disponible".
• La longitud màxima de Gust és de 30 caràcters.
• La columna Gust ha de contenir un valor. La columna Quantitat no és necessària.
• La Quantitat mínima és 0.
• La Quantitat màxima és 100.
• L'usuari actual pot llegir i editar els registres de la font de dades Gelat però no pot crear ni suprimir registres.

Fórmula	Descripció	Resultat
DataSourceInfo( Gelat, DataSourceInfo. DisplayName, Quantitat )	Torna el nom de visualització de la columna Quantitat de la font de dades Gelat.	"Quantitat disponible"
DataSourceInfo( Gelat, DataSourceInfo. MaxLength, Sabor )	Retorna la longitud màxima de la cadena per a la columna Gust de la font de dades Gelat.	30
DataSourceInfo( Gelat, DataSourceInfo. Obligatori, Sabor )	La columna Gust de la font de dades Gelat és obligatòria?	veritable
DataSourceInfo( Gelat, DataSourceInfo. Obligatori, quantitat )	La columna Quantitat de la font de dades Gelat és obligatòria?	fals
DataSourceInfo( Gelat, DataSourceInfo. MaxValue, Quantitat )	Retorna el valor numèric màxim de la columna Quantitat de la font de dades Gelat.	100
DataSourceInfo( Gelat, DataSourceInfo. MinValue, Quantitat )	Retorna el valor numèric mínim de la columna Quantitat de la font de dades Gelat.	0
DataSourceInfo( Gelat, DataSourceInfo. Permís de lectura)	L'usuari actual pot llegir registres a la font de dades Gelat?	veritable
DataSourceInfo( Gelat, DataSourceInfo. Permís d'edició)	L'usuari actual pot editar registres a la font de dades Gelat?	veritable
DataSourceInfo( Gelat, DataSourceInfo. CreatePermission)	L'usuari actual pot crear registres a la font de dades Gelat?	fals
DataSourceInfo( Gelat, DataSourceInfo. DeletePermission)	L'usuari actual pot suprimir registres a la font de dades Gelat?	fals