Building an ABAP RESTful Application

Objectives

After completing this lesson, you will be able to:
  • Comprender los componentes de una aplicación ABAP RESTful
  • Cree la aplicación de comestibles sostenibles

Comprender los componentes de programación de aplicaciones RESTful

El modelo de programación de aplicaciones ABAP RESTful define la arquitectura para el desarrollo integral de servicios OData (como las aplicaciones SAP Fiori) en el entorno ABAP. Admite el desarrollo de todos los tipos de aplicaciones Fiori y la publicación de API web. Se basa en tecnologías y frameworks como Core Data Services (CDS) para definir semánticamente modelos de datos enriquecidos y una infraestructura de modelo de servicio para crear servicios OData con vinculaciones a un protocolo OData y servicios de aplicación basados en ABAP para lógica personalizada e interfaces de usuario basadas en SAPUI5.

En esta unidad, creará una aplicación de comestibles sostenible utilizando una aplicación ABAP RESTful. Los objetos necesarios para una aplicación ABAP RESTful incluyen:

  • Tablas de base de datos
  • Entidades de Core Data Service (CDS)
  • Definiciones de comportamiento de Core Data Service (CDS)
  • Ampliaciones de metadatos de Core Data Service (CDS)
  • Una definición de servicio
  • Una vinculación de servicio
Arquitectura básica de una aplicación ABAP RESTful

El desarrollo de una aplicación RAP consta de los siguientes pasos principales:

Proporcionar las tablas de base de datos
El desarrollo de una aplicación RESTful empieza proporcionando las tablas de base de datos. Según el escenario de desarrollo, pueden ser tablas existentes, tablas existentes o tablas creadas específicamente para esta aplicación.
Defina el modelo de datos.
El modelo de datos del business object se define con vistas Core Data Service (CDS). Dependiendo de si se trata de un business object simple o compuesto, se necesitan una o más vistas CDS. En el caso de un business object compuesto, este también es el lugar en el que se define la jerarquía de entidades.
Definir e implementar el comportamiento (solo aplicaciones de transacción)
El comportamiento de un business object de aplicación RESTful se define en un objeto de repository llamado Definición de comportamiento de Core Data Service (CDS). Por lo general, el comportamiento de un business object de programación de aplicaciones RESTful también requiere alguna lógica adicional implementada en un determinado tipo de clase ABAP global llamada Pool de comportamiento. Para una aplicación no transaccional, por ejemplo, un informe de lista, se puede omitir la definición o implementación de comportamiento.
Proyectar el business object de programación de aplicaciones RESTful y proporcionar metadatos específicos del servicio
La proyección de business object de programación de aplicaciones RESTful consiste en una proyección de modelo de datos y, si se ha definido un comportamiento, una proyección de comportamiento. Para definir una proyección, cree una o más vistas de proyección de Core Data Service (CDS), que es un tipo de vista CDS, y una proyección de comportamiento, que es un tipo de definición de comportamiento. Para los servicios de interfaz de usuario (IU), las vistas de proyección deben enriquecerse con metadatos específicos de IU. Para admitir la ampliabilidad futura de la aplicación, recomendamos colocar las anotaciones específicas del servicio en ampliaciones de metadatos.
Definir el servicio
En las aplicaciones RESTful, un servicio se define creando una definición de servicio. La definición de servicio hace referencia a las vistas de proyección y especifica qué se debe exponer, es decir, qué es visible para el consumidor del servicio.
Vincular el servicio y probar el servicio
Se necesita una vinculación de servicio para especificar cómo se debe consumir el servicio (IU o API web) y mediante qué protocolo (OData V2 u OData V4). Para los servicios de IU, está disponible una Vista previa.

Creación de la aplicación de comestibles sostenibles

Gráfico que muestra el flujo de creación de una aplicación ABAP RESTful

Para crear el programa de aplicación RESTful, se debe crear o generar el siguiente objeto:

Una tabla de base de datos
Una tabla de base de datos almacenará permanentemente los datos en la base de datos. Crearemos una tabla de base de datos simple para almacenar información sobre sus comestibles comprados.
Objetos adicionales
Se generará una serie de objetos requeridos por el programa de aplicación RESTful mediante Generar objetos de repository ABAP... característica de las herramientas de desarrollo ABAP (ADT).
Comportamiento
El comportamiento de un business object de programa de aplicación RESTful se define en un objeto de repository llamado Definición de comportamiento de Core Data Service (CDS). Normalmente, el comportamiento también requiere una lógica adicional, que se implementa en un determinado tipo de clase ABAP global llamada Pool de comportamiento. Para una aplicación no transaccional, por ejemplo, un informe de lista, se puede omitir la definición o implementación de comportamiento. El comportamiento que añadiremos es una acción para verificar si los artículos de comestibles seleccionados han caducado. Esto fijará el indicador vencido en la tabla de base de datos.
Extensión de metadatos
El archivo de extensión de metadatos permite la personalización de la interfaz de usuario.

