Utilizando o SAP Ariba com o IBM App Connect Enterprise

O SAP Ariba é uma solução de colaboração de cadeia de suprimentos e compras baseada em cloud É um sistema de ponta a ponta que se concentra em fornecimento, relatório estratégico, governança, licitação competitiva e gerenciamento de contrato, o que permite respostas rápidas às suas necessidades de negócios. IBM® App Connect Enterprise fornece um nó de solicitação Ariba ( SAP ), que você pode usar para se conectar a um Ariba ( SAP ) e emitir solicitações para realizar ações em objetos como espaços de trabalho de contratos, organizações, projetos de sourcing, fornecedores e usuários.

1. No Kit de Ferramentas do IBM App Connect Enterprise, crie um fluxo que contenha um nó Ariba Request do tipo “ SAP ”.
2. Selecione o nó SAP Ariba Request no fluxo para mostrar as propriedades do nó no editor.
3. Na guia Básico , clique em Ativar Descoberta do Conector.
   Um painel é exibido no qual você especifica o nome do projeto de política e detalhes da área segura a serem usados durante a descoberta do conector.
4. Especifique os detalhes do projeto de política e da área segura a serem usados durante a descoberta de conector:
   1. No campo Projeto de Política , especifique o projeto de política usado para armazenar as políticas criadas durante a descoberta do conector.
      Como alternativa, é possível criar um novo projeto de política clicando em Novo e especificando o nome do novo projeto de política. Em seguida clique em Concluir.
   2. Especifique a área segura a ser usada durante a descoberta do conector. Por padrão, as credenciais usadas durante a descoberta do conector são armazenadas em uma área segura do diretório externo, que é uma área segura do App Connect Enterprise que pode ser usada por qualquer servidor de integração. Como alternativa, é possível armazenar as credenciais em uma área segura do servidor de integração, que é criada no diretório de trabalho do servidor de integração e pode ser usada apenas por esse servidor de integração específico.
      Para especificar a área segura a ser usada para armazenar as credenciais, conclua as etapas na seção Usando o assistente de Descoberta do Conector de um dos seguintes tópicos:

      • Configuração de um cofre de diretório externo
      • Configurando uma área segura do servidor de integração
   3. No campo Chave da área segura , insira a chave da área segura usada para acessar as credenciais armazenadas na área segura. A chave da área segura deve ter pelo menos 8 caracteres.
   4. Opcional: Por padrão, o local da área segura especificado e a chave da área segura são salvos como preferências no Toolkit para que os valores sejam pré-configurados quando você ativar a Descoberta do Conector. Se você não desejar que as preferências sejam salvas, cancele a seleção de Salvar nas preferências da área segura.
5. Clique em Ativar descoberta para iniciar o assistente de Descoberta do conector para o conector SAP Ariba .
   A janela Descoberta do Conector é exibida Se conexões SAP Ariba existentes (contas) estiverem disponíveis, uma lista dessas conexões será exibida. Se não houver nenhuma conexão existente, o status do conector SAP Ariba será mostrado como Not connected
   • Se uma ou mais conexões SAP Ariba (contas) estiverem disponíveis, conclua as etapas a seguir:
     1. Selecione a conexão (conta) que você deseja usar, clicando nela.
     2. Clique no tipo de objecto requerido e, em seguida, seleccione a acção que pretende executar no objecto. Por exemplo, para remover uma organização do SAP Ariba, clique em Organizações e, em seguida, em Remover organizações.
   • Se não houver conexões existentes (contas), conclua as etapas a seguir:
     1. Clique no tipo de objeto necessário e selecione a ação que deseja executar nesse objeto. Por exemplo, para remover uma organização do SAP Ariba, clique em Organizações e, em seguida, em Remover organizações.
     2. Clique em Conectar.
        Uma janela é exibida na qual você insere os detalhes da conexão para sua conta SAP Ariba . Insira as informações a seguir:

        • URL do ponto de extremidade: O URL do serviço da Web da API SOAP do SAP Ariba no formato https://<sapariba-domain>.cloud.ariba.com.
        • Nome do usuário: o nome do usuário de seu serviço da web SAP Ariba SOAP API.
        • Senha: a senha do serviço da web SAP Ariba SOAP API.
        • Região: o nome da região que está configurado para sua instância ou assinatura do SAP Ariba. O realm faz parte do URL que você usa para acessar o SAP Ariba, como realm=MyRealm-T.
        • Nome do proxy: Se necessário, insira o nome do proxy que você deseja que o IBM App Connect Enterprise utilize para encaminhar as chamadas do conector.

        Para obter mais informações sobre como acessar ou gerar esses detalhes de conexão, consulte “Como usar IBM App Connect com SAP Ariba” na documentação sobre Entrega Contínua (CD) do IBM App Connect in containers.

     3. Clique em Conectar.
6. Configure as propriedades necessárias do conector no assistente.. Por exemplo, selecione a organização que deseja remover.
7. Quando tiver concluído a especificação das propriedades no assistente de Descoberta do Conector, clique em Salvar.
   As credenciais usadas para se conectar ao SAP Ariba são armazenadas no cofre e os outros detalhes da conexão são salvos na política SAP Ariba. Os valores das propriedades definidas no assistente são retornados ao nó “ SAP ” do Ariba Request no IBM App Connect Enterprise Toolkit.
