Gatilho do gateway SAP

O gatilho de gateway SAP é um gatilho de evento de conector do conector de gateway do SAP que permite inserir, excluir, atualizar e ler operações nos dados do gateway SAP.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho do Gateway SAP, verifique se você tem o seguinte papel do IAM no projeto:
- Administrador de conectores (roles/connectors.admin)
Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do gateway SAP:
- Invocador do Application Integration (roles/integrations.integrationInvoker)

Adicionar o gatilho do gateway SAP

Para adicionar um gatilho do gateway SAP à sua integração, siga estas etapas:

No console do Google Cloud, acesse a página Application Integration.
Acessar o Application Integration
No menu de navegação, clique em Integrations.
A página Lista de integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração ou clique em Criar integração para criar uma nova.
Caso você esteja criando uma nova integração, siga estas etapas:
1. Insira um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas da integração.
  Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
4. Clique em Criar.
Isso abre a integração na página do editor de integração.
Na barra de navegação do editor de integração, clique em Gatilhos para ver a lista de gatilhos disponíveis.
Clique e coloque o elemento gatilho do Gateway SAP no editor de integração.

Para configurar o gatilho do Gateway SAP, use uma conexão do Gateway SAP disponível no Integration Connectors ou crie uma nova conexão do Gateway SAP usando a opção de criação de conexão inline.

Configurar o gatilho do gateway SAP usando uma conexão atual

O gatilho do gateway SAP é um gatilho de evento de conector, portanto, só é possível usar uma conexão de gateway SAP com a assinatura de evento ativada para configurar o gatilho.

Para informações sobre como configurar um gatilho do gateway SAP usando uma nova conexão do gateway SAP, consulte Configurar o gatilho do gateway SAP usando uma nova conexão (em inglês).

Para configurar um gatilho do Gateway SAP usando uma conexão do Gateway SAP, siga estas etapas:

Clique no elemento gatilho do Gateway SAP no editor de integração para abrir o painel de configuração do acionador.
Clique em Configurar gatilho.
Forneça os seguintes detalhes de configuração na página Editor do acionador de evento do conector:
1. Região:selecione a região da sua conexão de gateway SAP.
2. Conexão:selecione a conexão do Gateway SAP que você quer usar.
  A Application Integration exibe apenas as conexões do Gateway SAP que estão ativas e têm uma assinatura de evento ativada.
3. Insira o nome do campo do tipo de evento. Esse campo identifica o tipo de evento associadas à solicitação de evento recebida.
```
{
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
```
4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do gateway SAP.
Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configurar o gatilho do gateway SAP usando uma nova conexão

Clique no elemento gatilho do Gateway SAP no editor de integração para abrir o painel de configuração do acionador.
Clique em Configurar gatilho.
Ignore o campo Região.
Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
Na seção Detalhes da conexão, faça o seguinte:
1. Conector: selecione SAP Gateway na lista suspensa de conectores disponíveis.
2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
3. No campo Nome da conexão, insira um nome para a instância de conexão
  Os nomes de conexão precisam atender aos seguintes critérios:
  - Os nomes de conexões podem usar letras, números ou hifens.
  - As letras precisam ser minúsculas.
  - Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
  - Os nomes das conexões não podem exceder 63 caracteres.
4. Como opção, insira uma Descrição para a instância de conexão.
5. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
6. Se quiser usar a conexão para inscrições de eventos, selecione Ativar inscrição de eventos. Selecionando isso exibe as seguintes opções:
  - Ativar a assinatura de eventos com entidades e ações: selecione essa opção para usar a conexão para operações de assinatura de eventos e de conector (entidades e ações).
  - Ativar somente inscrição de eventos: selecione esta opção para usar a conexão. apenas para inscrição em eventos. Se você selecionar essa opção, clique em Próxima e configurar a inscrição em eventos.
7. Namespace: especifique o namespace do serviço do qual você quer recuperar dados. Isso é necessário se o serviço não for especificado no URL.
8. Serviço: especifique o serviço com os dados que você quer recuperar. Isso é necessário se o serviço não for especificado no URL.
9. CustomUrlParams::especifica parâmetros de string de consulta personalizados incluídos na solicitação HTTP. Os parâmetros precisam ser codificados como uma string de consulta neste formato: field1=value1&field2=value2. Os valores da string de consulta precisam ser codificados por URL.
10. Formato de dados: o formato de dados onde os dados serão recuperados. Selecione XML ou JSON.
11. Usar nomes de exibição: booleano que determina se os rótulos SAP serão usados ou não.
12. Opcionalmente, defina as Configurações do nó de conexão:
  - Número mínimo de nós: digite o número mínimo de nós de conexão.
  - Número máximo de nós: digite o número máximo de nós de conexão.
  Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.
13. Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
14. Clique em PRÓXIMA.
Na seção Destinos, defina o URL do ambiente do Gateway SAP ou como o URL completo do serviço OData. Por exemplo, formato: ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ e o URL de exemplo é https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Adicione propriedades adicionais usando a propriedade CustomUrlParams.
1. Tipo de destino: selecione um Tipo de destino.
  - Selecione Endereço do host na lista para especificar o nome do host ou o endereço IP do destino.
  - Para estabelecer uma conexão particular com seus sistemas de back-end, Selecione Anexo de endpoint na lista e depois selecione o anexo de endpoint necessário. na lista Endpoint Attachment.
    Observação : para entender como criar um anexo de endpoint, consulte Anexo de serviço PSC e anexo de endpoint. Depois de ter criado o anexo de endpoint, ele vai aparecer na lista Anexo do endpoint.
  Para estabelecer uma conexão pública com os sistemas de back-end com mais segurança, considere configurar endereços IP de saída estáticos para suas conexões e configure as regras de firewall para autorizar apenas os endereços IP estáticos específicos.
  
  Para inserir outros destinos, clique em +ADICIONAR DESTINO.
