Instalar e configurar a edição SAP BTP do ABAP SDK for Google Cloud

Neste documento, descrevemos como instalar e configurar a edição SAP BTP do ABAP SDK for Google Cloud no ambiente SAP BTP, ABAP.

Este documento é destinado a administradores da SAP, administradores do Google Cloud e outros profissionais de segurança da SAP e do Google Cloud.

Visão geral

O ABAP SDK for Google Cloud fornece bibliotecas de cliente na forma de classes ABAP para que os desenvolvedores acessem programaticamente as APIs do Google Cloud. Ao encapsular funções essenciais, como segurança, autenticação, serialização e desserialização de dados e tratamento de erros como componentes reutilizáveis, essas bibliotecas de cliente reduzem a quantidade de código que os desenvolvedores precisam escrever. Para ver uma lista completa das bibliotecas de cliente oferecidas pelo ABAP SDK for Google Cloud, consulte Bibliotecas de cliente do ABAP SDK for Google Cloud.

Como desenvolvedor de ABAP, é possível criar e implantar soluções de ML e orientadas por IA usando vários serviços do Google Cloud, como Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, APIs do Google Workspace e Plataforma Google Maps.

Para a comunicação entre as APIs SAP e Google Cloud, o ABAP SDK for Google Cloud usa o protocolo HTTPS com SSL.

Antes de começar

Antes de instalar a edição SAP BTP do ABAP SDK for Google Cloud, faça o seguinte:

  1. Inscreva-se no portal de paisagem do SAP BTP. Para informações sobre como se inscrever no portal Landscape, consulte Como assinar o Landscape Portal no SAP BTP.

  2. Ter um S-User ID válido associado a um número de cliente que tenha um contrato de suporte ativo da SAP.

  3. Se você é novo no Google Cloud, crie uma conta em https://cloud.google.com.

  4. Se você ainda não tiver um projeto do Google Cloud, crie um:

    Acessar o seletor de projetos

  5. Verifique se o faturamento está ativado no projeto. Para mais informações, consulte Verificar o status de faturamento do seu projeto.

  6. Ative as APIs compatíveis que você planeja acessar usando o SDK. Para informações sobre como ativar as APIs do Google Cloud, consulte Como ativar APIs.

Fazer upload dos certificados do Google

Para proteger a comunicação entre o SAP BTP, o ambiente ABAP e os servidores do Google, faça upload dos certificados do Google necessários no aplicativo Maintain Certificate Trust List do seu ambiente SAP BTP e ABAP.

Para fazer upload dos certificados no aplicativo Maintain Certificate Trust List do SAP, é preciso ter acesso ao catálogo comercial SAP_CORE_BC_SEC. Este catálogo da empresa está incluído no papel da empresa predefinido SAP_BR_ADMINISTRATOR.

Para fazer o upload dos certificados do Google, siga estas etapas:

  1. Faça o download dos seguintes certificados no repositório Google Trust Services:

    • GTS Root R1
    • GTS CA 1C3
  2. Faça login no cockpit do SAP BTP. Para mais informações, consulte a página da SAP em Acessar o cockpit.

  3. Selecione a subconta em que seu ambiente ABAP está hospedado.

  4. Acesse Instâncias e assinaturas > Instâncias e clique na instância do ABAP.

  5. No ambiente ABAP que é aberto, acesse Todos os espaços > Administração > Segurança.

  6. Abra o app Manter lista de confiança de certificado.

  7. Clique em Adicionar.

  8. Selecione os certificados que você salvou no repositório do Google Trust Services.

  9. Clique em Fazer upload. Os certificados são adicionados à lista de confiança.

Instalar a edição SAP BTP do ABAP SDK for Google Cloud

Instale a edição SAP BTP do ABAP SDK for Google Cloud usando o SAP BTP Landscape Portal.

Para instalar a edição SAP BTP do ABAP SDK for Google Cloud, siga estas etapas:

  1. Tenha o produto ABAP SDK for Google Cloud disponível no seu Landscape Portal.

    1. No componente BC-CP-ABA, abra um caso de prioridade média com o SAP usando uma das seguintes opções:

    2. Na descrição do caso, digite os seguintes detalhes:

      We would like the following product registered to our Landscape Portal:
      * Product: /GOOG/ABAP_SDK
      * Publisher: Google
      
    3. Forneça outros detalhes, conforme necessário, e envie o caso.

    Depois que a SAP confirmar que o produto está registrado no seu portal da paisagem, prossiga para a próxima etapa.

  2. Implante o produto ABAP SDK for Google Cloud:

    1. No Landscape Portal, abra o app Deploy.
    2. No campo Produto, selecione /GOOG/ABAP_SDK.
    3. No campo Versão de destino, selecione 1.0.1.
    4. Em Sistemas disponíveis, selecione a instância ABAP em que você precisa instalar o SDK.
    5. Clique em Implantar. A seção Status da implantação da versão do produto mostra o status de conclusão da implantação.

Adicionar apps Fiori à plataforma de lançamento

A edição SAP BTP do ABAP SDK for Google Cloud disponibiliza apps Fiori da SAP para configurações do SDK e geração de registros de aplicativos. Como administrador ou desenvolvedor, os apps Fiori são utilizados para configurar o SDK e a geração de registros de aplicativos. O SDK também fornece apps Fiori dedicados apenas para visualização de configurações de autenticação, configurações de geração de registros e análise dos registros do SDK.

Os administradores ou desenvolvedores que configuram o SDK e a geração de registros, ou os usuários que só precisam visualizar as configurações e os registros do SDK, precisam ter acesso aos apps Fiori relevantes. Para conceder acesso aos apps do SDK Fiori, é preciso adicionar os catálogos empresariais do ABAP SDK for Google Cloud ao papel comercial dos usuários que executam a configuração do SDK ou precisam visualizar as configurações e a geração de registros. A edição SAP BTP do ABAP SDK for Google Cloud inclui modelos de papéis empresariais que contêm catálogos comerciais necessários para acessar os apps da Fiori.

A tabela a seguir lista os modelos de funções na empresa e os apps Fiori relacionados a que eles oferecem acesso.

Modelo de função na empresa Nome do app Descrição
/GOOG/BRT_SDK SDK do Google: configuração principal Use este app para configurar a autenticação e se conectar com segurança às APIs do Google Cloud.
SDK do Google: configurações de registros do aplicativo Use este app para configurar a geração de registros e capturar erros, avisos e mensagens informativas em registros de aplicativos SAP.
SDK do Google: exibição de registros do aplicativo Use este app para visualizar os registros do aplicativo do SDK.
/GOOG/BRT_SDK_DISPLAY SDK do Google: exibir configuração principal Use este app para acessar as configurações do SDK.
SDK do Google: configuração dos registros de exibição Use este app para acessar as configurações de registro do aplicativo.
SDK do Google: exibição de registros do aplicativo Use este app para visualizar os registros do aplicativo do SDK.

Para adicionar os catálogos comerciais do ABAP SDK for Google Cloud ao papel comercial dos usuários que usam os modelos de papéis comerciais fornecidos, é necessário ter acesso ao catálogo de negócios SAP_CORE_BC_SEC. Este catálogo da empresa está incluído no papel da empresa predefinido SAP_BR_ADMINISTRATOR.

