Utilizar campos e lógica personalizados

Objectives

After completing this lesson, you will be able to:
  • Criar ampliações de fonte de dados
  • Criar campos personalizados
  • Ativar campos de banco de dados personalizados para utilização em aplicativos SAP Fiori
  • Criar lógica personalizada

Extensibilidade

A figura mostra a lista de apps na pasta Extensibilidade. Ela explica adicionalmente que você precisa ser atribuído a uma função empresarial que contém a extensibilidade do catálogo empresarial.

Os apps de extensibilidade ajudam você a personalizar aplicações e respectivas IUs, relatórios, modelos de e-mail e modelos de formulário. Utilizando apps de extensibilidade, você pode criar tabelas de banco de dados para segmentação e criar consultas.

Nota

Você só pode ampliar aplicações e as respectivas IUs, relatórios, modelos de e-mail e modelos de formulário se as aplicações que você quer ampliar forem ampliáveis.

Com os apps de extensibilidade, você pode criar campos personalizados, ampliações de fonte de dados e implementações de ampliação para contextos empresariais específicos para ampliar aplicações pré-fornecidas que são ampliáveis, de modo a adaptá-las às suas necessidades empresariais.

Você também pode criar visões CDS personalizadas com base em fontes de dados pré-fornecidas. Os dados de uma aplicação são distribuídos por várias tabelas de banco de dados. Usando visões CDS, você pode consolidar os dados de diferentes fontes de dados e reorganizar os campos de tabela de acordo com as necessidades específicas da aplicação.

É possível criar business objects personalizados com IUs e adicionar lógica personalizada a business objects personalizados. Assim, você pode criar suas próprias aplicações com base em business objects personalizados.

Os itens de ampliação podem ser transportados com os apps Configurar pacotes de software e Registrar ampliações para transporte para estarem disponíveis e utilizáveis de forma produtiva.

Você pode visualizar uma lista de seus itens de extensibilidade e as dependências entre eles, no Inventário de extensibilidade.

Extensões de fonte de dados

A figura mostra a posição do botão Ampliação de fonte de dados, que permite várias opções, como descrito abaixo.

Você pode criar, processar e eliminar ampliações de fonte de dados para ativar a utilização de campos existentes em fontes de dados pré-fornecidas.

Para criar e atualizar ampliações de fonte de dados, proceda da seguinte forma:

  1. Abra o app Campos e lógica personalizados. Você pode abrir o app diretamente a partir do launchpad do SAP Fiori ou a partir de uma aplicação ampliável, selecionando Adicionar campo no modo de adaptação da IU de uma aplicação.

    Mude para a guia Ampliações de fonte de dados.

  2. Crie uma ampliação de fonte de dados para a fonte de dados onde ela é necessária.

    Selecione Criar acima da lista de ampliações de fonte de dados existentes e selecione a fonte de dados a ser ampliada. Insira um ID de ampliação e uma descrição.

  3. Edite a ampliação da fonte de dados.

    Ative a utilização de campos padrão adicionais (campos fornecidos pela SAP) na fonte de dados. Selecione campos padrão adicionais que já podem ser alcançados pela fonte de dados ampliada, mas cujos valores ainda não foram recuperados por esta fonte de dados.

  4. Ajuste os nomes de campo propostos, se necessário.
  5. Publique sua ampliação de fonte de dados.

Nota

  • A adição de campos padrão adicionais pode permitir que os usuários finais acessem dados restritos na fonte de dados ampliada, sem ter a autorização necessária.
  • Dependendo do caminho do campo e da natureza dos campos selecionados, a obtenção de dados pode ficar mais lenta após a adição de uma ampliação de fonte de dados.

Para utilizar novos campos de uma ampliação de fonte de dados em um app SAP Fiori, você deve reiniciar o app no modo de adaptação da IU.

Mais tarde, é descrito como transportar ampliações de fonte de dados para o sistema produtivo.

App Campos e lógica personalizados

A figura ilustra o bloco Campos e lógica personalizados, que oferece três opções de extensibilidade, como descrito abaixo.

Diferentes usuários e contextos empresariais requerem diferentes layouts de documento ou funcionalidade de aplicação. Para atender a essas necessidades específicas, você pode utilizar o app Campos e lógica personalizados para adaptar de modo correspondente, por exemplo, modelos e lógica pré-fornecidos.

Este app combina as três opções de extensibilidade seguintes:

  • Campos personalizados
  • Ampliações de fonte de dados
  • Lógica personalizada

campos personalizados

Você pode usar o app Campos e lógica personalizados para criar e atualizar seus próprios campos que podem ser usados para ampliar aplicações que ativaram a sua extensibilidade para usuários-chave.