Crear una tabla de base de datos

Tabla de base de datos para aplicación de comestibles sostenibles

Se requiere una tabla de base de datos para almacenar nuestros datos de comestibles. Crearemos una tabla de base de datos para usar en nuestra aplicación de comestibles sostenibles.

Nota

En este ejercicio, XX hace referencia a su número.

Pasos

  1. Cree una tabla de base de datos denominada ZXX_GROCERY.

    1. Haga clic con el botón derecho en el paquete ZS4D100_XX en el Explorador de proyectos y seleccione Nuevo→Otro objeto de ABAP Repository. Escriba la tabla en el filtro y seleccione Tabla de base de datos. Pulse Siguiente.

    2. Introduzca ZXX_GROCERY como nombre y Comestibles como descripción. Pulse Siguiente para continuar.

    3. Seleccione su orden de transporte existente y pulse Finalizar.

  2. Ajuste el archivo ZXX_GROCERY copiando el código de plantilla y sustituyendo todas las ocurrencias de XX por su número.

    1. Sustituya el código generado en ZXX_GROCERY por el siguiente código:

      Code Snippet
      1234567891011121314151617181920212223242526272829
      @EndUserText.label : 'Groceries' @AbapCatalog.enhancement.category : #NOT_EXTENSIBLE @AbapCatalog.tableCategory : #TRANSPARENT @AbapCatalog.deliveryClass : #A @AbapCatalog.dataMaintenance : #RESTRICTED define table zXX_grocery { key client : abap.clnt not null; key id : sysuuid_x16 not null; product : abap.char(40); category : abap.char(40); brand : abap.char(40); @Semantics.amount.currencyCode : 'zXX_grocery.currency' price : abap.curr(10,2); currency : abap.cuky; quantity : abap.int2; purchasedate : abap.dats; expirationdate : abap.dats; expired : abap_boolean; rating : abap.fltp; note : abap.char(255); createdby : abap.char(12); createdat : tzntstmpl; lastchangedby : abap.char(12); lastchangedat : abp_lastchange_tstmpl; locallastchanged : abp_locinst_lastchange_tstmpl; }
    2. Copie el código en el ejercicio pulsando Copiar en el portapapeles.

    3. En Eclipse, seleccione Editar→Seleccionar todo.

    4. Seleccione Editar→Eliminar.

    5. Seleccione Editar→Pegar.

    6. Seleccione Editar→Buscar/Sustituir.

    7. Introduzca XX en el campo Buscar y su número en el campo Sustituir con.

    8. Pulse Reemplazar todo.

    9. Pulse Cerrar.

    10. Pulse Activar (Ctrl-F3).

    Practicar

Resultado

Ahora tiene una tabla de base de datos para almacenar su información de comestibles.

Generación de objetos adicionales

Generación de objetos adicionales

Acabamos de definir una tabla de base de datos para contener nuestros datos, pero la aplicación que crearemos necesita más objetos que esta tabla. Podemos generar estos objetos utilizando un asistente en las herramientas de desarrollo ABAP (ADT).

Arquitectura ampliada de una aplicación ABAP RESTful

Los objetos generados contienen toda la información necesaria para proporcionar una aplicación de trabajo con capacidades de creación, lectura, actualización y borrado. Más adelante, también ajustaremos y ampliaremos algunos de estos objetos para modificar la apariencia de la interfaz de usuario e implementar una verificación de los comestibles vencidos.

Para iniciar el generador de objetos, haga clic con el botón derecho en el nombre de la tabla en el Explorador de proyectos y seleccione Generar objetos de repository ABAP. El asistente se inicia y debe introducir un paquete al que se asignarán todos los objetos nuevos. A continuación, seleccione el generador, para este ejemplo, utilizamos el servicio de IU Modelo de programación de aplicaciones RESTful ABAP.

Captura de pantalla de la página inicial de la ventana del generador de modelos de programación de aplicaciones ABAP RESTful

Para iniciar el generador de objetos, haga clic con el botón derecho en el nombre de la tabla en el Explorador de proyectos y seleccione Generar objetos de ABAP Repository.... El asistente se inicia y debe introducir un paquete al que se asignarán todos los objetos nuevos. A continuación, seleccione el generador; para este ejemplo, estamos utilizando el servicio de IU Modelo de programación de aplicaciones RESTful ABAP.

