Ampliar visões CDS

Ajuste as configurações de extensibilidade da sua entidade de visão de base para os dados do empregado (o nome sugerido foi: Z##_R_Employee, em que ## é o seu número de grupo). Permita a ampliação da lista de elementos com campos provenientes de sua tabela de banco de dados para dados do empregado (o nome sugerido era Z##_EMPLOY).

Da mesma forma, ajuste as configurações de extensibilidade de sua entidade de visão com parâmetros para dados do empregado (o nome sugerido foi: Z##_C_EmployeeQueryP, em que ## é o número do seu grupo). Permita a extensão da lista de elementos com elementos provenientes de sua entidade de visão de base (o nome sugerido era Z##_R_Employee).

1. Abra a definição da sua entidade de visão de base para dados do empregado.

   1. Pressione Ctrl + Shift + A, insira o nome da definição de dados e selecione OK.

2. Ajuste a categoria de ampliação de visão para permitir a ampliação da lista de elementos.

   1. Modifique o valor da anotação @ABAPCatalog.viewEnhancementCategory de #NONE para #PROJECTION_LIST.

3. Atualize a lista de fontes de dados permitidas para a ampliação. Adicione a tabela de banco de dados a partir da qual a entidade de visão lê para esta lista.

   Nota

   Para adicionar a tabela de banco de dados à lista, você precisa definir um nome de alias para ela (nome de alias sugerido: Empregado).

   1. Adicione a anotação @ABAPCatalog.extensibility.dataSources da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567
      
       @AbapCatalog: {
          dataMaintenance: #RESTRICTED,
          viewEnhancementCategory: [#PROJECTION_LIST],
          extensibility.dataSources: [ 'Employee' ]
       }
      

   2. Defina o alias para a fonte de dados da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234
      
        define view entity Z##_R_Employee
        as select from z##employ as Employee
      

4. Defina um sufixo obrigatório para os campos adicionais (valor proposto: ZEM).

   1. Adicione a anotação @ABAPCatalog.extensibility.elementSuffix da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
       @AbapCatalog: {
          dataMaintenance: #RESTRICTED,
          viewEnhancementCategory: [#PROJECTION_LIST],
          extensibility.dataSources: [ 'Employee' ],
          extensibility.elementSuffix: 'ZEM'
       }
      

5. Ative a definição de dados.

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

6. Abra a definição de sua entidade de visão com parâmetros para dados do empregado.

   1. Pressione Ctrl + Shift + A, insira o nome da definição de dados e selecione OK.

7. Como antes, ajuste a categoria de ampliação de visão, atualize as fontes de dados permitidas e defina o sufixo do elemento.

   Nota

   Utilize o mesmo alias de fonte de dados e sufixo de elemento que antes.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678
      
       @AbapCatalog: {
          dataMaintenance: #RESTRICTED,
          viewEnhancementCategory: [#PROJECTION_LIST],
          extensibility.dataSources: [ 'Employee' ],
          extensibility.elementSuffix: 'ZEM'
      }
      

   2. Defina o alias para a fonte de dados da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789
      
      define view entity Z##_C_EmployeeQueryP
        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##_R_Employee as Employee
      

8. Ative a definição de dados.

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

Para sua entidade de visão básica, crie uma ampliação de visão CDS (nome sugerido: Z##EXT_R_EMPLOYEE) para adicionar os campos para o título do empregado e o país à lista de elementos (os nomes sugeridos foram: ZZTITLE_ZEM e ZZCOUNTRY_ZEM).

1. Crie uma ampliação de visão CDS para sua entidade de visão CDS Z##_R_Employee.

   1. No Explorador de projetos, localize a definição de dados Z##_R_EMPLOYEE, clique com o botão direito do mouse nela e selecione Nova definição de dados.

   2. Certifique-se de que o campo Pacote contém o nome do seu próprio pacote.

   3. Insira Z##EXT_R_Employee em Name and Extension of Z##_R_Employee em Description. Em seguida, selecione Seguinte.

   4. Confirme a ordem de transporte e selecione Seguinte.

      Nota

      Não selecione Concluir ainda ou você não poderá selecionar o modelo correto.

   5. Na lista de Modelos, selecione Ampliar entidade de visão e, em seguida, Concluir.

2. Edite a lista de elementos da ampliação de visão. Remova o caractere de preenchimento e utilize a conclusão de código para adicionar o título e o país do empregado.

   1. No texto fonte, substitua base_data_source_code.element_name. por zz e pressione Ctrl + espaço para chamar code-completion.

   2. A partir da lista de sugestões, selecione zztitle_zem- z##Employ como empregado (coluna) para adicionar o campo append à lista de elementos da ampliação de visão CDS.

   3. Repita para ajustar o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567
      
        extend view entity Z##_R_Employee with
        {
          employ.zztitle_zem,
          employ.zzcountry_zem
        }
      

3. Defina nomes de alias para os novos elementos de visualização (nomes sugeridos: ZZTitleZem e ZZCoutryZem).

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567
      
        extend view entity Z##_R_Employee with
        {
          employ.zztitle_zem   as ZZTitleZem,
          employ.zzcountry_zem as ZZCountryZem
        }
      

4. Ative a ampliação de visão.

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

5. Exiba a Descrição da dica da entidade de visão ampliada para confirmar que ela contém os novos elementos.

   1. Na linha de código que começa com extend view entity, posicione o cursor em z##_R_Employee e pressione F2.

Para sua entidade de visão de consulta com parâmetros, crie uma ampliação de visão CDS (nome sugerido: Z##EXT_C_EMPLOYEE) para adicionar os elementos que você adicionou à visão de base (os nomes de elementos sugeridos eram: ZZTitleZem e ZZCountryZem). Adicione também uma função SQL para concatenar o nome e o sobrenome do empregado, separados por um único espaço em branco (nome do elemento sugerido: ZZFullNameZem). Por fim, amplie a visão com um código que informa se o empregado está sediado na União Europeia ou não (nome do elemento sugerido: ZZEUBasedZem).

1. Crie uma ampliação de visão CDS para sua entidade de visão CDS Z##_C_EmployeeQueryP.

   1. No Explorador de projetos, localize a definição de dados Z##_C_EMPLOYEEQUERYP, clique com o botão direito do mouse nela e selecione Nova definição de dados.

   2. Certifique-se de que o campo Pacote contém o nome do seu próprio pacote.

   3. Insira Z##EXT_C_Employee em Name e Extension of Z##_C_EmployeeQueryP em Description. Em seguida, selecione Seguinte.

   4. Confirme a ordem de transporte e selecione Seguinte.

      Nota

      Não selecione Concluir ainda ou você não poderá selecionar o modelo correto.

   5. Na lista de Modelos, selecione Ampliar entidade de visão e, em seguida, Concluir.

2. Edite a lista de elementos da ampliação de visão. Remova o caractere de preenchimento e utilize a conclusão de código para adicionar o título e o país do empregado.

   1. No texto fonte, substitua base_data_source_code.element_name. por zz e pressione Ctrl + espaço para chamar code-completion.

   2. Na lista de sugestões, selecione ZZTitleZem - Z##_R_Employ como Empregado (coluna) para adicionar o campo de ampliação à lista de elementos.

   3. Repita para ajustar o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      1234567
      
        extend view entity Z##_C_EmployeeQueryP with
        {
          Employee.ZZTitleZem,
          Employee.ZZContryZem
        }
      

3. Utilize a função concat_with_space para concatenar o nome e sobrenome do empregado, separados por um único espaço em branco.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789
      
        extend view entity Z##_C_EmployeeQueryP with
        {
          Employee.ZZTitleZem,
          Employee.ZZContryZem,
      
          concat_with_space( Employee.FirstName, Employee.LastName, 1 )    
        }
      

4. Adicione um nome para este novo elemento (nome sugerido: ZZFullNameZem) e use a anotação relevante para fornecer uma etiqueta.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910
      
        extend view entity Z##_C_EmployeeQueryP with
        {
          Employee.ZZTitleZem,
          Employee.ZZContryZem,
          
          @endUserText.label: '
          concat_with_space( Employee.FirstName, Employee.LastName, 1 ) as ZZFullNameZem
        }
      

5. Amplie a visão com uma associação à entidade de visão CDS I_Country (nome sugerido: _ZZCountryZem).

   Dica

   Na condição ON, utilize o código do país da lista de elementos e o elemento-chave da entidade de visão I_Country.

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      12345678910111213
      
        extend view entity Z##_C_EmployeeQueryP with
        association [1..1] to I_Country as _ZZCountryZem
          on $projection.ZZCountryZem = _ZZCountryZem.Country
        {
          Employee.ZZTitleZem,
          Employee.ZZContryZem,
      
          concat_with_space( Employee.FirstName, 
                             Employee.LastName, 
                             1 )                    as ZZFullNameZem   
        }
      

6. Na lista de elementos, adicione o elemento IsEuropeanUnionMember do destino da associação (nome sugerido: ZZEUBasedZem).

   1. Ajuste o código da seguinte forma:

      Code Snippet

      Copy codeSwitch to dark mode

      123456789101112131415
      
        extend view entity Z##_C_EmployeeQueryP with
        association [1..1] to I_Country as _ZZCountryZem
          on $projection.ZZCountryZem = _ZZCountryZem.Country
        {
          Employee.ZZTitleZem,
          Employee.ZZContryZem,
      
          concat_with_space( Employee.FirstName, 
                             Employee.LastName, 
                             1 )                  as ZZFullNameZem,
      
          _ZZCountryZem.IsEuropeanUnionMember     as ZZEUBasedZem    
        }
      

7. Ative a ampliação de visão e exiba a Descrição de dica para a entidade de visão ampliada para confirmar que ela contém os novos elementos.

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

   2. Na linha de código que começa com extend view entity, posicione o cursor em z##_C_EmployeeQueryP e pressione F2.