Truco – Añadir KPIs a un un tile integrado en el Launchpad de SCP

Introducción

Pequeño truco para añadir KPIs a nuestras aplicaciones publicadas en el SCP y gestionadas utilizando el AppRouter integrado en el launchpad.

Pero antes de entrar en materia, si la presentación de este post te suena a chino, no te preocupes, hago un resumen rápido. Si ya sabes de que hablo, puedes saltarte el siguiente punto.

Approuter Managed by SAP Cloud Platform

En los inicios de SCP Foundry al crear una aplicación tipo SAPUI5 necesitábamos un servicio que nos brindara la conexión entre nuestro navegador y el repositorio de aplicaciones SAPUI5. Esta aplicación también nos gestionaba las conexiones mediante destinations y el login de nuestra aplicación.

Para este propósito al crear una aplicación SAPUI5 se nos creaba una aplicación tipo App Router, una vez creada, podíamos acceder a nuestra aplicación mediante la URL que nos generaba.

En las nuevas versiones de template de SAPUI5 con BAS, SAP nos permite escoger si queremos disponer de este APP Router (por ejemplo si queremos crear una aplicación web aislada del launchpad) o como en el ejemplo de hoy, publicada por el launchpad. Es decir, no tendremos una aplicación que nos gestione las conexiones, sino que el propio launchpad nos permitirá acceder al repositorio de aplicaciones SAPUI5 o las destinations.

Si quieres profundizar mas en el tema de una aplicación SAPUI5 de SCP Foundry te recomiendo esta entrada.

Deconstrucción de una aplicación UI5 en Cloud Foundry

Ahora que ya tienes mas clara la teoria, vamos manos a la obra con este truco.

Añadiendo el tile dinámico

Voy a omitir los pasos anteriores a la creación ya que básicamente se centran en seguir el wizard.

Cuando construimos nuestra aplicación SAPUI5 con la intención de añadir de manera rápida a nuestro launchpad en cloud seleccionamos la opción «Approuter Managed by SAP Cloud Platform».

Una vez el template finaliza, ya podemos añadir a nuestra aplicación la configuración de tile. Para ello, modificaremos nuestro manifest.json para añadir el siguiente código:

        "crossNavigation": {
            "inbounds": {
                "intent1": {
                    "signature": {
                        "parameters": {},
                        "additionalParameters": "allowed"
                    },
                    "semanticObject": "Object",
                    "action": "display",
                    "title": "{{appTitle}}",
                    "info": "{{appTitle}}",
                    "subTitle": "{{appSubTitle}}",
                    "icon": "sap-icon://account",
                    "indicatorDataSource": {
                        "dataSource": "APIPORTAL-Northwind",
                        "path": "/dynamic_dest/APIPORTAL-Northwind/V2/Northwind/Northwind.svc/Products/$count",
                        "refresh": 0
                    }
                }
            }
        }
},

Este código lo añadiremos dentro del tag «sap.app»:

Descifrando la configuración

A continuación paso a detallar la configuración añadida para cada uno de los tags relevantes:

• Cross Navigation = Tag para indicar la configuración de tiles
• inbounds = Estructura con todos los tiles a definir para una aplicación
• Intent1 = Nombre técnico que le damos al tile, típicamente IntentX, este nombre no tiene relevancia para el usuario
• semanticObject = Objeto semántico de navegación (Conocido como intent navigation) de libre elección
• action = Acción que se realiza en ese tile ( Display, update…) de libre elección
• title / info / subTitle / icon = Información de la aplicación
• indicatorDataSource = Indicador de parte dynamical del tile
• dataSource = Aquí ponemos el nombre de la destination del KPI de nuestro tile
  • path = El punto importante es añadir «/dynamic_dest/<<nombre de la destination>>/» + path a nuestro servicio de KPIs

El resultado

Una vez añadida nuestra aplicación al portal / launchpad en SCP:

Ya podemos disfrutar de nuestro tile dinámico en SCP.

---

Este pequeño truco os ayudará a dar mas valor al Launchpad que pronto podria sufrir algunas modificaciones 😉

Como siempre suscribete, dale a la campanita de notificaciones y comparte en redes para estar a la última.