Registrar un conjunto de datos
Prerrequisitos
- Acceso al menú Gestión de conjunto de datos > Tipo de conjunto de datos (DI007).
- Acceso al menú Gestión de conjunto de datos > Conjunto de datos (DI006).
- Fuente de datos de base de datos previamente configurada.
Introducción
Un conjunto de datos es una colección de datos extraídos de fuentes y bases internas y externas, construida a partir de comandos SQL.
Los conjuntos de datos incorporan una API REST propia, posibilitando consultas a través de peticiones HTTP.
Los conjuntos de datos registrados en SoftExpert Data integration son asociados a los formularios del componente Formulario por medio de listas de valores que muestran datos externos al sistema. Por lo tanto, sus SQL deben estar configurados para mostrar las informaciones necesarias para los formularios. Además, también se pueden utilizar en los atributos registrados en el sistema.
Vea cómo configurar los conjuntos de datos:
Registrar un tipo de conjunto de datos
Antes de registrar los conjuntos de datos, es necesario configurar los tipos utilizados para clasificarlos. Estos tipos facilitan la organización de los registros en el sistema y permiten crear una jerarquía entre ellos.
Para registrar un tipo de conjunto de datos, ejecute los siguientes pasos:
1. Acceda al menú Gestión de conjunto de datos > Tipo de conjunto de datos (DI007).
2. Haga clic en el botón 
.
3. Incluya un identificador y un nombre para el conjunto.
4. Si desea que el tipo se incluya jerárquicamente por debajo de otro tipo de conjunto de datos, llene el campo Tipo superior.
5. Haga clic en el botón 
.
Registrar un conjunto de datos
Información adicional
• En la etapa Construcción de la Query, se debe introducir el comando SQL que definirá los criterios de búsqueda y los datos que se utilizarán en el conjunto de datos que se está configurando.
• La fuente de datos establece la conexión con la base de datos y debe estar previamente configurada. Si el usuario tiene permiso, el botón 
aparecerá junto al campo, permitiendo la inclusión de una nueva fuente de datos.
• Después de introducir el comando SQL en el campo Construcción de la Query, algunos botones estarán disponibles:
| Ejecutar (Ctrl + Enter) | Haga clic en este botón para hacer una prueba de la consulta introducida en el campo Construcción de la Query. Si se produce un error de comando, se mostrará en la pantalla. |
| Editar parámetros | Este botón solo quedará habilitado cuando exista una condición en la consulta cuyo valor sea variable. Para ello, es necesario utilizar ":" después de la asignación para identificar que el valor debe ser un parámetro. Por ejemplo: SELECT IDLOGIN, NMUSER FROM ADUSER WHERE IDLOGIN =:ParamLogin Donde 'ParamLogin' es un parámetro del formulario. Cuando existen parámetros en la consulta, al hacer clic en el botón Ejecutar, el sistema mostrará automáticamente la pantalla de parámetros, donde deberán ser introducidos los valores para simular la ejecución de la consulta. |
| Ordenar datos | Al hacer clic en este botón, aparecerá la pantalla para definir los parámetros de ordenación. En la sección Campo, seleccione la columna (de la consulta) por la que se ordenarán los datos, y, en la sección Orientación, defina si el orden será ascendente o descendente. Si necesita ordenar los datos por medio de una segunda columna, haga clic en Incluir nuevo e introduzca la columna y la orientación de la ordenación. A continuación, haga clic en Aplicar para que el orden se aplique al resultado de la consulta. Obs.: Solo será posible ordenar los datos utilizando las columnas devueltas en la consulta (definidas en el SELECT). Si el comando SQL muestra todas las columnas (SELECT * FROM TABLE), todas las columnas se mostrarán en la sección Campo. |
| Aplicar formato | Haga clic en este botón para que el sistema aplique formato (sangría) al comando SQL, haciéndolo más legible para futuros cambios. |
• Para agregar un usuario, un grupo, un área o una función a la lista de seguridad, simplemente escriba el nombre deseado en el campo disponible y seleccione la opción correspondiente de la lista que se mostrará o presione la tecla "Enter" de su teclado. Para excluir, haga clic en el botón 
situado junto al registro deseado.
• Utilice el botón 
de la barra de herramientas del menú de registro de conjuntos de datos para simular el conjunto de datos. Al hacer clic en el botón, aparecerá una pantalla con los valores de los parámetros del conjunto.
API REST para consulta de conjuntos de datos
Para consultar conjuntos de datos analíticos a través de peticiones HTTP, una alternativa es utilizar una API REST.
Esta interfaz de programación de aplicaciones facilita la interacción entre diferentes sistemas, lo que permite obtener información estructurada vía endpoints, que son puntos de acceso designados.
En esta API, dos categorías de verbos pueden emplearse en peticiones: GET y POST.
Consulte las API publicadas haciendo clic aquí.
Conclusión
Una vez finalizado el registro, es posible simular el conjunto de datos.