Page Comparison

...

1. En el menú Tenant (Tenant), 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 tenant. 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.
   
   
   
2. 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.
   
3. Introduzca Ingrese el  Nombre de la aplicación.
4. Seleccione el tipo de integración.
5. 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.  

...

1. 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.
   
2. Introduzca Ingrese 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.

3. Introduzca Ingrese la URL base a la que Luma se debe conectar.

4. 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:

   1. No auth (Sin autenticación): utilice esta opción si no necesita ninguna autenticación para iniciar sesión en los sistemas de terceros.
   2. Basic Auth (Autenticación básica): utilice esta opción para autenticar las aplicaciones externas para interactuar con el tenant de Luma. La autenticación básica consta de los siguientes campos:
      
      1. 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.
      2. Contraseña: especifique la  contraseña. Luma utiliza esta contraseña durante la autenticación con el sistema de terceros.
      3. 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.
   3. 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:
      
      1. 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.
      2. Token: introduzca ingrese el token de autenticación exclusivo para que las aplicaciones externas se comuniquen con la API de Luma.
5. 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}.
   1. Introduzca Ingrese el Campo externo y el Valor.
6. 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. Por ejemplo, https://myserver.com/resource-name?param1=value1&param2=value2. 
   1. Introduzca Ingrese el Campo externo y el Valor.
7. 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.
   1. Introduzca Ingrese 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.

8. 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.

   
   

...

1. 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.
   
2. En la pestaña Detalles de operación , introduzca ingrese el  nombre de la operación.
3. El sistema muestra automáticamente el dominio de la habilidad predeterminado del tenant. 
4. El identificador de recursos uniforme (URI) se utiliza para referirse al recurso de información. Introduzca  Ingrese el URI.
5. 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.
6. El sistema muestra automáticamente la operación compatible para invocar la API REST.
7. 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 milisegundos000 milisegundos, 10 segundos10 segundos, y el valor máximo permitido es de 3 minutos3 minutos, 180.000 milisegundos000 milisegundos.
8. 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.
9. 
10. 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. 
    1. Introduzca Ingrese el Campo externo y el Valor.
11. 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. Por ejemplo, https://myserver.com/resource-name?param1=value1&param2=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. 
    1. Introduzca Ingrese el Campo externo y el Valor.
12. 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. 
    1. Introduzca Ingrese 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  (Contenido-Tipo): 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 tenant. 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.

         
         

13. 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. 
    

    

14. Para enviar un archivo adjunto como carga útil saliente, utilice Attachment Mapping (Asignación de archivos adjuntos). Introduzca Ingrese un Campo externo y seleccione un atributo con el tipo de datos Archivo como Valor.
    
    
    
    

15. Haga clic en Continuar para crear la configuración de la respuesta.

...

Esta sección se utiliza para procesar los datos o la respuesta recibida del servicio web externo.

Mapeo Asignación de entrada

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 Luma Bot Builder (Consola de Administración de Luma).

...

1. Haga clic en Add Attribute (Agregar atributo).
2. Para establecer un atributo, agregue los siguientes datos.
   1. Expression Type (Tipo de expresión) y Expression (Expresión): representan el tipo (valor o JSON) y la ruta de la ubicación del  valor que se asigna al atributo.
      1. Utilice Expression Type (Tipo de expresión) → Value (Valor) cuando un valor se asigna al atributo, por ejemplo, @{response.body}, @{response.code}.
      2. Use Tipo de expresión y  JSONPath cuando un valor de la respuesta de JSON recibida se asignará al atributo, por ejemplo,  Expresión apunta a una ruta de acceso a JSON (por ejemplo, $.data.TicketIdentifier, $.data.items[*].Priority).
      3. Use Expression Type (Tipo de expresión) → Indirect JSONPath (JSONPath indirecto) cuando un valor del atributo de tipo JSON se asignará al atributo, por ejemplo, Expression (Expresión) apunta a un atributo que mantiene una ruta de acceso a JSON (por ejemplo, @{local.items}→$).[*].TicketIdentifier
      4. Utilice Expression Type (Tipo de expresión) → Xpath cuando un valor que se asigna al atributo, es decir, Expression (Expresión), apunta a una ruta, por ejemplo, //AddResponse/Description.
   2. Scope (Alcance): representa el alcance del atributo que se utilizará para contener los valores entrantes.
      1. Utilice Global para asignar el valor a un atributo global que se utilizará en la habilidad. Aunque los atributos estén disponibles para que se puedan utilizar otras habilidades, el valor se mantiene durante la ejecución de las habilidades.
      2. Utilice Local (Local) para crear y establecer el valor de un atributo local. Estos atributos son válidos y están disponibles únicamente durante la ejecución de la habilidad. El valor de la variable local se conserva entre las solicitudes y se utiliza para pasar datos entre varias integraciones, mensajes de usuario o reglas.  Si se utiliza después de una respuesta del bot, se pierde el valor del atributo Local.
      3. Utilice User Custom (Personalizado del usuario) para asignar el valor a un atributo personalizado del usuario. Estos atributos mantienen los valores asignados a menos que se sobrescriban.
   3. Attribute (Atributo): es el nombre del atributo.
   4. Data Type (Tipo de dato): representa el tipo de dato del valor.
3. Para utilizar la función Transformation (Transformación), utilice Transform (Transformar).  Para obtener más información sobre cómo utilizar las funciones de transformación, consulte Usar las funciones de transformación

...

• Coincidencia con alguna de las siguientes condiciones: una de las condiciones especificadas debe coincidir para analizar el mensaje de error.
• Coincidencia con todas las siguientes condiciones: es necesario validar todas las condiciones especificadas para analizar el mensaje de error.
• Definición de criterios personalizados: se pueden definir criterios personalizados en función de las condiciones proporcionadas para analizar el mensaje de error si se valida.
  Por ejemplo, 1 y 2 o 3. Las condiciones primera y segunda deben coincidir, o solo la tercera condición debe coincidir. Se pueden introducir ingresar solo números, y, o, (,)

Especifique @response.StatusCode en el campo Key (Clave) seguido por un operador.  A continuación, se muestra la lista de operadores compatibles:

...