Uso de una fuente de datos en memoria para ampliar el alcance de los datos de Reveal

Puede que haya momentos en los que desee conectarse directamente a una fuente de datos que Reveal aún no admita de forma nativa. Por ejemplo, es posible que tenga su propia base de datos personalizada. Para dar cabida a esta necesidad, admitimos la memoria como fuente de datos. También puede que desee utilizar esta opción si necesita utilizar datos que ya están en la memoria como parte del estado de su aplicación, como el resultado de un informe solicitado por un usuario.

La fuente de datos en memoria también ofrece otros beneficios, como la velocidad de recuperación, ya que es mucho más rápido acceder a los datos en la memoria que en un disco duro.

En esta entrada de blog, analizaremos cómo utilizar esta función.

Definición de un esquema de datos

Recomendamos que defina un archivo de datos con un esquema que coincida con sus datos en memoria. Los archivos de datos pueden ser, por ejemplo, un archivo CSV o Excel, y un esquema es básicamente una lista de campos y el tipo de datos para cada campo. En el ejemplo que se muestra a continuación, encontrará detalles sobre cómo crear un archivo de datos con un esquema determinado y, a continuación, utilizar datos en memoria en lugar de obtener información de una base de datos.

En el ejemplo siguiente, utilizaremos datos en memoria con la lista de empleados de la empresa para integrar un panel de control que muestre métricas de recursos humanos en su sistema de recursos humanos. Y, en lugar de obtener la lista de empleados de su base de datos, utilizaremos los datos en memoria.

Preparación del archivo de datos y del panel de control de ejemplo

Utilice los pasos siguientes basándose en un empleado simplificado que solo tenga algunas propiedades:

EmployeeID: string
Fullname: string
Wage: numeric

Primero, cree el archivo CSV con el mismo esquema:

Example of preparing a Data File and Sample Dashboard in Reveal BI

Cargue el archivo en su sistema de intercambio de archivos preferido, como Dropbox o Google Drive
Cree un panel de control utilizando los datos de ejemplo. Tenga en cuenta que proporcionará los datos de producción reales más adelante en su aplicación
Exporte el panel de control (Menú del panel de control → Exportar → Panel de control) y guárdelo como un archivo .rdash.

Visualización del panel de control y devolución de los datos reales

Ahora, debe visualizar el panel de control utilizando sus propios datos en lugar de los datos de ejemplo.

Implemente IRVDataSourceProvider y devuélvalo como DataSourceProvider en IRevealSdkContext, como se describe en Reemplazo de fuentes de datos.

A continuación, en la implementación del método ChangeVisualizationDataSourceItemAsync, debe agregar un código similar a este:

Change Visualization Data Source Item Async example code

De esta manera, básicamente reemplaza todas las referencias a los archivos CSV en el panel de control con la fuente de datos en memoria identificada por "empleados". Esta identificación se utilizará más adelante al devolver los datos.

Implemente el método que devolverá los datos reales. Para ello, implemente IRVDataProvider como se muestra a continuación:

IRV Data Provider example code

Tenga en cuenta que las propiedades de la clase Employee tienen exactamente el mismo nombre que las columnas del archivo CSV, y el tipo de datos también es el mismo. Si desea alterar el nombre del campo, la etiqueta del campo y/o el tipo de datos de alguna de las propiedades, puede utilizar atributos en la declaración de la clase:

Se puede utilizar el atributo RVSchemaColumn para alterar el nombre del campo y/o el tipo de datos.
Se puede utilizar el atributo DisplayName para alterar la etiqueta del campo

RV Schema Column attribute can be used to alter the field name and/or data type