Creación de una carpeta o un documento en Oracle Content and Experience Cloud con un proceso en Oracle Integration Cloud

Use el evento Inicio del documento para modelar un proceso que puede iniciar un documento. Utilice el evento Inicio de carpeta para modelar un proceso que puede iniciar una carpeta.

Antes de crear uno de estos procesos, debe tener una cuenta de Oracle Content Management y debe configurar una conexión entre ese servicio y Oracle Integration.

Al activar la integración de Oracle Content Management, puede definir carpetas que se crearán automáticamente en Oracle Content Management para cada instancia de proceso, proporcionando una organización predefinida de los documentos implicados. También puede sustituir el tipo de acceso en el nivel de tarea para definir los permisos adecuados para la carpeta o el documento de una tarea concreta, en función de las necesidades de su negocio. Por ejemplo, puede que desee evitar que los usuarios vean un documento o una carpeta clasificados asociados con una tarea.

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

Para poder iniciar un proceso, 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 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 ella 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 para 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.

Para diseñar un proceso que puede ser iniciado por un documento o carpeta:

Defina el documento entrante o la carpeta entrante en Oracle Integration.
Modelar un proceso que tenga un evento de inicio de documento o un evento de inicio de carpeta.
Personalice su implantación para asignar el evento de inicio al documento o carpeta de entrada correspondiente que ha creado. Las opciones de implantación le permiten definir la forma en que el documento o la carpeta se exponen a los usuarios.
Opcionalmente, modifique qué rol puede acceder al documento o carpeta en el nivel de tarea.
Configure la carpeta en Oracle Content Management para iniciar un proceso cuando llegue un documento.

También puede utilizar la API de REST y proporcionar todos los valores de entrada.

Definir documento o carpeta entrante

Puede utilizar la página Documentos de Oracle Integration (Process Builder) para definir un documento o carpeta entrante.

Abra la aplicación de proceso que está modelando y haga clic en Documentos. La página Documentos muestra los documentos entrantes y las carpetas entrantes que ya se han definido.

Para crear un nuevo documento o carpeta entrante, haga clic en Nuevo , seleccione el tipo adecuado, introduzca un nombre y seleccione el permiso de acceso por defecto.

Procesos de modelo que se pueden iniciar desde eventos de inicio de documento o carpeta

Puede modelar un proceso en Oracle Integration que se pueda iniciar desde un evento de inicio de documento o de inicio de carpeta.

Antes de empezar, agregue el evento de inicio o inicio de carpeta del documento desde la paleta Elementos. Solo se admitirá el primer evento de inicio que agregue a un proceso.

En el separador Inicio de la aplicación, haga clic en Procesos.
Haga clic en Nuevo proceso para abrir el cuadro de diálogo Crear proceso.
Seleccione Ninguno.
Introduzca un nombre para el proceso, asegúrese de que la casilla de control Abrir inmediatamente esté seleccionada y, a continuación, haga clic en Crear.
En la paleta de elementos, haga clic en Eventos.
Arrastre el evento Inicio del documento o el evento Inicio de la carpeta al lienzo.
Agregue un flujo de secuencia del nuevo evento de inicio de documento o carpeta al evento final.
Suprima el evento de inicio vacío.
Continúe para modificar y definir el proceso. Asegúrese de probarla y desplegarla.

Activar roles de usuario para iniciar un proceso iniciado por documento o carpeta

Puede activar determinados roles de usuario para iniciar un proceso iniciado por documentos o carpetas en Oracle Integration.

Para permitir que un rol de usuario cargue un documento para iniciar un proceso:

Abra el proceso.
En el carril con el evento de inicio de documento o carpeta, haga clic en el nombre del rol y, a continuación, haga clic en Editar .
En el campo Rol, seleccione Manejador automático.

Personalizar un proceso iniciado por un documento o por una carpeta

Después de modelar un proceso en Oracle Integration, puede agregar un documento de inicio o una carpeta en un proceso y personalizarlo.

Para personalizar un proceso iniciado por un documento o por una carpeta:

En el diagrama de proceso, haga clic en el evento Inicio del documento o Inicio de la carpeta.
Haga clic en Menú y seleccione Abrir Propiedades.
Defina cómo desea gestionar el documento o la carpeta entrante.
- En el lugar: si selecciona este valor, se mantiene la ubicación del documento tal como está. Si lo desea, puede asignar el documento o la carpeta entrante a uno de los documentos o carpetas predefinidos para su gestión. (Para ello, abra la lista desplegable).
  
  Si no hay un documento entrante predefinido o una carpeta adecuada para este proceso en particular, haga clic en Nuevo para crear uno.
- Sin gestionar: el proceso actual ignora el documento o la carpeta. Oracle Integration Cloud no mostrará un documento o una carpeta no gestionados en tiempo de ejecución. Corresponde al modelador de procesos manejar el documento o la carpeta entrante. Por ejemplo, si desea mover la carpeta o el documento entrante a otra ubicación, puede utilizar una expresión XPath para obtener propiedades, como Id o Type, y transferir la información de propiedad a un servicio REST.

Configurar una carpeta

Para definir un proceso para que se inicie automáticamente cuando se cargue un documento en una carpeta, debe configurar la carpeta en Oracle Content Management.

Para configurar la carpeta para iniciar un proceso cuando llega un documento:

Inicie sesión en Oracle Content Management.
Seleccione la carpeta.
Seleccione Propiedades en la barra de menús.
Active la configuración Iniciar proceso a la llegada del documento.
Seleccione el proceso de la lista.
Haga clic en Guardar.

La carpeta y sus subcarpetas ahora estarán ahora disponibles para su uso en la interfaz de Oracle Integration. Cualquier cambio en un archivo de la carpeta o en cualquier archivo nuevo cargado en la carpeta activa el proceso asociado a la carpeta. Puede anular el proceso heredado en una subcarpeta, pero no puede desactivar su asociación al proceso.

Cuando se carga un archivo de Oracle Content Management en una carpeta configurada para su uso con Oracle Integration, el archivo se utiliza para la tarea asociada a esa carpeta. Los usuarios de Oracle Integration pueden realizar acciones en los archivos allí, como aprobaciones. Cuando se haya completado un paso de la tarea, el archivo se podrá mover o gestionar de acuerdo con el proceso definido.

Cuando Oracle Content Management inicia un proceso, la carga útil enviada para iniciar el proceso incluye esta información:

ID de documento
Nombre de documento
ID del usuario que ha iniciado el proceso
Tipo
Rol (indica el rol que se debe utilizar para generar enlaces de aplicación posteriores)
Versión

En el siguiente ejemplo se utilizan solo el ID de documento y el nombre de documento para mostrar en el formulario de Oracle Integration. Además, utiliza el ID de documento cuando realiza llamadas a la API de REST para mover o copiar el archivo en Oracle Content Management en la carpeta de tareas.

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "role": "role that should be used to generate subsequent applinks",
        "version": "version"
   }
}

Como desarrollador, debe tener en cuenta los siguientes requisitos para el proceso que desarrolle:

El proceso debe utilizar un evento de inicio de Oracle Content Management.
Al desplegar el proceso, debe compartirlo con el usuario especificado para activar la integración. De lo contrario, el usuario no tendrá 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.
Si activa la integración de procesos para una carpeta, debe compartir esta carpeta con la cuenta de usuario de Oracle Content Management que se utilizó para activar la integración en Oracle Integration.