Para obtener más información sobre esta recomendación, consulte Preguntas frecuentes sobre el cambio de versión.

1. Cree una nueva instancia autónoma de OCI Process Automation.

   Consulte Aprovisionamiento de una instancia de automatización de proceso en Administración de Oracle Cloud Infrastructure Process Automation.

   Al crear la instancia:

   • Seleccione un modelo de medición basado en un paquete de ejecución para aprovechar los precios gratuitos durante la actualización.
   • El usuario que crea la instancia autónoma de OCI Process Automation debe ser del mismo dominio de identidad que el usuario que ha creado la instancia de Oracle Integration Generation 2.
   • Debe crear la instancia autónoma de OCI Process Automation en el mismo arrendamiento, la misma región y, preferiblemente, el mismo compartimento que la instancia de Oracle Integration Generation 2.

     Si no utiliza el mismo compartimento, asegúrese de que el usuario que crea la instancia de OCI Process Automation tiene permisos para gestionar tanto la instancia de Oracle Integration como la instancia de OCI Process Automation.

     Puede gestionar estos permisos con las políticas de IAM.

     En 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 ejemplo:

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

     En OCI Process Automation:

     • 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 ejemplo:

     • allow group admin/oci-integration-admins to manage process-automation-instance in tenancy
2. Otorgue a los desarrolladores acceso a OCI Process Automation.

   Para garantizar que los desarrolladores puedan acceder a la instancia de OCI Process Automation recién aprovisionada y puedan trabajar en tareas posteriores, asegúrese de que se les asigna el rol de aplicación adecuado para acceder a la instancia. Consulte Asignación de roles de aplicación a grupos en un dominio de identidad en Administración de Oracle Cloud Infrastructure Process Automation.

3. Registre una instancia de Oracle Integration Generation 2 de no producción para realizar pruebas.

   Si las aplicaciones de proceso llaman a integraciones existentes, registre Oracle Integration Generation 2 en la nueva instancia de OCI Process Automation. Esto permite a la instancia de OCI Process Automation conectarse y detectar las integraciones existentes.

   Asegúrese de utilizar una instancia de Oracle Integration Generation 2 de no producción para el registro de servicio en este paso. Asegúrese de que el registro de la instancia de Oracle Integration Generation 2 seleccionada no afecte negativamente a ningún proceso de producción.

   1. Seleccione una instancia de Oracle Integration Generation 2 de no producción para registrarla.
   2. En la consola de Oracle Cloud Infrastructure, busque y tome nota del OCID de la instancia de Oracle Integration Generation 2 seleccionada.
   3. En OCI Process Automation, registre la instancia de Oracle Integration Generation 2. Consulte Registro de servicios en Uso de Oracle Cloud Infrastructure Process Automation.
      Nota
      
      Puede que desee crear un usuario ServiceAccount dedicado para esta conexión.

1. Determine qué aplicaciones desea migrar.

   Es posible que desee aprovechar esta oportunidad para deshacerse de las aplicaciones innecesarias. Piense si desea migrar solo las aplicaciones que están en su entorno de producción o si también desea migrar aplicaciones que están en prueba y desarrollo.

   Si va a migrar aplicaciones individuales, tome nota de las aplicaciones que desea migrar y de las dependencias que tengan.

