Antes de Começar

Objetivo

Este OBE (Oracle By Example) descreve como usar Forms Repetidos/Opcionais em uma Solicitação de Form de Orquestração.

Tempo para Conclusão

45 minutos.

Histórico

Anteriormente, uma Solicitação de Formulário de orquestração exigia que o designer soubesse a sequência exata de formulários que seriam executados no tempo de execução. No entanto, muitos aplicativos do JD Edwards EnterpriseOne repetem formulários ou ignoram formulários com base na entrada ou nas seleções do usuário em uma grade.

Ao selecionar a opção Formulação Repetitiva/Opcional, você pode criar uma única solicitação de formulário que suporte formulários que podem ser abertos várias vezes, ou não, dependendo das condições de tempo de execução.

Neste OBE, você usará a opção Formulário de repetição/opcional para abordar o seguinte:

  • Liberar todas as linhas em uma ordem em aberto.
  • Libere todas as linhas em um pedido de compras em aberto usando uma matriz para controlar a quantidade liberada para cada linha.
  • Liberar linhas e quantidades específicas em vários pedidos de vendas em aberto.
  • Criar um pedido de venda que possa incluir itens de kit e itens configurados.

Do Que Você Precisa?

Para executar as etapas neste OBE, você precisará:

Acesso a um ambiente JD Edwards EnterpriseOne com o Tools Release 9.2.26.2 ou mais recente. O JD Edwards EnterpriseOne Trial Edition executado no Oracle Cloud Infrastructure é adequado, mas você pode usar qualquer ambiente com a versão adequada do Tools.

Tarefa 1: Liberar Todas as Linhas em uma Ordem com Preço Fixo

Para esta e para as próximas tarefas, você precisa de pedidos de vendas em aberto que possam ser liberados. Nesta tarefa, você cria dois pedidos de contrato guarda-chuva/cobertura e depois registra um processo para liberar linhas de pedidos de contrato guarda-chuva/cobertura. Como o form Liberação de Ordem é aberto uma vez para cada linha selecionada, você atualiza a Solicitação de Formulário para usar um Formulário Repetitivo/Opcional para que a orquestração possa ser executada com sucesso, independentemente de quantas linhas forem selecionadas.

A. Criar Dois Pedidos de Compras em Aberto

  1. Acesse o cliente Web do EnterpriseOne.
  2. Na Home page do EnterpriseOne, clique em Navegador e informe P4310 ZJDE0006 em Caminho Rápido.
  3. Em Trabalhar com Cabeçalhos de Ordem, clique em Adicionar. O formulário Detalhes da prescrição é exibido.
  4. Informe os seguintes valores:
    • Fornecedor: 3090
    • Ramificação/Fábrica: 30
  5. Clique em OK.
  6. Na grade, adicione três linhas com os seguintes detalhes:
  7. Clique em OK para salvar a ordem e anote o Número da Ordem que você criou.
  8. Crie um segundo pedido global repetindo as etapas de 3 a 7 com as seguintes alterações:
    • Usar o mesmo Fornecedor (3090) e Filial/Fábrica (30).
    • Adicione duas linhas para o Item 210 e 220, cada uma com Quantidade Solicitada 100.
    • Observe o Número do Pedido Anterior.

