Fazer Upgrade para o Oracle Integration 3: Fase 2

Quando ativada, uma instância do Processo é automaticamente provisionada com a instância do Oracle Integration. Nesse caso, os dois serviços se tornam associados entre si e são listados na página de serviços Associados uns aos outros na Console do Oracle Cloud.

Configurar Políticas do IAM para Gerenciar a Instância do Processo

Para ativar o Processo com o Oracle Integration, crie políticas do Oracle Cloud Infrastructure Identity and Access Management (IAM) que permitam aos administradores do Oracle Integration pertencentes a um grupo do IAM especificado gerenciar a instância do Processo.

Configure as seguintes políticas do IAM para o Processo:

Consulte Sobre Políticas do IAM para Automação de Processos e Criar uma Política do IAM em um Domínio de Identidades em Administrando o Oracle Cloud Infrastructure Process Automation.

Para obter informações sobre políticas do IAM para o Oracle Integration, consulte Sobre Políticas do IAM para o Oracle Integration e Criar uma Política do IAM em um Domínio de Identidades para o Oracle Integration.

Ativar Processo

Para ativar uma instância do Processo com uma instância do Oracle Integration:

1. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Integração de Aplicativo, clique em Integração.
2. Na lista drop-down Compartimento, selecione o compartimento no qual você deseja provisionar e ativar uma instância do Processo com uma instância do Oracle Integration. A página é atualizada para mostrar quaisquer instâncias de serviço existentes no compartimento selecionado.
3. Escolha uma instância existente ou crie uma instância do Oracle Integration e selecione-a. A página de detalhes da instância de Integração é aberta.
4. Clique no link Ativar para Processo na guia de informações da instância de Integração.
5. Quando solicitado, clique em Ativar para confirmar que deseja ativar o Processo. Observe o seguinte:
   • O ícone do Oracle Integration fica laranja e seu status muda para Atualizando.
   • A conclusão da habilitação pode levar alguns minutos.
   • Uma vez concluída, ou seja, quando uma instância do Processo é ativada e provisionada com a instância do Oracle Integration, o ícone do Oracle Integration é alterado de volta para verde com um status Ativo e o Processo é mostrado como Ativado.
6. Para navegar até a instância do Processo que acabou de ser criada, clique em Serviços associados em Recursos.
7. Selecione a instância Processar e exiba seus detalhes.

Atribuir Funções de Aplicativo do IDCS para Gerenciar o Acesso

Depois de ativar uma instância do Processo, atribua atribuições predefinidas do aplicativo IDCS aos usuários para que eles possam trabalhar com os recursos da instância do Processo.

Em Processo, há duas atribuições de aplicativo do IDCS predefinidas: ServiceDeveloper e ServiceAdministrator. Essas atribuições devem ser designadas a usuários ou grupos no aplicativo de instância de serviço Processar da console de administração do Oracle Identity Cloud Service (IDCS).

Como prática recomendada, é recomendável designar essas atribuições a grupos, em vez de a usuários individuais. Por exemplo, designe a atribuição de aplicativo IDCS ServiceDeveloper a um grupo nos aplicativos de instância de serviço do Oracle Integration e do Process na console de administração do Oracle Identity Cloud Service. Dessa forma, será mais fácil gerenciar o acesso do usuário, pois qualquer usuário que seja membro do grupo pode acessar o tempo de design do Oracle Integration e do Process.

1. Determine quais aplicativos você deseja migrar.

   Você pode querer aproveitar essa oportunidade para limpar aplicativos desnecessários. Pense se você deseja migrar apenas os aplicativos que estão em seu ambiente de produção.

   Se você pretende migrar aplicativos individuais, anote os aplicativos que deseja migrar e quaisquer dependências que eles tenham.