2. Migre las aplicaciones mediante uno de los siguientes métodos:
   • Migrar todas las aplicaciones de forma masiva
     1. En la consola de Oracle Cloud Infrastructure, cree un cubo de Object Storage. Consulte Creación de un cubo de Object Storage.

        La URL del cubo de almacenamiento que necesitará en el siguiente paso tiene el siguiente formato:

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

        Donde:

        • region es el identificador del centro de datos de Oracle Cloud Infrastructure (OCI).
        • namespace es el arrendamiento en el que ha creado el cubo.
        • bucket es el nombre del cubo.
     2. Realice una solicitud POST en la instancia de Oracle Integration Generation 2 para exportar las aplicaciones:

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

        Con la siguiente carga útil:

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

        Sabrá que el trabajo de exportación se ha completado cuando vea el archivo process_status.json en el cubo. Este archivo contiene el estado del trabajo, su porcentaje de finalización y, si se produce un error, el mensaje de error. También debería ver el siguiente contenido en el cubo:

        • Process/project folder: contiene todas las aplicaciones de proceso.
        • Process/dmn folder: contiene todos los modelos de decisión.
     3. Después de exportar las aplicaciones al cubo, realice una solicitud POST a la instancia de Oracle Integration 3 para migrar las aplicaciones:

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

        Con su ID de inquilino:

        x-tenant-id: tenant_OCID

        Y la información de su cubo:

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

        Consulte Seguridad, autenticación y autorización en API de REST para Oracle Cloud Infrastructure Process Automation.

     4. Esperar hasta que se termine el trabajo de migración. Para comprobar el estado del trabajo de migración:

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

   • Migración de aplicaciones individuales
     1. Exporte las aplicaciones de proceso de Oracle Integration Generation 2.

        En la instancia de Oracle Integration Generation 2 que incluye las aplicaciones que desea migrar, exporte cada aplicación que desee migrar. Consulte Exportación de una aplicación en Uso de procesos en Oracle Integration Generation 2.

     2. Importe las aplicaciones de proceso a OCI Process Automation.

        En OCI Process Automation, importe las aplicaciones de proceso de Oracle Integration Generation 2. Consulte Importación de una aplicación en Uso de Oracle Cloud Infrastructure Process Automation.

        OCI Process Automation convierte las aplicaciones de proceso heredadas a la última versión del producto.

3. Consulte el informe de migración.

   Cuando finalice la importación y la conversión, verá un informe de migración que muestra lo que se importó correctamente, lo que necesita trabajo adicional y los elementos que no se pudieron migrar. Esto le da una idea de los problemas de migración que tendrá que manejar.

   Puede volver al informe de migración original en el menú principal. Consulte Importación de una aplicación en Uso de Oracle Cloud Infrastructure Process Automation.

Los roles de aplicación han cambiado significativamente en OCI Process Automation. Los roles ProcessOwner, AnalyticsViewer y ProcessReviewer ahora están definidos explícitamente para cada aplicación, lo que permite controlar sus miembros y permisos.

En la siguiente tabla se muestra cómo se asignan los roles de Oracle Integration Generation 2 a los roles de OCI Process Automation.

Los nuevos roles están disponibles después de la migración, pero debe agregarles miembros (usuarios y grupos). Probablemente tendrá que hacer referencia al entorno de Oracle Integration Generation 2 para ver qué miembros se deben asignar a cada rol.

Si OCI Process Automation comparte el mismo dominio de identidad que la instancia existente de Oracle Integration Generation 2, los usuarios y grupos existentes deben estar disponibles para su selección.

Puede agregar miembros antes de la activación en el diseñador o después de la activación en el espacio de trabajo.

• Trabajar con roles en el diseñador
• Gestionar Roles en Espacio de Trabajo

Para obtener más información sobre OCI Process Automation, consulte Configuración de roles para aplicaciones de proceso en Uso de Oracle Cloud Infrastructure Process Automation.

Para validar y activar las aplicaciones de proceso, realice los siguientes pasos:

1. Valide cada aplicación y corrija los errores y advertencias.

   Valide cada aplicación desde el diseñador haciendo clic en y seleccionando Validar en el menú.

   Para resolver problemas de validación, consulte How Upgrade Affects Process Features.

2. Active la aplicación.

   Una vez resueltos todos los errores de validación, puede activar la aplicación. Consulte Activación de aplicaciones en Uso de Oracle Cloud Infrastructure Process Automation.

• Proceso de llamadas de integraciones
• Integraciones llamadas por proceso
• Aplicaciones de Visual Builder
• Clientes que no son de Oracle-Integration
• Verificación

Proceso de llamadas de integraciones

Las API y los puntos finales de proceso han cambiado después del cambio de versión. Debe volver a configurar la integración mediante el asistente de llamadas de Process Automation. Consulte Volver a configurar la integración.

Integraciones llamadas por proceso

OCI Process Automation soporta la comunicación basada en REST solo mediante el registro de servicio. Esto significa que la conectividad a integraciones basadas en SOAP ya no será posible.