B. Registrar o Processo de Liberação Usando o Process Recorder

  1. Retorne à página inicial do EnterpriseOne.
  2. No menu do usuário (canto superior direito), clique em Registrar um Processo para abrir o Process Recorder.
    Veja a seguir a descrição da ilustração Record_the_Release_Process.png
    Registre o Processo de Liberação
  3. Na janela Processar Gravador, clique em Iniciar.
  4. Use Navegador para abrir o P43060 (programa Acesso a Liberação de Ordem).
  5. Informe o Número do Pedido do primeiro pedido em aberto (três linhas) e clique em Localizar.
    Veja a seguir a descrição da ilustração Entering_the_Order_Number.png
    Informe o Número do Pedido
  6. Marque todas as linhas marcando a caixa de seleção superior esquerda no cabeçalho da grade.
  7. Clique em Selecionar (ícone de verificação verde). Para cada linha selecionada, o sistema abre o formulário Liberação da Ordem.
  8. Para cada ocorrência do formulário Liberação da Ordem:
    1. Substituir Qtd. de Liberação por 1.
    2. Clique em OK.
    • Observação: Se você não substituir a Qtd. de Liberação, o sistema liberará a quantidade total.
  9. Depois de fechar o último form Liberação da Ordem e retornar ao form Trabalhar com Liberação da Ordem, clique em Formulário e selecione Gerar Ordens. O sistema exibe os resultados em Ordens de Compra Geradas.
  10. Em Process Recorder, clique em Retornar Valores.
  11. Em Ordens de Compra Geradas, clique no cabeçalho da coluna Número da Ordem na grade para retornar o número da ordem de compra gerada.
  12. Em Processar Gravador, clique em Retomar.
  13. Clique em Fechar para sair do formulário Ordens de Compra Geradas.
  14. Clique em Fechar para sair do Work With Order Release e retornar à Home page.
  15. Em Process Recorder, digite Blanket Release no campo Nome, clique em Salvar e feche o Process Recorder.

C. Atualizar uma Solicitação de Formulário com Formulário Repetido/Opcional

  1. Abra o Orchestrator Studio.
  2. Na Home page do Orchestrator Studio, clique no mosaico Solicitações de Formulário.
  3. No painel esquerdo, procure e selecione o processo Liberação do Contrato Guarda-Chuva/Cobertura. Se ele não aparecer, clique em Atualizar.
  4. Nos segmentos superiores do formulário, localize o formulário Liberação da Ordem. O processo registrado inclui uma ocorrência de Liberação da Ordem para cada linha selecionada. Neste exemplo, três linhas foram selecionadas, portanto, três ocorrências de Liberação de Ordem foram registradas.
  5. Exclua quaisquer ocorrências adicionais do formulário Liberação da Ordem para que apenas uma permaneça (mantenha uma ocorrência e exclua o restante):
    Veja a seguir a descrição da ilustração Remove_Order_Release.png
    Remover Liberação da Ordem
    1. Selecione uma etapa Liberação da Ordem, clique em Remover e clique em OK para confirmar. Não importa qual ocorrência você exclua, mas apenas uma ocorrência de Liberação da Ordem deve permanecer.
    2. Repita até que apenas uma etapa de Liberação de Pedido permaneça.
      3. Veja a seguir a descrição da ilustração Order_Release.png
      Liberação de Ordem
  6. Selecione a etapa restante Liberação da Ordem. Clique no botão Detalhes do Formulário ao lado do botão Remover.
  7. Ative Formulário de Repetição/Opcional e clique em Salvar e Carregar.
  8. No formulário Liberação da Ordem, renomeie a variável de entrada para Qtd. de Liberação para Qtd. de Liberação (em vez de Quantidade_Aberta).
  9. Clique em Salvar para salvar a solicitação de formulário.

D. Criar e Testar a Orquestração

  1. No menu Gerenciar, clique em Criar Orquestração.
  2. Clique em Salvar para salvar a orquestração.
  3. Execute a orquestração:
    • Clique duas vezes no nó Iniciar ou selecione o nó e clique em Executar Orquestração.
  4. Nas entradas, informe os seguintes valores:
    • Order_Number: o número da ordem do pedido de três registros em aberto
    • Release_Qty: 2
    • P43060_Version: deixe em branco
  5. Clique em Executar e anote o Número da Ordem retornado na resposta.
    Veja a seguir a descrição da ilustração Order_Number.png
    Número de Ordem

E. Verificar os Resultados

  1. No cliente Web do EnterpriseOne, use Navegador para abrir o P4310.
  2. Informe o número da ordem de compra retornada na resposta e clique em Localizar.
  3. Selecione a ordem na grade e clique em OK.
  4. Na tela Cabeçalho da Ordem, clique em OK.
  5. No formulário Detalhes da Ordem, verifique o seguinte:
    • O pedido inclui três linhas.
    • Cada linha tem uma quantidade de 2 (ou o valor informado em Qtd_Liberação).
    • Para confirmar a ordem de origem em aberto, role para a direita e verifique Ordem Original e Nº da Linha Original.
  6. Repita o procedimento descrito nas seções D e E usando o segundo pedido global e verifique se o pedido de compra gerado inclui as linhas e quantidades esperadas.