Criar uma função empresarial

  1. No seu ambiente ABAP, acesse Todos os espaços > Administração > Gerenciamento de identidade e acesso.
  2. Abra o app Modelos de funções empresariais.
  3. Pesquise e selecione um modelo de função da empresa conforme apropriado:

    • /GOOG/BRT_SDK: fornece acesso aos apps Fiori para configurar o SDK.
    • /GOOG/BRT_SDK_DISPLAY: fornece acesso aos apps Fiori para visualizar as configurações e os registros do SDK.
  4. Clique em Criar função empresarial.

  5. Na caixa de diálogo Criar função empresarial a partir de um modelo que é exibida, insira um valor para os seguintes campos:

    • Novo ID da função da empresa: insira um ID da função da empresa.
    • Nova descrição da função na empresa: insira uma descrição para a função que você criou.
  6. Clique em OK. A página Manter papéis comerciais aparece com o papel recém-criado.

  7. Em Categorias de acesso, especifique o acesso da função de negócios com base no modelo de função de negócios selecionado:

    • /GOOG/BRT_SDK: no campo Read, Write, Value Help, selecione Unrestricted.
    • /GOOG/BRT_SDK_DISPLAY: no campo Read, Write, Value Help, selecione No access.
  8. Como opção, na guia Catálogos comerciais atribuídos, é possível visualizar os catálogos empresariais dos apps Fiori associados ao papel empresarial.

  9. Clique em Salvar.

Atribuir espaço à função da empresa

  1. No seu ambiente ABAP, acesse Todos os espaços > Administração > Gerenciamento de identidade e acesso.
  2. Abra o app Manter funções comerciais.
  3. Pesquise e selecione a função que você criou na seção Criar uma função da empresa.
  4. Acesse a guia Espaços do Launchpad atribuídos e clique em Adicionar.
  5. Na caixa de diálogo Add Launchpad Space, digite um valor para os seguintes campos:

    • Atribuir espaço à função da empresa: selecione Criar novo espaço.
    • ID do espaço: digite o ID do espaço.
    • Descrição do espaço: digite uma descrição para o espaço.
    • Título do espaço: digite um título.
  6. Clique em Criar e atribuir espaço.

  7. Na guia Espaços do Launchpad atribuídos, clique no código do seu espaço.

  8. Na página Space Details, acesse a guia Pages e clique no ID da página.

  9. Na página Páginas do Launchpad gerenciado, acesse a guia Conteúdo da página e clique em Editar.

  10. No campo Título da seção, digite um título.

  11. Na seção Derived from Role, selecione os aplicativos Fiori e clique em Add. Esses apps Fiori são exibidos nos catálogos empresariais do ABAP SDK for Google Cloud.

  12. Clique em Salvar.

Atribuir papéis a usuários comerciais

Para conceder acesso aos apps do SDK Fiori, atribua o papel recém-criado aos usuários comerciais que gerenciam ou visualizam as configurações e os registros do SDK.

  1. No seu ambiente ABAP, acesse Todos os espaços > Administração > Gerenciamento de identidade e acesso.
  2. Abra o app Manter funções comerciais.
  3. Pesquise e selecione a função que você criou na seção Criar uma função empresarial.
  4. Acesse a guia Usuários comerciais atribuídos e clique em Adicionar.
  5. Na caixa de diálogo Adicionar usuários comerciais que aparece, pesquise e selecione os usuários necessários que precisam acessar os apps do SDK Fiori.
  6. Clique em OK. Os usuários podem conferir o espaço e a página atribuídos com os apps do SDK Fiori.

Configurar a autenticação

Para usar as APIs do Google Cloud, você precisa confirmar sua identidade por autenticação. Para informações sobre as opções de autenticação para o Google Cloud e as etapas de configuração, consulte Autenticação.

Configurar a geração de registros

A edição SAP BTP do ABAP SDK for Google Cloud usa registros de aplicativos SAP para salvar todas as mensagens geradas durante a execução de classes da biblioteca de cliente. Depois de definir uma configuração de registro padrão, o SDK começa a registrar as mensagens.

O objeto de registro /GOOG/LOG_OBJECT e o subobjeto /GOOG/LOG_SUBOBJECT são enviados com o SDK que pode ser usado para criar sua configuração de registro padrão.

Use o app SDK do Google: configurações do Application Log para criar uma configuração de registro.

É possível consultar os registros de aplicativos usando o app SDK do Google: exibição de registros de aplicativos. Saiba mais em Ver registros.