Si tiene integraciones que utilizan un disparador de SOAP y los llaman los procesos de Oracle Integration Generation 2, deberá realizar pasos adicionales para presentar una interfaz basada en REST a OCI Process Automation. Esto puede significar que debe realizar una de las siguientes acciones:

• Cree integraciones de envoltorio basadas en REST.

  or

• Cambie el disparador existente de SOAP a REST.

Además, para que el registro del servicio funcione como se esperaba, asegúrese de que el disparador REST utilice la política de seguridad de autenticación básica o OAuth 2.0.

Aplicaciones de Visual Builder

Los puntos finales de la API de proceso cambian después del cambio de versión. Como resultado, debe actualizar cualquier aplicación de Visual Builder que interactúe con ellas, sustituyendo cualquier patrón de integración en desuso. Consulte Trabajar con procesos de negocio en Creación de aplicaciones ajustables con Visual Builder Studio.

Para ello, puede que necesite evaluar el uso actual del proceso. Examine cada una de las aplicaciones de Visual Builder y determine si están realizando llamadas para procesar API a través de cadenas de acción, llamadas directas o mediante componentes de proceso incrustables (también denominados CCA).

Si las aplicaciones llaman a puntos finales de proceso, realice los siguientes pasos:

1. Conéctese a OCI Process Automation.

   Cree una conexión de backend a OCI Process Automation. Este backend se utilizará para establecer una conexión a la nueva instancia de OCI Process Automation. Consulte Conexión a las API de automatización de Oracle Process en Creación de aplicaciones con capacidad de respuesta con Visual Builder Studio.

2. Crear una nueva versión de las aplicaciones.

   Oracle recomienda crear una nueva versión de las aplicaciones de Visual Builder para implantar los cambios necesarios. Consulte Cómo crear versiones de una aplicación en Desarrollo de aplicaciones con Oracle Visual Builder.

3. Cadenas de acción

   Si la aplicación utiliza cadenas de acción para iniciar un proceso o realizar acciones en una tarea, deberá sustituir cada una de ellas por una conexión de servicio basada en REST. Repita estos pasos para cada tarea de cadena de acción de proceso.

   Disparo de un proceso

   Sustituya la cadena de acción Start Process por una conexión de servicio basada en catálogo.

   1. Vaya a Oracle Integration Generation 2 y tome nota del proceso al que está llamando. Puede determinar esto desde el paso de proceso de cadena de acción o desde el separador de procesos del menú de aplicación de la izquierda.
   2. Cree una conexión de servicio basada en catálogo para el proceso en la nueva versión de la aplicación Visual Builder. Consulte Creación de una conexión de servicio a partir de un catálogo de automatización de procesos de OCI en Creación de aplicaciones con capacidad de respuesta con Visual Builder Studio. Asegúrese de seleccionar el mismo proceso al que hacía referencia anteriormente.
      Nota
      
      El proceso ya debe estar activado.
   3. Cree un tipo basado en el punto final del proceso anterior. Consulte Creación de un tipo a partir de un punto final en Desarrollo de aplicaciones con Oracle Visual Builder.
   4. Cree una variable basada en el tipo anterior. Consulte Creación de variables en Desarrollo de aplicaciones con Oracle Visual Builder.
   5. Navegue a las cadenas de acciones y realice las siguientes acciones:
      1. Arrastre una acción Asignar variable sobre la acción Iniciar proceso actual.
      2. Correlación de los campos de datos y parámetros de entrada necesarios para llamar al proceso. Para ver un ejemplo, consulte Integración de Oracle Process Automation con Visual Builder.
      3. Arrastre la acción REST de llamada sobre la acción de inicio de proceso actual.
      4. Configure la acción REST de llamada seleccionando el punto final POST/Instances.
      5. Asigne la variable anterior al cuerpo de solicitud de la acción de REST.
      6. Suprima el valor de Start Process Acton heredado.
   6. Pruebe la llamada y asegúrese de que el proceso se llama correctamente en OCI Process Automation.

   Instancia de proceso GET

   Sustituya la cadena de acción Get Process Instance por una conexión de servicio basada en catálogo.

   Si ha creado una conexión de servicio basada en catálogo para el proceso siguiendo los pasos anteriores, observará que el punto final Obtener instancia de proceso ya está disponible en la conexión de servicio.

   Sustituya la acción Obtener proceso de instancia de proceso heredada por una acción REST de llamada configurada con el punto final anterior y vuelva a asignar el campo instanceID.

   Nota
   
   Los valores de carga útil de respuesta aquí han cambiado.

   Otras Acciones de Proceso

   Realice los siguientes pasos para todas las demás acciones de proceso, como Realizar tarea y Obtener tarea:

   1. Vaya a Oracle Integration Generation 2 y tome nota de las acciones de proceso que está utilizando.
   2. Sustituya estas acciones por conexiones de servicio basadas en punto final.

      En la siguiente tabla se asigna cada una de estas acciones a la API de OCI Process Automation correspondiente.

      Acción de Visual Builder	API de REST de OCI Process Automation	Descripción
      Realizar tarea	POST /process/api/v1/tasks/{id}/complete	Acciones de aprobación, como Aprobar, Rechazar, etc.
      Realizar tarea	PUT /process/api/v1/tasks/{id}	Actualice la prioridad de tarea, la carga útil, el título, etc.
      Realizar tarea	PUT /process/api/v1/tasks/{id}/payload	Actualice la carga útil de tarea.
      Realizar tarea	POST /process/api/v1/tasks/{id}/claim	Reclamación de una Tarea.
      Realizar tarea	POST /process/api/v1/tasks/{id}/release	Liberar una tarea.
      Realizar tarea	POST /process/api/v1/tasks/{id}/request-for-info	Solicitud de información sobre una tarea.
      Realizar tarea	POST /process/api/v1/tasks/{id}/submit-info	Envíe la información solicitada para una tarea.
      Realizar tarea	POST /process/api/v1/tasks/{id}/reassign	Volver a asignar una tarea.
      Obtener recopilación de tareas	OBTENER /process/api/v1/tasks
      Obtener tarea	OBTENER /process/api/v1/tasks/{id}
      Obtener recopilación de procesos desplegados	OBTENER /process/api/v1/instances
      Obtener recopilación de instancias de proceso	POST /process/api/v1/instances

