SAP ERP

Configurar para assinatura de eventos

Se você ativar a inscrição em eventos, será necessário configurar o ABAP SDK. Para informações sobre a configuração do SDK ABAP, consulte Visão geral do SDK ABAP para Google Cloud.

Insira os seguintes valores na seção Detalhes da assinatura de evento:

1. Selecione um dos seguintes tipos de autenticação para o listener de eventos.
   • Autenticação do Google. Se você ativar essa opção, siga as etapas em Autenticar usando JSON Web Tokens para configurar a autenticação do SDK do ABAP. Além disso, verifique se a conta de serviço tem o papel roles/connectors.listener, cujo token de acesso é usado para autenticação.
   • Autenticação de chave de API. Se você selecionar essa opção, será necessário ter criado uma chave de API e salvo a chave como um secret do Secret Manager. Para mais informações, consulte Criar uma chave de API.
2. 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
   ...
   }

3. Selecione Ativar conectividade particular para uma conectividade segura entre o aplicativo de back-end e a conexão. Se você selecionar essa opção, precisará executar mais etapas de configuração depois de criar a conexão. Para mais informações, consulte Conectividade particular para assinatura de eventos.
4. Insira a configuração de mensagens inativas. Se você configurar a carta inativa, a conexão gravará os eventos não processados no tópico do Pub/Sub especificado. Digite os seguintes detalhes:
   1. ID do projeto de dead-letter : o ID do projeto do Google Cloud em que você configurou o tópico de dead-letter do Pub/Sub.
   2. Tópico de mensagens mortas : o tópico do Pub/Sub em que você quer gravar os detalhes do evento não processado.

Exemplos de configuração de conexão

As seções a seguir listam os valores de amostra para os vários campos ao criar a conexão do SAP ERP e os parâmetros necessários para os diferentes tipos de conexão.

Como se conectar a um sistema SAP distribuído

Se você se conectar a um sistema SAP distribuído, como um sistema que usa balanceamento de carga, especifique as seguintes propriedades de conexão adicionais. Um administrador pode acessar essas propriedades de conexão na guia "Conexão" da caixa de diálogo "Propriedades de entrada do sistema" no sistema SAP.

• ID do sistema: especifique o valor obtido da propriedade SystemId. O ID do sistema é o ID do sistema/R3Name do sistema SAP. O ID do sistema é uma string com no máximo três caracteres.
• Servidor de mensagens: ao se conectar a um sistema SAP que usa balanceamento de carga, especifique o campo "Servidor de mensagens". Defina essa propriedade com o valor obtido da propriedade "MessageServer" no sistema SAP. Além disso, adicione o valor do campo "Servidor de mensagens" com o valor da caixa SAProuter.
• Grupo: defina essa propriedade com o valor obtido da propriedade Grupo/Servidor. A propriedade "Group" especifica o grupo de logon usado. O valor padrão é PUBLIC.

Conectar-se a um servidor de aplicativos personalizado

Se você se conectar a um sistema SAP com um servidor de aplicativos dedicado ou personalizado, especifique as seguintes propriedades de conexão adicionais. Um administrador pode receber essas propriedades de conexão do sistema SAP.

• ID do sistema: especifique o valor obtido da propriedade SystemId. É o ID do sistema ou R3Name do sistema SAP. O ID do sistema é uma string com no máximo três caracteres.
• Host: especifique o valor que você recebeu do servidor de aplicativos.

  Isso especifica o nome do host do sistema de destino. Esse valor pode ser um nome de host comum, um endereço IP ou um endereço de roteador SAP.

• Número do sistema: especifique o valor obtido da propriedade SystemNumber.

  A propriedade "SystemNumber" define o sistema de destino.

Configurar conexões de rede seguras

Se o administrador tiver configurado a comunicação de rede segura (SNC, na sigla em inglês), defina as seguintes propriedades adicionais. No sistema SAP, é possível acessar as seguintes propriedades de string de conexão SNC na guia "Rede" da caixa de diálogo "Propriedades da entrada do sistema".

• Modo SNC: se a caixa de seleção "Ativar conexões de rede seguras" estiver marcada no SAP, defina a propriedade de conexão do modo SNC como "True". Caso contrário, defina a propriedade de conexão do modo SNC como "False".

  A propriedade de conexão SNCMode é um valor booleano que determina se você está usando o SNC. O valor padrão é "False".

