Configurar integración de procesos entre Oracle Integration y Oracle Content Management

Antes de que usted o cualquier usuario puedan acceder a las funciones de documentos y conversaciones, un administrador debe configurar los valores tanto en Oracle Content Management como en Oracle Integration.

Solo un usuario con privilegios de administrador puede establecer una conexión entre los dos servicios.

Para las aplicaciones de proceso que se crearon antes de configurar la conexión con Oracle Content Management, las funciones de documentos y conversaciones se desactivan por defecto. Los desarrolladores pueden activar estas funciones manualmente en sus aplicaciones existentes.

Requisitos de acceso para una integración correcta

Tenga en cuenta estos requisitos de acceso para una integración correcta:

El usuario de Oracle Content Management configurado en Oracle Integration debe tener acceso completo a la carpeta (es decir, la carpeta del documento entrante) configurada en Oracle Content Management para poder iniciar un proceso.
Para un proceso iniciado por carpetas (es decir, un proceso con un evento Inicio de carpeta), el usuario de Oracle Content Management configurado en Oracle Integration debe tener acceso de mánager a la carpeta para acceder a su carpeta en Oracle Integration. Por ejemplo, se necesita acceso de mánager para ver la carpeta en las páginas Detalles de la tarea y Seguimiento del proceso, para acceder a la carpeta al embeber componentes de la interfaz de usuario del proceso en una aplicación externa o ver la carpeta en la aplicación móvil del proceso.
Para ver un proceso en la lista de procesos de una carpeta y poder iniciar una instancia de proceso cuando llega un nuevo documento, se debe otorgar al usuario de Oracle Integration configurado en Oracle Content Management el rol de iniciador de proceso.

Uso de documentos o anexos en una aplicación de proceso

Oracle Integration incluye automáticamente la funcionalidad estándar de anexos de archivos en las aplicaciones de proceso. Puede cargar archivos y adjuntarlos a un proceso. Al utilizar Oracle Content Management con Oracle Integration, también obtiene la funcionalidad de documentos, que le permite cargar archivos, organizar archivos en carpetas, gestionar el acceso a cada carpeta e incluso iniciar un proceso mediante la carga de un documento. Además, cada aplicación de proceso tiene la opción de utilizar documentos o anexos.

Se controla si un proceso utiliza documentos o anexos en el nivel de aplicación. Los documentos están activados por defecto. La configuración se encuentra en el panel Información de la aplicación.

A continuación se muestra la descripción de enable-docs-app-level-cb.png
Descripción de la ilustración enable-docs-app-level-cb.png

Una aplicación con la opción Integración de documentos activada puede utilizar documentos (y solo documentos). Una aplicación que tenga Integración de documentos desactivada solo puede utilizar anexos. Básicamente, al desactivar documentos para una aplicación, se activan los anexos para esa aplicación.

Recuerde que la configuración se aplica a la aplicación. Puede utilizar documentos o anexos en una aplicación, pero no ambos.

Para los anexos, asegúrese de que la opción Ocultar anexos no esté seleccionada en la pantalla Personalización de interfaz de usuario. Si se selecciona la opción Ocultar anexos, no podrá ver los anexos en los detalles de la tarea y los formularios de inicio.

Si utiliza API de REST para interactuar con Oracle Integration, asegúrese de utilizar la API adecuada en función de si la aplicación de proceso utiliza documentos o anexos:

Para los documentos, asegúrese de utilizar las API de REST /folders.
Para los anexos, asegúrese de utilizar las API de REST /attachments.

Si utiliza una API incorrecta, la aplicación devuelve un mensaje de error o finaliza sin funcionamiento.

Tenga en cuenta que si no puede ver anexos en los detalles de la tarea, compruebe las opciones en la pantalla Personalización de interfaz de usuario. Asegúrese de que la casilla de control Ocultar anexos no esté seleccionada para ver anexos.