Tarefa 2: Liberar Todas as Linhas em uma Ordem em Aberto Usando uma Matriz para Controlar a Quantidade Liberada para Cada Linha

Na tarefa anterior, a orquestração usou um único valor de entrada para controlar a quantidade liberada para cada linha de ordem em aberto. Nesta tarefa, você atualiza a solicitação de formulário e as entradas de orquestração para passar uma matriz de quantidades para que possa liberar uma quantidade diferente para cada linha.

A. Atualizar a Solicitação de Formulário para Usar uma Matriz de Entrada de Formulário Repetido

  1. Abra o Orchestrator Studio e navegue até Solicitações de Formulário.
  2. No painel esquerdo, selecione a solicitação de formulário Liberação do Contrato Guarda-Chuva/Cobertura criada na tarefa anterior.
  3. Nos segmentos superiores do form, selecione o form Liberação da Ordem e clique em Detalhes do Formícone de menu.
  4. Na janela Detalhes do Formulário, informe o seguinte valor:
    • Matriz de Entrada de Formulário Repetitivo: Quantidades
    • Isso permite que você informe uma matriz chamada Quantidades que contenha as entradas de variáveis para esse formulário. Nesta tarefa, Release_Qty é o único campo na matriz.
  5. Clique em Salvar e Carregar e em Salvar para salvar a solicitação de formulário.
    6. Veja a seguir a descrição da ilustração Save_the_Form_Request.png
    Salvar a Solicitação de Formulário

B. Atualizar as Entradas de Orquestração e Corrigir o Mapeamento

  1. Retorne à Home page do Orchestrator Studio e navegue até Orquestrações.
  2. Selecione a orquestração Liberação do Contrato Guarda-Chuva/Cobertura criada na tarefa anterior.
  3. Selecione o nó Iniciar e clique em Entradas e Valores:
    Veja a seguir a descrição da ilustração Inputs_and_Values.png
    Entradas e Valores
  4. Na lista Entradas, clique no X no final da linha Release_Qty para remover a entrada.
  5. Clique no curser na página de orquestração.

    Observação: a etapa Liberação do Contrato Guarda-Chuva/Cobertura exibe um selo Mapeamentos Quebrados porque a entrada Release_Qty, que estava em uso anteriormente, foi excluída.

    Veja a seguir a ilustração Broken_Mappings.png
    Mapeamentos Quebrados
  6. Selecione a etapa Liberação do Contrato Guarda-Chuva/Cobertura e clique no ícone Transformações.
  7. No painel Transformações, clique em Adicionar Entradas à Orquestração e, em seguida, clique em Mapa Automático. Isso recria a entrada Release_Qty como parte da matriz Quantities.
  8. Clique em Salvar para salvar a orquestração.

C. Testar a Orquestração

  1. Selecione o nó Iniciar e clique em Executar Orquestração.
  2. Informe um número de ordem em aberto para Order_Number.
  3. Ao lado de Quantidades, clique em Entradas de Array.
  4. Na janela pop-up Entradas de matriz, digite uma quantidade para cada linha do pedido de vendas em aberto.

    Observação: Depois de informar uma quantidade, clique fora do campo de entrada para adicionar uma nova linha de entrada.

    • Se você inserir menos quantidades, a quantidade padrão será aplicada às linhas restantes.
    • Se você inserir mais quantidades, os valores extras serão ignorados.
  5. Clique em Executar.
  6. Usando o Número da Ordem retornado na resposta, abra a ordem gerada no P4310 e inspecione as linhas e as quantidades da ordem.

Tarefa 3: Liberar Linhas e Quantidades Específicas em Várias Ordens em Aberto

Nesta tarefa, você cria uma orquestração que libera várias linhas de ordem em aberto, uma linha por vez. Você configura dois formulários consecutivos em uma única solicitação de formulário para serem executados repetidamente com base em um array de entrada. A orquestração aceita uma matriz que contém Número da Ordem, Número da Linha e Quantidade de Liberação, permitindo que você libere uma quantidade específica de linhas específicas em várias ordens em aberto antes de gerar ordens de compra.

