Programas de concorrência do conector EBS no Jitterbit Design Studio

Os programas de concorrência do EBS disponíveis no conector Oracle EBS permitem que você utilize programas de concorrência existentes do Oracle EBS para acessar dados e funções do Oracle EBS. Isso permite que o Jitterbit preencha tabelas de interface do Oracle, execute programas de concorrência e recupere informações de status sobre a execução. Essa atividade pode ser usada para inspecionar o repositório de integração em busca do esquema das tabelas de interface para o(s) programa(s) de concorrência selecionado(s), bem como os parâmetros necessários para executar o programa de concorrência.

O conceito e a implementação de programas de concorrência usados aqui são específicos para aplicações Oracle. Você pode aprender mais sobre a implementação de programas de concorrência do Oracle no Guia do Administrador do Sistema Oracle EBS - Definindo Programas e Solicitações de Concorrência.

Esta página descreve como usar programas de concorrência do EBS no Jitterbit usando um exemplo simplificado que primeiro preenche tabelas de interface do Oracle com novos dados de clientes por meio de uma conexão de banco de dados JDBC no Jitterbit, e depois chama um programa de concorrência do EBS para validar e aplicar os dados recém-criados nas tabelas base do Oracle.

Preenchendo tabelas de interface do Oracle

Antes de usar um programa de concorrência do Oracle em uma operação do Jitterbit, você já deve ter configurado uma operação que forneça os dados que deseja acessar com sua instância do Oracle EBS. Isso é realizado por meio da funcionalidade padrão fornecida pelo Jitterbit e não faz parte do Conector Oracle EBS.

Por exemplo, a primeira operação abaixo começa com uma fonte CSV local e, em seguida, transforma esses dados para inserção em um banco de dados Oracle EBS. Esta primeira operação essencialmente preenche as tabelas de interface no banco de dados Oracle. A segunda operação, que executa um programa de concorrência selecionado para validar e aplicar esses dados às tabelas base, faz parte do Conector Oracle EBS e será abordada nas outras seções desta página.

O procedimento para configurar uma operação que preenche as tabelas de interface do Oracle não é específico para o Conector Oracle EBS e pode ser configurado através de uma transformação padrão. Veja Assistente de texto para banco de dados para instruções detalhadas relacionadas a este exemplo. Uma variedade de outras Fontes também pode ser usada para fornecer os dados para a operação.

No exemplo utilizado aqui, o alvo do banco de dados Oracle EBS é configurado usando o driver Oracle [JDBC] com as mesmas credenciais usadas para o endpoint do conector ebs. O alvo do banco de dados EBS configurado está preparado para esta operação de exemplo da seguinte forma:

Criando uma operação de programa de concorrência EBS

No mesmo projeto onde você configurou a operação que fornece os dados para as tabelas de interface do Oracle, você deve criar outra operação que executará o programa de concorrência para validar e aplicar esses dados às tabelas base do Oracle. Os passos abaixo orientam sobre como criar uma nova operação para o programa de concorrência e, após a criação dessa operação, mostram como encadear a operação do programa concorrente para ser executada após a conclusão bem-sucedida da primeira operação.

1. Dentro do seu projeto no Jitterbit Studio, existem várias maneiras de iniciar um novo programa de concorrência EBS. Cada uma das opções a seguir iniciará o Assistente de Programa de Concorrência EBS para guiá-lo pelo processo.

   • Vá para Arquivo > Novo > Conectores > Novo Programa de Concorrência EBS.
   • Na árvore à esquerda, sob Conectores, clique com o botão direito na categoria Oracle EBS e selecione Novo Programa de Concorrência EBS.
   • Na árvore à esquerda, sob Conectores, clique duas vezes na categoria Oracle EBS, depois clique com o botão direito em Programas de Concorrência EBS e selecione Novo Programa de Concorrência EBS.
   • Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . Na janela pop-up, selecione Oracle EBS, depois selecione Programa de Concorrência EBS.

2. A tela Endpoint do Assistente de Programa de Concorrência EBS deve abrir na visualização principal do Studio. Esta tela solicita que você selecione o endpoint que gostaria de acessar os dados. Você já deve ter configurado seu endpoint em endpoint do conector EBS. Use o menu suspenso para selecionar o endpoint apropriado. Clique em Próximo quando terminar.

   