Captura de pantalla de la pestaña Modelo de datos en la ventana del generador

En el modelo de programación de aplicaciones RESTful no se accede directamente a las tablas de base de datos. En su lugar, utilice una entidad de vista de Core Data Service (CDS) para definir el modelo de datos. En esta etapa, en el generador, introduzca el nombre de una definición de datos. Dado que está trabajando en el área de nombres de cliente, el nombre debe comenzar con Z o Y.

También debe introducir un nombre de alias utilizado dentro de la aplicación generada para identificar la entidad que representa la definición de datos.

Captura de pantalla de la pestaña Comportamiento en la ventana del generador

Con la vista de modo de datos que crea, puede leer datos de la base de datos. Sin embargo, nuestra aplicación también debería poder crear, modificar y eliminar datos. Para que esto sea posible, debe definir una definición de comportamiento. Esto está vinculado a la vista de modo de datos y especifica cuáles de las acciones de creación, actualización y borrado están permitidas.

Además de especificar cuál de las acciones de creación, actualización y borrado debe estar disponible, la definición de comportamiento también puede contener los siguientes tipos de definiciones:

  • Habilitación de borrador
  • Numeración automática
  • Validaciones: son verificaciones que se llevan a cabo cuando el usuario introduce datos en la aplicación
  • Determinaciones: una determinación realiza un cálculo para rellenar los campos en el registro de datos.

El generador crea la definición de comportamiento y activa la numeración automática para el campo UUID. Si necesita utilizar validaciones y determinaciones, debe añadirlas manualmente.

La definición de comportamiento declara qué validaciones y determinaciones existen. Sin embargo, también necesitan una implementación ABAP. Las implementaciones son métodos, por lo que necesita una clase de implementación. La convención para fijar nombres para esta clase es utilizar el prefijo Z o Y para el área de nombres de cliente, seguido de BP_R. BP significa pool de comportamiento y R significa restringido.

La definición de comportamiento también define la habilitación de borrador para la entidad. En función de la definición de la vista de modelo de datos, el generador crea una tabla correspondiente que contendrá los datos de borrador. Por lo tanto, debe especificar el nombre de la tabla de borrador en este punto. La convención para fijar nombres es que para una tabla básica Z<table>, la tabla de borrador debería llamarse Z<table>_D.

Captura de pantalla de la pestaña Proyección de servicio en la ventana del generador

El modelo de datos y su definición de comportamiento son una implementación reutilizable de una entidad empresarial en particular. El siguiente paso en la generación de objetos es especificar el nombre de la previsión de servicio. La proyección contiene una vista con exactamente los campos necesarios para una aplicación en particular, una definición de comportamiento que especifica cuál de los comportamientos definidos debería estar disponible en la aplicación y una ampliación de metadatos. La ampliación de metadatos contiene anotaciones de Core Data Service (CDS) que definen el aspecto de la IU de la aplicación.

La convención para fijar nombres para la capa de proyección es ZC_<name>. La vista de proyección, la proyección de comportamiento y la ampliación de metadatos tendrán el mismo nombre.

Captura de pantalla de la pestaña Vinculación de servicio en la ventana del generador

Para exponer la aplicación, debe crear una definición de servicio y una vinculación de servicio. La definición de servicio especifica la vista de proyección que se expondrá en este servicio, la vinculación de servicio especifica el protocolo que se debe utilizar. En nuestro ejemplo, defina un servicio de IU OData basado en la versión 4 del protocolo OData.

La convención para fijar nombres para la definición de servicio es Z<name>. La convención para fijar nombres para la vinculación de servicio es ZUI_<name>_O4. Esto indica que la vinculación es para una aplicación de elementos Fiori y que utiliza la versión 4 del protocolo OData.

Captura de pantalla de la página Vista previa de salida del generador en la ventana del generador

Al final del asistente, el sistema muestra una lista de todos los objetos que generará. Puede verificar sus entradas comparándolas con las convenciones para fijar nombres, buscar errores de escritura y, si es necesario, retroceder y modificar las que sean incorrectas.

Generar objetos adicionales

Generar objetos adicionales

Necesitamos generar los objetos adicionales necesarios para la aplicación RESTful Application Program Sustainable Grocery App.

Nota

En este ejercicio XX hace referencia a su número.