A. Copiar solicitação de formulário existente

  1. Abra o Orchestrator Studio e navegue até Solicitações de Formulário.
  2. Selecione a solicitação de formulário Liberação do Contrato Guarda-Chuva/Cobertura criada nas tarefas anteriores.
  3. No menu Gerenciar, clique em Salvar Como.
  4. Na janela Salvar Como, informe os seguintes valores:
    • Novo Nome: Liberação em Aberto da Linha
    • Nova Descrição: Liberação em Aberto da Linha
  5. Clique em OK.

B. Configurar o Acesso ao Formulário de Liberação de Ordem para Repetir pela Entrada da Matriz

  1. Nos segmentos superiores do formulário, selecione o formulário Trabalhar com Liberação de Ordem (primeira opção).
  2. Clique em Detalhes do Formulário ícone de menu.
  3. Ative Formulário Repetitivo/Opcional.
  4. Em Matriz de Entrada de Formulário Repetitivo, informe Linhas em Aberto.
  5. Clique em Salvar e Carregar.

C. Adicionar um Filtro QBE de Número de Linha e Atualizar o Comportamento de Seleção de Grade

  1. Confirme se a opção Trabalhar com Liberação de Ordem ainda está selecionada nos segmentos superiores do formulário.
  2. Em Ações Disponíveis, expanda Trabalhar com Versão de Pedido – QBE.
  3. Localize o Número da Linha (ID 37) e clique em Adicionar Ação (+).
  4. Em Ordem de Execução, selecione a nova linha Número da Linha (normalmente a última linha adicionada) e reposicione-a como a segunda ação na sequência.
  5. Em Ordem de Execução, remova todas as ações Selecionar Todas as Linhas. Selecione cada ação Selecionar Todas as Linhas e clique em Excluir (X).
  6. Em Ações Disponíveis, expanda Trabalhar com Liberação de Ordem – Grade.
  7. Localize Selecionar Linha e clique em Adicionar Ação (+).
  8. Em Ordem de Execução, atualize a ação Selecionar Linha:
    • Desmarque Select_Row na coluna Entrada.
    • Defina o Valor Padrão como 1.
    • Filtrar por Número da Ordem e Número da Linha, a grade deve retornar uma única linha após Localizar.
  9. Reordene as ações para que Selecionar Linha seja executado entre Localizar e Selecionar.
    Veja a seguir Update_the_Select_Row_Action.png
    Atualizar a Ação Selecionar Linha

D. Configurar o Formulário de Liberação de Ordem para Usar o Mesmo Array de Entrada

  1. Nos principais segmentos do formulário, selecione Liberação da Ordem (segunda opção).
  2. Clique em Detalhes do Formulário<img src="images/menu_icon.png" alt="menu icon" style="width:20px; height:20px; position:relative; top:-2px; margin-left:4px;" .< li>
  3. Defina Matriz de Entrada de Formulário Repetitivo como Linhas em Aberto (para corresponder ao primeiro formulário).
  4. Clique em Salvar e Carregar.
    • Isso permite que você informe uma única matriz que inclua Número da Ordem, Número da Linha e Quantidade.
    • No tempo de execução, os dois primeiros formulários são executados uma vez consecutivamente para cada linha no array Linhas em Aberto. Depois que a matriz é processada, a solicitação de formulário continua a gerar o pedido de compra.
  5. Clique em Salvar para salvar a solicitação de formulário.

E. Criar e Testar a Orquestração

  1. No menu Gerenciar, clique em Criar Orquestração.
  2. Clique em Salvar para salvar a orquestração.
  3. Em Executar Orquestração, localize a entrada Linhas em Aberto e clique em Entradas da Matriz.
  4. Adicione várias linhas à matriz usando combinações válidas de suas ordens de teste em aberto (Número da Ordem + Número da Linha + Quantidade) e feche a janela.
    5. Veja a seguir a ilustração Adding_multiple_rows_to_the_array.png
    Adicionando Várias Linhas à Matriz
  5. Clique em Executar.
  6. Na resposta, confirme se o Número da Ordem gerado contém as informações de linha liberada esperadas.