2. Migre seus aplicativos usando um dos seguintes métodos:
   • Migre todos os aplicativos em massa
     1. Na Console do Oracle Cloud, crie um bucket do serviço Object Storage. Consulte Criando um Bucket do Serviço Object Storage.

        O URL do bucket de armazenamento que você precisará na próxima etapa está no seguinte formato:

        https://swiftobjectstorage.region.oraclecloud.com/v1/namespace/bucket

        Em que:

        • region é o identificador do seu data center do Oracle Cloud Infrastructure (OCI).
        • namespace é a tenancy em que você criou seu bucket.
        • bucket é o nome do seu bucket.
     2. Faça uma solicitação POST para sua instância do Oracle Integration Generation 2 para exportar seus aplicativos:

        curl -X POST https://Generation2_hostname/ic/api/process/v1/exportArtifactsInternal

        Com o seguinte payload:

        {
            "jobId": "enter_a_descriptive_ID",
            "storageInfo": {
                "storageUrl": "Swift_storage_bucket_URL",
                "storageUser": "OCI_Console_user",
                "storagePassword": "OCI_Console_user_password"
            }
        }

        Você saberá que o job de exportação foi concluído quando vir o arquivo process_status.json no seu bucket. Este arquivo contém o status do job, sua porcentagem de conclusão e, se houver falha, a mensagem de erro. Você também deverá ver o seguinte conteúdo em seu bucket:

        • Process/project folder — contém todos os seus aplicativos de processo.
        • Process/dmn folder — contém todos os seus modelos de decisão.
     3. Depois que os aplicativos tiverem sido exportados para seu bucket, faça uma solicitação POST para sua instância do Oracle Integration 3 para migrar seus aplicativos:

        curl -X POST https://Integration3_hostname/process/api/v1/oic-migration/jobs/

        Com seu ID de locatário:

        x-tenant-id: tenant_OCID

        E as informações do seu bucket:

        {
            "bucketInfo": {
                "region": "region",
                "namespace": "namespace",
                "bucket": "bucket"
            }
        }

        Consulte Segurança, Autenticação e Autorização na API do Desenvolvedor para o Oracle Cloud Infrastructure Process Automation.

     4. Aguarde a conclusão do job de migração. Para verificar o status do job de migração:

        curl http://localhost:8080/process/internal-api/v1/oic-migration/jobs/job_ID

   • Migrar aplicativos individuais
     1. Exporte os aplicativos de processo do Oracle Integration Generation 2.

        Na instância do Oracle Integration Generation 2 que inclui os aplicativos que você deseja migrar, exporte cada aplicativo que deseja migrar. Consulte Exportar um Aplicativo em Usando Processos no Oracle Integration Generation 2.

     2. Importe os aplicativos de processo para o Processo do Oracle Integration 3.

        No Processo do Oracle Integration 3, importe os aplicativos de processo do Oracle Integration Generation 2. Consulte Importar um Aplicativo no Usando o Oracle Cloud Infrastructure Process Automation.

        O Oracle Integration 3 Process converte os aplicativos de processos legados na versão mais recente do produto.

3. Revise o relatório de migração.

   Quando a importação e a conversão estiverem concluídas, você verá um relatório de migração mostrando o que foi importado com sucesso, o que precisa de trabalho adicional e todos os itens que não puderam ser migrados. Isso lhe dá uma ideia dos problemas de migração que você precisará lidar.

   Você pode consultar o relatório de migração original no menu principal. Consulte Importar um Aplicativo no Usando o Oracle Cloud Infrastructure Process Automation.

Validar e Ativar Aplicações de Processo Importadas

Para validar e ativar seus aplicativos de processo, execute as seguintes etapas:

1. Valide cada aplicativo e corrija quaisquer erros e avisos.

   Valide cada aplicativo no Designer clicando em e escolhendo Validar no menu.

   Para resolver problemas de validação, consulte Como o Upgrade Afeta os Recursos do Processo.

2. Ative o aplicativo.

   Depois de resolver todos os erros de validação, você poderá ativar seu aplicativo. Consulte Ativar Aplicativos no Usando o Oracle Cloud Infrastructure Process Automation.

Mapear Usuários e Grupos para Novas Atribuições de Aplicativo

As Atribuições do Aplicativo foram significativamente alteradas no Oracle Integration 3. As atribuições ProcessOwner, AnalyticsViewer e ProcessReviewer agora são definidas explicitamente para cada aplicativo, permitindo que você controle seus membros e permissões.

A tabela a seguir mostra como as atribuições do Oracle Integration Generation 2 são mapeadas para as atribuições do Processo do Oracle Integration 3.

As novas atribuições estão disponíveis após a migração, mas você precisa adicionar membros (usuários e grupos) a elas. Você provavelmente precisará fazer referência ao seu ambiente do Oracle Integration Generation 2 para ver quais membros devem ser designados a cada atribuição.

Se o Processo do Oracle Integration 3 compartilhar o mesmo domínio de identidades da sua instância existente do Oracle Integration Generation 2, os usuários e grupos existentes deverão estar disponíveis para seleção.

Você pode adicionar membros antes da ativação no Designer ou após a ativação no Espaço de Trabalho.

• Trabalhar com Funções no Designer
• Gerenciar Atribuições no Espaço de Trabalho

Para obter informações adicionais sobre o Processo do Oracle Integration 3, consulte Configurar Atribuições para Aplicativos de Processo no Usando o Oracle Cloud Infrastructure Process Automation.

