Creación de integraciones personalizadas de supervisión de eventos

En Gestor de tareas, puede crear una integración de supervisión de eventos para una aplicación externa. La integración de supervisión de eventos se desencadena cuando se produce un evento externo en otro servicio en la nube o en la aplicación local. Un ejemplo de una integración de supervisión de eventos es un desencadenante del libro mayor de Oracle E-Business Suite cuando un periodo, por ejemplo, enero de 2018, se cierra.

Asegúrese de que cumple todos los requisitos previos y siga estos pasos para configurar una integración entre el Gestor de tareas y una aplicación externa.

Para obtener una descripción general del flujo de integraciones personalizadas, consulte Creación de integraciones personalizadas.

Requisitos

Nota:

La supervisión de eventos también se puede desencadenar mediante cualquier herramienta de integración capaz de llamar a API de REST. En ese caso, no necesita los requisitos previos que se indican a continuación.

Para integrar el Gestor de tareas con una aplicación externa, necesita:
  • Una suscripción a Oracle Integration Cloud Service, para integrar los servicios locales y los servicios externos a EPM Cloud.

    Nota:

    necesita una instancia de Integration Cloud por instancia de Oracle EPM Cloud.
  • Configuración de la aplicación externa.
  1. Suscríbase a Oracle Integration Cloud/Oracle Autonomous Integration Cloud. Consulte Documentación de Integration Cloud Service para obtener información detallada.
  2. Instale el agente de Integration Cloud en su entorno de aplicación para comunicarse con su instancia de Oracle EPM Cloud. Para obtener más información acerca de la instalación del agente de Integration Cloud, consulte Administración de grupos de agentes.

    Nota:

    Si los servicios de la aplicación local se despliegan en un entorno configurado en una configuración de zona desmilitarizada (DMZ) de forma que todos los usuarios puedan acceder a los servicios a través de Internet, no tendrá que instalar el agente de Integration Cloud.

Configuración de la integración en el Gestor de tareas

  1. En la página de inicio, haga clic en Aplicación y, a continuación, haga clic en Gestor de tareas.
  2. Haga clic en el separador Integraciones de la izquierda y, a continuación, en Nueva.
  3. En el separador Propiedades, especifique la información necesaria:

    1. En Nombre, introduzca un nombre para la integración.

    2. En Código, introduzca un código de integración para la tarea de integración.

      El código se utiliza para ejecutar la integración y para asignar actualizaciones a una integración desde una importación de archivo.

    3. Opcional: En Descripción, introduzca una descripción para la tarea de integración.

    4. En Conexión, seleccione la aplicación a la que pertenece la tarea.

      Puede mantener la lista de aplicaciones con el icono Gestionar conexiones del cuadro de diálogo Gestionar conexiones.

    5. En Tipo de ejecución, seleccioneSupervisión de eventos.

    6. En Nombre de evento, especifique un nombre para el evento.

  5. En el separador Parámetros, haga clic en Nuevo y especifique la información necesaria:

    1. En Nombre, especifique un nombre para el parámetro.

    2. En Código de parámetro, introduzca un código de parámetro.

    3. Opcional: Introduzca una sugerencia de herramientas de parámetro.

    4. En la lista Tipo de parámetro, seleccione un tipo e introduzca información adicional para el parámetro:

      • Casilla de verificación: valor booleano

      • Fecha: valor de fecha

      • Entero: valor numérico en números enteros

      • Número: valor numérico en números enteros o fracciones

      • Grupo de opciones: casilla de verificación para el conjunto de valores predefinido

      • Lista estática: conjunto predefinido de valores de texto

      • Información de tarea: información de tarea, por ejemplo, persona asignada, duración, fechas de inicio y de finalización

      • Texto: valor de texto en formato libre

      • Artefacto de EPM: nombre del artefacto, como el formulario o el informe

    5. Si el parámetro necesita un valor, seleccione Requerido.

    6. Haga clic en Aceptar para guardar el parámetro.

    7. Haga clic en Guardar y cerrar para guardar la integración.

Creación de un tipo de tarea para la integración

  1. En la página de inicio, haga clic en Aplicación y, a continuación, haga clic en Gestor de tareas.

  2. Haga clic en el separador Tipos de tarea, situado a la izquierda.

  3. Haga clic en Nuevo.

  4. En el separador Propiedades, especifique un nombre de tipo de tarea y un ID de tipo de tarea.

  5. En Integración, haga clic en Buscar. A continuación, seleccione la integración y haga clic en Aceptar.

  6. En el separador Parámetros, establezca los parámetros de tipo de tarea.

Configuración de la conexión de Integration Cloud en el Gestor de tareas