• SNC PartnerName: especifica o nome SNC do servidor de aplicativos. Por exemplo: p:CN=SDI, OU=IT, O=CSW, C=DE
• Nome do SNC: opcional. A propriedade SNCName especifica o nome da conexão SNC. Defina essa propriedade para garantir que o nome correto do SNC seja usado na conexão.
• QoP do SNC: defina essa propriedade como a opção selecionada na seção "Configurações de rede segura". Por exemplo, se a opção "Integridade" estiver selecionada, defina a propriedade SNCQop como 3.

  A propriedade SNCQop especifica o nível (ou qualidade) da proteção de dados. Se essa propriedade não for especificada, o número inteiro -1 será definido para ela. Os valores válidos são 1, 2, 3, 8 ou 9, que correspondem aos níveis de proteção.

• ID do objeto SNC_Lib: defina essa propriedade como o caminho e o nome do arquivo da sua biblioteca SNC. Especifique o caminho completo para a biblioteca de segurança que você está usando, como C:\Secude\secude.xll..

Tipo de conexão ApplicationServer

Para a conectividade do servidor de aplicativos, o Private Service Connect e o balanceador de carga precisam ser configurados com o IP e a porta 33XX do sistema SAP no grupo de endpoints da rede (NEG) e na verificação de integridade. Em que XX é o número do sistema ou da instância do sistema SAP usado. A tabela a seguir lista os valores de configuração de exemplo para o tipo de conexão ApplicationServer. Consulte a interface de criação de conexão no console para saber os campos obrigatórios e opcionais.

Tipo de conexão do servidor de mensagens (servidor de grupo)

• O Private Service Connect e o balanceador de carga precisam ser configurados com o IP do sistema SAP nas portas 33XX e 36XX no grupo de endpoints da rede (NEG) e na verificação de integridade. Em que XX é o número do sistema ou da instância do sistema SAP usado.
• Crie uma zona DNS no Cloud DNS e mapeie o anexo de endpoint do servidor de aplicativos, que é configurado na porta 33XX com o nome do host do sistema SAP.
• Só é possível se conectar a um sistema SAP com um servidor de mensagens (servidor de grupo) se ele retornar o endereço de nome de domínio totalmente qualificado (FDQN) do servidor de aplicativos. Não é possível se conectar a um sistema SAP com um servidor de mensagens (servidor de grupo) se o servidor de mensagens retornar o endereço IP.
• O servidor de mensagens precisa responder com o DNS dos servidores de aplicativos a que o aplicativo precisa se conectar quando ele faz a solicitação.
• O DNS dos servidores de aplicativos precisa ser exclusivo e não pode ser usado por outro sistema SAP.
• No aplicativo SAP, os IPs de anexo de endpoint para os servidores de aplicativos e de mensagens precisam ser mantidos nos parâmetros gw/alternative_hostnames.
  1. Acesse o Tcode - RZ10 e faça uma entrada para o parâmetro "gw/alternative_hostname" no perfil da instância.
  2. Defina o parâmetro ms/lg\_with\_hostname como 1 para configurar versões do servidor de mensagens SAP anteriores à 7.53 para retornar nomes de host. As versões 7.53 e mais recentes retornam nomes de host por padrão.
  3. Reinicie o aplicativo SAP para que os parâmetros entrem em vigor.

A tabela a seguir lista os valores de configuração de exemplo para o tipo de conexão Group Server:

Tipo de conexão de certificado X.509

Para comunicações de rede seguras (SNC) com conectividade X509, o Private Service Connect e o balanceador de carga precisam ser configurados com o IP do sistema SAP e a porta 48XX no grupo de endpoints da rede (NEG) e na verificação de integridade. Em que XX é o número do sistema ou da instância do sistema SAP usado. A tabela a seguir lista os valores de configuração de exemplo para o tipo de conexão X509 certificate. Consulte a interface de criação de conexão no console para saber os campos obrigatórios e opcionais.

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Ações

Esta seção fornece informações sobre as RFCs e lista as ações compatíveis com o conector. Para entender como configurar as ações, consulte Exemplos de ações.

Como usar RFCs

Esta seção fornece informações sobre as RFCs necessárias e como usá-las.

RFCs obrigatórias

Se algum dos RFCs necessários não estiver disponível, algumas ou todas as funcionalidades poderão não funcionar. O T-Code SE37 pode ser usado para conferir os módulos de função disponíveis no SAP.

As seguintes RFCs são usadas pelo conector do SAP ERP.

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

Ler dados grandes

Esta seção descreve a abordagem que você precisa seguir para ler grandes quantidades de dados do back-end do SAP.

