Processamento de conjuntos de dados em visões CDS

Defina uma nova entidade de visão CDS (nome sugerido: Z##_C_DepartmentQuery) que retorna o ID e a descrição dos departamentos que têm pelo menos um empregado atribuído a ela. Como fonte de dados, utilize sua entidade de visão para dados do empregado com funções, mas sem parâmetros (o nome sugerido era: Z##_C_EmployeeQuery). Certifique-se de que cada departamento esteja listado apenas uma vez.

1. Em seu próprio pacote, crie uma nova definição de dados (nome sugerido: Z##_C_DEPARTMENTQUERY, em que ## é o número do seu grupo). Indique sua entidade de visão CDS Z##_C_EmployeeQuery como Objeto referenciado e selecione o modelo Definir entidade de visão para gerar a declaração de definição, algumas anotações padrão e a lista de elementos.

   1. Na visão Explorador de projetos, clique com o botão direito do mouse em sua definição de dados Z##_C_EMPLOYEEQUERY para abrir o menu de contexto.

   2. No menu de contexto, selecione Nova definição de dados.

   3. Confirme que o campo Pacote contém o nome do seu pacote e que o campo Objeto referenciado contém o nome da sua definição de tabela de banco de dados.

   4. No campo Nome, insira o nome para a entidade da visão CDS (Z##_C_DepartmentQuery, em que ## é o seu número de grupo).

   5. Insira Departamento (consulta) no campo Descrição e selecione Seguinte.

   6. Confirme a ordem de transporte e selecione Seguinte.

      Cuidado

      Certifique-se de que você ainda não selecionou Concluir. Se fizer isso, você não poderá escolher o modelo que deseja usar.

   7. A partir da lista de modelos, selecione Definir entidade de visão e, em seguida, selecione Concluir.

2. Aplique a formatação do código-fonte.

   1. No menu eclipse, selecione Formato→do texto fonte. Como alternativa, selecione Shift + F1.

3. Edite a lista de elementos da nova definição de dados. Remova todos os elementos, exceto DepartmentID e DepartmentDescription.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
      define view entity Z##_C_DepartmentQuery
        as select from Z##_C_EmployeeQuery
        {  
          DepartmentId,
          DepartmentDescription   
        }
      

4. Ative a definição de dados e exiba o resultado da consulta na ferramenta Visualização de dados.

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

   2. Pressione F8 para chamar a ferramenta Visualização de dados.

5. Edite a definição de dados e adicione o suplemento DISTINCT à instrução SELECT.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
      define view entity Z##_C_DepartmentQuery
        as select distinct from Z##_C_EmployeeQuery
        {  
          DepartmentId,
          DepartmentDescription   
        }
      

6. Ative a definição de dados e exiba novamente o resultado da query.

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

   2. Pressione F8 para chamar a ferramenta Visualização de dados.

Para cada departamento, calcule a média de afiliação da empresa e o salário anual total dos funcionários atribuídos a esse departamento.

1. Remova o suplemento DISTINCT da sua definição de dados.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription   
         }
      

2. No final da lista de elementos, adicione um novo elemento de visualização (nome sugerido: AverageAffiliation). Utilize a função agregada AVG com o argumento CompanyAffiliation.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription,
           avg( CompanyAffiliation ) as AverageAffiliation 
         }
      

3. Certifique-se de que o resultado tem o mesmo tipo que o elemento CompanyAffiliation da entidade de visão de origem.

   1. Posicione o cursor em CompanyAffiliation e pressione F2 para exibir as informações do elemento de código. O tipo de CompanyAffiliation é abap.dec(11,1).

   2. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription,
           avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation 
         }
      

4. Adicione um novo elemento de visualização (nome sugerido: TotalSalary). Use a função de agregação SUM com o argumento AnnualSalaryConverted.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567891011
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription,
           avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation, 
       
           sum( AnnualSalaryConverted ) as TotalSalary
         }
      

5. Adicione o código de moeda à lista de elementos e anote o campo de montante com @Semantics.amount.currencyCode.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789101112
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription,
           avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation, 
           @Semantics.amount.currencyCode: 'CurrencyCodeUSD'
           sum( AnnualSalaryConverted ) as TotalSalary, 
           CurrencyCodeUSD
       }
      

6. Use uma correção rápida para gerar a cláusula GROUP BY.

   1. Posicione o cursor em select e pressione Ctrl + 1 para chamar a correção rápida. Como alternativa, escolha o ícone de erro com uma lâmpada no lado esquerdo dessa linha de código.

   2. Na lista de soluções rápidas disponíveis, selecione Adicionar cláusula GROUP BY.

   3. Depois de aplicar a correção rápida, o código deve ter o seguinte aspecto:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910111213141516
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQuery
         {  
           DepartmentId,
           DepartmentDescription,
           avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation, 
           @Semantics.amount.currencyCode: 'CurrencyCodeUSD'
           sum( AnnualSalaryConverted ) as TotalSalary, 
           CurrencyCodeUSD
       }
       group by
          DepartmentId,
          DepartmentDescription,
          CurrencyCodeUSD
      

7. Ative a definição de dados e exiba novamente o resultado da query.

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

   2. Pressione F8 para chamar a ferramenta Visualização de dados.

