Definir uma visão CDS básica

Objectives

After completing this lesson, you will be able to:
  • Crie uma definição de dados.
  • Atualize a cláusula FROM e a lista de elementos.

Criação de uma definição de dados

Para criar uma nova definição de dados, proceda da seguinte forma:

  1. Clique com o botão direito do mouse em seu projeto no Explorador de projetos.
  2. Selecione Novo→Objeto do repositório ABAP …
  3. Na lista, selecione Core Data Services→Definições de dados.

    Dica

    Você pode usar o campo de entrada abaixo de Projeto para digitar um critério de pesquisa, por exemplo, definição de dados.

  4. Selecione Avançar.
  5. Insira o nome de um pacote existente e um nome e uma descrição para a nova definição de dados.

    Dica

    Se você inserir o nome de uma tabela de banco de dados ou o nome de uma entidade de visão CDS como Objeto referenciado, a nova visão irá ler todos os campos desse objeto referenciado.

Se seu pacote já contiver uma definição de dados, você pode usar o seguinte atalho:

  1. No Explorador de projetos, expanda o subnó Core Data Services→Definições de dados do pacote favorito.
  2. Clique com o botão direito em Definições de dados e selecione Nova definição de dados.

Modelos de definição de dados

Ao criar uma nova definição de dados, você pode começar com uma página em branco. Como alternativa, você pode utilizar um dos diversos modelos disponíveis como ponto de partida. O modelo recomendado ao definir uma visão simples é Definir entidade de visão.

Normalmente, é exibido um diálogo correspondente depois de você atribuir a nova definição de dados à sua ordem de transporte. Mas sempre é possível retornar ao modelo de seleção posteriormente no processo de edição.

Para selecionar um modelo posteriormente, vá para a ficha Modelos na ficha abaixo da janela do editor.

Nota

Você pode definir seus próprios modelos no editor preferências. Vá para →WindowPreferences e procure Modelos "de definição de dados".

A cláusula FROM

Uma visão CDS nunca armazena dados por si só. Ele sempre referencia uma ou mais fontes de dados a partir das quais lê os dados.

A infraestrutura de dados de uma visão CDS é indicada na instrução define após a palavra-chave FROM. Aqui você pode indicar tabelas de banco de dados e outras visões CDS.

Dica

Quando você pressiona Ctrl + espaço para inserir a fonte de dados usando a conclusão de código, o editor só sugere objetos de desenvolvimento adequados como fontes de dados.

a lista de elementos

a lista de elementos

Assista ao vídeo para saber mais sobre a lista de elementos.

A palavra-chave KEY torna um elemento de visão parte da chave views. Os elementos-chave devem ser colocados em um bloco no início da lista de elementos.

Para uma visão CDS, não é obrigatório definir uma chave, mas é altamente recomendado. Você verá uma advertência da verificação de sintaxe se a visão não contiver pelo menos um elemento-chave.

Existe outra advertência se a chave da visão CDS não corresponder à chave da respectiva fonte de dados. Podem existir motivos para ignorar esta advertência, mas normalmente a chave da visão deve ser idêntica à chave da fonte de dados. No entanto, existe uma exceção geral: se a fonte de dados for uma tabela de banco de dados com um campo de mandante, este campo de mandante não deve fazer parte da lista de elementos da visão.

Com o suplemento AS, você pode definir um nome para um elemento. Se um elemento for apenas um campo da fonte de dados, o suplemento AS será opcional. Nesse caso, o nome permanece o mesmo que na fonte de dados.

Dica

Nas tabelas de banco de dados, os nomes de campo não fazem distinção entre maiúsculas e minúsculas. Quando uma visão CDS lê a partir de uma tabela de banco de dados, é comum aumentar a legibilidade introduzindo nomes de alias que consistem em uma mistura de letras maiúsculas e minúsculas (maiúsculas e minúsculas). No exemplo, employee_id tornou-se EmployeeID e first_name se tornou FirstName.

