Función DataSourceInfo
Aplícase a:
Aplicacións de lenzo Aplicacións baseadas en modelos
Ofrece información sobre a orixe de datos.
Visión xeral
As orixes de datos poden proporcionar unha ampla información para optimizar a experiencia do usuario.
Pode usar información de nivel de columna-para validar a entrada do usuario e proporcionar comentarios inmediatos ao usuario antes de usar a función Patch. A función Validate usa esta mesma información.
Pode usar información a nivel de orixe de datos, por exemplo, para desactivar ou ocultar os botóns Editar e Novo para usuarios que non teñen permisos para editar e crear rexistros.
As orixes de datos varían na cantidade de información que fornecen, incluso sen proporcionar ningunha. As coleccións non proporcionan información. Se non se proporciona unha información, úsase un valor por defecto ou devólvese en branco.
Nota
Actualmente, a función DataSourceInfo non é compatible con Microsoft Lists.
Descripción
Información da columna
Pode usar DataSourceInfo para obter información sobre unha columna particular dunha orixe de datos:
| Argumento de información | Tipo de resultado | Descripción |
|---|---|---|
| DataSourceInfo.DisplayName | Cadea | Nome para mostrar da columna. Se non se define o nome de pantalla, devolve o nome da columna. |
| DataSourceInfo.MaxLength | Número | Número máximo de caracteres que pode conter a columna. Aplícase só ás columnas que conteñen cadeas. Se non se establece un máximo, devolve en branco. |
| DataSourceInfo.MaxValue | Número | Valor numérico máximo que pode conter unha columna. Aplícase só ás columnas que conteñen números. Se non se establece un máximo, devolve en branco. |
| DataSourceInfo.MinValue | Número | Valor numérico mínimo que pode conter unha columna. Aplícase só ás columnas que conteñen números. Se non se establece un mínimo, devolve en branco. |
| DataSourceInfo.Required | Booleano | Requírese un valor para esta columna? Se non está configurado pola orixe de datos, devolve false. |
O terceiro argumento é o nome dunha columna como unha cadea. Por exemplo, a columna Teléfono da colección Xente pasaríase como "Teléfono" incluídas as comiñas dobres.
Información da orixe de datos
Tamén pode usar DataSourceInfo para obter información sobre unha orixe de datos en conxunto:
| Argumento de información | Tipo de resultado | Descripción |
|---|---|---|
| DataSourceInfo.AllowedValues | Booleano | Que tipos de permisos se poden conceder aos usuarios para esta orixe de datos? Se non está configurado pola orixe de datos, devolve en branco. |
| DataSourceInfo.CreatePermission | Booleano | O usuario actual ten permiso para crear rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true. |
| DataSourceInfo.DeletePermission | Booleano | O usuario actual ten permiso para eliminar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true. |
| DataSourceInfo.EditPermission | Booleano | O usuario actual ten permiso para editar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true. |
| DataSourceInfo.ReadPermission | Booleano | O usuario actual ten permiso para ler rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true. |
Nota
DataSourceInfo devolve true se non pode determinar se o usuario actual ten o permiso solicitado. O servidor comprobará de novo os permisos cando se realice a operación real e amósase un erro se non se permitiu. Neste momento, comprobar permisos con DataSourceInfo só é posible cando se usa Microsoft Dataverse.
Sintaxe
DataSourceInfo( DataSource, Information [, ColumnName ])
- DataSource – Obrigatorio. A orixe de datos a utilizar.
- Information – Obrigatorio. O tipo de información que desexa recuperar.
- ColumnName – Opcional. O nome da columna para a que se quere recuperar a información a nivel de columna. Para obter información a nivel de orixe de datos, non se pode usar o argumento ColumnName.
Nota
En Power Apps anterior á versión 3.24042, os nomes das columnas eran especificados cunha cadea de texto usando comiñas dobres e, se estaban conectados a un orixe de datos, tamén debían ser nomes lóxicos. Por exemplo, utilizouse o nome lóxico "cr43e_name" con comiñas dobres en lugar do nome para mostrar Nome sen comiñas. Para fontes de datos SharePoint e Excel que conteñen nomes de columnas con espazos, cada espazo especificouse con "_x0020_", por exemplo "Nome da columna" as "Nome_x0020_columna". Despois desta versión, todas as aplicacións actualizáronse automaticamente á nova sintaxe descrita neste artigo.
Exemplos
Os exemplos desta sección usan esta orixe de datos, chamada Xeado:
O orixe de datos tamén proporcionou esta información:
- O nome para mostrar de Cantidade é "Cantidade dispoñible".
- A lonxitude máxima do Sabor é 30 caracteres.
- A columna Sabor debe conter un valor. A columna Cantidade non é necesaria.
- A Cantidade mínima é 0.
- A Cantidade máxima é 100.
- O usuario actual pode ler e editar os rexistros da orixe de datos Xeado pero non pode crear nin eliminar rexistros.
| Fórmula | Descripción | Resultado |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) | Devolve o nome para mostrar da columna Cantidade da orixe de datos Xeado. | "Cantidade dispoñible" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) | Devolve a lonxitude máxima da cadea da columna Sabor da orixe de datos Xeado. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) | É a columna Sabor da orixe de datos Xeado obrigatoria? | true |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Cantidade ) | É a columna Cantidade da orixe de datos Xeado obrigatoria? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Cantidade ) | Devolve o valor numérico máximo da columna Cantidade da orixe de datos Xeado. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, Cantidade ) | Devolve o valor numérico mínimo da columna Cantidade da orixe de datos Xeado. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Pode o usuario actual ler os rexistros da orixe de datos Xeado? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Pode o usuario actual editar os rexistros da orixe de datos Xeado? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Pode o usuario actual crear os rexistros da orixe de datos Xeado? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Pode o usuario actual eliminar os rexistros da orixe de datos Xeado? | false |