Consulte os conectores compatíveis com a integração de aplicativos.

Gatilho do gateway SAP

O gatilho do SAP Gateway é um gatilho de evento do conector. O conector do SAP Gateway permite executar operações de inserção, exclusão, atualização e leitura nos dados do SAP Gateway.

Antes de começar

  • Se você planeja criar ou configurar uma nova conexão para o acionador do gateway SAP, verifique se tem o seguinte papel do IAM no projeto:
    • Administrador do conector (roles/connectors.admin)

      • Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso.

  • Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do SAP Gateway:
    • Invocador do Application Integration (roles/integrations.integrationInvoker)

      • Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

    • Adicionar o acionador do SAP Gateway

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

    1. No console do Google Cloud, acesse a página Application Integration.

      Acessar o Application Integration

    2. 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.

    3. 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.
      3. Selecione uma conta de serviço para a integração. É possível 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 de integração.
      4. Clique em Criar.

      Isso abre a integração na página do editor de integração.

    4. Na barra de navegação do editor de integração, clique em Gatilhos para ver a lista de gatilhos disponíveis.
    5. Clique e coloque o elemento gatilho do Gateway SAP no editor de integração.

      6. 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 SAP Gateway usando uma conexão existente

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

    Saiba como configurar um gatilho do Gateway SAP usando uma nova conexão do Gateway SAP em Configurar o gatilho do Gateway SAP usando uma nova conexão.

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

    1. Clique no elemento Gatilho do SAP Gateway no editor de integração para abrir o painel de configuração do acionador.
    2. Clique em Configurar gatilho.
    3. 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 SAP Gateway que você quer usar.

        A integração de aplicativos só mostra as conexões do SAP Gateway 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 associado à 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.
    4. 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

    1. Clique no elemento gatilho do Gateway SAP no editor de integração para abrir o painel de configuração do acionador.
    2. Clique em Configurar acionador.
    3. Ignore o campo Região.
    4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
    5. 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 ter mais de 49 caracteres.
        • Para conectores que oferecem suporte à assinatura de eventos, os nomes de conexão não podem começar com o prefixo "goog".
      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. Ao selecionar essa opção, as seguintes opções são exibidas:
        • Ativar a assinatura de eventos com entidade e ações: selecione essa opção para usar a conexão nas operações de assinatura de eventos e 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, em seguida, em configurar a inscrição de 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 os parâmetros de string de consulta personalizados incluídos na solicitação HTTP. Os parâmetros precisam ser codificados como uma string de consulta no seguinte 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.
    6. Na seção Destinos, defina o URL do seu ambiente do SAP Gateway ou o URL completo do serviço OData. Por exemplo, o 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.

        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.
    7. 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. Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

      2. Clique em PRÓXIMA.
    8. Revisão: revise os detalhes de conexão e autenticação.
    9. 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 de eventos, insira os seguintes valores na seção Detalhes da assinatura de eventos:

    1. Selecione um dos seguintes tipos de autenticação para o listener de eventos.
    2. 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
...
}
    3. 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 assinaturas de eventos.
    4. Insira a configuração de mensagens inativas. Se você configurar a letra inativa, a conexão vai gravar os eventos não processados no 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 na SAP seguindo as instruções no guia Visão geral da autenticação da edição no local ou em qualquer nuvem do ABAP SDK for Google Cloud.

    Validar o gatilho

    Para validar o gatilho, crie um programa ABAP. Confira a seguir um exemplo de programa ABAP que pode ser usado 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.

    Cotas e limites

    Para informações sobre o assunto, consulte Cotas e limites.

    A seguir