O conector do SAP ERP usa a função SAP RFC_READ_TABLE para extrair dados de tabelas do SAP, e essa função tem um tamanho fixo de 512 bytes. Ele pode armazenar em buffer cada linha de dados. Por isso, não é possível selecionar mais colunas do que a quantidade que caberia nesse buffer. Se você selecionar mais de 512 bytes, a exceção DATA_BUFFER_EXCEEDED vai ocorrer ao executar a integração, indicando que você excedeu o tamanho máximo de buffer permitido por linha e precisa selecionar menos colunas.

Para resolver esse problema, inclua o código de um Custom RFC_READ_TABLE, que é semelhante ao SAP RFC_READ_TABLE, mas com um buffer maior para resolver o problema de DATA_BUFFER_EXCEEDED.

Como usar uma função personalizada de leitura de tabela

O conector é compatível com um Custom RFC_READ_TABLE semelhante ao SAP RFC_READ_TABLE, mas tem um buffer maior para que possa resolver o problema DATA_BUFFER_EXCEEDED.

Crie uma RFC_READ_TABLE personalizada no back-end do SAP

Siga as etapas abaixo para usar a amostra personalizada RFC_READ_TABLE.

1. Use a função RFC_READ_TABLE como um modelo para a nova função: selecione o código de transação SE37 e o grupo de funções SDTX e copie RFC_READ_TABLE para um novo grupo de funções ou para o grupo de funções em que você está trabalhando. Neste exemplo, RFC_READ_TABLE é copiado para Z_CUSTOM_RFC_TABLE.
2. Na guia Atributos da página do SAP, selecione Módulo ativado remotamente.
3. Na guia Tabelas, defina o parâmetro DATA como CHAR8000. Talvez seja necessário clicar com o botão direito do mouse e depois em Mostrar -> Mudar.
4. Na guia Código-fonte, insira o código RFC personalizado de leitura de tabela. Para referência, consulte sample Z_CUSTOM_RFC_TABLE_function.txt.
5. Clique em Salvar.
6. Defina as importações, tabelas e exceções conforme documentado na tabela de leitura personalizada fornecida.
7. Ative o módulo de função.

Tabela de leitura personalizada para ABAP 7.52

Se você estiver usando o ABAP 7.52 ou versões mais recentes, consulte o exemplo Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. A função de exemplo foi criada para a versão 7.52 e mais recentes do ABAP. Ela é semelhante à função Z_CUSTOM_RFC_TABLE, mas aproveita as palavras-chave recém-disponíveis no ABAP 7.52 para realizar a paginação no banco de dados em vez de no próprio script ABAP. Isso torna a paginação muito mais eficiente e melhora o desempenho ao trabalhar com tabelas grandes. Recomendamos usar o Z_CUSTOM_RFC_TABLE_752 RFC quando possível.

Acesso à função RFC_READ_TABLE

Esta seção fornece informações sobre a função a ser atribuída a um usuário do SAP para acessar a função RFC_READ_TABLE. Essa função é um módulo de função ativado remotamente que permite acesso genérico de leitura a tabelas arbitrárias.

Para que as tabelas sejam listadas em "Entidades" ao configurar a tarefa "Conectores do SAP ERP", use a função RFC_READ_TABLE no nível de conexão do SAP ERP e tenha autorização para acessar a função R/3 RFC_READ_TABLE.

Adicione a autorização S_TABU_DIS para a atividade 03 (exibição) e o grupo de autorizações "SC" para a função RFC_READ_TABLE.

Confira algumas das limitações técnicas de RFC_READ_TABLE:

• Só é possível ler tabelas com tipos de dados simples. Não há suporte para campos STRING ou XSTRING.
• A largura máxima da linha é de 512 caracteres.
• O número de registros retornados é limitado por limites de memória.

Ação BAPI_MATERIAL_SAVEDATA

Essa ação permite realizar tarefas específicas. Por exemplo, é possível usar o recurso para criar ou mudar dados mestre de materiais no SAP ERP.

Parâmetros de entrada da ação BAPI_MATERIAL_SAVEDATA

Parâmetros de saída da ação BAPI_MATERIAL_SAVEDATA

Essa ação retorna o status 200 (OK) se for bem-sucedida.

Para ver exemplos de como configurar a ação BAPI_MATERIAL_SAVEDATA, consulte Exemplos de ações.

Ação ZFM_GCP_MULTIDATA_TAB

Essa ação permite que os usuários realizem tarefas específicas. Por exemplo, é possível criar dados de vários tipos no SAP ERP.

Parâmetros de entrada da ação ZFM_GCP_MULTIDATA_TAB

Parâmetros de saída da ação ZFM_GCP_MULTIDATA_TAB

Essa ação retorna o status 200 (OK) se for bem-sucedida.

Para ver um exemplo de como configurar a ação ZFM_GCP_MULTIDATA_TAB, consulte Exemplos de ações.

