Consulte os conetores suportados para a solução Application Integration.

Acionador da gateway SAP

O acionador do SAP Gateway é um acionador de eventos do conetor. O conetor do SAP Gateway permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do SAP Gateway.

Antes de começar

  • Se planeia criar ou configurar uma nova associação para o acionador do SAP Gateway, certifique-se de que tem a seguinte função do IAM no projeto:
    • Administrador do conetor (roles/connectors.admin)

      • Para informações sobre a concessão de funções, consulte o artigo Faça a gestão do acesso.

  • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o acionador do SAP Gateway:

    • Adicione o acionador do gateway SAP

    Para adicionar um acionador do SAP Gateway à sua integração, siga estes passos:

    1. Na Google Cloud consola, aceda à página Application Integration.

      Aceda à solução Application Integration

    2. No menu de navegação, clique em Integrações

      A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

    3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

      Se estiver a criar uma nova integração:

      1. Introduza 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. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      4. Clique em Criar.

      A integração recém-criada é aberta no editor de integração.

    4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
    5. Clique e coloque o elemento Acionador do gateway SAP no editor de integração.

      6. Para configurar o acionador do SAP Gateway, pode usar uma ligação do SAP Gateway existente disponível nos Integration Connectors ou criar uma nova ligação do SAP Gateway através da opção de criação de ligações incorporada.

    Configure o acionador do SAP Gateway através de uma associação existente

    O acionador do SAP Gateway é um acionador de eventos do conetor. Por isso, só pode usar uma ligação do SAP Gateway com a subscrição de eventos ativada para configurar o acionador.

    Para obter informações sobre como configurar um acionador do SAP Gateway através de uma nova ligação do SAP Gateway, consulte o artigo Configure o acionador do SAP Gateway através de uma nova ligação

    Para configurar um acionador do SAP Gateway através de uma ligação existente do SAP Gateway, siga estes passos:

    1. Clique no elemento Acionador do SAP Gateway no editor de integração para abrir o painel de configuração do acionador.
    2. Clique em Configurar acionador.
    3. Forneça os seguintes detalhes de configuração na página Editor do acionador de eventos do conetor:
      1. Região: selecione a região da sua ligação SAP Gateway.
      2. Ligação: selecione a ligação do gateway SAP que quer usar.

        A integração de aplicações só apresenta as ligações do SAP Gateway que estão ativas e têm uma subscrição de eventos ativada.

      3. Introduza o nome do campo do tipo de evento. Este campo identifica o tipo de evento associado ao pedido de evento recebido. 
        {
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
      4. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para o acionador do SAP Gateway.
    4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

    Configure o acionador do SAP Gateway com uma nova ligação

    1. Clique no elemento Acionador do SAP Gateway 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 Associação e selecione a opção Criar associação no menu pendente.
    5. Na secção Detalhes da associação, conclua o seguinte:
      1. Conetor: selecione SAP Gateway na lista pendente de conetores disponíveis.
      2. Versão do conector: selecione a versão do conector na lista pendente de versões disponíveis.
      3. No campo Nome da ligação, introduza um nome para a instância de ligação.

        Os nomes das associações têm de cumprir os seguintes critérios:

        • Os nomes das associações podem usar letras, números ou hífenes.
        • As letras têm de ser minúsculas.
        • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
        • Os nomes das associações não podem exceder 49 carateres.
        • Para os conetores que suportam a subscrição de eventos, os nomes das associações não podem começar com o prefixo "goog".
      4. Opcionalmente, introduza uma Descrição para a instância de associação.
      5. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
      6. Para usar a associação para subscrições de eventos, selecione Ativar subscrição de eventos. Se selecionar esta opção, são apresentadas as seguintes opções:
        • Ativar subscrição de eventos com entidade e ações: selecione esta opção para usar a associação para a subscrição de eventos e as operações do conetor (entidades e ações).
        • Ativar apenas subscrição de eventos: selecione esta opção para usar a associação apenas para a subscrição de eventos. Se selecionar esta opção, clique em Seguinte e, de seguida, configure a subscrição de eventos.
      7. Namespace: especifique o espaço de nomes do serviço do qual quer obter dados. Isto é obrigatório se o serviço não estiver especificado no URL.
      8. Serviço: especifique o serviço do qual quer obter dados. Isto é obrigatório se o serviço não estiver especificado no URL.
      9. CustomUrlParams: especifique parâmetros de string de consulta personalizados que são incluídos no pedido HTTP. Os parâmetros têm de ser codificados como uma string de consulta no seguinte formato: field1=value1&field2=value2. Os valores na string de consulta têm de ser codificados por URL.
      10. Formato de dados: o formato de dados no qual pretende obter os dados. Selecione XML ou JSON.
      11. Usar nomes a apresentar: booleano que determina se devem ou não ser usadas etiquetas SAP.
      12. Opcionalmente, configure as definições do nó de associação:

        • Número mínimo de nós: introduza o número mínimo de nós de ligação.
        • Número máximo de nós: introduza o número máximo de nós de ligação.

        Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

      13. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
      14. Clique em SEGUINTE.
    6. Na secção Destinos, defina o URL do seu ambiente 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 quaisquer propriedades adicionais através da propriedade CustomUrlParams.
      1. Tipo de destino: selecione um Tipo de destino.
        • Para especificar o nome de anfitrião ou o endereço IP de destino, selecione Endereço do anfitrião e introduza o endereço no campo Anfitrião 1.
        • Para estabelecer uma ligação privada, selecione Anexo do ponto final e escolha o anexo necessário na lista Anexo do ponto final.

        Se quiser estabelecer uma ligação pública aos seus sistemas de back-end com segurança adicional, pode considerar configurar endereços IP estáticos de saída para as suas ligações e, em seguida, configurar as regras da firewall para permitir apenas os endereços IP estáticos específicos.

        Para introduzir destinos adicionais, clique em +ADICIONAR DESTINO.

      2. Clique em SEGUINTE.
    7. Na secção Autenticação, introduza os detalhes de autenticação.
      1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

        Os seguintes tipos de autenticação são suportados pela ligação do SAP Gateway:

        • Nome de utilizador e palavra-passe
        • Anónimo
        • Fluxo de código de autorização do OAuth 2.0
        • SAP BTP (OAuth 2.0 – credenciais de cliente)

        2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

      2. Clique em SEGUINTE.
    8. Rever: reveja os detalhes da ligação e da autenticação.
    9. Clique em Criar.

    Configure a autenticação

    Introduza os detalhes com base na autenticação que quer usar.

    • Nome de utilizador e palavra-passe
      • Nome de utilizador: nome de utilizador do conetor
      • Palavra-passe: Secret do Secret Manager que contém a palavra-passe associada ao conector.
    • Anónimo

      Se quiser usar o início de sessão anónimo, selecione Não disponível.

      • Chave da API: a chave da API do utilizador autenticado atualmente.
    • Fluxo de código de autorização do OAuth 2.0
      • ID de cliente: introduza o ID de cliente obtido na página do cliente da API.
      • Âmbitos: introduza uma lista de âmbitos desejados separada por vírgulas.
      • Segredo do cliente: introduza o segredo do cliente obtido na página do cliente da API.
      • Versão do Secret: introduza a versão do Secret para o segredo do cliente selecionado.
      • URL de autorização: introduza o URL de autorização gerado quando cria um cliente OAuth na sua instância do SAP Gateway.
      • Ativar substituição da autenticação: selecione esta opção para ativar a ligação de modo a aceitar uma autenticação diferente de forma dinâmica durante a execução.
    • SAP BTP (OAuth 2.0 – credenciais do cliente)
      • ID de cliente: introduza o ID de cliente obtido na página do cliente da API.
      • Segredo do cliente: introduza o segredo do cliente obtido na página do cliente da API.
      • Versão do Secret: introduza a versão do Secret para o Secret selecionado acima.
      • OAuthAccessTokenURL: introduza o URL da chave de acesso OAuth.
      • Nome do destino: introduza o nome do destino do SAP BTP.
      • URL de destino: introduza o URL de destino do SAP BTP.
      • Ativar substituição da autenticação: selecione esta opção para permitir que a ligação aceite uma autenticação diferente de forma dinâmica durante a execução.

    Configure a subscrição de eventos

    Se ativou a subscrição de eventos, introduza os seguintes valores na secção Detalhes da subscrição de eventos:

    1. Selecione um dos seguintes tipos de autenticação para o ouvinte de eventos.
    2. Introduza o nome do campo do tipo de evento. Este campo identifica o tipo de evento associado ao pedido de evento recebido. 
      {
"event_type": "user.created",
...
// other request fields
...
}
    3. Selecione Ativar conetividade privada para uma conetividade segura entre a sua aplicação de back-end e a sua ligação. Se selecionar esta opção, tem de realizar passos de configuração adicionais depois de criar a associação. Para mais informações, consulte o artigo Conetividade privada para subscrição de eventos.
    4. Introduza a configuração de mensagens não entregues. Se configurar a fila de mensagens rejeitadas, a ligação escreve os eventos não processados no tópico Pub/Sub especificado. Introduza os seguintes detalhes:
      1. ID do projeto de mensagens não entregues: o ID do projeto do Google Cloud onde configurou o tópico Pub/Sub de mensagens não entregues.
      2. Tópico de mensagens não entregues: o tópico do Pub/Sub onde quer escrever os detalhes do evento não processado.

    Configure a autenticação no SAP

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

    Valide o acionador

    Para validar o acionador, pode criar um programa ABAP. Segue-se um exemplo de um programa ABAP que 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.

    Quotas e limites

    Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

    O que se segue?