Para obter mais detalhes sobre essa recomendação, consulte Perguntas Frequentes sobre Upgrade.

1. Crie uma nova instância independente do OCI Process Automation.

   Consulte Provisionar uma Instância do Serviço Process Automation em Administrando o Oracle Cloud Infrastructure Process Automation.

   Quando você cria a instância:

   • Selecione um modelo de medição com base em um Pacote de Execução para aproveitar o preço do nível gratuito durante o upgrade.
   • O usuário que cria a instância stand-alone do OCI Process Automation deve ser do mesmo domínio de identidades que o usuário que criou sua instância do Oracle Integration Generation 2.
   • Você deve criar a instância standalone do OCI Process Automation na mesma tenancy, na mesma região e, de preferência, no mesmo compartimento da sua instância do Oracle Integration Generation 2.

     Se você não usar o mesmo compartimento, certifique-se de que o usuário que cria a instância do OCI Process Automation tenha permissões para gerenciar a instância do Oracle Integration e a instância do OCI Process Automation.

     Você gerencia essas permissões com políticas do serviço IAM.

     Para o Oracle Integration:

     • allow group domain-name/group_name to manage integration-instance in compartment compartment-name
     • allow group domain-name/group_name to manage integration-instance in tenancy

     Por exemplo:

     • allow group admin/oci-integration-admins to manage integration-instance in tenancy

     Para Automação de Processo do OCI:

     • allow group domain-name/group_name to manage process-automation-instance in compartment compartment-name
     • allow group domain-name/group_name to manage process-automation-instance in tenancy

     Por exemplo:

     • allow group admin/oci-integration-admins to manage process-automation-instance in tenancy
2. Conceda aos desenvolvedores acesso ao OCI Process Automation.

   Para garantir que seus desenvolvedores possam acessar a instância recém-provisionada do OCI Process Automation e possam trabalhar em tarefas subsequentes, certifique-se de que eles tenham a atribuição de aplicativo apropriada para acessar a instância. Consulte Designar Atribuições de Aplicativo a Grupos em um Domínio de Identidades em Administrando o Oracle Cloud Infrastructure Process Automation.

3. Registre uma instância sem produção do Oracle Integration Generation 2 para teste.

   Se seus aplicativos de processo estiverem chamando integrações existentes, registre o Oracle Integration Generation 2 na nova instância do OCI Process Automation. Isso permite que sua instância do OCI Process Automation se conecte e descubra suas integrações existentes.

   Certifique-se de usar uma instância não de produção do Oracle Integration Generation 2 para registro de serviço nesta etapa. Certifique-se de que o registro da instância selecionada do Oracle Integration Generation 2 não afete negativamente nenhum processo na produção.

   1. Escolha uma instância do Oracle Integration Generation 2 sem produção a ser registrada.
   2. Na Console do Oracle Cloud Infrastructure, localize e anote o OCID da instância selecionada do Oracle Integration Generation 2.
   3. No OCI Process Automation, registre a instância do Oracle Integration Generation 2. Consulte Registrar Serviços em Usando o Oracle Cloud Infrastructure Process Automation.
      Observação
      
      Talvez você queira criar um usuário ServiceAccount dedicado para esta conexão.

1. Determine quais aplicativos você deseja migrar.

   Você pode querer aproveitar esta oportunidade para se livrar de aplicativos desnecessários. Pense se você deseja migrar apenas os aplicativos que estão em seu ambiente de produção ou se também deseja migrar aplicativos que estão em teste e desenvolvimento.

   Se você quiser migrar aplicativos individuais, anote os aplicativos que deseja migrar e as dependências que eles têm.

2. Migre seus aplicativos usando um dos seguintes métodos:
   • Migre todos os aplicativos em massa
     1. Na Console do Oracle Cloud Infrastructure, crie um bucket de Armazenamento de Objetos. Consulte Criando um Bucket de Armazenamento de Objetos.

        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 OCI (Oracle Cloud Infrastructure).
        • namespace é a tenancy na qual 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 está concluído quando vir o arquivo process_status.json em seu bucket. Esse 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 à 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 REST para o Oracle Cloud Infrastructure Process Automation.

     4. Aguarda 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 do 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 você deseja migrar. Consulte Exportar um Aplicativo em Usando Processos no Oracle Integration Generation 2.

     2. Importe os aplicativos de processo para o OCI Process Automation.

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

        A OCI Process Automation 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 forem concluídas, você verá um relatório de migração mostrando o que foi importado com sucesso, o que precisa de trabalho adicional e quaisquer itens que não puderam ser migrados. Isso dá a você 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 em Usando o Oracle Cloud Infrastructure Process Automation.

As Atribuições de Aplicativo foram significativamente alteradas no OCI Process Automation. 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 funções do Oracle Integration Generation 2 são mapeadas para as funções do OCI Process Automation.

