Compartir por

DataSourceInfo Función

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 DataSourceInfo función non está soportada nas listas de Microsoft.

Descripción

Información da columna

Podes usar DataSourceInfo para obter información sobre unha columna concreta dunha fonte de datos:

Argumento de información Tipo de resultado Descripción
DataSourceInfo. Nome de visualización Cadea Nome para mostrar da columna. Se non se define o nome de pantalla, devolve o nome da columna.
DataSourceInfo. Lonxitude máxima 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. Valor máximo 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. Valor mínimo 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. Obrigatorio 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 podes usar DataSourceInfo para obter información sobre unha fonte de datos no seu conxunto:

Argumento de información Tipo de resultado Descripción
DataSourceInfo. Valores permitidos 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. Crear permiso booleano O usuario actual ten permiso para crear rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true.
DataSourceInfo. Borrar permiso booleano O usuario actual ten permiso para eliminar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true.
DataSourceInfo. Permiso de edición booleano O usuario actual ten permiso para editar rexistros nesta orixe de datos? Se non está configurado pola orixe de datos, devolve true.
DataSourceInfo. Permiso de lectura 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, a comprobación DataSourceInfo de permisos só é posible cando se usa Microsoft Dataverse.

Sintaxe

DataSourceInfo( DataSource, Information [, ColumnName] )

  • DataSource – Obrigatorio. A orixe de datos a utilizar.
  • Información – 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 mediante 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:

Exemplo de 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( Xeado, DataSourceInfo. DisplayName, Quantity :) Devolve o nome para mostrar da columna Cantidade da orixe de datos Xeado. "Cantidade dispoñible"
DataSourceInfo( Xeado, DataSourceInfo. MaxLength, Flavor ) Devolve a lonxitude máxima da cadea da columna Sabor da orixe de datos Xeado. 30
DataSourceInfo( Xeado, DataSourceInfo. Requirido, sabor :) É a columna Sabor da orixe de datos Xeado obrigatoria? verdade
DataSourceInfo( Xeado, DataSourceInfo. Obrigatorio, Cantidade :) É a columna Cantidade da orixe de datos Xeado obrigatoria? falso
DataSourceInfo( Xeado, DataSourceInfo. MaxValue, Quantity ) Devolve o valor numérico máximo da columna Cantidade da orixe de datos Xeado. 100
DataSourceInfo( Xeado, DataSourceInfo. Valor mínimo, cantidade ) Devolve o valor numérico mínimo da columna Cantidade da orixe de datos Xeado. 0
DataSourceInfo( Xeado, DataSourceInfo. ReadPermission) Pode o usuario actual ler os rexistros da orixe de datos Xeado? verdade
DataSourceInfo( Xeado, DataSourceInfo. Permiso de edición) Pode o usuario actual editar os rexistros da orixe de datos Xeado? verdade
DataSourceInfo( Xeado, DataSourceInfo. CreatePermission) Pode o usuario actual crear os rexistros da orixe de datos Xeado? falso
DataSourceInfo( Xeado, DataSourceInfo. DeletePermission) Pode o usuario actual eliminar os rexistros da orixe de datos Xeado? falso
  • Last updated on