El gestor de tareas utiliza Oracle Integration Cloud para todas las integraciones con aplicaciones externas. Puede configurar una conexión a Oracle Integration Cloud en el gestor de tareas utilizando la autenticación básica o de OAuth 2.0.

Nota:

  • Para Oracle Integration Cloud Generation 2, están soportadas tanto la autenticación básica como la de OAuth 2.0.
  • Para Oracle Integration Cloud Generation 3, solo está soportada la de OAuth 2.0.
  • El usuario de autenticación básica debe contar con el rol de administrador del servicio de Oracle Integration Cloud.
  • Para OAuth 2.0, solo están soportadas las credenciales de cliente. La aplicación de cliente OAuth 2.0 debe tener el rol Administrador del servicio para Integration Cloud y el ámbito permitido debe ser todos.

Antes de configurar la conexión de OAuth 2.0, asegúrese de que tiene las credenciales de cliente, como la URL de token de acceso, el identificador de cliente, el secreto de cliente y el ámbito. Para configurar la aplicación de cliente de OAuth, consulte Autenticación OAuth en Oracle Integration en la documentación de Oracle Integration Cloud Generation 3.

Para configurar la conexión de Integration Cloud con el Gestor de tareas:

  1. En la página de inicio, haga clic en Aplicación y, a continuación, haga clic en Gestor de tareas.

  2. Haga clic en el separador Integraciones situado a la izquierda.

  3. Haga clic en Gestionar conexiones y, a continuación, en Acciones, seleccione Conexión de Integration Cloud.
  4. Seleccione uno de los siguientes mecanismos de autenticación:
    • Autenticación básica: especifique la URL, el ID y la contraseña del usuario administrador del servicio de Integration Cloud.
    • OAuth 2.0: proporcione la URL de Integration Cloud, la URL de token de acceso, el identificador de cliente, el secreto de cliente y el ámbito.

    Nota:

    Introduzca la URL: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
  5. Haga clic en Validar. Una vez realizada la validación, haga clic en Guardar. De esta forma, se guardan el servidor y las credenciales de la conexión.

Configuración de la integración en Integration Cloud

Nota:

Si no tiene pensado utilizar Integration Cloud, omita este paso.

Para configurar la integración en Integration Cloud

  1. Inicie sesión en Integration Cloud.
  2. Cree una conexión mediante un adaptador de Oracle Enterprise Performance Management Cloud a su servicio de EPM. Consulte este enlace para obtener más información: Creación de una conexión a Oracle Enterprise Performance Management Cloud.
  3. Cree una o más conexiones en las demás aplicaciones según sea necesario.
  4. Cree integraciones de supervisión de eventos con las conexiones creadas y actívelas. Consulte este ejemplo: Uso del adaptador de Oracle Enterprise Performance Management Cloud con Oracle Integration.

Configuración de la integración sin Integration Cloud

Nota:

Si tiene pensado utilizar Integration Cloud, omita este paso.
Configure la herramienta de integración que tiene pensado utilizar.

1. Revise la API de REST, Actualización de estados de tarea para la supervisión de eventos en API de REST para Oracle Enterprise Performance Management Cloud.

2. Configure la herramienta de integración para que llame a la API de REST para que cierre la tarea de supervisión de eventos pasando los parámetros del evento.

Para obtener más información, consulte Actualización de estados de tarea para la supervisión de eventos en API de REST para Oracle Enterprise Performance Management Cloud.

Configuración de la integración en el Gestor de tareas

Siga estos pasos para configurar la integración en el Gestor de tareas.

  1. En la página de inicio, haga clic en Aplicación y, a continuación, haga clic en Gestor de tareas.
  2. Haga clic en el separador Integraciones de la izquierda y compruebe si se muestra la nueva integración.
  3. En el Gestor de tareas, haga clic en Programas. Cree una nueva programación con el estado Pendiente. Consulte Creación manual de programas.
  4. Cree la tarea de supervisión de eventos y agréguela al programa. Consulte Creación de tareas.
  5. En Programas, seleccione y abra el programa.
  6. Desencadene la acción que genera el evento en la aplicación externa (por ejemplo, EBS). Si no está utilizando Integration Cloud, sino otra herramienta de integración, llame a la API de REST desde esa herramienta.

    Nota:

    Pase los parámetros tal y como espera el tipo de integración, el evento y los parámetros. De lo contrario, la tarea no se tendrá en cuenta si no coinciden.
  7. Espere a que se complete la tarea.
  8. Opcional: para supervisar el estado de la integración en Integration Cloud Services, inicie sesión en Integration Cloud y navegue a Supervisión.