3. A tela Catálogo do Assistente de Programa de Concorrência EBS apresenta uma lista de categorias que contêm programas concorrentes específicos disponíveis em sua instância Oracle EBS. Estes são específicos para EBS, e você precisará saber sob qual categoria seu programa concorrente desejado está localizado dentro do catálogo EBS.

   Neste exemplo, para criar novos dados de clientes na instância Oracle EBS conectada, selecionaremos a categoria "Recebíveis". Em seguida, clique em Próximo para continuar.

   

   Nota

   Durante a seleção de catálogo e programa, se você tiver muitos itens disponíveis em sua instância EBS, pode ser necessário aguardar um momento para que eles sejam carregados. Você também pode inserir um nome de item no campo Filtro. Tente o botão Atualizar se os resultados não forem o que você espera.

4. A tela Programa do Assistente de Programa de Concorrência EBS apresenta uma lista dos programas de concorrência específicos disponíveis dentro da categoria selecionada. Estes são específicos do EBS, e você precisará saber qual programa de concorrência deseja usar.

   Neste exemplo, usaremos o programa de concorrência "RACUST". Clique em Concluir para continuar.

   

5. O Jitterbit prosseguirá então com a criação de uma estrutura de solicitação e resposta da API EBS que definirá os parâmetros dentro do seu programa de concorrência. Uma nova aba deve aparecer no Studio chamada Programas de Concorrência EBS. Você pode renomear seu programa de concorrência aqui, se desejar. Você também pode usar os botões + - ou setas para expandir todos os elementos dentro de cada estrutura.

6. Em seguida, na mesma tela, clique no botão Criar Operação localizado em Usar em uma Integração no canto superior direito. Isso criará a operação Jitterbit que usará seu programa de concorrência no Oracle EBS.

7. Uma nova aba deve abrir no Studio chamada Operações, contendo uma representação gráfica do programa de concorrência dentro de uma operação Jitterbit. Salve sua operação clicando no ícone de disco único para salvar apenas esta operação ou no ícone de múltiplos discos para salvar todas as alterações em seu projeto de integração. Você deve ver o asterisco na aba Operações e o título da operação desaparecerem à medida que sua nova operação de programa de concorrência é criada e salva em seu projeto.

8. Se você tiver outra operação que preenche as tabelas de interface do Oracle, pode encadear as duas operações juntas neste momento. Para fazer isso, clique com o botão direito do mouse no fundo da primeira operação e selecione Em Sucesso > Operação > Selecionar Existente, em seguida, selecione a operação existente que você acabou de criar. Neste caso, esta foi nossa operação RACUST, que nomeamos "2. Executar Programa de Concorrência - RACUST." A aba Operações deve parecer semelhante àquela abaixo.

   

   Nota

   Os ícones para Source, Request, Response e Target na imagem acima são marcadores para os componentes da operação, que definiremos na próxima seção.

Definindo os componentes da operação do programa de concorrência

A próxima etapa é definir os outros componentes da operação do programa de concorrência, incluindo Source, Request, Response e Target.

Você pode retornar à representação gráfica da operação que criou e clicar duas vezes em cada ícone para configurar cada componente, ou pode criar o Source, Request, Response e Target separadamente e, em seguida, arrastá-los da árvore à esquerda diretamente para os ícones na representação visual da sua operação.

Muitos tipos diferentes de dados podem ser usados para cada componente da operação. Para saber mais sobre opções de personalização adicionais, consulte a seção Design Studio da nossa documentação.

• Source: Para simplificar este exemplo, a fonte será codificada. Portanto, removeremos a fonte clicando com o botão direito no ícone da fonte no gráfico da operação e selecionando Remove From Graph.

  Nota

  Uma variedade de tipos de fonte está disponível no Jitterbit. Veja Sources para mais informações.

• Target: Clique duas vezes no ícone Target. Para simplificar este exemplo, vamos enviar o resultado, status e fase da operação para um arquivo XML. Clique no botão Create New Target, dê um Name ao seu target (por exemplo, Exemplo Target). Para este exemplo, estamos usando um agente privado com arquivos locais habilitados e, portanto, selecione um Type de "Local File" e Browse para um local no agente privado onde queremos salvar os dados. Insira uma Folder e um Filename que você gostaria de salvar.

  Nota

  Você também pode exportar para uma variedade de tipos de destino diferentes. O tipo não precisa ser o mesmo que o tipo de origem. Veja Destinos para opções.

