Actualización a Oracle Integration 3: Fase 2

Cuando está activada, una instancia de proceso se aprovisiona automáticamente con la instancia de Oracle Integration. En tal caso, los dos servicios se asocian entre sí y se muestran en la página de servicios asociados de cada uno en la consola de Oracle Cloud.

Configuración de políticas de IAM para gestionar la instancia de proceso

Para activar el proceso con Oracle Integration, debe crear políticas de Oracle Cloud Infrastructure Identity and Access Management (IAM) que permitan a los administradores de Oracle Integration que pertenecen a un grupo de IAM especificado gestionar la instancia de proceso.

Configure las siguientes políticas de IAM para Process:

Consulte Acerca de las políticas de IAM para Process Automation y Creación de una política de IAM en un dominio de identidad en Administración de Oracle Cloud Infrastructure Process Automation.

Para obtener información sobre las políticas de IAM para Oracle Integration, consulte Acerca de las políticas de IAM para Oracle Integration y Creación de una política de IAM en un dominio de identidad para Oracle Integration.

Activar proceso

Para activar una instancia de proceso con una instancia de Oracle Integration:

1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Integración de aplicación, haga clic en Integración.
2. En la lista desplegable Compartimento, seleccione el compartimento en el que desea aprovisionar y activar una instancia de proceso con una instancia de Oracle Integration. La página se refresca para mostrar cualquier instancia de servicio existente en el compartimento seleccionado.
3. Seleccione una instancia existente o cree una instancia de Oracle Integration y selecciónela. Se abrirá la página de detalles de la instancia de integración.
4. Haga clic en el enlace Activar del proceso en el separador Información de instancia de integración.
5. Cuando se le solicite, haga clic en Activar para confirmar que desea activar el proceso. Tenga en cuenta lo siguiente:
   • El icono de Oracle Integration cambia a naranja y su estado cambia a Actualizando.
   • La activación puede tardar varios minutos en completarse.
   • Una vez finalizada, es decir, cuando una instancia de proceso se activa y aprovisiona con la instancia de Oracle Integration, el icono de Oracle Integration vuelve a cambiar a verde con un estado Activo y el proceso se muestra como Activado.
6. Para navegar a la instancia de proceso que se acaba de crear, haga clic en Servicios asociados en Recursos.
7. Seleccione la instancia de proceso y consulte sus detalles.

Asignar roles de aplicación de IDCS para gestionar el acceso

Después de activar una instancia de proceso, asigne roles de aplicación de IDCS predefinidos a los usuarios para que puedan trabajar con las funciones de la instancia de proceso.

En curso, hay dos roles de aplicación de IDCS predefinidos: ServiceDeveloper y ServiceAdministrator. Estos roles se deben asignar a usuarios o grupos en la aplicación de instancia de servicio de proceso desde la consola de administración de Oracle Identity Cloud Service (IDCS).

Como práctica recomendada, se recomienda asignar estos roles a grupos, en lugar de a usuarios individuales. Por ejemplo, asigne el rol de aplicación de IDCS ServiceDeveloper a un grupo en las aplicaciones de instancia de servicio de Oracle Integration y Process desde la consola de administración de Oracle Identity Cloud Service. De esta forma, será más fácil gestionar el acceso de los usuarios, ya que cualquier usuario que sea miembro del grupo puede acceder al tiempo de diseño de Oracle Integration y Process.

1. Determine qué aplicaciones desea migrar.

   Es posible que desee aprovechar esta oportunidad para limpiar aplicaciones innecesarias. Piense si desea migrar solo las aplicaciones que se encuentran en su entorno de producción.

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

2. Migre sus aplicaciones mediante uno de los siguientes métodos:
   • Migrar todas las aplicaciones de forma masiva
     1. En la consola de Oracle Cloud, 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 de su 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 a 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 falla, 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. Una vez que las aplicaciones se hayan exportado al cubo, realice una solicitud POST en 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 del cubo:

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

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

     4. Espere a que finalice 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

   • Migrar 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 Using Processes in Oracle Integration Generation 2.

     2. Importe las aplicaciones de proceso al proceso de Oracle Integration 3.

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

        Oracle Integration 3 Process convierte las aplicaciones de proceso heredadas a la última versión del producto.

3. Revise 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 artículos 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 Importar una aplicación en Uso de Oracle Cloud Infrastructure Process Automation.

Validar y activar aplicaciones de proceso importadas

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.

   Después de resolver todos los errores de validación, puede activar la aplicación. Consulte Activar aplicaciones en Uso de Oracle Cloud Infrastructure Process Automation.

Asignar usuarios y grupos a nuevos roles de aplicación

Los roles de aplicación han cambiado significativamente en Oracle Integration 3. Los roles ProcessOwner, AnalyticsViewer y ProcessReviewer ahora se definen 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 proceso de Oracle Integration 3.

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 el proceso de Oracle Integration 3 comparte el mismo dominio de identidad que la instancia de Oracle Integration Generation 2 existente, 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.

• Trabajo con roles en diseñador
• Gestionar roles en espacio de trabajo

Para obtener información adicional sobre el proceso de Oracle Integration 3, consulte Configuración de roles para aplicaciones de proceso en Uso de Oracle Cloud Infrastructure Process Automation.

Realice los pasos que se aplican a la implantación:

• 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 integraciones que llaman a procesos en Oracle Integration 3 deberán actualizarse para utilizar la nueva acción de proceso. Para ello, cree una nueva versión principal de la integración, agregue la nueva acción de proceso y haga referencia al proceso que desea iniciar desde Oracle Integration 3. Elimine la acción de proceso heredada y active la integración.

Integraciones Llamadas por Proceso

El proceso de Oracle Integration 3 solo admite la comunicación basada en REST 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 estas son llamadas por procesos de Oracle Integration Generation 2, deberá realizar pasos adicionales para presentar una interfaz basada en REST al proceso de Oracle Integration 3. Esto puede significar que debe realizar una de las siguientes acciones:

• Cree integraciones de envoltorio basadas en REST.

  o

• Cambie el disparador existente de SOAP a REST.

Revise todas las conexiones de integración en las aplicaciones de proceso migradas. Refresque los metadatos de conexión y asegúrese de que la última definición se incluye en la aplicación de proceso. Actualice las asignaciones de datos no válidas y vuelva a desplegar el proceso mediante una nueva versión.

Aplicaciones de Visual Builder

Las API de desarrollador para la aplicación Process y Decision cambian después de la actualizació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 Trabajo con procesos de negocio en Creación de aplicaciones adaptables con Visual Builder Studio.

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

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

1. Conéctese al proceso de Oracle Integration 3.

   Cree una conexión de backend al proceso Oracle Integration 3. Este backend se utilizará para establecer una conexión a la nueva instancia de proceso de Oracle Integration 3. Consulte Conexión a API de desarrollador para la automatización de procesos en Creación de aplicaciones adaptables con Visual Builder Studio.

2. Cree 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 Iniciar proceso por una conexión de servicio basada en catálogo.

   1. Vaya a Oracle Integration Generation 2 y tome nota del proceso que está llamando. Puede determinar esto desde el paso de proceso de la cadena de acción o desde el separador Procesos del menú de la aplicación de la izquierda.
   2. Cree una conexión de servicio basada en catálogo al proceso en la nueva versión de la aplicación Visual Builder. Consulte Creación de una conexión de servicio desde un catálogo de automatización de procesos de OCI en Creación de aplicaciones ajustables 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 desde 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 por encima de la acción Iniciar proceso actual.
      2. Asigne los campos de datos y los 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 de llamada REST 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 la solicitud de la acción REST.
      6. Suprima la acción de proceso de inicio heredada.
   6. Pruebe la llamada y asegúrese de que el proceso se llama correctamente en el proceso de Oracle Integration 3.

   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 con 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 de proceso de obtención de instancia de proceso heredada por una acción de llamada REST 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.

      La siguiente tabla asigna cada una de estas acciones a la API de desarrollador correspondiente para el proceso.

      Acción de Visual Builder	API de desarrollador para procesos	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 la 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	Reclamar 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	Reasignar una tarea
      Obtener recopilación de tareas	OBTENER /process/api/v1/tasks
      Obtener tarea	GET /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 desarrollador para la aplicación Process y Decision cambian después de la actualización. Como resultado, debe actualizar las conexiones de servicio directo. Consulte API de desarrollador para Oracle Cloud Infrastructure Process Automation.

5. Componentes de CCA

   Si utiliza componentes de CCA de proceso de Oracle Integration Generation 2, debe sustituirlos por su componente de proceso equivalente de Oracle Integration 3.

   Nombre de componente	CCA de Oracle Integration Generation 2	Equivalente al proceso de Oracle Integration 3
   Lista Tareas	oj-pcs-task-list	lista de tareas de oj-opac
   Detalles de Tarea	oj-pcs-task-detail	oj-opac-task-detail
   Lista de apps	oj-pcs-app-list	oj-opac-applist
   Formulario de inicio	oj-pcs-start-form	oj-opac-start-form
   Lista de DP	oj-pcs-dplist	oj-opac-instance-list (muestra tanto el proceso estructurado como el dinámico)
   Visualización	oj-pcs-visualización	oj-opac-analytics (No se pueden guardar las 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 autorización que se utilizan para llamar a la instancia de proceso de Oracle Integration 3 recién configurada. Para obtener más información sobre los nuevos puntos finales de API y las políticas de autorización soportadas, consulte API de desarrollador 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:

• Proceso de Oracle Integration 3 - Oracle Integration 3 - Integraciones
• Oracle Integration 3 - Integraciones con Oracle Integration 3 - Procesos
• Visual Builder - Aplicaciones al proceso de Oracle Integration 3 - Procesos

Debe desplegar la nueva versión de todos los activos de Oracle Integration 3, como aplicaciones de proceso, aplicaciones de Visual Builder e integraciones, en el entorno superior para su validación.

Lleve cabo los siguientes pasos:

1. Active y despliegue los cambios de cliente para asegurarse de que todas las nuevas solicitudes controladas por el sistema se envíen al proceso de Oracle Integration 3 como se ha descrito anteriormente.
2. Comunique la nueva URL del espacio de trabajo de proceso de Oracle Integration 3 con los usuarios y asegúrese de que estos:
   • Marque el espacio de trabajo de proceso de Oracle Integration 3.
   • Cree nuevos procesos solo en el proceso de Oracle Integration 3.
   • Complete sus nuevas tareas en el proceso de Oracle Integration 3.
3. Baja las aplicaciones de Oracle Integration Generation 2 para que no se puedan crear procesos nuevos, pero se puedan completar los existentes. Consulte Gestión de aplicaciones activas en Uso de procesos en Oracle Integration 2.

Durante este tiempo:

• El proceso de Oracle Integration 3 servirá nuevas instancias de proceso.
• Las instancias de proceso existentes seguirán ejecutándose en el proceso de Oracle Integration Generation 2 hasta que se completen.

Durante este período, los usuarios del proceso deben:

• Trabaje principalmente desde el espacio de trabajo de proceso de Oracle Integration 3.
• Ocasionalmente, compruebe la lista Mis tareas de Oracle Integration Generation 2.
• Confíe en las aprobaciones basadas en correo electrónico tanto como sea posible, ya que los enlaces de los correos electrónicos los llevarán al lugar correcto para realizar la tarea.

El período de coexistencia dura hasta que se completan todas las transacciones creadas en Oracle Integration Generation 2. Usted debe tratar activamente de acortar la duración de este período tanto como sea posible. Estas son algunas directrices:

• Evite la creación de nuevas transacciones en Oracle Integration Generation 2 mediante la funcionalidad de baja. Esto se aplica a todos los procesos estructurados que no contienen actividades de recepción. La funcionalidad de baja impide la creación de nuevas instancias, pero también permite completar las transacciones existentes. Consulte Gestión de aplicaciones activas en Uso de procesos en Oracle Integration 2.
• Intente acelerar activamente la finalización de las instancias de Oracle Integration Generation 2 tanto como sea posible realizando un seguimiento con los usuarios para realizar acciones que los lleven a su finalización. Puede ver el número de transacciones abiertas por proceso y la persona asignada para las tareas asociadas mediante un nuevo informe disponible si navega hasta Proceso, Administración y, a continuación, hasta Informe de migración.
• Para un proceso de larga ejecución, las instancias que no se pueden completar en varios meses, explore las siguientes opciones:
  • Vuelva a crear la instancia en el proceso de Oracle Integration 3 y utilice la funcionalidad Modificar flujo para actualizar la carga útil y mover la instancia de proceso a la acción actual (donde se encuentra actualmente en el proceso de Oracle Integration Generation 2). Una vez hecho esto, se puede terminar la instancia existente de Oracle Integration Generation 2. Consulte Modificación del flujo de un proceso en Uso de Oracle Cloud Infrastructure Process Automation.
  • Modifique la aplicación migrada para que se pueda iniciar con el último estado de la instancia de proceso existente de Oracle Integration Generation 2.

Puede realizar un seguimiento de las transacciones de proceso de Oracle Integration Generation 2 restantes haciendo clic en Mis tareas y, a continuación, seleccionando Procesos en la instancia de Oracle Integration Generation 2. Debe iniciar sesión con un usuario que tenga el rol de administrador del servicio.

Puede mover las aplicaciones de proceso a Oracle Integration 3 antes del 31 de diciembre de 2026 activando Process en Oracle Integration 3. Consulte Activación de procesos con Oracle Integration 3. Para obtener información sobre la exportación o importación de artefactos de tiempo de diseño de aplicaciones de proceso, consulte Migración de todos los puntos finales de REST de aplicaciones.

Guardar datos de tiempo de ejecución del proceso de Oracle Integration Generation 2. Este paso es importante para garantizar que no se pierda el historial de transacciones completadas. Debe realizar esta actualización antes de la actualización. Consulte Archivado y depuración de datos de automatización de procesos en Oracle Integration.

Como parte de estos pasos, configurará el servicio de almacenamiento de Oracle y programará instancias para archivar y depurar. Tenga en cuenta los siguientes puntos:

• La información archivada estará disponible en el cubo configurado de Object Storage.
• Los anexos no se incluyen en los archivos de almacenamiento. Debe exportarlos manualmente. Consulte Recuperación de una asociación de proceso como flujo en API de REST para Oracle Integration 2.