Compartir a través de

Implementación del componente de conjunto de datos para aplicaciones de lienzo

  • Artículo

Este ejemplo muestra cómo crear un componente de conjunto de datos para aplicaciones de lienzo. El componente de conjunto de datos también muestra cómo usar métodos de la API de conjunto de datos para obtener metadatos de columna, registrar datos, navegar por datos y gestionar la navegación.

Control de cuadrícula de conjunto de datos.

Disponible para

Aplicaciones de lienzo.

Código

Puede descargar el componente de ejemplo completo aquí.

Nota

Algunos de los métodos de la API del conjunto de datos todavía no son compatibles con las aplicaciones de lienzo. Ver, documentación de API individual para detalles de disponibilidad. Vea Componente de conjunto de datos para aplicaciones basadas en modelo para obtener más información sobre cómo se implementan los componentes de tipo conjunto de datos en las aplicaciones basadas en modelo.

En esta muestra, la información de la columna se extrae utilizando context.parameters.[dataset_property_name].columns. Es un tipo de matriz. Las formas de acceder a ellas son las mismas para aplicaciones de lienzo y basadas en modelo.

Puede definir múltiples conjuntos de datos en el manifiesto. El primer conjunto de datos en el manifiesto es el conjunto de datos principal. Al configurar el componente múltiple conjunto de datos, la propiedad principal conjunto de datos siempre tiene un nombre Items. Todas las propiedades conjunto de datos no primarias tendrán un sufijo _Items después del nombre del conjunto de datos.

Algunas funciones del panel de creación solo se aplicarán a las propiedades conjunto de datos principales, como el selector origen de datos, el selector de campo y el selector de vista. Para configurar una propiedad conjunto de datos no primaria, el creador debe importar primero el origen de datos a la aplicación y luego establecer el valor de la propiedad en ese origen de datos secundario. Property-set debe usarse para acceder a columnas en una propiedad conjunto de datos no primaria.

Enlace de registro

  • La información de ID de registro ordenada se puede extraer utilizando context.parameters.[dataset_property_name].sortedRecordIds.
  • Obtenga toda la información de registro utilizando context.parameters.[dataset_property_name].records.
  • Obtenga cada objeto de registro usando context.parameters.[dataset_property_name].records[record_Id]
  • El valor con formato se puede recuperar utilizando el método getFormattedValue.

Cargar más páginas de datos

El método context.parameters.[dataset_property_name].paging proporciona funcionalidad de paginación. El botón Load Next aparece el botón si tiene datos de la página siguiente. Los usuarios pueden volver a las páginas anteriores utilizando el botón Load Prev.

Conjuntos de propiedades

El conjunto de propiedades se utiliza para acceder a valores de columnas individuales para columnas particulares en el registro. Por ejemplo, el control del mapa puede usar la longitud y la latitud en el conjunto de datos para mostrar los pings de ubicación en el mapa. En este componente de muestra, se definen dos conjuntos de propiedades en el manifiesto, samplePropertySet y samplePropertySet2. Los usuarios verán dos columnas vacías cuando el componente se agregue a la aplicación de lienzo antes de que se configuren los nombres de las columnas. Para un conjunto de propiedades, las columnas correspondientes se agregan al principio y el orden será 0.

Configuración del conjunto de propiedades.

Dimensionamiento

Este ejemplo también muestra cómo el componente escucha el cambio de tamaño del contenedor. Se debe llamar al método trackContainerResize dentro del método init para que mode.allocatedWidth y mode.allocatedHeight se proporcionen cada vez que se llama a updateView. Si no se llama inicialmente a este método, no tienen valores allocatedWidth y allocatedHeight proporcionados. Si allocatedHeight es –1, significa que no existe ningún límite en el alto. El componente debe ajustar su altura basándose en el ancho proporcionado.

Conjunto de datos métodos de API que no son compatibles con las aplicaciones de lienzo

Filtro y SortStatus

En esta vista previa para aplicaciones de lienzo, solo un conjunto limitado de métodos filtering y sortStatus son compatibles. El filtro y la clasificación se pueden aplicar a conjunto de datos en columnas de tipo primario, excepto el GUID. El filtro y la clasificación se pueden aplicar de la misma manera que en las aplicaciones basadas en modelo. Para recuperar el conjunto de datos con información de filtrado y clasificación, llame a los métodos en context.parameters.[dataset_property_name].filtering y context.parameters.[dataset_property_name].sorting, luego invoque el context.parameters.[dataset_property_name].refresh().

Vista

En las aplicaciones basadas en modelo, se requieren vistas para componentes de conjunto de datos para obtener la información de la columna. En las aplicaciones de lienzo, las vistas se usan como filtro. Depende del creador de la aplicación decidir qué columnas se agregarán para cada componente. Se puede seleccionar una vista después de seleccionar un origen para el componente de conjunto de datos. Esto es aplicable solo cuando se elige Microsoft Dataverse como origen. Al seleccionar una vista, se aplica el filtro de la vista al origen. El nombre de la vista y el Id. de la vista se pueden recuperar utilizando los métodos context.parameters.[dataset_property_name].getTitle() y context.parameters.[dataset_property_name].getViewId().

Descargar componentes de ejemplo
¿Cómo usar los componentes de ejemplo?
Referencia de la API de Power Apps component framework
Referencia de esquema de manifiesto de Power Apps component framework

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).