SAP Ariba Procurement

O conetor do SAP Ariba Procurement permite-lhe realizar operações de inserção, atualização e leitura nos dados do SAP Ariba Procurement.

Versões suportadas

Este conetor suporta APIs REST de aprovisionamento do SAP Ariba.

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

  • Certifique-se de que a conetividade de rede está configurada. Para mais informações, consulte o artigo Conetividade de rede.
  • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
  • Conceda funções de IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que quer usar para o conector
  • Ative a secretmanager.googleapis.com (API Secret Manager) e a connectors.googleapis.com (API Connectors). Para mais informações, consulte o artigo Ativar serviços.

Configure o conetor

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:

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

  2. Clique em + CRIAR NOVO para abrir a página Criar associação.
  3. Na secção Localização, conclua o seguinte:
    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. Clicar em Seguinte.
  4. Na secção Detalhes da associação, conclua 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 associação, introduza um nome para a instância da associação. O nome da associação pode conter letras minúsculas, números ou hífenes. O nome tem de começar com uma letra e terminar com uma letra ou um número, e não pode exceder 49 carateres.
    4. Descrição: introduza uma descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. ANID: especifique o seu ID da SAP Ariba Network.
    8. Chave da API: introduza a chave da aplicação OAuth para autenticação.
    9. Domínio: introduza o domínio da SAP Ariba para a ligação.
    10. API: introduza a API SAP Ariba a partir da qual quer obter dados.
    11. Centro de dados: introduza a localização geográfica onde os dados da sua conta estão alojados.
    12. Ambiente: introduza o ambiente SAP Ariba ao qual quer estabelecer ligação.
    13. 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.

    14. + ADICIONAR ETIQUETA: clique nesta opção para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    15. Clicar em Seguinte.
  5. 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 SAP Ariba Procurement:

      • OAuth 2.0 – Credenciais de cliente

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

    2. Clicar em Seguinte.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Configure a autenticação

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

  • OAuth 2.0 – credenciais de cliente
    • ID de cliente: introduza o ID de cliente da aplicação que criou.
    • Segredo do cliente: introduza o segredo do gestor de segredos que contém o segredo do cliente para a app associada que criou.
    • Versão do Secret: selecione a versão do Secret para o segredo do cliente.
    • Ativar substituição de autenticação: ative esta opção para a substituição de autenticação.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo dos vários campos que configura quando cria a associação.

OAuth 2.0 – Tipo de ligação de credenciais de cliente

Nome do campo Detalhes
Localização europe-west1
Conetor SAP Ariba Procurement
Versão do conetor 1
Nome da ligação gcp-sapariba-procurement-po-supplier
Ative o Cloud Logging Sim
Conta de serviço my-service-account@my-project.iam.gserviceaccount.com
Nível de registo Depurar
ANID AN11234322444-T
Chave de API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Realm 745628447-T
API PurchaseOrdersSupplierAPI-V1
Centro de dados EUA
Ambiente TESTE
Número mínimo de nós 2
Número máximo de nós 50
Autenticação OAuth 2.0 – Credenciais de cliente
ID do cliente 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Segredo do cliente projects/617888503870/secrets/AribaProcurement/versions/10
Versão do Secret 10

Limitações do sistema

O conetor do SAP Ariba Procurement pode processar um máximo de 3 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

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

Use a ligação do SAP Ariba Procurement numa integração

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

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

Ações

Esta secção mostra como realizar algumas das ações neste conector.

Ação CreateChildElementSchema

Esta ação cria um ficheiro de esquema para uma matriz de documentos no modelo de vista.

Parâmetros de entrada da ação CreateChildElementSchema

Nome do parâmetro Tipo Aceita streams de saída Descrição
ViewTemplateName String Falso O nome de um modelo de vista existente.
ChildElement String Falso Um elemento secundário ou uma matriz de documentos no modelo de visualização na notação de pontos, como LineItems.SplitAccountings.
TableName String Falso O nome da nova tabela, como View_LineItems_SplitAccountings.
FileName String Falso O nome do ficheiro do esquema gerado. Pode ser um caminho relativo ou um caminho absoluto para a localização de gravação pretendida.
FileStream String Verdadeiro Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos.

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

Ação CreateSchema

Cria um ficheiro de esquema para a tabela ou a vista especificada.

Parâmetros de entrada da ação CreateSchema

Nome do parâmetro Tipo Aceita streams de saída Descrição
TableName String Falso O nome da nova tabela.
FileName String Falso O nome do ficheiro do esquema gerado. Pode ser um caminho relativo ou um caminho absoluto para a localização de gravação pretendida.
FileStream String Falso Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos.

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

Exemplos de ações

Esta secção mostra como realizar alguns dos exemplos de ações neste conetor.

Exemplo: crie um esquema de elemento secundário

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateChildElementSchema e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa conectores, clique em connectorInputPayload e, de seguida, introduza 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 ao seguinte:

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

Exemplo: crie um esquema

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

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

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

Exemplos de operações de entidades

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

Exemplo: apresenta todas as encomendas

  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, de seguida, clique em Concluído.
  4. Na secção Task Input da tarefa connectors, pode definir o filterClause de acordo com o requisito do cliente.

    5. Tem de usar aspas simples (') para incluir o valor de uma filterClause. Pode usar o filterClause para filtrar registos com base nas colunas.

Exemplo: liste todos os elementos publicitários

  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, de seguida, clique em Concluído.
  4. Na secção Entrada de tarefas da tarefa conectores, pode definir o filterClause de acordo com o requisito do cliente.

Exemplo: obter detalhes de uma encomenda

  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, de seguida, clique em Concluído.
  4. Defina o entityId como "DO240", que é a chave a ser transmitida. Para definir o entityId, na secção Data Mapper de Data Mapping, clique em Open Data Mapping Editor e, em seguida, introduza "DO240" no campo Input Value e escolha o entityId como variável local.

    5. Deve transferir o valor para entityId diretamente, como "DO240". Aqui, "DO240" é o valor da chave primária exclusivo.

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

Exemplo: obtenha detalhes de um elemento publicitário

  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, de seguida, clique em Concluído.
  4. Defina o filterClause como LineNumber='1' AND DocumentNumber='DO240', que são as chaves compostas a transmitir. Para definir o filterClause, na secção Mapeamento de dados do Mapeador de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "LineNumber='1' AND DocumentNumber='DO240'" no campo Valor de entrada e escolha o filterClause como variável local.

Exemplo: crie uma visualização de propriedade

  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, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza 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 devolve uma resposta semelhante à seguinte na variável de saída da tarefa do conetor connectorOutputPayload:

    {
  "Success": true
}

Exemplo: atualize uma vista

  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, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value. 
    {
  "Status": "published"
}
  5. Defina o entityId no mapeador de dados para o ID das visualizações. Para definir o entityId, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha o entityId, o connectorInputPayload ou o filterClause como variável local.

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

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

    {
}

    Um objeto JSON vazio {}na resposta indica que a operação de atualização foi bem-sucedida.

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?