Función DataSourceInfo en Power Apps

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.

Descripción

Información de 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 falso.

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 verdadeiro.
DataSourceInfo.DeletePermission Booleano O usuario actual ten permiso para eliminar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve verdadeiro.
DataSourceInfo.EditPermission Booleano O usuario actual ten permiso para editar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve verdadeiro.
DataSourceInfo.ReadPermission Booleano O usuario actual ten permiso para ler rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve verdadeiro.

Sintaxe

DataSourceInfo ( DataSource , Information , ColumnName )

  • DataSource : necesario. A orixe de datos a utilizar.

  • Información – Obrigatorio. O tipo de información que desexa recuperar.

  • ColumnName – Opcional. Para información a nivel de columna, o nome de columna como cadea. A columna Teléfono pasaríase como "Teléfono" , incluídas as comiñas dobres. Para obter información a nivel de orixe de datos, non se pode usar o argumento ColumnName.

    Nota

    Para SharePoint e orixes de datos de Excel que conteñen nomes de columna con espazos, especifique cada espazo como "_x0020_". Por exemplo, especifique o "Column Name" como "Column_x0020_Name".

Exemplos

Os exemplos desta sección usan esta orixe de datos, chamada Xeado :

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, "Quantity" ) É a columna Cantidade da orixe de datos Xeado obrigatoria? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Devolve o valor numérico máximo da columna Cantidade da orixe de datos Xeado. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) 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