Programas de Simultaneidade do Conector EBS

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

O conceito e a implementação de programas simultâneos usados aqui são específicos para aplicativos Oracle. Você pode aprender mais sobre a implementação de programas simultâneos Oracle em Oracle EBS System Administrator's Guide - Defining Concurrent Programs and Requests.

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

Preenchendo Tabelas de Interface Oracle

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

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

O procedimento para configurar uma operação que preenche tabelas de interface Oracle não é específico do Oracle EBS Connector e pode ser configurado por meio de uma transformação padrão. Consulte Assistente de Texto para Banco de Dados para obter instruções detalhadas relacionadas a este exemplo. Uma variedade de outras fontes também pode ser usado para fornecer os dados da operação.

No exemplo usado aqui, o destino do banco de dados Oracle EBS é configurado usando o driver Oracle [JDBC] com as mesmas credenciais usadas para o EBS Connector Endpoint. O destino do banco de dados EBS configurado é definido para esta operação de exemplo da seguinte maneira:

Criando uma Operação do Programa de Simultaneidade EBS

No mesmo projeto em que você configurou a operação que fornece os dados para as tabelas de interface Oracle, você deverá criar outra operação que executará o programa de simultaneidade para validar e aplicar esses dados às tabelas base Oracle. As etapas abaixo explicam a criação de uma nova operação para o programa de simultaneidade e, após a criação dessa operação, mostram como encadear a operação do programa simultâneo 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 simultaneidade EBS. Cada uma das opções a seguir iniciará o Assistente do programa de simultaneidade do EBS para guiá-lo durante o processo.

   • Vá para Arquivo > Novo > Conectores > Novo programa de simultaneidade do EBS.
   • Na árvore à esquerda em Conectores, clique com o botão direito na categoria Oracle EBS e selecione Novo Programa de Simultaneidade EBS.
   • Na árvore à esquerda em Conectores, clique duas vezes na categoria Oracle EBS, depois clique com o botão direito em EBS Concurrency Programs e selecione New EBS Concurrency Programa.
   • Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . No pop-up, selecione Oracle EBS e, em seguida, selecione EBS Concurrency Program.

2. A tela Endpoint do EBS Concurrency Program Wizard deve abrir na visualização principal do Studio. Esta tela pede para selecionar o endpoint no qual você gostaria de acessar os dados. Você já deve ter configurado seu endpoint em EBS Connector Endpoint. Use o menu suspenso para selecionar o endpoint apropriado. Clique em Avançar quando terminar.

   

3. A tela Catálogo do EBS Concurrency Program Wizard apresenta uma lista de categorias que contêm programas simultâneos específicos disponíveis em sua instância do Oracle EBS. Eles são específicos do EBS e você precisará saber em qual categoria o programa simultâneo desejado está localizado no catálogo do EBS.

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

   

   Nota

   Durante a seleção do catálogo e do programa, se você tiver muitos itens disponíveis em sua instância do 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. Experimente o botão Atualizar se os resultados não forem os esperados.

4. A tela Programa do EBS Concurrency Program Wizard apresenta uma lista de programas simultâneos específicos disponíveis na categoria selecionada. Eles são específicos do EBS e você precisará saber qual programa simultâneo deseja usar.

   Neste exemplo, usaremos o programa simultâneo "RACUST". Clique em Concluir para continuar.

   

5. A Jitterbit prosseguirá com a criação de uma estrutura de solicitação e resposta da API EBS que definirá os parâmetros em seu programa simultâneo. Uma nova aba deve aparecer no Studio chamada EBS Concurrency Programs. Você pode renomear seu programa de simultaneidade 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 simultaneidade no Oracle EBS.

7. Uma nova aba deverá abrir no Studio chamada Operations, contendo uma representação gráfica do programa de simultaneidade 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 vários discos para salvar todas as alterações em seu projeto de integração. Você deverá ver o asterisco na aba Operações e o título da operação desaparecer à medida que sua nova operação do programa de simultaneidade for criada e salva em seu projeto.

8. Se você tiver outra operação que preencha as tabelas de interface Oracle, poderá encadear as duas operações neste momento. Para fazer isso, clique com o botão direito no plano de fundo da primeira operação e selecione On Success > Operation > Select Existing e selecione a operação existente que você acabou de criar. Neste caso esta foi a nossa operação RACUST, que denominamos "2. Executar Programa de Simultaneidade - RACUST". A aba Operações deve ser semelhante à abaixo.

   

   Nota

   Os ícones de Origem, Solicitação, Resposta e Destino na imagem acima são espaços reservados para os componentes da operação, que definiremos na próxima seção.

Definindo os Componentes de Operação do Programa de Simultaneidade

