API e integración de SAP ALM: extensión de SAP Cloud ALM con SAP Build (parte 2)
By s4pcademy
En esto serie de blogs nos centraremos en integrar la API de SAP Cloud ALM con un Compilación de SAP aplicación para demostrar cómo extender SAP Cloud ALM con funcionalidad personalizada.
En este blog, desarrollaremos un sencillo Crear aplicaciones aplicación donde podemos interactuar con nuestros proyectos y tareas dentro de un destino determinado que se vincula a nuestra API SAP Cloud ALM.
Al final de este blog terminaremos con una Proyectos y un Tareas página como se muestra a continuación:
Al hacer clic en un proyecto, debería enviarnos a su página Tareas que muestra todas las tareas en este proyecto.
Seguiremos los siguientes pasos:
- Crear una entidad de datos que se vincule al punto final del proyecto.
- Creación de la variable de datos.
- Creación de la lista de proyectos.
- Creación de la variable de datos para el extremo de la tarea.
- Creando nuestra variable de datos para la entidad de datos de la tarea.
- Creación de la lista de tareas.
- Vinculación de la página Proyecto y la página Tarea.
1. Crear una entidad de datos que se vincule al punto final de Proyectos.
En el último tutorial vimos cómo crear una entidad de datos simple que se vincula a nuestra API principal. Aquí crearemos uno nuevo y lo vincularemos al punto final de nuestro proyecto.
En el último tutorial también habilitamos la autenticación SAP BTP necesaria para los próximos pasos.
Vaya a la pestaña de datos en la parte superior de la página. Allí podrá hacer clic en «Crear entidad de datos» y elegir «Integración de API REST de destino BTP de Sap». Después de haber hecho esto, debería abrirse una pestaña de configuración para su entidad de datos:
Una vez en esta página, debemos elegir el nombre de destino BTP para vincularlo a nuestro destino API de Sap Cloud ALM:
Entonces necesitamos activar una de las operaciones que se ejecutarán en este destino.
Como buscamos recuperar todos los proyectos que existen en nuestro arrendatario, necesitaremos activar la operación de lista. Esto nos permitirá ejecutar un GET en la API.
Habilitamos nuestra operación de lista en la pestaña izquierda de la configuración de la entidad de datos. Para poder extraer los datos deseados, se debe proporcionar la ruta relativa al punto final de nuestros proyectos.
Ahora podemos usar el CORRER PRUEBA pestaña para probar la vinculación a nuestra API. Al ejecutar la prueba, deberíamos terminar con un «Estado: OK (200)».
Crear la variable de datos
Ahora tenemos una conexión funcional con nuestro punto final de proyectos SAP Cloud ALM de nuestra API. Para acceder a la información de nuestra API dentro del lienzo, debe estar vinculada a una variable de datos.
Para hacer esto, debemos echar un vistazo a la pestaña de variables en nuestra página:
En la parte superior derecha de la página, seleccionamos la vista de variables. Luego hacemos clic en Variables de datos. Aquí podemos crear variables en nuestra página que nos permitirán interactuar con nuestra entidad de datos. Esto nos permitirá llamar a nuestras operaciones definidas en esa entidad.
Para crear esta variable, debemos hacer clic en «Agregar variable de datos» y luego seleccionar la entidad de datos que creamos en el Paso 1 (por ejemplo, CALM_TENANT_PROJECTS).
Cuando se selecciona, terminamos con la variable de datos en la pantalla y luego tenemos acceso a su tabla lógica.
En el lado derecho de la página están las características de nuestra variable. Aquí, como estamos obteniendo todos los proyectos, entonces es un tipo de variable «Colección de registros de datos». Esto ya debería estar seleccionado, y no es necesario realizar cambios en esta configuración.
Debería terminar con una variable de datos que se parece a la captura de pantalla anterior.
Ahora tenemos un enlace a nuestra API y una forma de acceder a ella en nuestra página. A continuación, debemos crear una lista que muestre todos los Proyectos.
Creación de la lista de proyectos
Para crear una lista que contenga todos nuestros proyectos primero debemos agregar un “Elemento de la lista” en nuestra página.
Ahora que tenemos nuestra lista en la página, debemos vincularla a nuestra variable de datos para mostrar todos los proyectos.
El enlace a nuestra variable Data se realiza con el “repetir con” parámetro de la lista.
Aquí hacemos clic en el pequeño símbolo debajo de «Repetir con». Esto nos permitirá hacer que nuestra lista se repita y mostrar toda la información sobre un elemento determinado.
Seguimos navegando hacia nuestra variable Datos.
Nuestra lista ahora se repetirá en nuestra variable de datos y esto nos permite mostrar todas las variables de nuestra API.
Para poder mostrar los nombres de los proyectos, debemos vincular nuestra lista «Etiqueta principal» a nuestros nombres de proyectos.
Hacemos clic en el botoncito debajo de “etiqueta primarial” propiedad. Esto se hace para establecer el valor que aparecerá en cada cuadro dentro de nuestra lista.
El siguiente paso es utilizar el elemento de datos en repetición.
Seleccionamos «actual» como nuestra repetición de selección y luego current.name como nuestra «propiedad de datos de repetición seleccionada». Esto hará que nuestra lista muestre todos los nombres de proyectos que tenemos en nuestro arrendatario. ¡Siga esto haciendo clic en guardar y ahora tenemos una lista que mostrará todos los nombres de nuestros Proyectos!
Para hacer que esta página sea un poco más agradable, puede usar su cuadro de título para agregar «Proyectos» como título.
Una vez que se abrió la página, debería poder ver todos los proyectos en su arrendatario actual en un formato de lista como el siguiente:
Creación de la variable de datos para el extremo de la tarea
Ahora tenemos una página con todos los proyectos de nuestro inquilino actual enumerados. Lo que queremos ahora es poder hacer clic en uno de esos proyectos y que aparezcan todas las tareas de ese proyecto.
Para hacer esto, primero tenemos que crear una nueva entidad de datos que se vincule a nuestro punto final de tarea.
De la misma manera que creamos nuestra primera entidad de datos, navegamos a nuestra página de datos, nos desplazamos hacia abajo y hacemos clic en crear entidad de datos. Elegimos “Integración API REST de destino BTP de SAP”. En la selección de Destino hacemos lo mismo que en el paso 1, elegimos el destino que creamos en el tutorial anterior.
Ahora necesitamos conectarlo a nuestro punto final:
Primero habilitamos nuestra operación de lista para poder enumerar todas las tareas. Después de hacer clic en el pequeño «ABC», aquí estableceremos nuestra ruta relativa a una fórmula SAP Build.
Esto abre la página de edición de fórmulas que nos permite agregar funciones o texto. Necesitamos escribir el siguiente texto en la sección de edición:
La parte de la cadena es el enlace a nuestro punto final de Tarea, la «consulta.búsqueda.consulta» es lo que nos permitirá obtener tareas que son específicas de un determinado Proyecto. Esta será una variable que se dará cuando hagamos clic en un proyecto.
Una vez que se proporciona la ruta relativa, podemos probar para ver si la conexión a nuestro punto final es posible. Para hacer esto, debemos darle un ID de proyecto en la parte de búsqueda de la página de prueba. Con este parámetro dado, podemos hacer clic en «EJECUTAR PRUEBA» y ver si tenemos una respuesta de «Estado: OK».
Una vez tengamos esta respuesta pulsamos en “AUTODETECT SCHEMA FROM RESPONSE” para poder definir las variables con las que vamos a interactuar.
Creando nuestra variable de datos para la entidad de datos de Tarea
Cuando hayamos terminado de crear nuestra entidad de datos, ahora necesitamos crear una variable de datos en una nueva página para poder mostrar la información.
Para crear la conexión entre las dos páginas, primero debemos crear un «parámetro de página» en nuestra nueva página de tareas.
Para hacer esto, debemos navegar a la sección de variables de nuestra página, luego a los parámetros de la página y hacer clic en «Agregar parámetro».
Aquí nombré el parámetro de la página. Projecto IDy establezca su tipo de valor en UUID.
Esta será la variable que contendrá el ProjectId del proyecto en el que hicimos clic para mostrar sus tareas.
Una vez creado el parámetro de página, ahora podemos hacer que nuestros datos sean variables. De la misma manera que creamos el último para la página de proyectos, navegamos a la pestaña Variable de datos, hacemos clic en «Agregar variable de datos» y luego elegimos la entidad de datos que creamos para nuestro Punto final de tarea.
Esta variable es un “variable de búsqueda” para indicar de qué proyecto queremos las tareas.
Aquí hacemos clic en la pequeña “X” que debe estar debajo del Buscar parámetro para navegar hacia la pantalla de edición de fórmula.
Una vez en la pantalla de edición de fórmulas, desea agregar lo siguiente:
Esto pasará el parámetro ProjectId que creamos antes a nuestra API para decirle de qué proyecto queremos las tareas.
Una vez hecho esto, puede guardar la variable de datos.
Creando la lista de Tareas
Ahora podemos navegar de regreso a nuestra vista de página y crear la lista que mostrará todas las tareas.
Para hacer esto, puede agregar el elemento de la lista en nuestro lienzo de la misma manera que lo hicimos para la lista de proyectos.
De la misma manera que conectamos nuestra lista de Proyectos a la variable de datos que habíamos creado, debemos hacer clic en los datos repetidos, luego en Datos y variables, luego en la variable de datos y luego elegir la variable que hemos creado anteriormente.
Vinculación de la página del proyecto y la página de la tarea
El último paso a completar es el enlace entre la página Proyecto y la página Tarea.
Necesitamos hacer clic en el elemento de la lista y abrir la función lógica de este elemento.
Luego debemos agregar el elemento «Abrir página» de la pestaña en la parte inferior izquierda.
Arrastramos este elemento a nuestro lienzo lógico para poder usarlo.
Conectamos el «Grifo de componente» al elemento Abrir página. Esto nos permitirá abrir la página de tareas cuando hagamos clic en un determinado proyecto.
Ahora podemos vincular la página que queremos que se abra cuando se haga clic en el elemento. Normalmente, su proyecto solo tiene 2 páginas, su página de tareas debe configurarse directamente en la página que se abrirá. De lo contrario, debe hacer clic en la pequeña página y luego elegir su página de tareas.
Ahora debemos darle un parámetro ProjectID ya que creamos un parámetro de página en nuestra TaskPage.
Para hacer esto, haga clic en la «X» para cambiar qué variable le dará. Luego hacemos clic en «Elemento de datos en repetición» y luego elegimos «actual» y luego ID. Esto nos permitirá pasar el ID del proyecto en el que hemos hecho clic a la página siguiente.
Debería terminar con los mismos parámetros que se muestran arriba. ¡Ahora el enlace a estas páginas está listo!
Cuando abra su aplicación, debería abrirse la página Proyecto, y cuando se haga clic en un proyecto, ¡debería aparecer la página Tarea que muestra todos los títulos de las tareas!
Gracias por seguir este tutorial.
En el siguiente tutorial, exploraremos cómo interactuar con la API mediante el intercambio de datos de SAP Cloud ALM entre diferentes inquilinos de SAP Cloud ALM.