As novas atribuições estão disponíveis após a migração, mas você precisa adicionar membros (usuários e grupos) a elas. Provavelmente, você 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 OCI Process Automation compartilhar o mesmo domínio de identidades que 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 depois da 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 OCI Process Automation, consulte Configurar Atribuições para Aplicativos de Processos em Usando o Oracle Cloud Infrastructure Process Automation.

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

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

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

   Para resolver problemas de validação, consulte Como a Atualização 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 em 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

APIs de processo e pontos finais foram alterados após o upgrade. É necessário reconfigurar a integração usando o assistente de chamada do Process Automation. Consulte Reconfigurar a Integração.

Integrações Chamadas por Processo

O OCI Process Automation 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 trigger SOAP e elas forem chamadas por processos no Oracle Integration Generation 2, precisará executar etapas adicionais para apresentar uma interface baseada em REST ao OCI Process Automation. Isso pode significar que você precisa fazer um dos seguintes:

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

  ou

• Altere o trigger existente de SOAP para REST.

Além disso, para que o registro de serviço funcione conforme esperado, certifique-se de que o trigger REST utilize a política OAuth 2.0 ou Segurança de Autenticação Básica.

Aplicativos Visual Builder

Os pontos finais da API do processo são alterados após o upgrade. Como resultado, você deve atualizar quaisquer aplicativos do 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 fazer isso, talvez seja necessário avaliar o uso do processo atual. Examine cada um dos seus aplicativos Visual Builder e determine se eles estão fazendo chamadas para processar APIs por meio de Cadeias de Ação, Chamadas Diretas ou usando componentes de processo incorporáveis (também conhecidos como CCA).

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

1. Conecte-se ao OCI Process Automation.

   Crie uma conexão de backend com o OCI Process Automation. Esse backend será usado para estabelecer uma conexão com a nova instância do OCI Process Automation. Consulte Estabelecer Conexão com APIs do Oracle Process Automation em Criando Aplicativos Responsivos com o Visual Builder Studio.

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

   A Oracle recomenda criar uma nova versão de seus aplicativos do 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 seu aplicativo estiver usando cadeias de ações 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. Você pode determinar isso na etapa do processo da cadeia de ações ou na guia de 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 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 estava fazendo referência antes.
      Observação
      
      Seu processo já deve estar ativado.
   3. Crie um Tipo com base no ponto final do processo acima. Consulte Criar um Tipo com Base em um Ponto Final em Desenvolvendo Aplicativos com o 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 Integrar o Oracle Process Automation com o 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 OCI Process Automation.

   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 com seu processo seguindo as etapas acima, observará que o ponto final Obter Instância do Processo agora está disponível em sua conexão de serviço.

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

   Observação
   
   Os valores de 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 OCI Process Automation correspondente.

      Ação do Visual Builder	API REST do OCI Process Automation	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}	Atualize a Prioridade da Tarefa, Carga Útil, Título e tal.
      Executar Tarefa	PUT /process/api/v1/tasks/{id}/payload	Atualize o Payload da Tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/claim	Solicite uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/release	Libere uma tarefa.
      Executar Tarefa	POST /process/api/v1/tasks/{id}/request-for-info	Solicitação de informações em 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	Redesignar uma tarefa.
      Obter Coleta de Tarefas	OBTENHA /process/api/v1/tasks
      Obter Tarefa	OBTER /process/api/v1/tasks/{id}
      Obter Coleta do Processo Implantado	OBTENHA /process/api/v1/instances
      Obter Coleta da Instância do Processo	POST /process/api/v1/instances

4. Chamadas Diretas

   As APIs de processo e os pontos finais mudam após o upgrade. Como resultado, você deve atualizar qualquer conexão de serviço direta. Consulte API REST do Oracle Cloud Infrastructure Process Automation.

5. Componentes CCA

   Se você estiver usando componentes CCA do Processo do Oracle Integration Generation 2, deverá substituí-los por seu componente equivalente do OCI Process Automation.

   Nome do Componente	CCA do Oracle Integration Generation 2	Equivalente ao OCI Process Automation
   Lista de Tarefas	oj-pcs-tarefa-lista	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-início-forma	forma oj-opac-início
   Lista DP	oj-pcs-dplist	oj-opac-instance-list (Exibe Processo Estruturado e 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 autenticação usadas para chamar a instância recém-configurada do OCI Process Automation. Para obter mais informações sobre os novos pontos finais de API e as políticas de autenticação suportadas, consulte API REST do 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. Este teste deve se concentrar na validação dos seguintes padrões de interação com base em seu uso:

• OCI Process Automation - Processos para o Oracle Integration Generation 2 - Integrações
• Oracle Integration Generation 2 - Integrações ao OCI Process Automation - Processos
• Visual Builder - Aplicativos para OCI Process Automation - Processos