• Processo de Chamada de Integrações
• Integrações Chamadas por Processo
• Aplicativos Visual Builder
• Clientes Não Oracle-Integration
• Verificação

Processo de Chamada de Integrações

As integrações que chamam processos no Oracle Integration 3 precisarão ser atualizadas para usar a nova ação Processo. Para fazer isso, crie uma nova versão principal da sua integração, adicione a nova ação do processo e faça referência ao processo que você deseja iniciar no Oracle Integration 3. Remova a ação do processo existente e ative sua integração.

Integrações Chamadas por Processo

O Processo do Oracle Integration 3 suporta comunicação baseada em REST somente por meio do Registro de Serviço. Isso significa que a conectividade com integrações baseadas em SOAP não será mais possível.

Se você tiver integrações que usam um acionador SOAP e elas forem chamadas por processos no Oracle Integration Generation 2, precisará seguir etapas adicionais para apresentar uma interface baseada em REST ao Processo do Oracle Integration 3. Isso pode significar que você precisa executar um dos seguintes procedimentos:

• Crie integrações de encapsulador baseadas em REST.

  ou

• Altere o trigger existente de SOAP para REST.

Revise todas as conexões de integração nos aplicativos de processo migrados. Atualize os metadados de conexão, garantindo que a definição mais recente seja incorporada ao seu aplicativo de processo. Atualize qualquer mapeamento de dados inválido e reimplante seu processo por meio de uma nova versão.

Aplicativos do Visual Builder

As APIs do desenvolvedor para o aplicativo Process and Decision são alteradas após a atualização. Como resultado, você deve atualizar quaisquer aplicativos Visual Builder que interajam com eles, substituindo quaisquer padrões de integração obsoletos. Consulte Trabalhar com Processos de Negócios em Criando Aplicativos Responsivos com o Visual Builder Studio.

Para isso, talvez seja necessário avaliar o uso do processo atual. Examine cada um dos aplicativos do Visual Builder e determine se eles estão fazendo chamadas para APIs de desenvolvedor para Processo por meio de Cadeias de Ação, Chamadas Diretas ou usando componentes de processo incorporáveis (também chamados de CCA).

Se seus aplicativos estiverem chamando pontos finais do Processo, execute as seguintes etapas:

1. Estabeleça Conexão com o Processo do Oracle Integration 3.

   Crie uma conexão de backend com o Processo do Oracle Integration 3. Esse backend será usado para estabelecer uma conexão com a nova instância do Processo do Oracle Integration 3. Consulte Connect to Developer APIs for Process Automation no Building Responsive Applications with Visual Builder Studio.

2. Crie uma nova versão de seus aplicativos.

   A Oracle recomenda a criação de uma nova versão de seus aplicativos Visual Builder para implementar as alterações necessárias. Consulte Como Criar Versões de um Aplicativo em Desenvolvendo Aplicativos com o Oracle Visual Builder.