Para criar uma configuração de registro, siga estas etapas:

  1. Acesse a plataforma de lançamento do SAP Fiori.
  2. Acesse o espaço que contém os apps Fiori para configuração do SDK.
  3. Abra o app SDK do Google: configuração dos registros do aplicativo.
  4. Clique em Criar.
  5. Na caixa de diálogo Criar que é exibida, insira um valor para os seguintes campos:

    • Tipo de configuração de registro: selecione OBJ_SUBOBJ.
    • Objeto: selecione /GOOG/LOG_OBJECT.
    • Subobjeto: selecione /GOOG/LOG_SUBOBJECT.
  6. Clique em Continuar.

  7. Forneça os seguintes detalhes:

    • Dias de retenção: especifique o número de dias que os registros serão retidos.
    • Nível de registro: especifique o nível mínimo de registro. Os valores compatíveis são:

      • I: informações, avisos e erros
      • W: avisos e erros
      • E: apenas erros Recomendamos que você defina o nível de registro como I para que a maioria das mensagens de registro seja registrada.
    • Término em: especifique a data de término até a ativação dessa configuração de registro. A data de término padrão é 9999/12/31.

    • É padrão: para tornar essa sua configuração de registro padrão, marque a caixa de seleção.

  8. Clique em Criar.

Gerenciar a configuração de registros

Se uma configuração de registro não for mais necessária, você poderá desativá-la.

Para desativar uma configuração de registro, siga estas etapas:

  1. Abra o app SDK do Google: configuração dos registros do aplicativo.
  2. No campo Status da edição, selecione um status conforme necessário e clique em Ir.
  3. Clique na entrada de configuração de registro que você precisa desativar.
  4. Clique em Editar.
  5. Defina o campo Terminar em como uma data passada.
  6. Clique em Salvar.

Especificar o endpoint da API Google Cloud

A edição SAP BTP do ABAP SDK for Google Cloud oferece as seguintes opções para especificar o endpoint da API ao chamar uma API do Google Cloud usando a classe da biblioteca de cliente da API:

  • Endpoints padrão
  • Endpoint personalizado

Endpoints padrão

Por padrão, cada classe de API fixa no código os endpoints globais como um valor constante. A biblioteca de cliente usa esses endpoints quando um método é chamado para executar uma operação em recursos da API. Para usar os endpoints padrão, nenhuma outra configuração é necessária.

Endpoints personalizados

Nos cenários em que você precisa de flexibilidade para definir seus próprios endpoints, é possível criar endpoints personalizados. Por exemplo, você cria um endpoint personalizado para estabelecer conexão com o Google Cloud quando precisa fazer o seguinte:

  • Acessar endpoints específicos da região de uma API para aplicativos regulatórios ou sensíveis à latência.
  • Usar APIs específicas, como a Vertex AI, que só oferecem endpoints regionais.

Para criar um endpoint personalizado, use o cenário de comunicação /GOOG/COM_SDK_SRV que é enviado com o ABAP SDK for Google Cloud.