Substitua a fonte de dados pela sua visão que fornece parâmetros de entrada (o nome sugerido foi: Z##_C_EmployeeQueryP). Para fornecer os parâmetros, adicione os mesmos parâmetros à sua nova visão e encaminhe-os para a visão da fonte.

1. Na cláusula FROM, substitua a fonte de dados e use sua entidade de visão com parâmetros. Use o code completion para inserir a assinatura completa da fonte de dados, ou seja, a entidade de visão CDS com os respectivos parâmetros.

   1. Na cláusula FROM, substitua Z##_C_EmployeeQuery por Z##_C_EmployeeQueryP. Se você usou /LRN/C_Employee_Fnc, substitua-o por /LRN/C_Employee_Par.

   2. Posicione o cursor imediatamente após o nome da entidade e pressione Ctrl + espaço para chamar a conclusão de código.

   3. Pressione Shift + Enter para inserir a entidade de visão com assinatura completa.

   4. A conclusão de código deve ajustar o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345
      
       define view entity Z##_C_DepartmentQuery
         as select from Z##_C_EmployeeQueryP( p_target_curr: , p_date: )
      
      

2. Defina dois parâmetros de entrada para sua visão. Use os mesmos nomes de parâmetro, tipos e anotações usados na fonte de dados.

   Dica

   É mais fácil copiar as definições de parâmetro da fonte de dados.

   1. Mantenha pressionada a tecla Strg e selecione o nome da visão após FROM para navegar para a fonte de dados.

   2. Selecione o código antes de as select, incluindo o suplemento WITH PARAMETERS e pressione Ctrl + C para copiar a definição do parâmetro para o clipboard.

   3. Retorne à sua definição de dados e insira a definição de parâmetro antes de as select.

   4. O código deve ter o seguinte aspecto:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910
      
       define view entity Z##_C_DepartmentQuery
         with parameters
           p_target_curr : /dmo/currency_code,
           @EndUserText.label: 'Date of evaluation'
           @Environment.systemField: #SYSTEM_DATE
           p_date        : abap.dats
         as select from Z##_C_EmployeeQueryP( p_target_curr: , p_date: )
      
      

3. Use os novos parâmetros como entrada para a fonte de dados.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789101112
      
       define view entity Z##_C_DepartmentQuery
         with parameters
           p_target_curr : /dmo/currency_code,
           @EndUserText.label: 'Date of evaluation'
           @Environment.systemField: #SYSTEM_DATE
           p_date        : abap.dats
         as select from Z##_C_EmployeeQueryP(  
                          p_target_curr: $parameters.p_target_curr, 
                          p_date: $parameters.p_date )
      
      

4. Na lista de elementos, ajuste o nome do elemento do código de moeda, ou seja, remova o sufixo USD.

   1. ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910111213141516
      
      {
        DepartmentId,
        DepartmentDescription,
        avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation,
        @Semantics.amount.currencyCode: 'CurrencyCode'
        sum( AnnualSalaryConverted )               as TotalSalary,
        CurrencyCode
      }
      
       group by
         DepartmentId,
         DepartmentDescription,
         CurrencyCode
      
      

5. Ative e teste a definição de dados.

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

   2. Pressione F8 para chamar a ferramenta Visualização de dados.

   3. Utilize valores diferentes para o parâmetro P_TARGET_CURR.

Você quer ver todos os departamentos, mesmo aqueles que não têm empregados atribuídos a eles. Para isso, use uma junção externa da fonte de dados atual e sua entidade de visão para dados do departamento (o nome sugerido era: Z##_R_Department).

1. Em sua entidade de visão Z##_C_DepartmentQuery, ajuste a cláusula FROM. No final da cláusula, adicione uma junção externa direita da sua entidade de visão CDS para dados do departamento.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567
      
        as select 
           from Z##_C_EmployeeQueryP(
                  p_target_curr: $parameters.p_target_curr,
                  p_date:        $parameters.p_date ) 
           right outer join Z##_R_Department
      

2. Defina nomes de alias para as duas fontes de dados (nomes sugeridos: e para funcionário e d para departamento) e adicione a condição ON.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
        as select 
           from Z##_C_EmployeeQueryP(
                  p_target_curr: $parameters.p_target_curr,
                  p_date:        $parameters.p_date ) as e
           right outer join Z##_R_Department as d
           on e.DepartmentId = d.Id 
      

3. Na lista de elementos, leia o ID do departamento e a descrição do departamento da entidade de visão do departamento em vez da entidade de visão do empregado e transforme o ID do departamento em um elemento-chave.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910
      
       {
          d.Id,
          d.Description,
          avg( CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation,
          @Semantics.amount.currencyCode: 'CurrencyCode'
          sum( AnnualSalaryConverted )                as TotalSalary,
          CurrencyCode
        }
      

4. Remova a cláusula GROUP BY e gere-a novamente usando a correção rápida.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456
      
       group by
          d.Id,
          d.Description,
          CurrencyCode
      

5. Adicione o alias da tabela como prefixo quando solicitado pela verificação de sintaxe.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567891011121314
      
      {
          d.Id,
          d.Description,
          avg( e.CompanyAffiliation as abap.dec(11,1) ) as AverageAffiliation,
          @Semantics.amount.currencyCode: 'CurrencyCode'
          sum( e.AnnualSalaryConverted )                as TotalSalary,
          e.CurrencyCode
        }
      group by
          d.Id,
          d.Description,
          e.CurrencyCode
      

6. Ative e teste a definição de dados.

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

   2. Pressione F8 para chamar a ferramenta Visualização de dados.