3. Cadeias de ação

   Se o seu aplicativo estiver usando cadeias de ação para iniciar um processo ou executar uma ação em uma tarefa, você precisará substituir cada uma delas por uma Conexão de Serviço baseada em REST. Repita essas etapas para cada tarefa da cadeia de ações do processo.

   Acionando um Processo

   Substitua a cadeia de ações Iniciar Processo por uma Conexão de Serviço baseada em Catálogo.

   1. Navegue até o Oracle Integration Generation 2 e anote o processo que você está chamando. É possível determinar isso na etapa do processo da cadeia de ações ou na guia processos no menu do aplicativo à esquerda.
   2. Crie uma Conexão de Serviço Baseada em Catálogo para seu processo na nova versão do seu aplicativo Visual Builder. Consulte Criar uma Conexão de Serviço com Base em um Catálogo do OCI Process Automation em Criando Aplicativos Responsivos com o Visual Builder Studio. Certifique-se de selecionar o mesmo processo que você estava fazendo referência antes.
      Observação
      
      Seu processo já deverá estar ativado.
   3. Crie um Tipo com base no ponto final do processo acima. Consulte Create a Type from an Endpoint em Developing Applications with Oracle Visual Builder.
   4. Crie uma Variável com base no tipo acima. Consulte Criar Variáveis em Desenvolvendo Aplicativos com o Oracle Visual Builder.
   5. Navegue até suas cadeias de ações e execute as seguintes ações:
      1. Arraste uma Ação Atribuir Variável acima da Ação Iniciar Processo atual.
      2. Mapeie os campos de dados e os parâmetros de entrada necessários para chamar seu processo. Para obter um exemplo, consulte Integrate Oracle Process Automation with Visual Builder.
      3. Arraste a Ação REST de Chamada acima da Ação Iniciar Processo atual.
      4. Configure a Ação REST de Chamada selecionando o ponto final POST/Instâncias.
      5. Mapeie a Variável acima para o corpo da solicitação da Ação REST.
      6. Exclua o Start Process Acton legado.
   6. Teste a chamada e certifique-se de que seu processo esteja sendo chamado com sucesso no Processo do Oracle Integration 3.

   Obter Instância do Processo

   Substitua a cadeia de ações Obter Instância do Processo por uma Conexão de Serviço Baseada em Catálogo.

   Se você criou uma Conexão de Serviço Baseada em Catálogo para seu processo seguindo as etapas acima, notará que o ponto final Obter Instância do Processo agora está disponível em sua conexão de serviço.

   Substitua a Ação Obter Processo da Instância do Processo herdada por uma Ação REST de Chamada configurada com o ponto final acima e remapeie o campo instanceID.

   Observação
   
   Os valores do payload de resposta aqui foram alterados.

   Outras Ações do Processo

   Execute as seguintes etapas para todas as outras Ações do Processo, como Executar Tarefa e Obter Tarefa:

   1. Navegue até o Oracle Integration Generation 2 e anote as Ações do Processo que você está usando.
   2. Substitua essas Ações por Conexões de Serviço baseadas em ponto final.

      A tabela a seguir mapeia cada uma dessas ações para a API do Desenvolvedor correspondente para Processo.

      Ação do Visual Builder	API do Desenvolvedor para Processo	Descrição
      Executar Tarefa	POST /process/api/v1/tasks/{id}/complete	Ações de aprovação, como Aprovar, Rejeitar, etc.
      Executar Tarefa	PUT /process/api/v1/tasks/{id}	Atualizar a Prioridade da Tarefa, a Carga Útil, o Título etc.
      Executar Tarefa	PUT /process/api/v1/tasks/{id}/payload	Atualize o Payload da Tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/claim	Reivindicar uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/release	Liberar uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/request-for-info	Solicitação de informações sobre uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/submit-info	Envie as informações solicitadas para uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/reassign	Reatribuir uma tarefa.
      Obter Coleta de Tarefas	OBTER /process/api/v1/tasks
      Obter Tarefa	OBTER /process/api/v1/tasks/{id}
      Obter Coleta do Processo Implantado	OBTER /process/api/v1/instances
      Obter Coleta de Instâncias do Processo	POST /process/api/v1/instances

4. Chamadas diretas

   As APIs do desenvolvedor para o aplicativo Process and Decision são alteradas após a atualização. Como resultado, você deve atualizar todas as conexões de serviço diretas. Consulte API do Desenvolvedor para Oracle Cloud Infrastructure Process Automation.

5. Componentes CCA

   Se você estiver usando componentes CCA do Processo do Oracle Integration Generation 2, deverá substituí-los pelo componente equivalente do Processo do Oracle Integration 3.

   Nome do Componente	Oracle Integration Generation 2 CCA	Oracle Integration 3 Equivalente ao Processo
   Lista de Tarefas	oj-pcs-task-list	oj-opac-lista de tarefas
   Detalhes da Tarefa	oj-pcs-tarefa-detalhe	oj-opac-detalhe da tarefa
   Lista de aplicativos	oj-pcs-app-list	oj-opac-applist
   Form Inicial	oj-pcs-forma de início	oj-opac-forma inicial
   Lista DP	oj-pcs-dplist	oj-opac-instance-list (Exibe o Processo Estruturado e o Processo Dinâmico)
   Visualização	oj-pcs-visualização	oj-opac-analytics (Não é possível salvar visualizações)

Clientes Não Oracle-Integration

Se você estiver chamando aplicativos de processo de fora do Oracle Integration (por exemplo, seu próprio aplicativo personalizado), será necessário atualizar os pontos finais REST e as políticas de autorização usadas para chamar a instância do Processo do Oracle Integration 3 recém-configurada. Para obter mais informações sobre os novos pontos finais de API e políticas de autorização suportadas, consulte API do Desenvolvedor para o Oracle Cloud Infrastructure Process Automation.

Verificação

Execute um Teste de Integração do Sistema para validar seu trabalho.

Teste a conectividade com o novo ambiente de processo. Esse teste deve se concentrar na validação dos seguintes padrões de interação com base no seu uso:

