Funció DataSourceInfo
S'aplica a: Aplicacions del 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 cap informació. Si no es proporciona cap informació, s'utilitza un valor per defecte o es retorna en blanc.
Nota
Actualment, la funció DataSourceInfo no està admesa a les 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.DisplayName | Cadena | Nom de visualització de la columna. Si no es defineix cap nom de visualització, retorna el nom de la columna. |
DataSourceInfo.MaxLength | 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.MaxValue | 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.MinValue | 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.Required | Boolean | 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 general:
Argument d'informació | Tipus de resultat | Descripció |
---|---|---|
DataSourceInfo.AllowedValues | Boolean | 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 | Boolean | 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 | Boolean | 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.EditPermission | Boolean | 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.ReadPermission | Boolean | 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 cert 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 amb DataSourceInfo només és possible quan s'utilitza el Microsoft Dataverse.
Sintaxi
DataSourceInfo ( DataSource, Information [, ColumnName] )
- DataSource: obligatori. La font de dades per utilitzar.
- Informació: obligatori. El tipus d'informació que voleu recuperar.
- ColumnName: opcional. El nom de la columna per al qual es recupera la informació del 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 utilitzant 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 i que contenen noms de columna amb espais, cada espai s'ha especificat amb "_x0020_", per exemple "Nom de la columna" com"Column_x0020_Name ". Després d'aquesta versió, totes les aplicacions s'han actualitzat 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 ( IceCream, 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.Required, Sabor ) | La columna Gust de la font de dades Gelat és obligatòria? | true |
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantitat ) | La columna Quantitat de la font de dades Gelat és obligatòria? | false |
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantitat ) | Retorna el valor numèric màxim de la columna Quantitat de la font de dades Gelat. | 100 |
DataSourceInfo ( IceCream, DataSourceInfo.MinValue, Quantitat ) | Retorna el valor numèric mínim de la columna Quantitat de la font de dades Gelat. | 0 |
DataSourceInfo( Gelat, DataSourceInfo.ReadPermission) | L'usuari actual pot llegir registres a la font de dades Gelat? | true |
DataSourceInfo( Gelat, DataSourceInfo.EditPermission) | L'usuari actual pot editar registres a la font de dades Gelat? | true |
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 |