Configurar los valores de Oracle Integration en Oracle Content Management

Active Oracle Integration para los documentos en Oracle Content Management.

Conéctese a Oracle Content Management como administrador.
En el menú Administración, seleccione Integraciones.
En Aplicaciones, seleccione Oracle Integration para activar el servicio y, a continuación, defina estos valores:
- URL de servicio: URL del servicio REST al que pueden acceder los usuarios para sus aplicaciones, que termina por bpm/api/4.0/processes (por ejemplo, https://servicename/bpm/api/4.0/processes).
- Usuario de servicio: introduzca la dirección de correo electrónico del usuario propietario del proceso que se va a utilizar en Oracle Content Management.
- Contraseña de servicio: Introduzca la contraseña del usuario.

Cuando se haya completado un paso de tarea, el archivo se puede gestionar de acuerdo con el proceso definido. Para un documento entrante, un usuario puede realizar acciones basadas en el rol asignado para ese documento: Contributor, Downloader o Viewer.

Cuando Oracle Content Management inicia un proceso, se envía la siguiente carga útil para iniciar el proceso:

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

Como desarrollador, debe conocer los siguientes requisitos para el proceso que desarrolla:

Debe ser un proceso que utilice un evento de inicio de documento de Oracle Content Management.
Al desplegar el proceso, debe compartirlo con el usuario especificado para activar la integración, de modo que el usuario tenga derechos para disparar el proceso,
Para que el usuario que cargó el archivo se muestre como el usuario que inició la tarea, el proceso debe utilizar el valor transferido en el campo startedby como nombre mostrado para el iniciador.

Configuración de valores de documentos en Oracle Integration

Como administrador, también debe configurar la conexión entre Oracle Integration y Oracle Content Management. Debe introducir información como la URL y las credenciales de conexión para Oracle Content Management.

Para configurar los valores en Oracle Integration:

En el panel de navegación de Oracle Integration, haga clic en Mis tareas, haga clic en Espacio de trabajo y, a continuación, haga clic en Administración.
Haga clic en Servicios.
En la sección Oracle Content Management, introduzca la siguiente información:
- URL: dirección web de Oracle Content Management. El administrador de servicio recibe una bienvenida al correo electrónico de Oracle Cloud cuando el servicio está listo para su uso. El correo electrónico tiene la URL de Oracle Content Management. Por ejemplo, https://your_service_name.com/documents.
- Dominio de identidad: nombre del dominio de identidad al que pertenece Oracle Content Management. Puede configurar correctamente una conexión a Oracle Content Management (para la función de documentos) sin proporcionar un dominio de identidad.
- Usuario y Contraseña: credenciales de cuenta para un usuario que tiene acceso a Oracle Content Management. Esta cuenta de usuario se utiliza para probar la conexión entre los servicios. También se utiliza durante el tiempo de ejecución para conectarse a los servicios y realizar todas las operaciones de tiempo de ejecución, como la creación de carpetas.
Importante:

Si desea colaborar mediante conversaciones, el usuario que especifique aquí debe tener asignado el siguiente rol:

service_instance_name.CECIntegrationUser

Utilice la aplicación Oracle Cloud My Services para asignar roles a los usuarios.
Haga clic en Probar.

Siempre que realice cambios en los valores de configuración, es recomendable verificar que los valores introducidos sean correctos. Desea confirmar que se ha establecido una conexión correcta con Oracle Content Management.

Revise los resultados de la prueba, que pueden incluir mensajes, errores y advertencias.
Seleccione una de las siguientes opciones para continuar:
- Si hay errores o advertencias, realice los cambios necesarios y, a continuación, vuelva a hacer clic en Probar para verificar los nuevos valores. Repita la prueba cada vez que cambie la configuración.
- Si la prueba de conexión se realiza correctamente, haga clic en Guardar para guardar los valores de configuración.
- Si desea cancelar y volver a los últimos valores guardados, haga clic en Revertir.