Em seguida, precisamos definir os outros componentes da operação do programa de simultaneidade, 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 Origem, Solicitação, Resposta e Almeje separadamente e depois arraste e solte-os da árvore à esquerda diretamente nos ícones na representação visual de sua operação.

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

• Fonte: 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 de operação e selecionando Remover do gráfico.

  Nota

  Uma variedade de tipos de fontes estão disponíveis no Jitterbit. Veja Fontes para mais.

• Alvo: clique duas vezes no ícone Alvo. Para simplificar este exemplo, enviaremos o resultado, o status e a fase da operação em um arquivo XML. Clique no botão Criar novo alvo e dê um Nome ao seu alvo (por exemplo, alvo de exemplo). Neste exemplo, estamos usando um Agente Privado com arquivos locais habilitados, e assim selecionar um Tipo de "Arquivo Local" e Browse até um local no Agente Privado onde queremos salvar os dados. Insira uma pasta e um nome de arquivo que você gostaria de salvar.

  Nota

  Você também pode enviar para uma variedade de tipos de destino diferentes. O tipo não precisa ser igual ao tipo de origem. Consulte Metas 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 orientará você na criação da solicitação.

  Nota

  Informações adicionais sobre estruturas de solicitação são fornecidas 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 menu suspenso Fonte para selecionar a origem da transformação. No exemplo, nossa fonte está 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 outra. Neste exemplo, para codificar a origem, clique duas vezes em cada campo no lado do destino e digite os seguintes valores no script:

     ALVO: Programa de simultaneidade EBS: RACUST INPUT > RACUST > HEADER	Script
     USER_NAME	<trans> "SERVICES" </trans>
     RESPONSABILIDADE	<trans> "QUICK_CUSTOMER" </trans>
     RESP_APLICAÇÃO	<trans> "AR" </trans>
     SECURITY_GROUP	<trans> "STANDARD" </trans>
     SERVER_NAME	<trans> "" </trans>
     ID_ORG	<trans> "204" </trans>

     ALVO: Programa de simultaneidade EBS: RACUST INPUT > RACUST > PROGRAM_INPUTS	Script
     APLICAÇÃO	<trans> "AR" </trans>
     PROGRAMA	<trans> "RACUST" </trans>
     DESCRIÇÃO	<trans> "INVENTORY" </trans>
     START_TIME	<trans> "" </trans>
     SUB_REQUEST	<trans> "" </trans>
     CREATE_RECIPROCAL_CUSTOMER	<trans> "1" </trans>
     ID_ORG	<trans> "204" </trans>

     Depois de codificar a fonte, seu mapeamento de transformação deve ser semelhante ao mostrado abaixo.

     

• Resposta: Clique duas vezes no ícone Resposta e selecione Criar nova Transformação. Isso abrirá o Assistente de Transformação que orientará você na criação da resposta.

  Nota

  Informações adicionais sobre estruturas de resposta são fornecidas 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 menu suspenso Target para selecionar o destino da transformação. No exemplo queremos usar a resposta do EBS, então selecionamos “Oracle EBS Function Response”. Clique em próximo para continuar.

  2. Na próxima tela, Target, use o menu suspenso para selecionar o programa de simultaneidade 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 Concluir para continuar.

  3. A aba Transformações deve abrir onde você pode completar seu mapeamento. Use o + para expandir os lados de origem e de 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 ser semelhante à mostrada abaixo.

     

A configuração final da operação deve ser semelhante à abaixo.

Implantando e Executando as Operações

Com a operação de inserção de dados nas tabelas de interface Oracle e também a operação do programa de simultaneidade EBS totalmente configurada, estamos prontos para implantar e executar as operações.

1. Na primeira operação na aba Operações, clique no botão implantar ícone.
2. Em seguida, clique em executar ícone para colocar as operações na fila para execução. A primeira operação será concluída primeiro, seguida pela segunda operação que será encadeada para ser executada se a primeira operação for bem-sucedida.
3. Na parte inferior da tela, o Monitor de operação deverá indicar que sua primeira operação foi executada com sucesso. Caso contrário, você pode clicar duas vezes no ícone Status para visualizar quaisquer mensagens de registro. Se você quiser verificar se sua segunda operação também foi executada com sucesso, você também pode clicar com o botão direito em Operações na árvore à esquerda e selecionar Registro de Operação para visualizar o logs para todas as operações em seu projeto.
4. Agora você também deverá ver a resposta de saída que foi mapeada para seu arquivo de destino. No exemplo, o arquivo XML agora é criado localmente no local especificado. Como a operação foi executada com êxito, vemos o resultado "Sucesso", o status "Normal" e a fase "Concluído".