Criar ampliações de metadados

Ajuste a definição de sua entidade de visão com parâmetros para dados do empregado (o nome sugerido era: Z##_C_EmployeeQueryP) e extraia todas as anotações para as quais isso é permitido para uma nova ampliação de metadados da camada mais baixa. Use o mesmo nome para a definição de dados e a ampliação de metadados. Após a extração, utilize uma correção rápida para permitir a ampliação da entidade de visão.

1. Abra a definição da sua entidade de visão com parâmetros para dados do empregado e certifique-se de que ela esteja ativa.

   1. Pressione Ctrl + Shift + A.

   2. No campo de pesquisa, insira Z##_C_, em que ## é seu número de grupo.

   3. Na lista de itens correspondentes, selecione a entrada Z##_C_EmployeeQueryP e selecione OK.

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

2. Usando uma ferramenta de refatoração, extraia todas as anotações disponíveis para uma nova extensão de metadados.

   1. No menu Eclipse, selecione Extração de texto fonte→Ampliação de metadados.

   2. No campo Entidade ampliada, insira Z##_C, pressione Ctrl + Espaço e selecione o nome da entidade da visão CDS que você quer ampliar (Z##_C_EmployeeQueryP).

   3. Copie esse nome do campo Entidade ampliada para o campo Nome.

   4. Insira uma descrição (por exemplo, Consulta de empregado (metadados)) e selecione Seguinte.

   5. Confirme a ordem de transporte e selecione Seguinte.

   6. Selecione Expandir tudo no lado direito e analise as anotações que podem ser extraídas.

   7. Selecione Selecionar tudo no lado direito e Concluir na parte inferior.

3. Utilize a conclusão de código para definir a camada da sua ampliação de metadados para o valor com a prioridade mais baixa.

   1. Na anotação @Metadata.layer, remova o caractere de preenchimento layer.

   2. Pressione Ctrl + espaço para chamar a conclusão de código.

   3. Na lista de sugestões, selecione o valor #CORE, uma vez que esta camada tem a prioridade mais baixa.

4. Use uma correção rápida para ajustar a entidade de visão anotada de modo que ela permita ampliações de metadados.

   1. Posicione o cursor na linha de código começando com annotate view e pressione Ctrl + 1 para chamar o quickfix. Em alternativa, você pode selecionar o ícone de erro com a lâmpada ao lado desta linha de código.

   2. A partir da lista de quickfixes disponíveis, selecione Adicionar anotação 'Metadata.allowExtensions' para a visão de base.

5. Ative a ampliação de metadados e a entidade de visão anotada.

   1. Pressione Ctrl + Shift + F3 para ativar todos os objetos de desenvolvimento inativos.

   2. Selecione Marcar tudo e OK.

   3. Selecione Selecionar tudo e Ativar.

6. Abra a entidade de visão anotada na ferramenta Anotações ativas e verifique se algumas das anotações são agora provenientes da ampliação de metadados.

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

      Resultado

      Para algumas das anotações, a coluna Fonte de dados de origem deve conter sua ampliação de metadados.

Com base em um modelo apropriado, crie uma segunda ampliação de metadados para a mesma entidade de visão que antes (nome sugerido: Z##_C_EMPLOYEE_QUERYP2). Selecione a camada de metadados com a prioridade mais alta, sobregrave a etiqueta para o parâmetro P_DATE e adicione uma etiqueta para o elemento de visão AssistantName.

1. No Explorador de projetos, localize a definição da entidade de visão que você ampliou na tarefa anterior.

   1. Por exemplo, expanda o subnó Definições de dados do→Core Data Services do pacote ZS4D430_##.

2. Para esta entidade de visão, crie uma nova ampliação de metadados CDS com base no modelo Anotar visão com parâmetros.

   1. Clique com o botão direito do mouse no nome da definição de dados para abrir o menu de contexto e selecione Nova ampliação de metadados.

   2. Copie o valor do campo Entidade ampliada para o campo Nome e adicione o caractere 2 para distingui-lo da ampliação de metadados já existente.

   3. Insira uma descrição (por exemplo, Consulta de empregado (metadados finais)) e selecione Seguinte.

   4. Confirme a ordem de transporte e selecione Seguinte.

   5. Na lista de modelos disponíveis, selecione Anotar visão com parâmetros e clique em Concluir.

3. Utilize a conclusão de código para definir a camada da sua ampliação de metadados para o valor com a prioridade mais alta.

   1. Na anotação @Metadata.layer, remova o caractere de preenchimento layer.

   2. Pressione Ctrl + espaço para chamar a conclusão de código.

   3. Na lista de sugestões, selecione o valor #CLIENTE, pois essa camada tem a prioridade mais alta.

4. Substitua o caractere de preenchimento parameter_name por p_date e adicione um novo rótulo para esse parâmetro, por exemplo, Data de conversão de moeda.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567891011
      
      @Metadata.layer: #CUSTOMER
      annotate view Z##_C_EmployeeQueryP
          with parameters 
              @EndUserText.label: 'Currency Conversion Date'
              p_date 
      {
          element_name;
          
      }
      

5. Substitua o caractere de preenchimento element_name por AssistantName e adicione uma etiqueta para esse elemento de visão, por exemplo, Assistente de departamento.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567891011
      
      @Metadata.layer: #CUSTOMER
      annotate view Z##_C_EmployeeQueryP
          with parameters 
              @EndUserText.label: 'Currency Conversion Date'
              p_date 
      { 
         @EndUserText.label: 'Department Assistant'
         AssistantName;
      }
      

6. Ative a nova ampliação de metadados.

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

7. Abra a entidade de visão anotada na ferramenta Anotações ativas e verifique se a etiqueta do parâmetro p_date vem da nova ampliação de metadados.

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