Pasos

  1. Genere los objetos adicionales para la aplicación RESTful Application Program Sustainable Grocery.

    1. En el Explorador de proyectos, haga clic con el botón derecho en la tabla de base de datos ZXX_GROCERY y seleccione Generar objetos de repository ABAP...

    2. Seleccione ABAP RESTful Modelo de programación de aplicaciones→Servicio de IU OData. Pulse Siguiente.

    3. Introduzca el nombre del paquete (ZS4D100_XX) y pulse Siguiente.

    4. Seleccione Modelo→de datos de business object. Verifique que el nombre de definición de datos sea ZR_XX_GROCERY e introduzca el nombre alias CDS: Comestibles.

    5. Seleccione Comportamiento→de business object y verifique que los nombres generados por defecto para la clase de implementación sean ZBP_R_XX_GROCERY y que el nombre de tabla de borrador sea ZXX_GROCERY_D.

    6. Seleccione Proyección de servicio y verifique que el nombre predeterminado sea ZC_XX_GROCERY.

    7. Seleccione Definición de servicio de→servicio empresarial. Verifique que el nombre predeterminado sea ZUI_XX_GROCERY_O4.

    8. Seleccione Vinculación de servicio de→servicio empresarial. Verifique que el nombre predeterminado sea ZUI_XX_GROCERY_O4 y que el tipo de vinculación sea OData V4 - IU.

    9. Pulse Siguiente.

    10. Visualice la Vista previa de salida del generador y pulse Finalizar para generar los objetos.

    Practicar

Modificación de objetos generados

Es necesario modificar varios objetos para personalizar nuestra aplicación

Captura de pantalla de una vista de proyección con anotaciones

En el archivo de definición de datos, se pueden añadir anotaciones ZC_XX_GROCERY para habilitar las capacidades de búsqueda de la aplicación. Las anotaciones empiezan con un símbolo @. Aquí, estamos añadiendo anotaciones para permitir las capacidades de búsqueda de campos específicos en la aplicación. La anotación se coloca antes del nombre del campo.

Captura de pantalla de una definición de comportamiento

En la definición de comportamiento ZR_XX_GROCERY, los campos CreatedBy y CreatedAt serán de solo lectura. También estamos creando una acción de instancia CheckExpirationDate.

Captura de pantalla de la ventana emergente de finalización de código que sugiere una corrección para una advertencia de código

En la definición de comportamiento ZR_XX_GROCERY, puede hacer que Eclipse genere el método checkExpirationDate haciendo clic en la advertencia en el margen de la sentencia de acción. A continuación, haga doble clic en el método Añadir ... para generar el método en las clases locales de la clase de implementación ZBP_R_XX_GROCERY.

Captura de pantalla de una proyección de comportamiento

En la definición de comportamiento ZR_XX_GROCERY, se añade la acción checkExpirationDate para habilitar la acción.

Captura de pantalla de una clase de implementación de comportamiento

En la clase de implementación ZBP_R_XX_GROCERY en la etiqueta Tipos locales estará el método para la acción checkExpirationDate. Aquí, el código es necesario para verificar la fecha de vencimiento de un artículo de alimentación seleccionado y fijar el indicador vencido en verdadero o falso. El código necesario está incluido en el ejercicio.

Captura de pantalla de una extensión de metadatos

La ampliación de metadatos permite el ajuste de la interfaz de usuario. @UI.lineItem hace referencia a la lista inicial, mientras que @UI.Identification hace referencia a la lista detallada en una segunda pantalla. En este ejemplo, el ID se oculta de la visualización de la aplicación. La posición es de izquierda a derecha de valores bajos a altos. Importancia: #ALTO indica que el campo debe mostrarse en todos los tamaños de dispositivo, mientras que la importancia: #MEDIUM tiene el campo enumerado en pantallas grandes (de escritorio) y pantallas medianas (tableta), pero no en pantallas pequeñas (smartphone).

Captura de pantalla de una vinculación de servicio no publicada con el botón Publicar

Para publicar el servicio, abra la vinculación de servicio ZUI_XX_GROCERY_O4, seleccione el servicio y pulse el botón Publicar.

Captura de pantalla de una vinculación de servicio publicada con el botón Vista previa activado...

Para probar la aplicación, seleccione Comestibles en Conjunto de entidades y asociación de la vinculación de servicio ZUI_XX_GROCERY_04. Pulse Vista previa... para iniciar la aplicación.

Captura de pantalla de la vista previa de la aplicación