• Processo do Oracle Integration 3 - Oracle Integration 3 - Integrações
• Oracle Integration 3 - Integrações com o Oracle Integration 3 - Processos
• Visual Builder - Aplicativos para o Processo do Oracle Integration 3 - Processos

Faça o seguinte:

1. Ative e implante alterações do cliente para garantir que todas as novas solicitações orientadas pelo sistema sejam enviadas para o Processo do Oracle Integration 3, conforme descrito anteriormente.
2. Comunique o novo URL do Oracle Integration 3 Process Workspace aos usuários e certifique-se de que os usuários:
   • Marque o espaço de trabalho do Processo do Oracle Integration 3.
   • Crie novos processos somente no Processo do Oracle Integration 3.
   • Conclua suas novas tarefas no Processo do Oracle Integration 3.
3. Desative os aplicativos do Oracle Integration Generation 2 para que nenhum novo processo possa ser criado, mas os existentes possam ser concluídos. Consulte Gerenciar Aplicações Ativas em Usando Processos no Oracle Integration 2.

Durante esse tempo:

• As novas instâncias de processo serão atendidas pelo Processo do Oracle Integration 3.
• As instâncias de processo existentes continuarão a ser executadas no Processo do Oracle Integration Generation 2 até que sejam concluídas.

Durante esse período, os usuários do Processo devem:

• Trabalhe principalmente no Espaço de Trabalho do Oracle Integration 3 Process.
• Ocasionalmente, verifique a Lista Minhas Tarefas do Oracle Integration Generation 2.
• Conte com aprovações baseadas em email, tanto quanto possível, pois os links nos emails os levarão ao lugar certo para executar a tarefa.

O período de coexistência dura até que todas as transações criadas no Oracle Integration Generation 2 sejam concluídas. Você deve procurar ativamente encurtar a duração deste período, tanto quanto possível. Aqui estão algumas diretrizes:

• Impedir a criação de novas transações no Oracle Integration Generation 2 usando a funcionalidade Retirar. Isso se aplica a todos os processos estruturados que não contêm atividades de recebimento. A funcionalidade de baixa impede a criação de novas instâncias, mas também permite a conclusão de transações existentes. Consulte Gerenciar Aplicações Ativas em Usando Processos no Oracle Integration 2.
• O objetivo é agilizar ativamente a conclusão das instâncias do Oracle Integration Generation 2, tanto quanto possível, acompanhando os usuários para tomar medidas que os permitam concluir. Você pode ver o número de transações em aberto por processo e o responsável pelas tarefas associadas usando um novo relatório que estará disponível se você navegar até Processo, Administração e Relatório de Migração.
• Para processos de execução muito longa, as instâncias que não podem ser concluídas em vários meses, explore as seguintes opções:
  • Recrie a instância no Processo do Oracle Integration 3 e use a funcionalidade Alterar Fluxo para atualizar a carga útil e mover a instância do processo para a ação atual (onde ela está no momento no Processo do Oracle Integration Generation 2). Depois que isso for feito, a instância existente do Oracle Integration Generation 2 poderá ser encerrada. Consulte Alterar o Fluxo de um Processo no Usando o Oracle Cloud Infrastructure Process Automation.
  • Modifique o aplicativo migrado para que ele possa ser iniciado usando o estado mais recente da instância do processo existente do Oracle Integration Generation 2.

Você pode rastrear as transações restantes do processo do Oracle Integration Generation 2 clicando em Minhas Tarefas e, em seguida, escolhendo Processos na sua instância do Oracle Integration Generation 2. Você deve se conectar com um usuário que tenha a Função de Administrador de Serviço.

Você pode mover seus aplicativos do Processo para o Oracle Integration 3 antes de 31 de dezembro de 2026 ativando o Processo no Oracle Integration 3. Consulte Ativar Processo com o Oracle Integration 3. Para obter informações sobre como exportar ou importar artefatos de design-time do aplicativo de Processo, consulte Migrar Todos os Pontos Finais REST de Aplicativos.

Salve dados de runtime do Processo do Oracle Integration Generation 2. Esta etapa é importante para garantir que você não perca o histórico de transações concluídas. Você deve fazer este antes upgrade. Consulte Arquivando e Expurgando Dados de Automação de Processos no Oracle Integration.

Como parte dessas etapas, você configurará o Oracle Storage Service e programará instâncias para arquivamento e expurgação. Lembre-se dos seguintes pontos:

• As informações arquivadas estarão disponíveis no bucket configurado do Object Storage.
• Os anexos não estão incluídos nos arquivos compactados. Você deve exportá-los manualmente. Consulte Recuperar um Anexo de Processo como um Fluxo na API REST para Oracle Integration 2.