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, Informació, ColumnName )

  • DataSource: obligatori. La font de dades per utilitzar.

  • Informació: obligatori. El tipus d'informació que voleu recuperar.

  • ColumnName: opcional. Per a la informació de nivell de columna, el nom de la columna com a cadena. La columna Telèfon es passaria com a "Telèfon", incloent-hi les cometes dobles. Per obtenir informació al nivell de font de les dades, l'argument ColumnName no es pot utilitzar.

    Nota

    Per a les fonts de dades del SharePoint i de l'Excel que contenen noms de columna amb espais, especifiqueu cada espai com a "_x0020_". Per exemple, especifiqueu "Nom de columna" com a "Nom_x0020_Columna".

Exemples

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

Exemple de 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, "Gust" ) Retorna la longitud màxima de la cadena per a la columna Gust de la font de dades Gelat. 30
DataSourceInfo( Gelat, DataSourceInfo.Required," Gust") La columna Gust de la font de dades Gelat és obligatòria? true
DataSourceInfo( Gelat, DataSourceInfo.Required, "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.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