Em vez de adicionar os campos da fonte de dados um a um, você pode pressionar Ctrl + Espaço e selecionar Inserir todos os elementos. Este modelo não só adiciona todos os campos da fonte de dados (exceto o campo de cliente) à lista de elementos, como também assume a definição de chave e sugere nomes de alias em letras maiúsculas e minúsculas para todos os campos.

Nota

Quando você cria uma visão CDS com uma tabela de banco de dados ou uma visão CDS como objeto referenciado, o modelo Inserir todos os elementos é aplicado por padrão.

The DDL Formatter e Comentários

A sintaxe que usamos em definições de dados é chamada de Linguagem de definição de dados CDS (DDL). Para aumentar a legibilidade, você pode permitir que o ADT formate a fonte DDL. Posicione o cursor em algum lugar na definição de dados e selecione Formato do→código-fonte no menu do Eclipse ou pressione Ctrl + F1.

Por padrão, o Eclipse utiliza um perfil de formatador padrão que deriva do sistema ABAP. Você pode definir seus próprios perfis de formatador na caixa de diálogo Preferências do Eclipse. Selecione Window→Preferences no menu eclipse e procure DDL Formatter.

Comentários em DDL de CDS

Assista ao vídeo para saber mais sobre comentários no DDL de CDS.

Como definir uma visão CDS básica

Reproduza o vídeo para ver como definir uma visão CDS básica.

Definir uma visão CDS básica

Você pretende separar o acesso aos dados e a definição de tabela. Para isso, você define uma entidade de visão CDS que lê

Modelo:

  • n.a.

Solução:

  • /LRN/R_EMPLOYEE (Definição de dados)

Pré-requisitos

Para este exercício, você precisa da tabela de banco de dados para os dados do empregado que criou e preencheu em um exercício anterior (o nome sugerido foi: Z##EMPLOY, em que ## é o número do seu grupo). Se você não tiver concluído esse exercício, crie uma cópia da tabela de banco de dados /LRN/EMPLOY_DEP.

Tarefa 1: Definir uma entidade de visão CDS

Defina uma nova entidade de visão CDS que leia a partir de sua tabela de banco de dados com dados do empregado (nome sugerido: Z##_R_Employee, em que ## é o número do seu grupo). Utilize um modelo que adicione todos os campos de tabela à lista de elementos da visão (exceto o campo de mandante, o salário anual e o código de moeda) e que assume a definição de chave da tabela de banco de dados.

Etapas

  1. Em seu próprio pacote, crie uma nova definição de dados (nome sugerido: Z##_R_EMPLOYEE, em que ## é seu número de grupo). Indique sua tabela de banco de dados como Objeto referenciado e selecione o modelo Definir entidade de visão para gerar a instruçã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 em sua definição de tabela de banco de dados Z##EMPLOY 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##_R_Employee, em que ## é o seu número de grupo).

    5. Insira Empregado (entidade) 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. Por enquanto, comente os elementos AnnualSalary e CurrencyCode.

    1. Selecione as duas linhas de código e pressione Ctrl + < para adicionar dois sinais de barra (/) no início de cada linha.

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

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

  4. Ative a definição de dados.

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

Tarefa 2: Analisar a entidade de visão CDS

Analise a implementação técnica da entidade de visão CDS no banco de dados e teste o resultado.

Etapas

  1. Exiba a instrução SQL com a qual a representação técnica da entidade de visão é criada no banco de dados.

    1. Clique com o botão direito do mouse em qualquer lugar no texto fonte da definição de dados e selecione Mostrar instrução SQL CREATE.

  2. Abra a Visualização de dados para sua visão CDS.

    1. Clique com o botão direito do mouse em qualquer lugar no texto fonte da definição de dados e selecione Abrir com→visualização de dados. Como alternativa, posicione o cursor em qualquer lugar no texto fonte da definição de dados e pressione F8.