Esta página foi traduzida pela API Cloud Translation.

SAP Gateway

O conetor do SAP Gateway permite-lhe realizar operações de inserção, eliminação, atualização e leitura na base de dados do SAP Gateway.

Versões suportadas

Este conector usa a API SAP Gateway para permitir o acesso bidirecional aos serviços SAP que usam o gateway. As seguintes edições do SAP são suportadas:

S/4 HANA Cloud
S/4 HANA
SAP ERP
Outras edições SAP que suportem a API SAP Gateway

Antes de começar

Antes de usar o conetor do SAP Gateway, faça as seguintes tarefas:

No seu projeto do Google Cloud:
- Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
- Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
- Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.
- Ative os seguintes serviços:
  - secretmanager.googleapis.com (Secret Manager API)
  - connectors.googleapis.com (API Connectors)
  Para saber como ativar serviços, consulte o artigo Ativar serviços.
Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o serviço SAP OData no S/4HANA no local

Para configurar o serviço SAP OData no S/4HANA no local, faça as seguintes tarefas:

Ative os serviços ICM
Ative o SAP Gateway
Ative os serviços OData
Teste o serviço OData ativado no servidor SAP

Ative os serviços ICM

O serviço SAP OData funciona através de protocolos HTTP ou HTTPS. Por conseguinte, certifique-se de que os serviços relevantes estão ativados no Internet Communication Manager (ICM). Use HTTPS para proteger os dados durante a transmissão.

Aceda à transação SMICM.
Aceda a Serviços.
Clique em Serviço > Criar.
Defina um novo serviço.

Quando define portas de serviço, alguns parâmetros são pré-preenchidos com base no sistema SAP.

Defina os parâmetros restantes para os protocolos HTTP e HTTPS.

Ative o SAP Gateway

Para ativar o SAP Gateway, siga estes passos:

Aceda à transação SPRO e selecione SAP Reference IMG.
Expanda o nó SAP NetWeaver > SAP Gateway > OData Channel > Configuration > User Settings > Connection Settings > Activate or Deactivate SAP Gateway e, de seguida, clique com o botão direito do rato e selecione Edit Activity.
Clique em Ativar. Se for apresentada a mensagem O gateway SAP está atualmente ativo na caixa de diálogo, clique em Cancelar.

Ative os serviços OData

Para ativar os serviços OData, siga estes passos.

Aceda à transação SICF.
Clique em Executar (ou prima F8).
Ignorar Filtro no ecrã de seleção.
Navegue para o nó da árvore default_host > sap > opu > OData para ativar todos os serviços OData (V2).
Navegue para o nó correspondente mais abaixo na árvore para ativar um serviço individual.
Clique com o botão direito do rato no nó do serviço OData e selecione Ativar.

Teste o serviço OData ativado no servidor SAP

Use a ferramenta SAP Gateway Client para executar pedidos OData.

Chame a seguinte transação para iniciar a ferramenta: /n/IWFND/GW_CLIENT

Especifique o URI do pedido OData.
Selecione o método HTTP, o protocolo (HTTP ou HTTPS), os cabeçalhos do pedido e o corpo do pedido.
Clique em Executar para enviar o pedido depois de introduzir todos os dados necessários.

Os cabeçalhos de resposta e os dados de resposta são apresentados após a execução.

Configure o serviço SAP OData no S/4HANA Cloud

Para configurar o serviço SAP OData no S/4HANA Cloud, conclua as seguintes tarefas:

Crie um utilizador de comunicação
Crie um sistema de comunicação
Crie um acordo de comunicação

Crie um utilizador de comunicação

O utilizador de comunicação é um tipo especial de utilizador técnico usado para chamadas de serviço OData externas. É usado apenas para a comunicação SAP com o sistema externo. Não é possível iniciar sessão com o SAP GUI através do utilizador de comunicação. A app Manter utilizadores de comunicação permite-lhe definir estas definições na nuvem.

Aceda à app Manter utilizadores de comunicação.
Clique em Novo para criar um novo utilizador.
Introduza o nome de utilizador e a descrição do utilizador.
Introduza a palavra-passe. Use propose password para gerar a palavra-passe.
Clique em Criar.

Crie um sistema de comunicação

Um sistema de comunicação é uma especificação de um sistema que representa um parceiro de comunicação e todas as informações técnicas necessárias para a comunicação, como o nome do anfitrião/endereço IP, a identidade, as informações do utilizador e os certificados. Nos sistemas do S/4HANA Cloud, estas entidades são necessárias para a comunicação externa. A app Communication Systems permite-lhe definir estas definições na nuvem.

Aceda à app Sistemas de comunicação.
Clique em Novo para criar um novo sistema de comunicação.
Introduza o ID do sistema e o nome do sistema.
Clique em + para adicionar o utilizador de comunicação criado para a comunicação de entrada. Introduza os detalhes do utilizador de comunicação.

A comunicação de entrada significa que o sistema definido é usado por um parceiro de comunicação para fazer chamadas do exterior para o sistema SAP S/4HANA.

Clique em Guardar.

Crie um acordo de comunicação