Tarefa 4: Criar uma Ordem de Venda que Pode Incluir Itens Configurados e do Kit

Nesta tarefa, você registra e cria uma orquestração que cria uma ordem de venda contendo qualquer combinação de itens regulares, de kit e configurados. Quando você adiciona um item de kit, o formulário Seleção de kit é aberto. Quando você adiciona um item configurado, um formulário de configurador é aberto. Para esta tarefa, você aceita a configuração padrão para kits e itens configurados.

A. Registrar o Processo para Criar um Pedido de Vendas

  1. Acesse o cliente Web do EnterpriseOne.
  2. No menu do usuário (canto superior direito), clique em Registrar um Processo para abrir o Process Recorder.
  3. Na janela Processar Gravador, clique em Iniciar.
  4. Use Navegador e digite P42101 em Fast Path.
  5. Clique em Adicionar (ícone +).
  6. No cabeçalho da ordem, insira os seguintes valores:
    • Vendido para: 4244
    • Ramificação/Fábrica: 30
  7. Na grade, insira a primeira linha:
    • Número do Item: 2400
    • Filial/Fábrica: 30
  8. No Cabeçalho da Ordem, clique na guia Resumo da Ordem. Alternar as guias de cabeçalho remove o foco da grade e solicita que os valores da grade sejam processados.
  9. Quando a janela Seleção de Kit for aberta, clique em OK para aceitar a configuração do kit padrão.
    10. accept_the_default_kit_configuration.png é exibido a seguir
    Aceitar a Configuração Padrão do Kit
  10. Adicione uma segunda linha na grade:
    • Número do Item: 6000
    • Filial/Fábrica: M30
    • Observação: Se você receber um erro, confirme se a Agência/Fábrica é M30 (não 30).
  11. Saia da linha. A janela do configurador é aberta.
    12. configurator_window.png a seguir
    Janela do Configurador
  12. Clique em Validar Configuração.
  13. Clique em Adicionar à Ordem.
  14. Ao retornar à ordem de venda, selecione a guia Cabeçalho da Ordem de Venda.
  15. Na janela Processar Gravador, clique em Retornar Valores e selecione o campo que contém o número da ordem para capturá-lo.
  16. Na janela Processar Gravador, clique em Retomar.
  17. Clique em Enviar e Fechar para salvar o pedido.
  18. Em Gerenciar Ordem Existente, informe o número da ordem capturada no campo de filtro Número da Ordem e clique em Localizar.
  19. Na janela Process Recorder, clique em Retornar Valores.
  20. Na grade, selecione as seguintes colunas clicando em cada cabeçalho de coluna:
    • Número de Ordem
    • Número da Linha
    • 2º Número do Item
    • Descrição 1
  21. Na janela Processar Gravador, clique em Retomar.
  22. Feche Gerenciar Ordem Existente (ícone X) para interromper a gravação.
  23. Em Process Recorder, digite Adicionar Ordem de Venda com Kits e Itens de Configuração para o Nome, clique em Salvar e feche o Process Recorder.

B. Atualizar a Solicitação de Formulário para Tratar Formulários Opcionais/Repetitivos

  1. No Orchestrator Studio, navegue até Solicitações de Formulário.
  2. No painel esquerdo, selecione Adicionar Ordem de Venda com Kits e Itens de Configuração.
  3. Nos segmentos superiores do form, localize a segunda ocorrência do form Informar Nova Ordem (quarta opção) e remova-o.
    • Selecione o formulário, clique em Remover e clique em OK para confirmar.
    • Esta segunda ocorrência foi registrada porque a janela Seleção de Kit foi aberta depois que você inseriu a primeira linha.
    • No tempo de execução, a orquestração adiciona todas as linhas por meio do array transmitidas ao primeiro formulário Informar Novo Pedido e os formulários kit/configurador são abertos apenas conforme necessário.
  4. Configure o formulário Seleção de Kit como repetido/opcional:
    1. Selecione Seleção de Kit no segmento.
    2. Clique em Detalhes do Formulárioícone de menu.
    3. Ative Formulário Repetitivo/Opcional.
    4. Clique em Salvar e Carregar.
  5. Configure o formulário de item configurado como repetido/opcional:
    1. Selecione Formulário Pai – Revisões de Item Configuradas no segmento.
    2. Clique em Detalhes do Formulárioícone de menu.
    3. Ative Formulário Repetitivo/Opcional.
    4. Clique em Salvar e Carregar.

