Función DataSourceInfo en PowerAppsDataSourceInfo function in PowerApps

Proporciona información sobre un origen de datos.Provides information about a data source.

Información generalOverview

Los orígenes de datos pueden proporcionar una gran cantidad de información para optimizar la experiencia del usuario.Data sources can provide a wealth of information to optimize the user experience.

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 Revisión.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. La función Validate usa esta misma información.The Validate function uses this same information.

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.You can use information at the data-source level, for example, to disable or hide Edit and New buttons for users who don't have permissions to edit and create records.

Los orígenes de datos varían en la cantidad de información que proporcionan; incluso pueden no ofrecer ninguna.Data sources vary in how much information they provide, including not providing any at all. Las colecciones no proporcionan ninguna información.Collections provide no information. Si no se proporciona una parte de la información, se utilizará el valor predeterminado o se devolverá en blanco.If a piece of information isn't provided, a default is used, or blank is returned.

DescripciónDescription

Información de columnaColumn information

Puede usar DataSourceInfo para obtener información sobre una columna concreta de un origen de datos:You can use DataSourceInfo to obtain information about a particular column of a data source:

Argumento de informaciónInformation Argument Tipo de resultadoResult Type DescripciónDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName CadenaString Nombre para mostrar de la columna.Display name for the column. Si no se ha definido ningún nombre para mostrar, devolverá el nombre de la columna.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NúmeroNumber Número máximo de caracteres que puede contener la columna.Maximum number of characters that the column can hold. Solo se aplica a las columnas que contienen cadenas.Applies only to columns that contain strings. Si no se configura un máximo, devuelve en blanco.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NúmeroNumber Valor numérico máximo que puede contener una columna.Maximum numeric value that a column can hold. Solo se aplica a las columnas que contienen números.Applies only to columns that contain numbers. Si no se configura un máximo, devuelve en blanco.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NúmeroNumber Valor numérico mínimo que puede contener una columna.Minimum numeric value that a column can hold. Solo se aplica a las columnas que contienen números.Applies only to columns that contain numbers. Si no se configura un mínimo, devuelve en blanco.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required BooleanoBoolean ¿Es un valor requerido para esta columna?Is a value required for this column? Si no se establece mediante el origen de datos devuelve false.If not set by the data source, returns false.

El tercer argumento es el nombre de una columna como una cadena.The third argument is the name of a column as a string. Por ejemplo, la columna Teléfono de la colección Personas se pasaría como "Teléfono" incluidas las comillas dobles.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

Información de origen de datosData-source information

Puede usar DataSourceInfo para obtener información sobre un origen de datos como un todo:You can also use DataSourceInfo to obtain information about a data source as a whole:

Argumento de informaciónInformation Argument Tipo de resultadoResult Type DescripciónDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues BooleanoBoolean ¿Qué tipos de permisos se les pueden conceder a los usuarios para este origen de datos?What types of permissions can users be granted for this data source? Si no se establecen mediante el origen de datos, se devuelve en blanco.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission BooleanoBoolean ¿Tiene permiso el usuario actual para crear registros en este origen de datos?Does the current user have permission to create records in this data source? Si no se establece mediante el origen de datos, devuelve true.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission BooleanoBoolean ¿Tiene permiso el usuario actual para eliminar registros en este origen de datos?Does the current user have permission to delete records in this data source? Si no se establece mediante el origen de datos, devuelve true.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission BooleanoBoolean ¿Tiene permiso el usuario actual para editar registros en este origen de datos?Does the current user have permission to edit records in this data source? Si no se establece mediante el origen de datos, devuelve true.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission BooleanoBoolean ¿Tiene permiso el usuario actual para leer registros en este origen de datos?Does the current user have permission to read records in this data source? Si no se establece mediante el origen de datos, devuelve true.If not set by the data source, returns true.

SintaxisSyntax

DataSourceInfo( DataSource, Information, ColumnName )DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource: requerido.DataSource – Required. El origen de datos que se va a usar.The data source to use.
  • Information: requerido.Information – Required. El tipo de información que desea recuperar.The type of information that you want to retrieve.
  • ColumnName: opcional.ColumnName – Optional. Para la información en el nivel de columna, el nombre de columna como una cadena.For column-level information, the column name as a string. La columna Teléfono se pasaría como "Teléfono" incluidas las comillas dobles.Column Phone would be passed as "Phone", including the double quotes. Para la información en el nivel de origen de datos, el argumento ColumnName no se puede usar.For information at the data-source level, the ColumnName argument can't be used.

    Nota: Para orígenes de datos de SharePoint y Excel que contienen nombres de columna con espacios, especifique cada uno de ellos como "_x0020_".Note: For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". Por ejemplo, especifique "Nombre de columna" como "Nombre_x0020_de_columna".For example, specify "Column Name" as "Column_x0020_Name".

EjemplosExamples

Los ejemplos de esta sección usan este origen de datos, denominado IceCream:The examples in this section use this data source, named IceCream:

El origen de datos también ha proporcionado esta información:The data source has also provided this information:

  • El nombre para mostrar para Quantity es "Cantidad disponible".The display name for Quantity is "Quantity on Hand".
  • La longitud máxima de Flavor es de 30 caracteres.The maximum length of Flavor is 30 characters.
  • La columna Flavor debe contener un valor.The Flavor column must contain a value. La columna Quantity no se requiere.The Quantity column isn't required.
  • La cantidad mínima es 0.The minimum Quantity is 0.
  • La cantidad máxima es 100.The maximum Quantity is 100.
  • El usuario actual puede leer y editar los registros del origen de datos IceCream, pero no se pueden crear ni eliminar registros.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FórmulaFormula DescripciónDescription ResultadoResult
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Devuelve el nombre para mostrar de la columna Quantity del origen de datos IceCream.Returns the display name for the Quantity column of the IceCream data source. "Cantidad disponible""Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Devuelve la longitud máxima de la cadena para la columna Flavor del origen de datos IceCream.Returns the maximum length of the string for the Flavor column of the IceCream data source. 3030
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) ¿Se requiere la columna Flavor del origen de datos IceCream?Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) ¿Se requiere la columna Quantity del origen de datos IceCream?Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Devuelve el valor numérico máximo de la columna Quantity del origen de datos IceCream.Returns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Devuelve el valor numérico mínimo de la columna Quantity del origen de datos IceCream.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) ¿Puede leer el usuario actual los registros del origen de datos IceCream?Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) ¿Puede editar el usuario actual los registros del origen de datos IceCream?Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) ¿Puede crear el usuario actual los registros del origen de datos IceCream?Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) ¿Puede eliminar el usuario actual los registros del origen de datos IceCream?Can the current user delete records in the IceCream data source? falsefalse