8. Quando tiver concluído a descoberta e salvo os valores da propriedade, saia do assistente de Descoberta do Conector clicando no X no canto superior direito da janela ou pressionando Alt+F4.
9. Voltar à edição do nó “ SAP ” do Ariba Request no Kit de Ferramentas do IBM App Connect Enterprise.
   As propriedades do conector que foram configuradas no assistente de Descoberta do Conector (na etapa 6) agora estão visíveis no nó SAP Ariba Request no editor de propriedades. A guia Básico mostra os valores das propriedades Ação e Objeto que você configura no assistente. Por exemplo, se você selecionou Organizações > Remover organizações no assistente, as seguintes propriedades estarão visíveis na guia Básico do nó:

   • Ação - DeleteOrganizationOperation
   • Objeto - Organization

   Os valores das propriedades Ação e Objeto são exibidos no formato somente leitura.. Se você desejar mudar esses valores, será possível fazer isso clicando em Ativar descoberta do conector novamente e configurando novos valores no assistente de Descoberta do conector.

   A propriedade Nome Base do Esquema especifica o nome base dos arquivos de esquema que descrevem o formato das mensagens de solicitação e resposta enviadas e recebidas do conector SAP Ariba . O nome base do esquema é configurado automaticamente na primeira vez que você executar a descoberta para o nó e ele é baseado no nome do fluxo atual e no nome do nó Se você configurar essa propriedade manualmente antes de executar a descoberta pela primeira vez, o valor configurado será usado. Se você renomear os esquemas após a descoberta, deverá editar essa propriedade para que ela corresponda ao nome base do esquema utilizado pelos esquemas renomeados no projeto. Se você alterar essa propriedade após a descoberta, deverá renomear os nomes do esquema para corresponder ou executar a descoberta novamente.

   Dependendo da ação selecionada durante a descoberta, o assistente de Descoberta do Conector gera um esquema de solicitação e um esquema de resposta ou apenas um esquema de resposta. Um esquema de solicitação será gerado apenas se a ação e o objeto selecionados requererem uma mensagem de solicitação O esquema de solicitação gerado é usado para validação da mensagem de solicitação.. Se a ação foi RETRIEVE ou DELETE, apenas o esquema de resposta será retornado pelo conector

   Os arquivos de esquema gerados são incluídos no projeto e podem ser usados por um nó Mapeamento para transformar dados de entrada ou saída. O nome do arquivo completo do esquema é derivado do nome base do esquema (como gen/MyMessageFlow.SAP_Ariba_Request), sufixado com response.schema.json ou request.schema.json. É possível abrir o esquema clicando em Abrir esquema de solicitação ou em Abrir esquema de resposta.

10. Verifique se as configurações de propriedade no nó SAP Ariba Request estão corretas e salve o fluxo de mensagens.
11. Na guia Connection do nó SAP Ariba Request , a propriedade Policy mostra o nome da política que contém os detalhes da identidade de segurança a ser usada para a conexão A política tem um tipo SAP Ariba.
    Para obter mais informações, consulte a política SAP Ariba.
12. Opcional: Configure a propriedade Tempo limite na guia Conexão para especificar o tempo (em segundos) que o nó espera para o SAP Ariba processar a operação.
13. A guia Filtro do nó SAP Ariba Request contém propriedades que controlam a maneira como o fluxo de mensagens seleciona dados. Os valores iniciais dessas propriedades são obtidos a partir dos valores da propriedade que foram configurados para o conector SAP Ariba no assistente de Descoberta do Conector, incluindo as propriedades de opções de filtro e quaisquer condições especificadas (conforme descrito na etapa 6). Se você retornar subsequentemente ao assistente de Descoberta do Conector e alterar os valores de quaisquer propriedades (incluindo novas condições, por exemplo) essas atualizações são refletidas nas propriedades configuradas no nó.

    As propriedades Opções de filtro controlam quais objetos devem ser operados quando o nó SAP Ariba Request é executado. As propriedades Limite de Filtro controlam o número máximo de itens a serem recuperados e a ação a ser executada se o limite for excedido.

    É possível modificar os valores clicando em Editar próximo ao valor que deseja modificar na seção Opções de Filtro e alterando os valores da propriedade que foram configurados na seção Limite de Filtro .

    Os valores de propriedade podem ser valores de texto, ou expressões ESQL ou XPATH que são resolvidas a partir do conteúdo da mensagem transmitida para o nó SAP Ariba Request conforme ele é executado.

14. Na guia Solicitação , configure a propriedade Local de dados. para especificar o local na árvore de mensagens recebidas que contém os dados do objeto a serem criados em SAP Ariba Esses dados formam a solicitação que é enviada do nó SAP Ariba Request para o SAP Ariba.
15. Na guia Resultado , configure a propriedade Local de dados de saída: para especificar o local na árvore de mensagem de saída que conterá os dados do registro criado em SAP Ariba.
16. Por padrão, as mensagens de solicitação são validadas com relação ao esquema de solicitação que foi gerado durante a descoberta do conector É possível desativar a validação de solicitação ou mudar as configurações de validação usando as propriedades Validação do nó SAP Ariba Pedido
17. Salve o fluxo de mensagem