ABAP CDS Annotations

ABAP CDS Annotations: Uso y Definición

ABAP CDS Annotations

Las Annotations en ABAP Core Data Services (CDS) son metadatos que enriquecen los objetos CDS con información adicional sobre su estructura y comportamiento. Estas anotaciones se definen en la sintaxis de CDS y se utilizan en diferentes partes del código fuente.

¿Para qué sirven las Annotations en ABAP CDS?

Las anotaciones en ABAP CDS ayudan a mejorar la interpretación y optimización de los objetos de datos, permitiendo:

  • Definir reglas de negocio dentro del modelo de datos.
  • Controlar la visibilidad y accesibilidad de los datos.
  • Optimizar el rendimiento en bases de datos como SAP HANA.
  • Facilitar la generación de interfaces de usuario en SAP Fiori.

Las annotations se almacenan internamente cuando se activa un objeto CDS y pueden ser evaluadas mediante la clase del sistema CL_DD_DDL_ANNOTATION_SERVICE.

¿Cómo se Definen las Annotations en ABAP CDS?

Las anotaciones se definen mediante una CDS Annotation Definition, la cual establece:

  • El nombre de la anotación principal.
  • Los valores permitidos para la anotación.
  • Si puede estructurarse con subanotaciones.
  • Si permite arreglos de anotaciones.

Estas definiciones se crean en código fuente DDLA (Data Definition Language for Annotations) usando el comando DEFINE ANNOTATION. El código DDLA sólo puede ser editado en ABAP Development Tools (ADT) para Eclipse.

Consideraciones sobre el Uso de Annotations

  • SAP proporciona un conjunto de anotaciones predefinidas que deben utilizarse según las reglas establecidas.
  • No es posible crear anotaciones personalizadas por parte de clientes o socios de SAP en este momento.
  • Las annotations mejoran la experiencia en ADT, facilitando el autocompletado y la organización del código.
  • El chequeo de sintaxis en DDL no evalúa las definiciones de anotaciones, sólo su corrección sintáctica.Ejemplo

Ejemplo Sencillo de Anotación en ABAP CDS

Para comprender mejor cómo funcionan las anotaciones en ABAP CDS, veamos un ejemplo sencillo de una anotación utilizada en un objeto CDS:

@AbapCatalog.sqlViewName: 'ZMY_VIEW'
@EndUserText.label: 'Vista de Clientes'
DEFINE VIEW ZCustomer_View AS SELECT FROM KNA1 {
    key KUNNR AS CustomerID,
    NAME1 AS CustomerName,
    ORT01 AS City
};

Explicación del Ejemplo:

  • @AbapCatalog.sqlViewName: Define el nombre de la vista en la base de datos.
  • @EndUserText.label: Especifica la descripción que verá el usuario final.
  • DEFINE VIEW: Define una vista basada en la tabla KNA1 (tabla estándar de clientes en SAP).
  • Se seleccionan los campos KUNNR, NAME1 y ORT01 con nombres más intuitivos.

Conclusión

Las Annotations en ABAP CDS son esenciales para estructurar modelos de datos eficientes y escalables en SAP. Su implementación permite optimizar procesos, mejorar la legibilidad del código y aprovechar al máximo las capacidades de SAP HANA y SAP Fiori.

Para dominar su uso, se recomienda practicar en ABAP Development Tools (ADT) para Eclipse y explorar la documentación oficial de SAP sobre anotaciones CDS. ¡Dominar estas anotaciones mejorará significativamente la calidad del desarrollo en ABAP!