2. Clique em PRÓXIMA.
Na seção Autenticação, insira os detalhes da autenticação.
1. Selecione um Tipo de autenticação e insira os detalhes relevantes.
  Os seguintes tipos de autenticação são compatíveis com a conexão do SAP Gateway:
  - Nome de usuário e senha
  - Anônimo
2. Clique em PRÓXIMA.
Revisão: revise os detalhes de conexão e autenticação.
Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

Nome de usuário e senha
- Nome de usuário: nome de usuário para o conector
- Senha: a senha do Secret Manager que contém a senha associada ao conector.

Anônimo
Se você quiser usar o login anônimo, selecione Não disponível.
- Chave de API: a chave de API do usuário autenticado no momento.

Configurar inscrição no evento

Se você tiver ativado a assinatura do evento, insira os seguintes valores na seção Detalhes da assinatura do evento:

Selecione um dos seguintes tipos de autenticação para o listener de eventos.
Observação : antes de configurar a autenticação, verifique se você tem o ponto de extremidade do listener de eventos, que é disponibilizado após a criação da conexão. Para visualizar o endpoint, acessar a página Todas as conexões e clique na conexão que você quer visualizar. O endpoint é exibido a seção Detalhes da conexão.
- Autenticação do Google. Se você ativar essa opção, siga as etapas em Autenticar usando JSON Web Tokens para configurar a autenticação para o SDK do ABAP. Além disso, verifique se a conta de serviço tem o papel roles/connectors.listener e seu token de acesso é usado para autenticação.
- Autenticação de chave de API. Se você selecionar essa opção, deverá ter criado uma chave de API e a salvou como secret do Secret Manager. Para mais informações, consulte Criar uma chave de API.
Insira o nome do campo do tipo de evento. Esse campo identifica o tipo de evento associadas à solicitação de evento recebida.
```
{
"event_type": "user.created",
...
// other request fields
...
}
```
Selecione Ativar conectividade privada para conectividade segura entre seu aplicativo de back-end e sua conexão. Se você selecionar essa opção, será necessário realizar outras etapas de configuração depois de criar a conexão. Para mais informações, consulte Conectividade particular para assinatura de eventos.
Insira a configuração de mensagens inativas. Se você configurar mensagens inativas, a conexão gravará os eventos não processados para o tópico do Pub/Sub especificado. Digite os seguintes detalhes:
1. ID do projeto de mensagens inativas: o ID do projeto do Google Cloud em que você configurou o tópico de mensagens inativas do Pub/Sub.
2. Tópico de mensagens inativas: o tópico do Pub/Sub em que você quer gravar os detalhes do evento não processado.

Configurar a autenticação no SAP

Configure a autenticação no SAP seguindo as instruções no guia Visão geral da autenticação para o local ou qualquer edição na nuvem do SDK do ABAP para o Google Cloud.

Validar o gatilho

Para validar o gatilho, crie um programa ABAP. A seguir, apresentamos um exemplo de programa ABAP que você pode usar como referência. O campo ls_event_payload muda com base nos seus requisitos:

*&---------------------------------------------------------------------*
*& Report ZR_TEST_INT_CONNECTOR
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT zr_test_int_connector.
PARAMETERS: p_auth TYPE char1 RADIOBUTTON GROUP rbg1 USER-COMMAND uc DEFAULT 'X',
 p_apik TYPE char1 RADIOBUTTON GROUP rbg1.
DATA:
 lv_p_projects_id TYPE string,
 lv_p_locations_id TYPE string,
 lv_p_connections_id TYPE string,
 ls_input TYPE /goog/cl_connectors_v1=>ty_103.
TYPES: BEGIN OF event_payload,
 event_type TYPE string,
 event_id TYPE string,
 name TYPE string,
 org_id TYPE string,
 END OF event_payload.
DATA: ls_event_payload TYPE event_payload.
ls_event_payload = VALUE #(
 event_type = 'create-entity'
 event_id = '1'
 name = 'demo-org'
 org_id = 'SAP'
 ).
TRY.
 IF p_Auth = abap_true.
 DATA(lv_client_key) = 'IC_DEMO_GOOGLE_AUTH'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway'.
 ELSE.
 lv_client_key = 'IC_DEMO_GOOGLE_APIK'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway-apik'.
 ENDIF.
* Open HTTP Connection
 DATA(lo_client) = NEW /goog/cl_connectors_v1( iv_key_name = CONV #( lv_client_key ) ).
* Populate relevant parameters
 lv_p_projects_id = lo_client->gv_project_id.
 lv_p_locations_id = 'us-central1'.
 GET REFERENCE OF ls_event_payload INTO ls_input-payload .
* Call API method: connectors.projects.locations.connections.listenEvent
 CALL METHOD lo_client->listen_event_connections
 EXPORTING


iv_p_projects_id = lv_p_projects_id
 iv_p_locations_id = lv_p_locations_id
 iv_p_connections_id = lv_p_connections_id
 is_input = ls_input
 IMPORTING
* es_raw =
 es_output = DATA(ls_output)
 ev_ret_code = DATA(lv_ret_code)
 ev_err_text = DATA(lv_err_text)
 es_err_resp = DATA(ls_err_resp).
 IF lo_client->is_success( lv_ret_code ).
 MESSAGE 'Success' TYPE 'S'.
 ELSE.
 MESSAGE lv_err_text TYPE 'E'.
 ENDIF.
* Close HTTP Connection
 lo_client->close( ).
 CATCH /goog/cx_sdk INTO DATA(lo_exception).
 MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.