Función DataSourceInfo
Se aplica a:
Aplicaciones de Canvas Aplicaciones basadas en modelos
Proporciona información sobre un origen de datos.
Introducción
Los orígenes de datos pueden proporcionar una gran cantidad de información para optimizar la experiencia del usuario.
Puede usar información de nivel de columna para validar entradas de usuario y proporcionar una respuesta inmediata al usuario antes de usar la función Patch. La función Validate usa esta misma información.
Puede usar información en el nivel de origen de datos para, por ejemplo, deshabilitar u ocultar los botones Editar y Nuevo de los usuarios que no tienen permisos para editar y crear registros.
Los orígenes de datos varían en la cantidad de información que proporcionan; incluso pueden no ofrecer ninguna. Las colecciones no proporcionan ninguna información. Si no se proporciona una parte de la información, se utilizará el valor predeterminado o se devolverá blank.
Nota
Actualmente, la función DataSourceInfo no es compatible con las listas. Microsoft
Description
Información de columna
Puede usar DataSourceInfo para obtener información sobre una columna concreta de un origen de datos:
| Argumento de información | Tipo de resultado | Descripción |
|---|---|---|
| Información de origen de datos.Nombre para mostrar | Cadena | Nombre para mostrar de la columna. Si no se ha definido ningún nombre para mostrar, devolverá el nombre de la columna. |
| Información de origen de datos.Longitud máxima | Número | Número máximo de caracteres que puede contener la columna. Solo se aplica a las columnas que contienen cadenas. Si no se configura un máximo, devuelve blank. |
| Información de origen de datos.Valor máximo | Número | Valor numérico máximo que puede contener una columna. Solo se aplica a las columnas que contienen números. Si no se configura un máximo, devuelve blank. |
| Información de origen de datos.Valor mínimo | Número | Valor numérico mínimo que puede contener una columna. Solo se aplica a las columnas que contienen números. Si no se configura un mínimo, devuelve blank. |
| Información de origen de datos.Obligatorio | Booleano | ¿Es un valor requerido para esta columna? Si no se establece mediante el origen de datos devuelve false. |
El tercer argumento es el nombre de una columna como una cadena. Por ejemplo, la columna Teléfono de la colección Personas se pasaría como "Teléfono" incluidas las comillas dobles.
Información de origen de datos
Puede usar DataSourceInfo para obtener información sobre un origen de datos como un todo:
| Argumento de información | Tipo de resultado | Descripción |
|---|---|---|
| Información de origen de datos.Valores permitidos | Booleano | ¿Qué tipos de permisos se les pueden conceder a los usuarios para este origen de datos? Si no se establecen mediante el origen de datos, se devuelve blank. |
| Información de origen de datos.Crear permiso | Booleano | ¿Tiene permiso el usuario actual para crear registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true. |
| Información de origen de datos.Permiso de eliminación | Booleano | ¿Tiene permiso el usuario actual para eliminar registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true. |
| Información de origen de datos.Permiso de edición | Booleano | ¿Tiene permiso el usuario actual para editar registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true. |
| Información de origen de datos.Permiso de lectura | Booleano | ¿Tiene permiso el usuario actual para leer registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true. |
Nota
DataSourceInfo devuelve verdadero si no puede determinar si el usuario actual tiene el permiso solicitado. El servidor volverá a comprobar los permisos cuando se lleve a cabo la operación real y se mostrará un error si no se permitió. En este momento, verificar los permisos con DataSourceInfo solo es posible cuando se usa Microsoft Dataverse.
Sintaxis
DataSourceInfo( DataSource, Información [, NombreDeColumna] )
- Fuente de datos : obligatoria. El origen de datos que se va a usar.
- Información – Obligatoria. El tipo de información que desea recuperar.
- ColumnName – Opcional. El nombre de la columna para la que recuperar la información en el nivel de columna. Para la información en el nivel de origen de datos, el argumento ColumnName no se puede usar.
Nota
En Power Apps antes de la versión 3.24042, los nombres de las columnas se especificaban con una cadena de texto usando comillas dobles y, si estaban conectadas a un origen de datos también debían ser nombres lógicos. Por ejemplo, se utilizó el nombre lógico "cr43e_name" con comillas dobles en lugar del nombre Name sin comillas. Para orígenes de datos de SharePoint y Excel que contienen nombres de columnas con espacios, cada espacio se especificó con "_x0020_", por ejemplo "Column Name" como "Column_x0020_Name". Después de esta versión, todas las aplicaciones se actualizaron automáticamente a la nueva sintaxis descrita en este artículo.
Ejemplos
Los ejemplos de esta sección usan este origen de datos, denominado IceCream:
El origen de datos también ha proporcionado esta información:
- El nombre para mostrar para Quantity es "Cantidad disponible".
- La longitud máxima de Flavor es de 30 caracteres.
- La columna Flavor debe contener un valor. La columna Quantity no se requiere.
- La cantidad mínima es 0.
- La cantidad máxima es 100.
- El usuario actual puede leer y editar los registros del origen de datos IceCream, pero no se pueden crear ni eliminar registros.
| Fórmula | Descripción | Resultado |
|---|---|---|
| DataSourceInfo(Helado, DataSourceInfo.DisplayName, Cantidad) | Devuelve el nombre para mostrar de la columna Quantity del origen de datos IceCream. | "Cantidad disponible" |
| DataSourceInfo(Helado, DataSourceInfo.MaxLength, Sabor) | Devuelve la longitud máxima de la cadena para la columna Flavor del origen de datos IceCream. | 30 |
| DataSourceInfo(Helado, DataSourceInfo.Requerido, Sabor) | ¿Se requiere la columna Flavor del origen de datos IceCream? | verdadero |
| DataSourceInfo(Helado, DataSourceInfo.Requerido, Cantidad) | ¿Se requiere la columna Quantity del origen de datos IceCream? | FALSO |
| DataSourceInfo(Helado, DataSourceInfo.MaxValue, Cantidad) | Devuelve el valor numérico máximo de la columna Quantity del origen de datos IceCream. | 100 |
| DataSourceInfo(Helado, DataSourceInfo.MinValue, Cantidad) | Devuelve el valor numérico mínimo de la columna Quantity del origen de datos IceCream. | 0 |
| DataSourceInfo(Helado, DataSourceInfo.ReadPermission) | ¿Puede leer el usuario actual los registros del origen de datos IceCream? | verdadero |
| DataSourceInfo(Helado, DataSourceInfo.EditPermission) | ¿Puede editar el usuario actual los registros del origen de datos IceCream? | verdadero |
| DataSourceInfo(Helado, DataSourceInfo.CreatePermission) | ¿Puede crear el usuario actual los registros del origen de datos IceCream? | FALSO |
| DataSourceInfo(Helado, DataSourceInfo.DeletePermission) | ¿Puede eliminar el usuario actual los registros del origen de datos IceCream? | FALSO |