Para informações sobre o acordo de comunicação, consulte o artigo Acordo de comunicação.

Aceda à app Acordos de comunicação.
Clique em Nova para criar um novo acordo de comunicação.
Selecione o cenário de comunicação, introduza o nome da disposição e clique em Criar.

Adicione o seu sistema de comunicação e selecione o utilizador de comunicação a usar neste acordo de comunicação.
Pode encontrar o URL para chamar o serviço OData na disposição de comunicação neste formato:https://-api.s4hana.ondemand.com/sap/opu/odata/sap/
Clique em Guardar.

Configure a associação

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.
Aceda à página Ligações
Clique em + CRIAR NOVO para abrir a página Criar associação.
Na secção Localização, escolha a localização para a ligação.
1. Região: selecione uma localização na lista pendente.
  Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.
2. Clique em SEGUINTE.
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.
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.
    Nota: para saber como criar uma associação de ponto final, consulte Associação de serviço do PSC e Associação de ponto final. Depois de criar a associação do ponto final, esta fica visível na lista Associação 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.
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. Clique em SEGUINTE.
Rever: reveja os detalhes da ligação e da autenticação.
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:

Selecione um dos seguintes tipos de autenticação para o ouvinte de eventos.
Nota: antes de configurar a autenticação, certifique-se de que tem o ponto final do ouvinte de eventos, que fica disponível depois de criar a associação. Para ver o ponto final, aceda à página Todas as associações e, de seguida, clique na associação que quer ver. O ponto final é apresentado na secção Detalhes da ligação.
- Autenticação Google. Se ativar esta opção, siga os passos em Autentique através de tokens Web JSON para configurar a autenticação para o SDK ABAP. Além disso, certifique-se de que a conta de serviço tem a função roles/connectors.listener, cuja chave de acesso é usada para autenticação.
- Autenticação de chave da API. Se selecionar esta opção, tem de ter criado uma chave da API e, em seguida, guardado a chave como um Secret do Secret Manager. Para mais informações, consulte o artigo Crie uma chave da API.
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
...
}
```
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.
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.

Exemplos de configuração de ligação

Esta secção fornece os valores de exemplo para os vários campos que configura quando cria um conetor do SAP Gateway.

Autenticação básica: tipo de ligação

Nome do campo	Detalhes
Região	us-central1
Conetor	SAP Gateway Connector
Versão do conetor	1
Nome do conector	sapgateway-basicauth-conn
Conta de serviço	SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
Formato de dados	JSON
Nível de verbosidade	5
Endereço do anfitrião	http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
Autenticação:	Palavra-passe do utilizador
Nome de utilizador	nome de utilizador
Palavra-passe	palavra-passe
versões	1

Chave da API – tipo de ligação

Nome do campo	Detalhes
Região	us-central1
Conetor	SAP Gateway Connector
Versão do conetor	1
Nome do conector	sapgateway-api-token-conn
Conta de serviço	SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
Formato de dados	JSON
Nível de verbosidade	5
Endereço do anfitrião	http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
Chave de API	API_KEY-example-pet-store.com
versões	1

Proxy – Tipo de ligação

Nome do campo	Detalhes
Região	us-central1
Conetor	SAP Gateway Connector
Versão do conetor	1
Nome do conector	sapgateway-basicauth-conn
Conta de serviço	SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
Formato de dados	JSON
Nível de verbosidade	5
Endereço do anfitrião	http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
Formato de dados:	JSON
Nível de verbosidade:	5
Proxy	True
Tipo de SSL de proxy	Automático
Servidor proxy	34.148.1.XX:XXXX
Endereço do anfitrião:	http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
Autenticação:	Palavra-passe do utilizador
Nome de utilizador	nome de utilizador
Palavra-passe:	palavra-passe
Versões	1

Fluxo de código de autorização do OAuth 2.0 – tipo de ligação

Nome do campo	Detalhes
Região	us-central1
Conetor	SAP Gateway Connector
Versão do conetor	1
Espaço de nomes	sap
Serviço	API_SALES_ORDER_SRV
Formato de dados	JSON
Endereço do anfitrião	https://Host:Port
Autenticação	OAuth 2.0
ID do cliente	sb-cloneae083fa9a39742e88774df43216a5dbc!b366296\|destination-xsappname!b62
Segredo do cliente	projects/617888503870/secrets/gateway-oauth/versions/1
Âmbitos	ZAPI_SALES_ORDER_SRV_0001
URL de autorização	https://HostIp:Port/sap/bc/sec/oauth2/authorize
Versões	1

SAP BTP (OAuth 2.0 – credenciais de cliente) – tipo de ligação

Nome do campo	Detalhes
Região	us-central1
Conetor	SAP Gateway Connector
Versão do conetor	1
Nome do conector	sap-gateway-oauth-client-connection
Conta de serviço	SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
Formato de dados	JSON
Endereço do anfitrião:	https://my-api.s4hana.cloud.sap/sap/opu/odata/sap/API_PURCHASEORDER_PROCESS_SRV
Autenticação:	SAP BTP
ID do cliente	CLIENT_ID
Segredo do cliente	CLIENT_SECRET
OAuthAccessTokenURL	https://atrial.authentication.us10.hana.ondemand.com/oauth/token
Nome do destino	DESTINATION_NAME
URL de destino	https://destination-configuration.cfapps.us10.hana.ondemand.com/destination-configuration/v1/destinations/Google
Versões	1

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.
No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.
Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:
- Lista
- Obter
- Criar
- Atualizar
- Eliminar
Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.
Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Limitações do sistema

O conector do SAP Gateway pode processar um máximo de 9 transações por segundo, por nó.
Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.
Nota: o número de nós de conectores de integração é dimensionado automaticamente de forma dinâmica com base na sua utilização. No entanto, se quiser reservar capacidade para grandes volumes sem esperar pela escalabilidade automática, pode ajustar o valor mínimo de nós para uma ligação. São necessários mais nós para processar mais transações para uma associação. Por outro lado, são necessários menos nós se uma associação processar menos transações. Para configurar os valores dos nós, faça o seguinte:
- Se for cliente de pagamento conforme o uso, configure o valor mínimo e máximo do nó na página de edição da associação.
- Se for cliente com base numa subscrição, contacte o apoio técnico.
O número máximo de transações que um nó pode processar depende de vários fatores. Assim, antes de ajustar os nós mínimos para um melhor débito, é recomendável verificar se os seus sistemas de back-end estão configurados de forma ideal para processar o tráfego necessário.
As seguintes funcionalidades não são suportadas:
- Etags
- Inserção profunda
- Operações baseadas em ficheiros

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: listar todos os registos

Este exemplo apresenta todos os registos na entidade SalesOrderSet.

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrderSet na lista Entity.
Selecione a operação List e, de seguida, clique em Concluído.
Opcionalmente, na secção Entrada de tarefas da tarefa Conectores, pode filtrar o conjunto de resultados especificando uma cláusula de filtro. Por exemplo, City='Bangalore'. Também pode especificar várias condições de filtro através dos operadores lógicos. Por exemplo, City='Bangalore' and region='asia-south2'.

Exemplo: obter um registo

Este exemplo obtém um registo com o ID especificado da entidade SalesOrderSet.

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrderSet na lista Entity.
Selecione a operação Get e, de seguida, clique em Concluído.
Na secção Entrada de tarefas da tarefa Conetores, clique em EntityId e, de seguida, introduza 13 no campo Valor predefinido.
Aqui, 13 é um valor de chave principal na entidade SalesOrderSet.

Exemplo: crie um registo

Este exemplo cria um registo na entidade SalesOrderSet.

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrderSet na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"Vbeln":"999",
"Erdat":"2020-08-25 00:00:00",
"Erzet":"13:12:31",
"Ernam":"Test"
}
```
Se a integração for bem-sucedida, o campo connectorOutputPayload da tarefa do conector tem um valor semelhante ao seguinte:
```
{
"Vbeln": "999"
}
```