Utilizando o app Campos e lógica personalizados, você pode:

  • Criar seus próprios campos
  • Ativar a utilização do campo
    • Disponibilize seus campos para IUs, relatórios, modelos de e-mail, modelos de formulário e cenários empresariais.
    • Torne o conteúdo de seus campos pesquisável com a pesquisa de texto livre.
  • Indique o comportamento de agregação dos campos.
  • Eliminar campos.

Além das coisas listadas acima, Campos personalizados, você pode:

  • Escolha um tipo de campo
  • Disponibilizar seus campos em outros idiomas
  • Publicar campos em seu sistema de teste
  • Editar campos que já foram publicados
  • Descartar as alterações que você fez em um campo que já foi publicado e, assim, redefinir todas as modificações para voltar ao estado da última versão publicada de um campo com um clique
A figura ilustra como criar campos personalizados. O botão Mais abre uma janela pop-up. Com este popup, você pode criar os campos personalizados necessários. O processo é descrito detalhadamente abaixo.

Para criar campos personalizados, proceda da seguinte forma:

  1. Abra o app Campos e lógica personalizados. Você pode abrir o app diretamente a partir do launchpad do SAP Fiori ou a partir de uma aplicação ampliável, selecionando Adicionar campo no modo de adaptação da IU da aplicação.
  2. Crie um campo personalizado no contexto empresarial onde ele é necessário.
  3. Editar um campo personalizado.

    Decida onde o campo personalizado é necessário e se deve ser pesquisável. Traduza o campo, se necessário. Você também pode definir o comportamento de agregação do campo. Dependendo do tipo de campo, você pode escolher entre os seguintes comportamentos de agregação:

    • Nenhum: os valores de campo não são agregados. Este comportamento de agregação é o padrão para os tipos de campo Data e Hora.
    • Soma: os valores do campo são somados. Este comportamento de agregação é o padrão para tipos de campo numérico.
    • Máximo: o valor máximo do campo é calculado.
    • Mínimo: o valor mínimo do campo é calculado.

    Nota

    Os campos dos tipos Campo de seleção, Endereço de e-mail, Lista de códigos, Endereço Web e Texto não podem ser agregados.

    Assim que um campo é ativado para utilização de campo em IUs e relatórios que exibem dados agregados, o comportamento de agregação selecionado é aplicado ao campo.

    Se o seu campo for um tipo em forma de caractere ou suportar a utilização de casas decimais, você pode adaptar o comprimento do campo e o número de casas decimais, conforme necessário.

    Nota

    Quando você publica um campo com um determinado comprimento, não pode reduzir o comprimento do campo mais tarde.
  4. Publique seus campos personalizados para transporte.

Para utilizar um campo em um app SAP Fiori, você deve reiniciar o app no modo de adaptação.

Criar campos personalizados

Cenário empresarial

Neste exercício, você aprenderá a ampliar o app Administrar clientes predefinido adicionando campos personalizados.

Etapas

  1. Inicie o app Administrar clientes predefinido utilizando o launchpad do SAP Fiori. Neste app, navegue para a página de objeto para um cliente e abra o app Campos e lógica personalizados selecionando Adicionar campo no modo de adaptação da IU para esta página.

  2. No app Campos e lógica personalizados, crie e publique os dois campos personalizados seguintes:

    Contexto empresarialRótuloIdentificadorDica de ferramentaTipo
    S4D425: estudante 01Status do prêmioZZ1_ispremium_01Status do prêmioCampo de seleção
    S4D425: estudante 01DescontoZZ1_Discount_01DescontoNúmero (comprimento: 5, casas decimais: 2)

    Certifique-se de que a utilização dos dois campos personalizados no app Administrar clientes está ativada.

  3. Adicione os dois campos personalizados ao grupo Informações gerais na página de objeto do app Administrar clientes.

  4. Para testar os campos personalizados adicionados, processe um cliente existente no app Administrar clientes. Defina o código Status do prêmio para o cliente como verdadeiro, insira um desconto diferente de zero e grave suas modificações.

Campos de banco de dados personalizados

Os campos personalizados podem ser criados não só utilizando o app SAP Fiori Campos e lógica personalizados, mas também utilizando transações back-end para criar campos de banco de dados.

Você pode enfrentar a seguinte situação: os campos personalizados (campos de banco de dados) já estão disponíveis no back-end, mas precisam ser usados em um aplicativo SAP Fiori. Para utilizar campos de banco de dados também para ampliar aplicações SAP Fiori, você precisa ativar os campos de banco de dados para utilização com SAP Fiori.

Nota

O organizador de transporte de adaptação deve ser configurado no sistema no qual você quer ativar campos de banco de dados para utilização em apps SAP Fiori. Isso é efetuado por meio da transação S_ATO_SETUP.
A figura explica a utilização das instruções Preparar e Ativar para ativar campos para utilização no app Campos e lógica personalizados.

Para ativar campos de banco de dados para utilização em apps SAP Fiori, proceda da seguinte forma:

Abra a transação Ativar campos para utilização no app 'Campos e lógica personalizados' (transação SCFD_EUI) e procure os campos de banco de dados que você pretende ativar para utilização.

É exibida uma lista de campos de banco de dados. Esses campos foram adicionados a tabelas de banco de dados utilizando estruturas append ou includes de cliente. O status do campo indica se um campo pode ser ativado diretamente, se precisa ser preparado previamente ou se já foi ativado.

Entre outros, existem os seguintes status:

  • Preparação necessária

    Nesse caso, selecione Preparar e siga as instruções passo a passo fornecidas no diálogo que é aberto.

  • Pode ser ativado
  • Habilitado
  • Não pode ser ativado

    Isso significa que o campo não se encontra em uma tabela de banco de dados que foi preparada pela SAP para utilização no app Campo e lógica personalizados, ou o respectivo tipo de dados ABAP Dictionary não é suportado pelo app.

Após ativar e antes de o app SAP Fiori Campos e lógica personalizados ser utilizado para adicionar um campo a IUs, relatórios ou modelos de e-mail, verifique se o seu campo de banco de dados foi adicionado manualmente a definições de dados Core Data Services (CDS) fornecidas pela SAP.

A figura ilustra a posição do botão Ativar utilização em uma tela.

Uma vez ativados para o app SAP Fiori Campos e lógica personalizados, os campos estão disponíveis no app juntamente com quaisquer campos personalizados recém-criados e podem ser adicionados a IUs e relatórios SAP Fiori, modelos de formulário e modelos de e-mail, bem como cenários empresariais da mesma forma que os campos personalizados.

Isso significa que você deve ativar a utilização dos campos de banco de dados personalizados no app Campos e lógica personalizados.

Lógica personalizada

Com o app Campos e lógica personalizados, você também pode criar implementações de ampliação para adaptar aplicações.

Utilizando este app, você pode:

  • Implementar lógica personalizada
  • Testar sua lógica personalizada, por exemplo, com variantes de teste predefinidas
  • Criar condições de filtro para definir quando uma implementação de ampliação é executada
  • Publicar implementações de ampliação em seu sistema de teste
  • Processar implementações de ampliação que já foram publicadas
  • Eliminar implementações de ampliação
A figura ilustra o procedimento, que começa quando o botão Mais na respectiva tela é selecionado. O processo em si é descrito abaixo.

Para criar e atualizar a lógica personalizada que pode ser usada para ampliar aplicações, que ativaram a sua extensibilidade para usuários-chave, proceda da seguinte forma:

  1. Abra o app Campos e lógica personalizados. Você pode abrir o app diretamente a partir do launchpad do SAP Fiori ou a partir de uma aplicação ampliável, selecionando Adicionar campo no modo de adaptação da IU de uma aplicação.
  2. Crie uma implementação de ampliação para o contexto empresarial, onde a lógica personalizada precisa ser executada.
  3. Processe sua implementação de ampliação.

    A lógica personalizada é implementada em uma implementação de ampliação usando ABAP para usuários-chave em um editor baseado na Web.

  4. Publicar implementações de ampliação para transporte.
A figura mostra um exemplo de uma codificação ABAP.

O ABAP para usuários-chave é utilizado para implementar extensões de lógica empresarial usando um editor baseado na Web no ambiente SAP Fiori.

Para mais informações sobre como utilizar ABAP para usuários-chave para implementar sua lógica personalizada utilizando o app Campos e lógica personalizados, você pode consultar a documentação.

ABAP restrito

Informações sobre ABAP restrito:

  • Os apps de extensibilidade de usuário-chave Campos e lógica personalizados, Business objects personalizados e Elementos reutilizáveis personalizados incluem um editor ABAP no app para codificação, por exemplo, validações de dados, substituições ou determinações. Neste editor, só é possível uma forma restrita de ABAP.
  • As funcionalidades de idioma suportadas no ABAP restrito são:

    • Expressões básicas, instruções de controle e fluxo, variáveis e tabelas internas
    • Cadeia, matemática, dados e operações de tempo
    • Acesso de leitura e escrita à interface da opção de ampliação
    • Acesso de leitura e escrita a APIs SAP permitidos (classes)
    • Acesso de leitura (suporte completo a seleção de SQL) a visões CDS da SAP permitidas
  • As seguintes funcionalidades ABAP não são permitidas para garantir a robustez, a segurança e o destino de consistência de dados:

    • Qualquer operação de banco de dados, exceto seleções de visões liberadas, por exemplo, a declaração commit work não é permitida
    • Acesso a arquivos e outros comandos de E/S
    • Criação de novas tarefas (processamento paralelo)
    • Programação dinâmica
    • Geração de código
    • Para simplificar a sintaxe, comandos ABAP obsoletos são removidos da sintaxe
  • A lista completa de instruções ABAP permitidas está disponível na documentação.