Uso de anotaciones ABAP en vistas CDS

Copie la definición de datos del modelo. Si ha finalizado el ejercicio anterior, puede omitir esta tarea y continuar editando la definición de datos Z##_EMPLOYEE.

1. Copie la definición de datos /LRN/R_EMPLOYEE en una definición de datos de su propio paquete (nombre sugerido: Z##_EMPLOYEE, donde ## representa su número de grupo).

   1. En la vista Explorador de proyectos, haga clic con el botón derecho en la definición de datos /LRN/R_EMPLOYEE para abrir el menú contextual.

   2. En el menú contextual, seleccione Duplicar ....

   3. Introduzca el nombre del paquete en el campo Paquete. En el campo Nombre, introduzca el nombre de la entidad de la vista CDS (Z##_Employee, donde ## representa su número de grupo).

   4. Ajuste la descripción y seleccione Siguiente.

   5. Confirme la orden de transporte y seleccione Finalizar.

2. Active la copia.

   1. Pulse Ctrl + F3 para activar la definición de datos.

En su definición de datos, actualice las anotaciones de vista. Añada una anotación que se pueda utilizar para restringir la vista previa de datos para una entidad de vista CDS y ajustar los valores de las anotaciones ObjectModel.usageType.

1. Al principio de la definición de datos, use la finalización de código para agregar la anotación @ABAPCatalog.dataMaintenance con su valor predeterminado.

   1. Sitúe el cursor al principio de la primera fila de código y pulse Intro para insertar una nueva fila vacía.

   2. En la fila vacía, introduzca @A y pulse Ctrl + Espacio para invocar la finalización de código.

   3. En la lista de sugerencias, seleccione @ABAPCatalog: { } (anotación.

   4. Introduzca un signo de punto (.) y pulse Ctrl + Espacio de nuevo.

   5. Seleccione dataMaintenance: #RESTRICTED (anotación).

2. Agrupe las anotaciones de entidad que empiecen por @ABAPCatalog.

   Consejo

   Puede utilizar la sintaxis del grupo de anotación @ObjectModel.usageType como anteproyecto.

   1. Ajuste el código de la siguiente manera:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789
      
      // @AbapCatalog.dataMaintenance: #RESTRICTED
      // @AbapCatalog.viewEnhancementCategory: [#NONE]
        @AbapCatalog: {
          dataMaintenance: #RESTRICTED,
          viewEnhancementCategory: [#NONE]
        }
        @AccessControl.authorizationCheck: #NOT_REQUIRED
      

3. Visualice la documentación de las anotaciones @ObjectModel.usageType y actualice los valores.

   Nota

   Debe asegurarse de que los valores de anotación se ajusten a las opciones técnicas de tabla de su tabla de base de datos para datos de empleado.

   1. Sitúe el cursor en @ObjectModely pulse F1 para abrir la ayuda de idioma ABAP.

   2. En la vista Ayuda de idioma ABAP que se abre debajo del editor, seleccione@ObjectModel, anotaciones de vista CDS, entidad de vista.

   3. Para la anotación serviceQuality, seleccione #D porque la vista no admite el procesamiento transaccional.

   4. Para la anotación sizeCategory, seleccione #M porque esperamos menos de 100.000 conjuntos de datos.

   5. Para la anotación dataClass, seleccione #MASTER porque los datos de empleado son datos maestros.

En su definición de datos, añada la anotación de elemento obligatoria para establecer el enlace entre el salario anual y el código de moneda. Utilice la vista Anotaciones activas para analizar las etiquetas de elemento derivadas de elementos de datos y proporcionar una etiqueta alternativa para el elemento CurrencyCode.

1. En la lista de elementos, anule el comentario del elemento AnnualSalary y el elemento CurrencyCode.

   1. Seleccione ambas filas de código y pulse Ctrl + Mayús + < para eliminar los signos de comentario del principio de cada fila.

2. Añada la anotación de elemento obligatorio que identifica el elemento AnnualSalary como importe y lo vincula al elemento CurrencyCode.

   Nota

   Es posible que deba añadir esta anotación manualmente con el soporte de la finalización de código. En el momento de escribir, el editor para las definiciones de datos no ofrece una corrección rápida para este error. (El editor para las definiciones de tabla de base de datos sí lo hace).

   1. Ajuste el código de la siguiente manera:

      Code Snippet

      Copy codeSwitch to dark mode

      123456
      
        department_id         as DepartmentId,
        @Semantics.amount.currencyCode: 'CurrencyCode'
        annual_salary         as AnnualSalary,
        currency_code         as CurrencyCode,
      

3. Abra la vista Anotaciones activas y analice los valores de la anotación EndUserText.Label para los diferentes elementos de vista.

   1. Haga clic con el botón derecho en cualquier lugar del código fuente de la definición de datos y seleccione Abrir con→anotaciones activas.

      Resultado

      La vista Anotaciones activas aparece como una nueva ficha debajo de la vista de editor. El origen de los textos de usuario final se enumera en la columna Tipo de datos de origen.

4. Vuelva al código fuente de su definición de datos y añada la anotación de elemento EndUSerText.label para el elemento de vista CurrencyCode. Modifique la etiqueta de Moneda a Clave de moneda.

   1. Ajuste el código de la siguiente manera:

      Code Snippet

      Copy codeSwitch to dark mode

      123456
      
       @Semantics.amount.currencyCode: 'CurrencyCode'
       annual_salary         as AnnualSalary,
       @EndUserText.label: 'Currency Key'
       currency_code         as CurrencyCode,
      

5. Active la definición de datos.

   1. Pulse Ctrl + F3 para activar el objeto de desarrollo.

6. Vuelva a la vista Anotaciones activas, actualice la visualización y confirme que ahora la nueva etiqueta está activa.

   Consejo

   Para encontrar una anotación específica más fácilmente, primero puede ocultar todo el árbol y, a continuación, desplegar el elemento y la anotación principal que le interesen.

   1. En la barra de herramientas de la vista Anotaciones activas, seleccione Actualizar (F5). Como alternativa, sitúe el cursor en cualquier lugar de la vista y pulse F5.

   2. En la barra de herramientas de la vista Anotaciones activas, seleccione Ocultar todo.

   3. Despliegue Z##_R_EMPLOYEE→CurrencyCode→@EndUserText.