O procedimento a seguir ilustra como criar um endpoint regional para a API Pub/Sub. É possível seguir o mesmo procedimento para criar endpoints personalizados para outros serviços compatíveis do Google Cloud.

  1. Acesse a plataforma de lançamento do SAP Fiori do sistema BTP ABAP em que o ABAP SDK for Google Cloud está instalado.
  2. Acesse Todos os espaços > Administração > Gerenciamento da comunicação.
  3. Crie um sistema de comunicação:
    1. Abra o app Communication Systems.
    2. Clique em Novo.
    3. Na caixa de diálogo New Communication System, insira um valor para os seguintes campos:
      • ID do sistema: digite um ID do sistema.
      • Nome do sistema: digite um nome para o sistema.
    4. Clique em Criar.
    5. No campo Nome do host, insira seu endpoint personalizado. Por exemplo, insira um endpoint regional para o serviço Pub/Sub: https://asia-east1-pubsub.googleapis.com.
    6. No campo Porta, digite 443.
    7. Na guia Usuários para comunicação de saída, clique em Adicionar.
    8. No campo Método de autenticação, selecione Nenhum.
    9. Clique em Criar.
    10. Para salvar o sistema de comunicação, clique em Save.
  4. Crie um acordo de comunicação:

    1. Abra o app Communication Arrangement.
    2. Clique em Novo.
    3. Na caixa de diálogo New Communication Arrangement que é exibida, insira os seguintes detalhes:

      • Cenário: selecione Comunicação de saída para qualquer API (/GOOG/COM_SDK_SRV).
      • Nome do acordo: insira um nome para o acordo de comunicação.
    4. Clique em Criar.

    5. No campo Communication System, selecione o sistema de comunicação que você criou na etapa anterior.

    6. Em Comunicação de saída, no campo Nome de usuário, selecione Nenhum.

    7. Clique em Salvar.

  5. Crie um mapa de comunicação para um serviço de API:

    1. Acesse o espaço que contém os apps Fiori para configuração do SDK.
    2. Abra o app SDK do Google: configuração principal.
    3. Selecione a chave de cliente em que você precisa criar um endpoint personalizado. Presume-se que você já tenha criado uma chave de cliente e um mapa de comunicação para autenticação. Caso contrário, crie uma chave de cliente e um mapa de comunicação para autenticação. Para mais informações, consulte a Autenticação.
    4. Clique em Criar.
    5. Na caixa de diálogo Criar que aparece, selecione um nome de serviço. Por exemplo, selecione pubsub:v1.
    6. Clique em Continuar.
    7. No mapa de comunicação exibido, no campo Disposição da comunicação, selecione o tipo de comunicação que você criou na etapa anterior. Os outros artefatos de comunicação são preenchidos automaticamente.
    8. Clique em Aplicar.
    9. Clique em Salvar.
    10. Para validar a configuração personalizada do endpoint, clique em Verificar conexão. Uma marca de seleção verde em uma entrada indica que a configuração foi bem-sucedida. Acesse a página de solução de problemas para receber orientações sobre como resolver erros comuns.

Métricas de uso

A edição SAP BTP do ABAP SDK for Google Cloud coleta métricas de uso e as envia ao Google para fins de suporte, em conformidade com o Aviso de privacidade do Google Cloud (dados de serviço que coletamos). Essas métricas de uso são coletadas sempre que uma API do Google Cloud é chamada do ABAP SDK for Google Cloud.

O SDK coleta as seguintes métricas de uso:

  • Método de autenticação: informações sobre o método de autenticação usado para chamar os serviços do Google Cloud.
  • Versão do SDK do ABAP: no da edição SAP BTP do ABAP SDK for Google Cloud.
  • Versão SAP_ABA: versão do componente de software SAP_ABA.

Licenciamento

A edição SAP BTP do ABAP SDK for Google Cloud é disponibilizada como "Software" de acordo com o contrato que rege seu uso do Google Cloud Platform, incluindo os Termos Específicos do Serviço disponíveis em https://cloud.google.com/terms/service-terms Sem limitar a generalidade dos termos anteriores, não é possível modificar ou distribuir o ABAP SDK for Google Cloud sem permissão expressa por escrito do Google.

O software ABAP SDK for Google Cloud é oferecido gratuitamente. Para maior clareza, o uso de outros "Softwares" e "Services" nos termos do contrato que rege o uso do Google Cloud Platform, como a Cloud Translation API e a Pub/Sub API, pode ser cobrado.

O ABAP SDK for Google Cloud não inclui nenhuma licença para o software SAP. Você precisa adquirir separadamente uma licença adequada para o software SAP.

Ciclo de vida do suporte

O Google Cloud oferece suporte e mantém a versão principal atual da edição SAP BTP do ABAP SDK for Google Cloud por um período de pelo menos 12 meses após a publicação de um aviso de suspensão de uso da versão principal anterior em Página de notas da versão para SAP no Google Cloud

Receber suporte

Se você precisar de ajuda para resolver problemas com o ABAP SDK for Google Cloud, faça o seguinte: