...
- En el menú Tenant (Inquilino), haga clic en Integrations (Integraciones).
La página Connected Apps (Aplicaciones conectadas) aparece como se muestra a continuación.
Aquí podemos configurar una integración entre Luma y un sistema de terceros, que es válida en el nivel de inquilino. Una vez que se ha creado la aplicación conectada, el paso siguiente es crear la instancia de la aplicación y las operaciones de servicios web correspondientes.
- Haga clic en Crear aplicación para crear una nueva aplicación.
Aparecerá la página Create App (Crear aplicación) como se muestra a continuación.
- Introduzca el Nombre de la aplicación.
- Seleccione el tipo de integración.
- Haga clic en Create (Crear) para completar la creación de la aplicación.
La aplicación creada está disponible en la lista Connected Apps (Aplicaciones conectadas). El paso siguiente es crear una instancia.
...
- En la página de Connected Apps (Aplicaciones conectadas), haga clic en Create Instance (Crear instancia) como se muestra a continuación.
Aparecerá la página de Crear instancia como se muestra a continuación.
- Introduzca el Nombre y la Descripción de la instancia. El paso siguiente es definir las credenciales y los detalles de conexión para esta instancia.
Introduzca la URL base a la que Luma se debe conectar.
Luma usa el tipo de autorización para iniciar sesión y realizar las operaciones especificadas como parte de la operación del servicio web.
Luma es compatible con los siguientes tipos de autorizaciones:
- No auth (Sin autenticación): utilice esta opción si no necesita ninguna autenticación para iniciar sesión en los sistemas de terceros.
- Basic Auth (Autenticación básica): utilice esta opción para autenticar las aplicaciones externas para interactuar con el inquilino de Luma. La autenticación básica consta de los siguientes campos:
- Username (Nombre de usuario): especifique el nombre de usuario. Luma lo utiliza como un nombre de usuario de autenticación para iniciar sesión en los sistemas de terceros.
- Contraseña: especifique la contraseña. Luma utiliza esta contraseña durante la autenticación con el sistema de terceros.
- Authorization Header Name (Nombre del encabezado de autorización): de forma predeterminada, el nombre del encabezado de autorización es especificado como autorización por Luma.
- Bearer Token (Token de portador): este es el token único de autenticación que se necesita para que las aplicaciones externas se comuniquen con la API de Luma.
El token de portador consta de los siguientes campos:- Authorization Header Name (Nombre del encabezado de autorización): de forma predeterminada, el nombre del encabezado de autorización es especificado como autorización por Luma.
- Token: introduzca el token de autenticación exclusivo para que las aplicaciones externas se comuniquen con la API de Luma.
- Path Parameter (Parámetro de ruta): forma parte de un segmento de ruta que aparece después de su nombre. Los parámetros de ruta ofrecen una oportunidad única para reemplazar los valores de forma dinámica y pasarlos a la dirección URL. Por ejemplo, http://myserver.com/some-path/{parameter1}/path-continued/{parameter2}.
- Introduzca el Campo externo y el Valor.
- Query Parameter (Parámetros de consulta): los parámetros de consulta a veces se conocen como parámetros opcionales. Los parámetros de consulta se separan de los parámetros jerárquicos con un signo de interrogación. Los parámetros de consulta se muestran en la dirección URL tras el signo de interrogación (
?) después del nombre del recurso. https://myserver.com/resource-name?param1=value1¶m2=value2.- Introduzca el Campo externo y el Valor.
- Encabezados: los encabezados se clasifican principalmente como encabezados de solicitudes. Se deberán establecer los encabezados de la solicitud cuando se envíe la solicitud.
- Introduzca el Campo externo y el Valor.
Los siguientes encabezados de muestra son los que más se encuentran.- Authorization (Autorización): incluye credenciales que contienen la información de autenticación del cliente para el recurso que se solicita.
Accept-charset (Aceptar conjunto de caracteres): se trata de un encabezado que se establece con la solicitud y que indica al servidor qué conjuntos de caracteres son aceptables para el cliente.
Content-Type (Tipo de contenido): indica el tipo de medio (texto/HTML o texto/JSON, XML/personalizado) de la respuesta que el servidor envía al cliente, por lo que el cliente podrá procesar correctamente el cuerpo de la respuesta.
- Introduzca el Campo externo y el Valor.
Haga clic en Create (Crear) para crear la instancia de la aplicación.
Info La primera instancia que se agrega se considera la instancia predeterminada.
...
- En la página de Aplicaciones conectadas , haga clic en Crear operación como se muestra a continuación.
La página de Crear operación aparecerá como se muestra a continuación.
- En la pestaña Detalles de operación , introduzca el nombre de la operación.
- El sistema muestra automáticamente el dominio de la habilidad predeterminado del inquilino.
- El identificador de recursos uniforme (URI) se utiliza para referirse al recurso de información. Introduzca el URI.
- Seleccione el métodode la operación. Utiliza un marco de encadenamiento de solicitud de API para que los bots inserten o soliciten datos desde los sitios web, los sistemas y las aplicaciones web mediante el uso de los servicios web.
Los métodos de operación siguientes están disponibles:- Get (Obtener): para recuperar datos
- Post (Publicar): para crear datos
- Colocar: para editar los datos
- Delete (Eliminar): para eliminar los datos
- Parche: realizar actualizaciones parciales del recurso.
- El sistema muestra automáticamente la operación compatible para invocar la API REST.
- Se debe especificar Timeout (in milliseconds) (Tiempo de espera [en milisegundos]), la cantidad de tiempo de espera para una respuesta de servicio web al invocar una solicitud saliente. El valor predeterminado es de 10.000 milisegundos, 10 segundos, y el valor máximo permitido es de 3 minutos, 180.000 milisegundos.
- Haga clic en Next (Siguiente) para especificar los detalles de la configuración de la solicitud .
La página Request Configuration (Configuración de la solicitud) aparece como se muestra a continuación. - Parámetro de ruta: forma parte de un segmento de ruta que aparece después de su nombre. Los parámetros de ruta ofrecen una oportunidad única para reemplazar los valores de forma dinámica y pasarlos a la dirección URL. Por ejemplo, http://myserver.com/some-path/{parameter1}/path-continued/{parameter2}. Se puede sobrescribir la configuración definida en el nivel de instancia o continuar utilizando el mismo elemento, y es posible que se necesite agregar los valores y variables específicos de la operación.
- Introduzca el Campo externo y el Valor.
- Parámetros de consulta: los parámetros de consulta a veces se conocen como parámetros opcionales. Los parámetros de consulta se separan de los parámetros jerárquicos con un signo de interrogación. Los parámetros de consulta se muestran en la dirección URL tras el signo de interrogación (
?) después del nombre del recurso. https://myserver.com/resource-name?param1=value1¶m2=value2. Se puede sobrescribir la configuración definida en el nivel de instancia o continuar utilizando el mismo elemento, y es posible que se necesite agregar los valores y variables específicos de la operación.- Introduzca el Campo externo y el Valor.
- Encabezados: los encabezados se clasifican principalmente como encabezados de solicitudes. Se deberán establecer los encabezados de la solicitud cuando se envíe la solicitud. Se puede sobrescribir la configuración definida en el nivel de instancia o continuar utilizando el mismo elemento, y es posible que se necesite agregar los valores y variables específicos de la operación.
- Introduzca el Campo externo y el Valor.
Los siguientes encabezados de muestra son los que más se encuentran.- Authorization (Autorización): incluye credenciales que contienen la información de autenticación del cliente para el recurso que se solicita.
Accept-charset (Aceptar conjunto de caracteres): se trata de un encabezado que se establece con la solicitud y que indica al servidor qué conjuntos de caracteres son aceptables para el cliente.
Content Type: indica el tipo de medio (texto/HTML, texto/JSON, XML/personalizado o multipart/form-data) de la respuesta que el servidor envía al cliente, por lo que el cliente podrá procesar correctamente el cuerpo de la respuesta.
Info - Use multipart/form-data como Content Type (Tipo de contenido) para enviar un archivo adjunto al servidor del inquilino.
- Si desea sobrescribir las configuraciones del encabezado global definidas en el nivel de instancia, seleccione Ignore Global Headers (Ignorar encabezados globales). El sistema tendrá en cuenta las configuraciones definidas en el nivel de operación. Del mismo modo, también puede sobrescribir el parámetro de ruta y el parámetro de consulta.
- Introduzca el Campo externo y el Valor.
- Carga saliente: es necesario transmitir la carga saliente para completar la solicitud. Form Data es la codificación predeterminada que usa un formulario web para transferir datos. El área del cuadro de texto acepta pares simples de clave-valor y JSON complejos o anidados.
Para enviar un archivo adjunto como carga útil saliente, utilice Attachment Mapping (Asignación de archivos adjuntos). Introduzca un Campo externo y seleccione un atributo con el tipo de datos Archivo como Valor.
- Haga clic en Continuar para crear la configuración de la respuesta.
...
En esta sección, se pueden transformar los datos que se reciben como respuesta y asignarlos a Atributos de usuario local, global y personalizado. Estos datos, a su vez, se pueden utilizar en operaciones de terceros, conjuntos de reglas, ejecución de habilidades, respuestas de bots y la aplicación de generación de bots de Luma.
Hay dos formas de configurar los atributos.
...
Por ejemplo, extraer el número de ticket del identificador del ticket recibido de un sistema ITSM y proporcionarlo a un cliente. Luma proporciona una variedad de funciones de transformación para permitir a los desarrolladores de habilidades manipular los datos según sea necesario, como Dividir, Recortar, Subcadena, Reemplazar, Fecha y hora personalizada, entre otras.
Para establecer la asignación de entrada, siga los pasos a continuación:
...
Esta sección se utiliza para definir el comportamiento y la respuesta de bot para el usuario cuando se produce un error durante la ejecución de la operación. Se pueden crear varias reglas que controlen errores desde las operaciones del servicio web.
Seleccione una de las siguientes opciones para definir una regla para enviar el mensaje de error. El mensaje de error se enviará solo si se validan las condiciones especificadas:
...
- En el menú Tenant (Inquilino), haga clic en Integrations (Integraciones).
- Todas las aplicaciones conectadas se enumeran como se muestra a continuación donde está disponible la opción para editar.
- Haga clic en el botón Edit (Editar)
. Aparecerá la página Connected App (Aplicación conectada). 
- Aquí se pueden editar los detalles como el tipo de integración, la instancia predeterminada, la operación de inicio de sesión y la operación de cierre de sesión.
Las operaciones Iniciar sesión y Cerrar sesión son útiles cuando una funcionalidad/operación requiere una condición previa al inicio de sesión y posterior al cierre de sesión.
Por ejemplo, la operación de inicio de sesión y cierre de sesión se puede utilizar para el control de la sesión. Al ejecutar una operación a través de una habilidad, la operación de inicio de sesión generaría un token y reserva la sesión. Al finalizar la tarea, la operación de cierre de sesión liberará la sesión. Esto garantiza una utilización óptima de las sesiones asignadas al usuario de la API.
Una vez seleccionadas las operaciones necesarias, haga clic en el botón Update (Actualizar) para guardar los cambios.
...