Cómo funciona un servicio de cuadro de mando

Servicios de la aplicación

En caso de seleccionar un servicio de este tipo es necesario indicar las siguientes propiedades:

• El Objeto negocio utilizado para el cálculo del servicio.
• El Formulario detalle asociado al objeto de negocio usado en el servicio que se mostrará en las acciones asociadas al servicio.
• Servicio multivalor. Indica que el servicio retorna una lista de valores de campos del panel principal del objeto de negocio para mostrarlos en modo gráfico en los widgets que lo utilicen. En el caso de activarlo se debe indicar la información multiregistro a través del diálogo accesible a través del botón con el icono Series.
• Registros seleccionados. Para mostrar registros seleccionados para acceder a detalle; indica que al ejecutar la acción asociada al servicio desde los widgets muestre un formulario con los datos representativos de los registros asociados al cálculo del servicio. Este formulario se muestra como un visor de registros y permite acceder al formulario de detalle con los datos de cualquiera de los registros mostrados.
• Obtener valor mediante una operación, pudiendo ser COUNT, SUM, MAX, MIN o AVG.
  • COUNT. Indica que el valor del servicio se realiza mediante la contabilización de los registros asociados al objeto de negocio utilizado en el servicio aplicándole las restricciones indicadas.
  • SUM. Contabiliza la suma de los valores del campo seleccionado.
  • MAX. Contabiliza el valor máximo de los valores del campo seleccionado.
  • MIN. Contabiliza el valor mínimo de los valores del campo seleccionado.
  • AVG. Contabiliza el valor promedio de los valores del campo seleccionado.
• Mostrar barra de herramientas. Para indicar que al visualizar el formulario de detalle se muestre la barra de herramientas.

Existen diferentes tipos de servicios:

• Monovalor. En el caso de que el retorno sea un único valor.
  • Por valor o por operación.
  • En los dos casos hay que indicar el campo del objeto de negocio y su máscara.
• Multivalor. En el caso de que el retorno sea un conjunto de valores.
  • Si el servicio es multivalor se activa un botón con un icono de gráfico que permite acceder a la ventana de definición de los controles del objeto de negocio que se usará para mostrar el gráfico del servicio. En esta ventana se permite indicar:
    • Un único control que actúa como etiqueta del gráfico.
    • Diferentes controles del objeto de negocio que actuarán como valores del gráfico para mostrar.
    • También se puede indicar el orden en que se mostrarán los diferentes controles de valores dentro del gráfico.

Además es posible añadir restricciones por defecto para aplicar cuando se crea un widget basado en el servicio que se está definiendo.

Servicios HTML

En caso de seleccionar un servicio de este tipo es necesario indicar las siguientes propiedades:

• URL de acceso al servicio. La dirección de donde obtener el valor del servicio, mediante búsqueda del valor deseado en su retorno.
• URL de enlace. La dirección de acceso al detalle de la información. Este enlace se abre al pulsar sobre un widget que utilice este servicio.
• Servicios parametrizables. En el caso de que desee parametrizar un servicio HTML en función de una parte variable dentro de la URL (también en la URL de enlace), lo podrá indicar cambiando cada una de estas partes variables por la cadena $ { V } $.
  • Así, si desea crear un servicio reutilizable para obtener la temperatura de una población, podrá indicar: http://www.aemet.es/xml/municipios/localidad_$ { V } $.xml donde se permite indicar como parámetro, por ejemplo 08205, código de ciudad para Sant Cugat del Valles, código de localización AEMET, con lo que al utilizar el servicio se aplicará sobre la dirección: http://www.aemet.es/xml/municipios/localidad_08205.xml
  • En una URL se permiten indicar tantos parámetros como desee para crear servicios HTML customizables.
• Patrón de búsqueda. Con el Patrón de búsqueda se indica el método para buscar por la página devuelta, el valor deseado.
  • Valor. Puede ser uno o varios valores hasta llegar al inicio del texto buscado. Ejemplo para el caso de la URL indicada en el ejemplo anterior, los prefijos  y .
  • Terminador. En este punto se indica el texto que indica el final del elemento buscado (a partir del inicio detectado por los diferentes valores del patrón de búsqueda). Ejemplo para el caso de la URL indicada en el ejemplo anterior el sufijo.

Para crear el servicio

Se desea crear un servicio de cuadro de mando que proporcione la temperatura de una población determinada. Se pueden usar recursos públicos de la Agencia Estatal de Meteorología o AEMET del Gobierno de España..

Para crear el servicio puede acceder al mantenimiento de los servicios del cuadro de mando después de seleccionar el punto Sistema, en el punto Diseño | Cuadro de mando, en Servicios de cuadro de mando.

Se necesita crear un servicio de tipo HTML, por ejemplo de nombre ka_temp. Tras indicar la descripción y títulos, lo podemos vincular a Platform Starter kit.

En caso de seleccionar un servicio de este tipo es necesario indicar las siguientes propiedades:

• La URL de acceso al servicio. La dirección de donde obtener el valor del servicio; mediante búsqueda del valor deseado en su retorno.
  • Por ejemplo:

http://www.aemet.es/xml/municipios/localidad_$ { V } $.xml

• La URL de enlace. La dirección de acceso al detalle de la información. Este enlace se abre al pulsar sobre un widget que utilice este servicio.
  • Por ejemplo

https://www.aemet.es/es/eltiempo/prediccion/municipios.

• Servicios parametrizables. En el caso de que desee personalizar el servicio en función de una parte variable dentro de la URL (también en la URL de enlace), lo podrá indicar cambiando cada una de estas partes variables por la cadena {V}.
  • Le permite indicar como parámetro, por ejemplo 08205, código de ciudad para Sant Cugat del Valles, código de localización AEMET.
  • URL test con lo que al utilizar el servicio se aplicará sobre la dirección: http://www.aemet.es/xml/municipios/localidad_08205.xml.
• Con el Patrón de búsqueda se indica el método para buscar por la página devuelta, el valor deseado. En nuestro caso se trata de la temperatura de la población:
  • En Valor indicamos los prefijos  y .
  • Y en Terminador indicamos el sufijo .

Parar utilizar el servicio

Una vez creado el servicio el usuario lo podrá integrar en la UI.

Los pasos mínimos necesarios podrían ser:

• En primer lugar crear el nuevo widget desde el Asistente de widgets:
  • Acceso al asistente.
  • En el paso Selección de servicios, seleccionar el servicio Temperatura.
  • En configuración de servicio HTML, se puede cambiar el parámetro. Por ejemplo el valor 18087 para Granada.
  • En criterios de valores, no hace falta ninguno, Aceptar. Aunque se podrían indicar distintos colores para distintos márgenes de temperaturas.
  • Asociar a mi workspace.
  • Y en grabación del widget indicar un nombre interno por ejemplo ka_mywidget.
• Para mostrar el cuadro de mando, seleccione Ver del Menú principal. Luego marque la casilla Cuadro de mando.
• Para agrupar el widget, en Cuadro de mando del Menú principal, Temperatura, cualificar con agrupado.