Una vez en la aplicación de comestibles sostenibles, puede pulsar Ir para rellenar la lista de comestibles a partir de los datos existentes. También puede utilizar el campo Buscar para buscar artículos de comestibles. Pulse Crear para añadir un nuevo artículo de tienda de comestibles. Pulse Eliminar para eliminar un artículo de comestibles. Seleccione posiciones con una casilla de selección y pulse Verificar vencimiento para verificar la fecha de vencimiento y fije el indicador Vencido.

Si hace clic en un artículo de comestibles, accederá a una página de detalles de ese artículo. Desde la página de detalles, puede pulsar Editar para modificar los valores de posición, pulsar Borrar para eliminar la posición y pulsar Verificar vencimiento para fijar el indicador vencido.

Activar capacidades de búsqueda

Habilitar capacidades de búsqueda de aplicación de comestibles sostenibles

Debe activar las capacidades de búsqueda de la aplicación de comestibles sostenibles. Las capacidades de búsqueda están activadas en el archivo de definición de datos ZC_XX_GROCERY.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Definición de datosZC_XX_GROCERYHabilitar capacidades de búsqueda

Pasos

  1. Active las capacidades de búsqueda en el archivo de definición de datos ZC_XX_GROCERY para los campos Producto, Categoría, Marca, Fecha de vencimiento, Vencido y Valoración. Sustituya el código en el archivo de definición de datos copiando y pegando el siguiente código de solución.

    1. Haga doble clic en el archivo de definición de datos ZC_XX_GROCERY en el Explorador de proyectos para abrirlo.

    2. Sustituya el código en el archivo de definición de datos copiando el siguiente código:

      Code Snippet
      1234567891011121314151617181920212223242526272829303132
      @AccessControl.authorizationCheck: #CHECK @EndUserText.label: 'Projection View for ZR_XX_GROCERY' define root view entity ZC_XX_GROCERY provider contract transactional_query as projection on ZR_XX_GROCERY { key ID, Product, Category, Brand, Price, Currency, Quantity, PurchaseDate, ExpirationDate, Expired, Rating, Note, CreatedBy, CreatedAt, LastChangedBy, LocalLastChanged }
    3. En el archivo de definición de datos ZC_XX_GROCERY, pulse Ctrl-A para seleccionar todo el contenido y, a continuación, pulse la tecla Eliminar. Pulse Ctrl-V para pegar el contenido copiado anteriormente.

    4. Pulse Ctrl-F. Introduzca XX en el campo Buscar y su número en el campo Sustituir con. Pulse Reemplazar todo. Pulse Cerrar.

    5. Pulse Activar (Ctrl+F3).

    Practicar

Resultado

Los campos Producto, Categoría, Marca, Fecha de vencimiento y Calificación ahora están habilitados para la búsqueda.

Modificar conducta

Modificar el comportamiento de la aplicación de comestibles sostenibles

Es necesario modificar el comportamiento de la aplicación de comestibles sostenibles. Algunos campos deben ser de solo lectura y se debe añadir una acción para verificar la fecha de vencimiento del producto.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Definición de conductaZR_XX_GROCERYEspecificar cualquier campo de solo lectura, crear una acción para verificar el vencimiento del artículo y generar el método de acción
Definición de conductaZC_XX_GROCERYActivar acción para verificar fecha de vencimiento