4. Llamadas directas

   Las API de proceso y los puntos finales cambian después del cambio de versión. Como resultado, debe actualizar las conexiones de servicio directas. Consulte API de REST para Oracle Cloud Infrastructure Process Automation.

5. Componentes de CCA

   Si utiliza componentes de Oracle Integration Generation 2 Process CCA, debe sustituirlos por su componente equivalente de OCI Process Automation.

   Componente Nombre	CCA de Oracle Integration Generation 2	Equivalente a OCI Process Automation
   Lista de Tareas	oj-pcs-task-list	oj-opac-lista de tareas
   Detalle de Tarea	oj-pcs-tarea-detalle	oj-opac-tarea-detalle
   Lista de apps	oj-pcs-app-list	oj-opac-applist
   Iniciar formulario	oj-pcs-start-formulario	oj-opac-start-formulario
   Lista de DP	oj-pcs-dplist	oj-opac-instance-list (muestra el proceso estructurado y el proceso dinámico)
   Visualización	oj-pcs-visualización	oj-opac-analytics (no se pueden guardar visualizaciones)

Clientes que no son de Oracle-Integration

Si llama a aplicaciones de proceso desde fuera de Oracle Integration (por ejemplo, su propia aplicación personalizada), debe actualizar los puntos finales de REST y las políticas de autenticación utilizadas para llamar a la instancia de OCI Process Automation recién configurada. Para obtener más información sobre los nuevos puntos finales de API y las políticas de autenticación soportadas, consulte API de REST para Oracle Cloud Infrastructure Process Automation.

Verificación

Realice una prueba de integración del sistema para validar el trabajo.

Pruebe la conectividad al nuevo entorno de proceso. Esta prueba debe centrarse en validar los siguientes patrones de interacción en función de su uso:

• Automatización de procesos de OCI: procesos a Oracle Integration Generation 2 - Integraciones
• Oracle Integration Generation 2 - Integraciones con OCI Process Automation - Procesos
• Visual Builder - Aplicaciones a OCI Process Automation - Procesos