• Solicitação: Clique duas vezes no ícone Solicitação e selecione Criar Nova Transformação. Isso abrirá o Assistente de Transformação, que o guiará na criação da solicitação.

  Nota

  Informações adicionais sobre estruturas de solicitação estão disponíveis em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como padrão. Em seguida, use o dropdown Fonte para selecionar a fonte da transformação. No exemplo, nossa fonte é codificada, então selecionaremos "Nenhum." Clique em Concluir para continuar.

  2. A aba Transformações deve abrir, onde você pode completar seu mapeamento. Use o + para expandir os itens de origem e destino em cada árvore. Em uma transformação padrão, você arrastaria e soltaria cada campo que gostaria de mapear de uma árvore para a outra. Para este exemplo, para codificar a origem, clique duas vezes em cada campo do lado do destino e digite os seguintes valores no script:

     DESTINO: Programa de Concorrência EBS: RACUST ENTRADA > RACUST > CABEÇALHO	Script
     USER_NAME	<trans> "SERVICES" </trans>
     RESPONSIBILITY	<trans> "QUICK_CUSTOMER" </trans>
     RESP_APPLICATION	<trans> "AR" </trans>
     SECURITY_GROUP	<trans> "STANDARD" </trans>
     SERVER_NAME	<trans> "" </trans>
     ORG_ID	<trans> "204" </trans>

     DESTINO: Programa de Concorrência EBS: RACUST ENTRADA > RACUST > ENTRADAS_DO_PROGRAMA	Script
     APLICAÇÃO	<trans> "AR" </trans>
     PROGRAMA	<trans> "RACUST" </trans>
     DESCRIÇÃO	<trans> "INVENTORY" </trans>
     HORÁRIO_INÍCIO	<trans> "" </trans>
     SUB_SOLICITAÇÃO	<trans> "" </trans>
     CRIAR_CLIENTE_RECÍPROCO	<trans> "1" </trans>
     ID_ORGÃO	<trans> "204" </trans>

     Após codificar a fonte, seu mapeamento de transformação deve se parecer com o mostrado abaixo.

     

• Resposta: Clique duas vezes no ícone Resposta e selecione Criar Nova Transformação. Isso abrirá o Assistente de Transformação, que o guiará na criação da resposta.

  Nota

  Informações adicionais sobre estruturas de resposta estão disponíveis em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como o padrão. Em seguida, use o menu suspenso Destino para selecionar o destino da transformação. No exemplo, queremos usar a resposta do EBS, então selecionamos "Resposta da Função Oracle EBS." Clique em Próximo para continuar.

  2. Na próxima tela, Target (Alvo), use o menu suspenso para selecionar o programa de concorrência que você já configurou (por exemplo, "RACUST"). A parte inferior da tela exibirá as estruturas de solicitação e resposta associadas a este programa. Clique em Finish (Concluir) para continuar.

  3. A aba Transformations (Transformações) deve abrir, onde você pode completar seu mapeamento. Use o + para expandir os lados de origem e destino. Clique e arraste a pasta "OUTPUT" do lado esquerdo (lado de origem) para a pasta "OUTPUT" do lado direito (lado de destino). Sua tela de mapeamento agora deve se parecer com a abaixo.

     

A configuração final da operação deve se parecer com a abaixo.

Implantação e execução das operações

Com a operação para inserir dados nas tabelas de interface do Oracle, bem como a operação do programa de concorrência do EBS totalmente configuradas, estamos prontos para implantar e executar as operações.

1. A partir da primeira operação na aba Operations (Operações), clique no ícone de implantar .
2. Em seguida, clique no ícone de executar para colocar as operações na fila para execução. A primeira operação será concluída primeiro, seguida pela segunda operação que está encadeada para ser executada se a primeira operação for bem-sucedida.
3. Na parte inferior da tela, o Operation monitor (Monitor de Operações) deve indicar que sua primeira operação foi executada com sucesso. Se não, você pode clicar duas vezes no ícone Status para visualizar quaisquer mensagens de log. Se você quiser verificar se sua segunda operação também foi executada com sucesso, você pode clicar com o botão direito em Operations (Operações) na árvore à esquerda e selecionar Operation Log (Log de Operações) para visualizar os logs de todas as operações em seu projeto.
4. Você também deve agora ver a resposta de saída que foi mapeada para seu arquivo de destino. No exemplo, o arquivo XML agora é criado localmente na localização que você especificou. Como a operação foi executada com sucesso, vemos um resultado de "Success" (Sucesso), status de "Normal" e fase de "Completed" (Concluído).