Pasos

  1. En el archivo de definición de comportamiento ZR_XX_GROCERY, cree la acción checkExpirationDate y haga que los campos CreatedBy y CreatedAt sean de solo lectura.

    1. Haga doble clic en el archivo de definición de comportamiento ZR_XX_GROCERY en el Explorador de proyectos para abrirlo.

    2. Sustituya el código en el archivo de definición de comportamiento copiando el siguiente código:

      Code Snippet
      1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
      managed implementation in class ZBP_R_XX_GROCERY unique; strict ( 2 ); with draft; define behavior for ZR_XX_GROCERY alias Grocery persistent table zXX_grocery draft table ZXX_GROCERY_D etag master LocalLastChanged lock master total etag LastChangeDat authorization master( global ) { field ( readonly ) ID, field ( numbering : managed ) ID; create; update; delete; draft action Edit; draft action Activate optimized; draft action Discard; draft action Resume; draft determine action Prepare; mapping for ZXX_GROCERY { ID = id; Product = product; Category = category; Brand = brand; Price = price; Currency = currency; Quantity = quantity; PurchaseDate = purchasedate; ExpirationDate = expirationdate; Expired = expired; Rating = rating; Note = note; CreatedBy = createdby; CreatedAt = createdat; LastChangedBy = lastchangedby; LastChangeDat = lastchangedat; LocalLastChanged = locallastchanged; } }
    3. En el archivo de definición de comportamiento ZR_XX_GROCERY, pulse Ctrl-A para seleccionar todo el contenido y, a continuación, pulse la tecla Eliminar. Pulse Ctrl-V para pegar el contenido copiado anteriormente.

    4. Pulse Ctrl-F. Introduzca XX en el campo Buscar y su número en el campo Sustituir con. Pulse Reemplazar todo. Pulse Cerrar.

    5. Pulse Activar (Ctrl+F3).

  2. Genere el método de acción checkExpirationDate.

    1. En el archivo de definición de comportamiento ZR_XX_GROCERY, busque la línea que define la acción checkExpiratonDate. Tendrá una advertencia de que falta la implementación. Haga clic en la advertencia en el margen para ver una ventana emergente que indica: Añadir método para la acción checkExpirationDate.... Haga doble clic en esta línea para generar el método en la clase de implementación ZBP_R_XX_GROCERY.

    2. La clase de implementación ZBP_R_XX_GROCERY se abrirá en el editor. Pulse Activar (Ctrl-F3).

  3. Para habilitar la acción, añada una instrucción use action checkExpirationDate; a la definición de comportamiento del archivo ZC_XX_GROCERY.

    1. Haga doble clic en el archivo de definición de comportamiento ZC_XX_GROCERY en el Explorador de proyectos para abrirlo.

    2. Sustituya el código en el archivo de definición de comportamiento copiando el siguiente código:

      Code Snippet
      123456789101112131415161718192021
      projection; strict ( 2 ); use draft; define behavior for ZC_XX_GROCERY alias Grocery use etag { use create; use update; use delete; use action Edit; use action Activate; use action Discard; use action Resume; use action Prepare; }
    3. En el archivo de definición de comportamiento ZR_XX_GROCERY, pulse Ctrl-A para seleccionar todo el contenido y, a continuación, pulse la tecla Eliminar. Pulse Ctrl-V para pegar el contenido copiado anteriormente.

    4. Pulse Ctrl-F. Introduzca XX en el campo Buscar y su número en el campo Sustituir con. Pulse Reemplazar todo. Pulse Cerrar.

    5. Pulse Activar (Ctrl+F3).

    Practicar

Resultado

Los campos Createdby, CreatedAt, LastChangeDat y LocalLastChanged ahora son de solo lectura. Se ha declarado la acción checkExpirationDate.

Verificar vencimiento de producto

Implementar código ABAP para verificar fecha de vencimiento de producto

En la aplicación Sustainable Grocery se ha definido una acción para verificar la fecha de vencimiento de un producto. Debe añadir un código ABAP para verificar la fecha de vencimiento y, si la fecha de vencimiento se encuentra en el pasado, se debe fijar el indicador Vencido.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Clase de implementaciónZBP_R_XX_GROCERYAñadir código de acción para verificar el vencimiento del artículo seleccionado

Pasos

  1. Implemente el método local checkExpirationDate en la clase de implementación ZBP_R_XX_GROCERY.

    1. Haga doble clic en el archivo de clase ZBP_R_XX_GROCERY en el Explorador de proyectos para abrirlo.

    2. Haga clic en la pestaña Tipos locales en la parte inferior de la ventana del editor.

    3. Sustituya el código en el archivo de definición de comportamiento copiando el siguiente código:

      Code Snippet
      12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
      CLASS lhc_grocery DEFINITION INHERITING FROM cl_abap_behavior_handler. PRIVATE SECTION. METHODS: get_global_authorizations FOR GLOBAL AUTHORIZATION IMPORTING REQUEST requested_authorizations FOR Grocery RESULT result, checkExpirationDate FOR MODIFY IMPORTING keys FOR ACTION Grocery~checkExpirationDate RESULT result. ENDCLASS. CLASS lhc_grocery IMPLEMENTATION. METHOD get_global_authorizations. ENDMETHOD. METHOD checkExpirationDate. DATA: lt_groceries TYPE TABLE FOR READ RESULT zr_xx_grocery, ls_grocery TYPE STRUCTURE FOR READ RESULT zr_xx_grocery, lv_expiration TYPE d, lv_current_date TYPE d, lv_expired TYPE abap_boolean, lt_update_groceries TYPE TABLE FOR UPDATE zr_xx_grocery. READ ENTITIES OF zr_xx_grocery IN LOCAL MODE ENTITY Grocery ALL FIELDS WITH CORRESPONDING #( keys ) RESULT lt_groceries. LOOP AT lt_groceries INTO ls_grocery. lv_expiration = ls_grocery-Expirationdate. lv_current_date = cl_abap_context_info=>get_system_date( ). IF lv_expiration < lv_current_date. lv_expired = abap_true. ELSE. lv_expired = abap_false. ENDIF. APPEND VALUE #( id = ls_grocery-Id expired = lv_expired ) TO lt_update_groceries. MODIFY ENTITIES OF zr_xx_grocery IN LOCAL MODE ENTITY Grocery UPDATE FIELDS ( expired ) WITH lt_update_groceries. ENDLOOP. result = VALUE #( FOR groceries IN lt_groceries ( id = groceries-id %param = groceries ) ). ENDMETHOD. ENDCLASS.
    4. En el fichero de clases ZBP_XX_GROCERY, pulse Ctrl-A para seleccionar todo el contenido y, a continuación, pulse la tecla Supr. Pulse Ctrl-V para pegar el contenido copiado anteriormente.

    5. Pulse Ctrl-F. Introduzca XX en el campo Buscar y su número en el campo Sustituir con. Pulse Reemplazar todo. Pulse Cerrar.

    6. Pulse Activar (Ctrl+F3).

    Practicar