Ação PushIDoc

Essa ação permite realizar tarefas específicas. Por exemplo, é possível transferir dados do SAP para um sistema externo.

Parâmetros de entrada da ação PushIDoc

Parâmetros de saída da ação PushIDoc

Essa ação retorna o status 200 (OK) se for bem-sucedida.

Para ver um exemplo de como configurar a ação PushIDoc, consulte Exemplos de ações.

Ação ExecuteCustomQuery

Essa ação permite executar uma consulta personalizada.

Para criar uma consulta salva, siga estas etapas:

1. Siga as instruções detalhadas para adicionar uma tarefa de conectores.
2. Quando você configurar a tarefa do conector, selecione Ações no tipo de ação que você quer realizar.
3. Na lista Ação, selecione Executar consulta personalizada e clique em Concluído.

   

4. Expanda a seção Entrada de tarefas e faça o seguinte:
   1. No campo Tempo limite após, digite o número de segundos de espera até que a consulta seja executada.

      Valor padrão: 180 segundos

   2. No campo Número máximo de linhas, digite o número máximo de linhas a serem retornadas do banco de dados.

      Valor padrão: 25.

   3. Para atualizar a consulta personalizada, clique em Editar script personalizado. A caixa de diálogo Editor de script é aberta.

      

   4. Na caixa de diálogo Editor de script, insira a consulta SQL e clique em Salvar.

      É possível usar um ponto de interrogação (?) em uma instrução SQL para representar um único parâmetro que precisa ser especificado na lista de parâmetros de consulta. Por exemplo, a seguinte consulta SQL seleciona todas as linhas da tabela Employees que correspondem aos valores especificados na coluna LastName:

      SELECT * FROM Employees where LastName=?

   5. Se você usou pontos de interrogação na consulta SQL, adicione o parâmetro clicando em + Adicionar nome do parâmetro para cada ponto de interrogação. Ao executar a integração, esses parâmetros substituem os pontos de interrogação (?) na consulta SQL sequencialmente. Por exemplo, se você tiver adicionado três pontos de interrogação (?), deverá adicionar três parâmetros em ordem de sequência.

      

      Para adicionar parâmetros de consulta, faça o seguinte:

      1. Na lista Tipo, selecione o tipo de dados do parâmetro.
      2. No campo Valor, insira o valor do parâmetro.
      3. Para adicionar vários parâmetros, clique em + Adicionar parâmetro de consulta.

Se a execução for bem-sucedida, essa ação vai retornar o status 200 (OK) com um corpo de resposta que tem os resultados da consulta.

Exemplos de ações

Exemplo: criar um registro

Este exemplo cria um registro de material usando a ação BAPI_MATERIAL_SAVEDATA.

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação BAPI_MATERIAL_SAVEDATA e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa BAPI_MATERIAL_SAVEDATA terá um valor semelhante a este:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemplo: atualizar um registro

Este exemplo atualiza um registro de material usando a ação BAPI_MATERIAL_SAVEDATA.

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação BAPI_MATERIAL_SAVEDATA e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa BAPI_MATERIAL_SAVEDATA terá um valor semelhante a este:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemplo: excluir um registro

Este exemplo exclui um registro de material usando a ação BAPI_MATERIAL_SAVEDATA.

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação BAPI_MATERIAL_SAVEDATA e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa BAPI_MATERIAL_SAVEDATA terá um valor semelhante a este:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemplo: criar dados de vários tipos

Este exemplo cria dados de vários tipos usando a ação ZFM_GCP_MULTIDATA_TAB.

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação ZFM_GCP_MULTIDATA_TAB e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa ZFM_GCP_MULTIDATA_TAB terá um valor semelhante a este:

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Exemplo: enviar um IDoc

Este exemplo envia um IDoc para o SAP ERP.

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação PushIDoc e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa PushIDoc terá um valor semelhante a este:

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

Exemplos de operações de entidade

Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.

Exemplo: listar todos os registros

Este exemplo lista todos os registros na entidade T001.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione T001 na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Se quiser, na seção Entrada de tarefa da tarefa Conectores, é possível filtrar o conjunto de resultados especificando uma cláusula de filtro. Sempre especifique o valor da cláusula de filtro entre aspas simples (').

Exemplo: receber um registro de uma entidade

Este exemplo recebe um registro com o ID especificado da entidade T001.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione T001 na lista Entity.
3. Selecione a operação Get e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Conectores, clique em EntityId e insira 0001 no campo Valor padrão.

   Aqui, 0001 é um ID de registro exclusivo na entidade T001.