Configurar Blue Prism para que utilice Interact

Blue Prism e Interact se comunican a través de la Remote API de Blue Prism Interact. Para usar esta API, el archivo de lanzamiento del servicio de API de Interact debe importarse a Blue Prism; esto incluye un servicio de API web y VBO. Una vez importado, deberá actualizarse con la URL base y los códigos de autorización adecuados para permitir la comunicación segura.

Si actualiza Interact a un nuevo lanzamiento, debe importar el archivo del último lanzamiento a Blue Prism. El archivo de lanzamiento del servicio API de Interact está disponible en el portal de Blue Prism.

Si desea configurar Blue Prism para usar Interact, debe:

1. Configurar una cuenta de servicio en Hub y generar una clave secreta.
2. Importar el VBO del servicio de API de Interact a Blue Prism.
3. Configurar las credenciales para la cuenta del servicio de API web de Interact en Blue Prism.
4. Configurar el servicio API de Interact para permitir que Blue Prism se comunique con Interact.

Configurar una cuenta de servicio

Para configurar las credenciales de Remote API de Interact en Blue Prism, se requiere una clave secreta. Esta se genera a partir de la cuenta de servicio asociada en Hub para su uso con Remote API de Interact. Si pierde la clave, puede volver a generar otra desde la cuenta de servicio. Para obtener más información, consulte Cuentas de servicio.

Si no tiene una cuenta de servicio configurada para Remote API de Interact, puede crear una cuenta de servicio:

1. En Blue Prism Hub, en la página Cuentas de servicio, haga clic en Agregar cuenta.

2. Ingrese una id. única y un nombre descriptivo, por ejemplo, InteractRemoteAPI.

   No utilice InteractRemoteClient. Este nombre se asigna internamente en el sistema.

3. En Permisos, seleccione Remote API de Interact.

   

4. Haga clic en Crear cuenta de servicio.

   Aparece el diálogo Agregar una cuenta de servicio con una clave secreta generada. Deberá ingresar esta clave en el cliente interactivo de Blue Prism al configurar la credencial asociada.

5. Copie la clave secreta generada en su portapapeles para pegarla en el cliente interactivo de Blue Prism.

   

6. Haga clic en Aceptar para cerrar el diálogo.

   Aparece la página Cuentas de servicio con la cuenta recién creada que se muestra.

Configurar credenciales en Blue Prism

1. Inicie sesión en el cliente interactivo de Blue Prism, seleccione Sistema y haga clic en Seguridad > Credenciales. Consulte Seguridad > Credenciales para obtener información adicional.

2. Haga clic en Nueva.

   Se muestra el diálogo Detalles de la credencial.

3. En la pestaña Credenciales de la aplicación del diálogo Detalles de la credencial:

   1. Ingrese un nombre.
   2. Cambie el Tipo a OAuth 2.0 (Credenciales del cliente).

   3. En Id. de cliente, ingrese la Id. que utilizó para crear la cuenta de servicio anterior en Configurar Blue Prism para que utilice Interact, por ejemplo, InteractRemoteAPI.

   4. En Secreto del cliente ingrese la clave secreta generada para la cuenta de servicio.

   

4. En la pestaña Derechos de acceso del diálogo Detalles de la credencial, configure los permisos de acceso requeridos.
5. Haga clic en Aceptar.

Configurar el servicio API de Interact

1. En Blue Prism, seleccione Sistema y luego haga clic en Objetos > Servicios de API web.

   Aparece la pantalla Objetos: servicios de API web. Por ejemplo:

   

2. Seleccione Administración de Interact y haga clic en Editar servicio.

   Aparece la pantalla API web: administración de Interact.

   

3. En la pantalla de apertura de API web: administración de Interact, en URL base, ingrese la URL para el servicio API de Interact de su organización. Esto se definió durante la instalación de Interact.

4. Seleccione Autenticación común en el árbol de navegación y luego complete lo siguiente:

   1. Asegúrese de que el Tipo de autenticación esté configurado como OAuth 2.0 (credenciales del cliente)

   2. En URI de autorización, ingrese la URL del Authentication Server en el formato:

      <Authentication Server URL>:<port if specified during install>/connect/token

      Por ejemplo, https://authentication.blueprism.com:5000/connect/token

      O bien, si se utilizó el puerto predeterminado, https://authentication.blueprism.com/connect/token.

      Si ha actualizado desde una versión anterior a 4.3, su sistema seguirá usando IMS. En este caso, debe ingresar la información en el formato:

      <IMS URL>:<port if specified>/connect/token

      Por ejemplo, https://ims.blueprism.com:5000/connect/token.

   3. En Credencial, seleccione la credencial que creó en Configurar credenciales en Blue Prism.

   

5. Haga clic en Aceptar para guardar y completar la configuración del servicio de API web.

El servicio web tiene acciones definidas. Estas acciones están disponibles dentro de Utilidad - Interact API Blue Prism VBO junto con una serie de acciones adicionales que se asignan al servicio web. Las acciones son las siguientes:

API web de Interact	VBO de Blue Prism: Utilidad - API de Interact
Obtener envío	Obtener envío
Obtener esquema de formulario	Obtener esquema de formulario
Crear envío	Crear envío
Editar valor de campo de envío	Editar relleno de regla horizontal Editar <Type>valor de campo, donde el tipo es lo siguiente: Casilla de verificación simple Casilla de verificación múltiple Fecha Lista desplegable simple Lista despegable múltiple Número Párrafo Radio Tabla Texto Área de texto Hora Cargar
Actualizar configuración	Cambiar el estado del campo a opcional Cambiar el estado del campo a obligatorio Cambiar el estado del campo a solo lectura Cambiar el estado del campo a oculto Cambiar el estado de la página a visible Cambiar el estado de la página a oculto
Actualizar estado	Mover envío a la pestaña Historial Mover envío a la pestaña Aprobado Mover envío a la pestaña Revisión Mover envío a la pestaña Rechazados Mover envío a la pestaña Borrador Mover envío a la pestaña Bandeja de entrada Mover envío a la pestaña Archivados
Presentar envío	Presentar envío
Obtener usuarios por nombre del formulario	Obtener usuarios por nombre del formulario
Cargar archivo	Cargar archivo
Obtener Id. de rol por nombre de rol	Obtener Id. de rol por nombre de rol
Obtener roles por nombre de formulario	Obtener roles por nombre de formulario
Obtener envío por transacción	Obtener envío por Id. de transacción: se utiliza internamente mediante Crear envío, Presentar envío y Presentar envío a rol para devolver la Id. de envío a los trabajadores digitales.
Presentar envío a rol	Presentar envío a rol
Editar valor de campo de envío por Id. de transacción	Obtener Id. de transacción: se utiliza internamente mediante Editar relleno de regla horizontal y Editar valor de campo de párrafo.

Estas acciones se llaman desde la utilidad de Interact API VBO, por lo que después de la configuración inicial de la URL y los códigos de autorización no es necesario modificar el servicio web. Cada una de las acciones dentro de la utilidad de Interact API VBO se explica en la siguiente sección.