C. Certifique-se de que a Variável Criada para Armazenar o Número da Ordem seja Usada para Obter Detalhes da Ordem

  1. Selecione o próximo formulário nos segmentos do formulário (quinta opção).
  2. Na coluna Ação ícone de menu da grade, clique no botão para exibir a variável OrderNumber retornada.
  3. Observe o nome exato da variável retornada (por exemplo, OrderNumber).
  4. Selecione o sexto formulário no segmento e localize o mapeamento do campo Número da Ordem.
  5. Altere o valor Input de Order_Number para o nome da variável retornada (por exemplo, OrderNumber).
    • Isso garante que a solicitação de formulário localize imediatamente a prescrição que acabou de ser criada.
  6. Clique em Salvar para salvar as alterações da solicitação de formulário.

D. Criar e Testar a Orquestração

  1. Em Gerenciar, clique em Criar Orquestração.
  2. Clique em Salvar para salvar a orquestração.
  3. Teste a orquestração usando Executar Orquestração.
  4. Informe as seguintes entradas de cabeçalho:
    • Long_Address_Number_Sold_To: 4244
    • HdrBusinessUnit: 30
  5. Ao lado do array de entrada de linha (por exemplo, GridIn_188_20_2), clique em Entradas do Array.
    • Observação: é recomendável renomear as variáveis criadas pelo Process Recorder antes de criar a orquestração.
  6. Testar apenas com um item regular:
    • Adicione uma linha com Item_Number 210 e Branch_Plant 30.
  7. Feche a janela Entradas da Matriz e clique em Executar.
    • Deixe OrderNumber e P42101_Version em branco.
    • Verifique se a resposta exibe um pedido de venda de linha única (nenhum kit ou formulários do configurador foram necessários).
  8. Teste com um item de kit:
    1. Clique em Entradas de Array novamente.
    2. Adicione uma segunda linha com Item_Number 2400 e Branch_Plant 30.
      3. Veja a seguir Array_inputs.png
      Entradas do Array
    3. Feche a janela e clique em Executar.
    4. Verifique se a ordem inclui os dois itens de entrada mais as linhas de componente do kit padrão.
      • Para o item de kit 2400, linhas como 2.01 e 2.02 são os componentes de kit padrão.
        • Order.png segue
        Ordem
  9. Testar com um item configurado:
    1. Adicione o item configurado à entrada da matriz (além dos itens anteriores).
      2. Veja a seguir a ilustração Adding_the_configured_item.png
      Adicionando o Item Configurado
    2. Execute a orquestração.
    3. Verifique se o pedido inclui linhas anteriores e linhas de item configuradas adicionais (por exemplo: 3, 3.001, 3.002, 3.003, 3.004).
  10. Modifique o array de entrada para incluir qualquer combinação de itens regulares, de kit e configurados, e confirme as linhas da ordem de venda retornadas na resposta.

Conclusão

Neste Oracle-by-Example, você aprendeu a usar a opção Form Repetido/Opcional em uma Solicitação de Formulário para indicar que um formulário específico pode repetir um número de vezes ou talvez não. No caso de liberar linhas de um pedido de compra com entregas fracionadas, você pode controlar a quantidade de itens que está sendo liberada para cada linha no pedido de forma independente. No caso de criar uma ordem de venda com itens que podem ou não ser configurados ou itens de kit, a solicitação de formulário pode iterar sobre os formulários de item e kit configurados de intervenção. Dessa forma, a opção Formulário Repetido/Opcional permite automatizar aplicativos do EnterpriseOne que iteram em formulários um número indeterminado de vezes.