Resultado

Se ha implementado el código ABAP para verificar la fecha de vencimiento y fijar el campo vencido.

Ampliar interfaz de usuario

Personalizar la interfaz de usuario de la aplicación de comestibles sostenibles

La interfaz de usuario de la aplicación Sustainable Grocery App debe personalizarse para especificar qué datos mostrar y de qué manera.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Extensión de metadatosZC_XX_GROCERYEspecificar información de la interfaz de usuario, como qué datos mostrar, cómo mostrar los datos y activar la funcionalidad de acción

Pasos

  1. Personalice la interfaz de usuario (IU) añadiendo anotaciones @UI al archivo de extensión de metadatos ZC_XX_GROCERY. @UI.lineITem hace referencia a la lista inicial, mientras que @UI.Identification hace referencia a la lista detallada en una segunda pantalla. Las anotaciones se colocan antes del nombre del campo. Estos son algunos comandos @UI de ejemplo:

    @UI.oculto: verdadero
    Oculta el campo de la visualización
    @UI.lineItem.position
    Ordene los campos de izquierda a derecha con números inferiores a la derecha y números superiores a la izquierda
    @UI.lineItem.import
    Qué dispositivos deben mostrar el elemento:
    #HIGH - todos los tamaños de pantalla (escritorios, tabletas y smartphones)
    #MEDIUM - pantallas grandes (de escritorio) y medianas (tablet)
    #LOW - pantallas grandes (escritorios)
    @UI.lineItem.label
    Etiqueta del campo
    1. Haga doble clic en el archivo de extensión de metadatos ZC_XX_GROCERY en el Explorador de proyectos para abrirlo.

    2. Sustituya el código en el archivo de definición de comportamiento copiando el siguiente código:

      Code Snippet
      123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
      @Metadata.layer: #CORE @UI: { headerInfo: { typeName: 'Sustainable Grocery App', typeNamePlural: 'Sustainable Groceries App' } } annotate view ZC_XX_GROCERY with { @UI.facet: [ { id: 'idIdentification', type: #IDENTIFICATION_REFERENCE, label: 'Sustainable Groceries App', position: 10 } ] @UI: { lineItem: [ { exclude: true } , { type: #FOR_ACTION, dataAction: 'checkExpirationDate' , label: 'Check for expiration' } ] , identification: [ { position: 1, label: 'ID' } , { type: #FOR_ACTION, dataAction: 'checkExpirationDate', label: 'Check for expiration' } ] } @UI.hidden: true ID; @UI.lineItem: [ { position: 10 , importance: #HIGH, label: 'Product' } ] @UI.identification: [ { position: 10 , label: 'Product' } ] Product; @UI.lineItem: [ { position: 20 , importance: #MEDIUM, label: 'Category' } ] @UI.identification: [ { position: 20 , label: 'Category' } ] Category; @UI.lineItem: [ { position: 30 , importance: #MEDIUM, label: 'Brand' } ] @UI.identification: [ { position: 30 , label: 'Brand' } ] Brand; @UI.lineItem: [ { position: 40 , importance: #MEDIUM, label: 'Price/Currency' } ] @UI.identification: [ { position: 40 , label: 'Price/Currency' } ] Price; @UI.hidden: true Currency; @UI.lineItem: [ { position: 60 , importance: #MEDIUM, label: 'Quantity' } ] @UI.identification: [ { position: 60 , label: 'Quantity' } ] Quantity; @UI.lineItem: [ { position: 70 , importance: #MEDIUM, label: 'Purchase Date' } ] @UI.identification: [ { position: 70 , label: 'Purchase Date' } ] PurchaseDate; @UI.lineItem: [ { position: 80 , importance: #MEDIUM, label: 'Expiration Date' } ] @UI.identification: [ { position: 80 , label: 'Expiration Date' } ] ExpirationDate; @UI.lineItem: [ { position: 90 , importance: #MEDIUM, label: 'Expired' } ] @UI.identification: [ { position: 90, label: 'Expired' } ] Expired; @UI.lineItem: [ { position: 100 , importance: #MEDIUM, label: 'Rating' } ] @UI.identification: [ { position: 100 , label: 'Rating' } ] Rating; @UI.lineItem: [ { position: 110 , importance: #MEDIUM, label: 'Note' } ] @UI.identification: [ { position: 110 , label: 'Note' } ] Note; @UI.hidden: true CreatedBy; @UI.hidden: true CreatedAt; @UI.hidden: true LastChangedBy; @UI.hidden: true LocalLastChanged; }
    3. En el archivo de extensión de metadatos ZC_XX_GROCERY, pulse Ctrl-A para seleccionar todo el contenido y, a continuación, pulse la tecla Eliminar. Pulse Ctrl-V para pegar el contenido copiado anteriormente.

    4. Pulse Ctrl-F. Introduzca XX en el campo Buscar y su número en el campo Sustituir con. Pulse Reemplazar todo. Pulse Cerrar.

    5. Pulse Activar (Ctrl+F3).

    Practicar

