SAP Ariba Procurement

O conector do SAP Ariba Procurement permite executar operações de inserção, atualização e leitura nos dados do SAP Ariba Procurement.

Versões compatíveis

Esse conector é compatível com as APIs REST de compras do SAP Ariba.

Antes de começar

No seu projeto do Google Cloud, faça o seguinte:

  • Verifique se a conectividade de rede está configurada. Para mais informações, consulte Conectividade de rede.
  • Conceda o papel do IAM roles/connectors.admin ao usuário que está configurando o conector.
  • Conceda os papéis do IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que você quer usar para o conector.
  • Ative secretmanager.googleapis.com (API Secret Manager) e connectors.googleapis.com (API Connectors). Para mais informações, consulte Como ativar serviços.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + CRIAR NOVO para abrir a página Criar conexão.
  3. Na seção Local, faça o seguinte:
    1. Região: selecione um local na lista suspensa.

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em Próxima.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione SAP Ariba Procurement na lista de conectores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista de versões disponíveis.
    3. No campo Nome da conexão, insira um nome para a instância de conexão. O nome da conexão pode conter letras minúsculas, números ou hífens. O nome precisa começar com uma letra e terminar com uma letra ou um número, e não pode ter mais de 49 caracteres.
    4. Descrição: insira uma descrição para a instância de conexão.
    5. Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    7. ANID: especifique seu ID da rede SAP Ariba.
    8. Chave de API: insira a chave do aplicativo OAuth para autenticação.
    9. Domínio: insira o domínio do SAP Ariba para a conexão.
    10. API: insira a API do SAP Ariba para recuperar dados.
    11. Data center: insira a localização geográfica em que os dados da sua conta estão hospedados.
    12. Ambiente: insira o ambiente do SAP Ariba a que você quer se conectar.
    13. 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.

    14. + ADICIONAR RÓTULO: clique aqui para adicionar um rótulo à conexão na forma de um par de chave-valor.
    15. Clique em Próxima.
  5. 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 Ariba Procurement:

      • Credenciais do cliente OAuth 2.0

      Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

    2. Clique em Next.
  6. Revisão: revise os detalhes de conexão e autenticação.
  7. Clique em Criar.

Configurar a autenticação

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

  • OAuth 2.0: credenciais do cliente
    • ID do cliente: insira o ID do cliente do aplicativo que você criou.
    • Chave secreta do cliente: insira o secret do Secret Manager que contém a chave secreta do cliente para o app conectado que você criou.
    • Versão do secret: selecione a versão do secret para a chave secreta do cliente.
    • Ativar substituição de autenticação: ative essa opção para substituir a autenticação.

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

OAuth 2.0: tipo de conexão de credenciais do cliente

Nome do campo Detalhes
Local europe-west1
Conector SAP Ariba Procurement
Versão do conector 1
Nome da conexão gcp-sapariba-procurement-po-supplier
Ativar Cloud Logging Sim
Conta de serviço my-service-account@my-project.iam.gserviceaccount.com
Nível do registro Depurar
ANID AN11234322444-T
Chave de API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Realm 745628447-T
API PurchaseOrdersSupplierAPI-V1
Data center EUA
Ambiente TESTAR
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Credenciais do cliente OAuth 2.0
ID do cliente 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Chave secreta do cliente projects/617888503870/secrets/AribaProcurement/versions/10
Versão do secret 10

Limitações do sistema

O conector do SAP Ariba Procurement pode processar no máximo três transações por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Usar a conexão do SAP Ariba Procurement em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e no Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa de conectores na integração da Apigee, consulte Tarefa de conectores.
  • Para entender como criar e usar a tarefa de conectores na Application Integration, consulte tarefa de conectores.

Ações

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

Ação CreateChildElementSchema

Essa ação cria um arquivo de esquema para uma matriz de documentos no modelo de visualização.

Parâmetros de entrada da ação CreateChildElementSchema

Nome do parâmetro Tipo Aceita fluxos de saída Descrição
ViewTemplateName String Falso O nome de um modelo de visualização.
ChildElement String Falso Um elemento filho ou uma matriz de documentos no modelo de visualização em notação de ponto, como LineItems.SplitAccountings.
TableName String Falso O nome da nova tabela, como View_LineItems_SplitAccountings.
FileName String Falso O nome do arquivo para o esquema gerado. Pode ser um caminho relativo ou absoluto para o local de salvamento desejado.
FileStream String Verdadeiro Uma instância de um fluxo de saída em que os dados do arquivo são gravados.

Para ver um exemplo de como configurar a ação CreateChildElementSchema, consulte Exemplos.

Ação CreateSchema

Cria um arquivo de esquema para a tabela ou visualização especificada.

Parâmetros de entrada da ação CreateSchema

Nome do parâmetro Tipo Aceita fluxos de saída Descrição
TableName String Falso O nome da nova tabela.
FileName String Falso O nome do arquivo para o esquema gerado. Pode ser um caminho relativo ou absoluto para o local de salvamento desejado.
FileStream String Falso Uma instância de um fluxo de saída em que os dados do arquivo são gravados.

Para ver um exemplo de como configurar a ação CreateSchema, consulte Exemplos.

Exemplos de ações

Nesta seção, mostramos como realizar alguns dos exemplos de ações neste conector.

Exemplo: criar um esquema de elemento filho

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateChildElementSchema e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}

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

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Exemplo: criar um esquema

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

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

    [
  {
    "FileData": "",
    "Result": "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 pedidos

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Orders na lista Entity.
  3. Selecione a operação List e clique em Concluído.
  4. Na seção Entrada de tarefa da tarefa conectores, é possível definir a filterClause de acordo com a exigência do cliente.

    5. Use aspas simples (') para incluir o valor de uma filterClause. Use o filterClause para filtrar registros com base nas colunas.

Exemplo: listar todos os itens de linha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione LineItems na lista Entity.
  3. Selecione a operação List e clique em Concluído.
  4. Na seção Entrada de tarefa da tarefa conectores, é possível definir a filterClause de acordo com a exigência do cliente.

Exemplo: receber detalhes de um pedido

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Orders na lista Entity.
  3. Selecione a operação Get e clique em Concluído.
  4. Defina o entityId como "DO240", que é a chave a ser transmitida. Para definir o entityId, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e insira "DO240" no campo Input Value. Depois, escolha o entityId como variável local.

    5. Transmita o valor de entityId diretamente, como "DO240". Aqui, "DO240" é o valor exclusivo da chave primária.

    Se a transmissão de um único entityId gerar um erro devido à presença de duas chaves compostas, use filterClause para transmitir o valor, como DocumentNumber='DO240'.

Exemplo: receber os detalhes de um item de linha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione LineItems na lista Entity.
  3. Selecione a operação Get e clique em Concluído.
  4. Defina filterClause como LineNumber='1' AND DocumentNumber='DO240', que são as chaves compostas a serem transmitidas. Para definir a filterClause, na seção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira "LineNumber='1' AND DocumentNumber='DO240'" no campo Valor de entrada e escolha a filterClause como variável local.

Exemplo: criar uma visualização

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Views na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha entityId, connectorInputPayload ou filterClause como variável local. 
    {
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
  "Success": true
}

Exemplo: atualizar uma visualização

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Views na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. 
    {
  "Status": "published"
}
  5. Defina o entityId no Data Mapper como o ID das visualizações. Para definir o entityId, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. Escolha entityId, connectorInputPayload ou filterClause como variável local.

    Em vez de especificar o entityId, você também pode definir a filterClause como TestView = '1754629881645'.

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
}

    Um objeto JSON vazio {} na resposta indica que a operação de atualização foi concluída.

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir