Utilização de anotações ABAP em visões CDS

Copie a definição de dados do modelo. Se você concluiu o exercício anterior, pode ignorar esta tarefa e continuar processando sua definição de dados Z##_EMPLOYEE.

1. Copie a definição de dados /LRN/R_EMPLOYEE para uma definição de dados em seu próprio pacote (nome sugerido: Z##_EMPLOYEE, onde ## representa seu número de grupo).

   1. Na visão Explorador de projetos, clique com o botão direito do mouse na definição de dados /LRN/R_EMPLOYEE para abrir o menu de contexto.

   2. No menu de contexto, selecione Duplicar ....

   3. Insira o nome do seu pacote no campo Pacote. No campo Nome, insira o nome para a entidade da visão CDS (Z##_Employee, onde ## representa seu número de grupo).

   4. Ajuste a descrição e selecione Seguinte.

   5. Confirme a ordem de transporte e selecione Concluir.

2. Ative a cópia.

   1. Pressione Ctrl + F3 para ativar a definição de dados.

Em sua definição de dados, atualize as anotações de visão. Adicione uma anotação que pode ser usada para restringir a visualização de dados para uma entidade de visão CDS e ajustar os valores das anotações ObjectModel.usageType.

1. No início da definição de dados, use code-completion para adicionar a anotação @ABAPCatalog.dataMaintenance com seu valor padrão.

   1. Posicione o cursor no início da primeira linha de código e pressione Enter para inserir uma nova linha vazia.

   2. Na linha vazia, insira @A e pressione Ctrl + espaço para chamar code-completion.

   3. Na lista de sugestões, selecione @ABAPCatalog: { } (annotation.

   4. Insira um sinal de ponto (.) e pressione Ctrl + espaço novamente.

   5. Selecione dataMaintenance: #RESTRICTED (anotação).

2. Agrupe as anotações de entidade que começam com @ABAPCatalog.

   Dica

   Você pode usar a sintaxe do grupo de anotações @ObjectModel.usageType como blueprint.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

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

3. Exiba a documentação para as anotações @ObjectModel.usageType e atualize os valores.

   Nota

   Você deve garantir que os valores de anotação correspondem às configurações de tabela técnica da sua tabela de banco de dados para dados do empregado.

   1. Posicione o cursor em @ObjectModele pressione F1 para abrir a ajuda de linguagem ABAP.

   2. Na visão Ajuda de linguagem ABAP que é aberta abaixo do editor, selecione@ObjectModel, anotações de visão CDS, entidade de visão.

   3. Para a anotação serviceQuality, selecione #D porque a visão não suporta o processamento transacional.

   4. Para a anotação sizeCategory, escolha #M porque esperamos menos de 100.000 conjuntos de dados.

   5. Para a anotação dataClass, selecione #MASTER porque os dados do empregado são dados mestre.

Na sua definição de dados, adicione a anotação de elemento obrigatória para estabelecer a ligação entre o salário anual e o código da moeda. Utilize a visão Anotações ativas para analisar as etiquetas de elemento derivadas de elementos de dados e fornecer uma etiqueta alternativa para o elemento CurrencyCode.

1. Na lista de elementos, remova o comentário dos elementos AnnualSalary e CurrencyCode.

   1. Selecione as duas linhas de código e pressione Ctrl + Shift + < para remover os sinais de comentário do início de cada linha.

2. Adicione a anotação de elemento obrigatória que identifica o elemento AnnualSalary como um montante e vincula-o ao elemento CurrencyCode.

   Nota

   Você pode precisar adicionar essa anotação manualmente com o suporte de preenchimento de código. No momento da escrita, o editor para definições de dados não oferece uma correção rápida para este erro. (O editor para definições de tabela de banco de dados faz.)

   1. Ajuste o código da seguinte forma:

      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 a Visão de anotações ativas e analise os valores da anotação EndUserText.Label para os diferentes elementos de visão.

   1. Clique com o botão direito do mouse em qualquer lugar no texto fonte da definição de dados e selecione Abrir com→anotações ativas.

      Resultado

      A visão Anotações ativas é exibida como uma nova aba abaixo da visão do editor. A origem dos textos do usuário final é listada na coluna Tipo de dados de origem.

4. Retorne ao texto fonte de sua definição de dados e adicione a anotação de elemento EndUSerText.label para o elemento de visão CurrencyCode. Modifique a etiqueta de Moeda para Código da moeda.

   1. Ajuste o código da seguinte forma:

      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. Ative a definição de dados.

   1. Pressione Ctrl + F3 para ativar o objeto de desenvolvimento.

6. Retorne à visão Anotações ativas, atualize a exibição e confirme que agora a nova etiqueta está ativa.

   Dica

   Para encontrar uma anotação específica mais facilmente, você pode primeiro comprimir toda a árvore e, em seguida, expandir o elemento e a anotação principal em que está interessado.

   1. Na barra de ferramentas da visão Anotações ativas, selecione Atualizar (F5). Como alternativa, posicione o cursor em qualquer lugar na visão e pressione F5.

   2. Na barra de ferramentas da visão Anotações ativas, selecione Comprimir tudo.

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