Exemplo: crie um registo

Este exemplo cria um registo na entidade SalesPriceSet.

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesPriceSet na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"Vbeln": "129",
"Posnr": "000000",
"Knumh": "SUN25MAY",
"Kpein": 1.0
}
```
Se a integração for bem-sucedida, o campo connectorOutputPayload da tarefa do conector tem um valor semelhante ao seguinte:
```
{
"Posnr": "000000",
"Vbeln": "129"
}
```

Exemplo: atualize um registo

Este exemplo atualiza um registo na entidade SalesOrderSet.

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione SalesOrderSet na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"Ernam": "Test123"
}
```
Clique em entityId e, de seguida, introduza 99 no campo Valor predefinido.
Se a integração for bem-sucedida, o campo connectorOutputPayload da tarefa do conector tem um valor semelhante ao seguinte:
```
{
"Vbeln": "999"
}
```

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
espaço de nome	STRING	Falso	Especifique o espaço de nomes do serviço a partir do qual quer obter dados. Isto é obrigatório se o serviço não estiver especificado no URL.
serviço	STRING	Falso	Especifique o serviço a partir do qual quer obter dados. Isto é obrigatório se o serviço não estiver especificado no URL.
custom_url_params	STRING	Falso	Os CustomUrlParams permitem especificar 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 formato field1=value1&field2=value2. Os valores na string de consulta têm de ser codificados por URL.
data_format	ENUM	Falso	O formato de dados para obter dados. Selecione XML ou JSON. Os valores suportados são: XML, JSON
use_display_names	BOOLEAN	Falso	Booleano que determina se devem ou não ser usadas etiquetas SAP.
verbosidade	STRING	Falso	Nível de verbosidade para a ligação, varia de 1 a 5. Um nível de detalhe mais elevado regista todos os detalhes de comunicação (pedido,resposta e certificados SSL).
proxy_enabled	BOOLEAN	Falso	Selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
proxy_auth_scheme	ENUM	Falso	O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user	STRING	Falso	Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password	SECRET	Falso	Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype	ENUM	Falso	O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL

Use a ligação do SAP Gateway numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?

Compreenda como suspender e retomar uma associação.
Compreenda como monitorizar a utilização do conector.
Compreenda como ver os registos do conetor.