Resultado

Qué campos se deben visualizar y en qué orden, así como qué visualizar en la página de detalles se han definido para la aplicación Comestibles sostenibles.

Publicar la aplicación de comestibles sostenibles

Publicar la aplicación de comestibles sostenibles

Es hora de publicar la aplicación de comestibles sostenibles.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Vinculación de servicioZUI_XX_GROCERY_04Publicar servicio y probar aplicación.

Pasos

  1. Publique y pruebe el servicio.

    1. Haga doble clic en el archivo de vinculaciones de servicio ZUI_XX_GROCERY_04 en el Explorador de proyectos para abrirlo.

    2. Expanda el servicio ZUI_XX_GROCERY_04 en la tabla de servicios y seleccione la línea siguiente con la entrada Versión1.0.0. Pulse el botón Publicar. La publicación tardará unos minutos.

    Practicar

Resultado

Se ha publicado la aplicación de comestibles sostenibles.

Probar la aplicación de comestibles sostenibles

Probar la aplicación de comestibles sostenibles

Es hora de probar la aplicación de comestibles sostenibles.

Nota

En este ejercicio, XX hace referencia a su número.

Objetos para ajustar:

Tipo de objetoNombre del objetoDescripción de la modificación
Vinculación de servicioZUI_XX_GROCERY_04Aplicación de prueba.

Pasos

  1. Previsualice el servicio Sustainable Grocery App.

    1. Haga doble clic en el archivo de vinculaciones de servicio ZUI_XX_GROCERY_04 en el Explorador de proyectos para abrirlo.

    2. En la sección Detalles de versión de servicio, seleccione Comestibles en la lista Conjunto de entidades y asociación.

    3. Pulse Vista previa... para iniciar la aplicación.

  2. Crear una entrada de producto nueva

    1. Seleccione Crear en la aplicación.

    2. Introducir detalles del producto:

      ProductoHarina de avena
      CategoríaDesayuno
      MarcaOrganicos
      Precio5.00
      MonedaUSD
      Cantidad1
      Fecha de compraElija hace 3 semanas a partir de hoy
      Fecha de vencimientoSeleccione 3 días a partir de hoy
      VencidoNo verificado
      Valoración5
      NotaYummy
    3. Pulse Crear.

    4. Pulse la flecha Alt+Izquierda para volver a la pantalla anterior.

    5. Pulse IR para ver su nuevo producto.

  3. Verifique el procesamiento de vencimiento.

    1. Marque la casilla de selección a la derecha de su producto.

    2. Pulse Verificar vencimiento. El campo de nota caducó con un valor de No.

    3. Haga clic en la línea de productos para ir a la página de detalles.

    4. Seleccione Editar para modificar el producto.

    5. Cambie la fecha de vencimiento a hace 1 día.

    6. Pulse Grabar.

    7. Pulse Verificar vencimiento. Los campos de aviso han vencido ahora con un valor de Sí.

    8. Pulse la flecha Alt+Izquierda para volver a la primera página.

    Practicar

Resultado

La aplicación de comestibles sostenibles ya ha sido probada.