...
- En la página de Aplicaciones conectadas , haga clic en Crear operación como se muestra a continuación.
- Aparecerá la página Create Operation (Crear operación).
- En la pestaña Operation Details (Detalles de la operación), agregue los detalles de la operación:
- Introduzca el Operation Name (Nombre de la aplicación).
- Seleccione uno de los WSDL agregados para la aplicación.
- Seleccione el método de enlace. Los métodos de enlace se rellenan automáticamente en función del WSDL seleccionado.
- Seleccione la operación. El sistema muestra automáticamente las operaciones admitidas para el WSDL y el método de enlace seleccionados.
- Se debe especificar Timeout (in milliseconds) (Tiempo de espera [en milisegundos]). Es 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, el valor mínimo es 1000 milisegundos 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.
- 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. Los encabezados especificados a nivel de instancia se rellenan automáticamente. Puede sobrescribir la configuración definida en el nivel de instancia o continuar utilizando la misma
- Ignore Global Header (Ignorar encabezados globales): si necesita sobrescribir la configuración definida en el nivel de instancia, seleccione Ignore Global Headers (Ignorar encabezados globales) y podrá agregar la variable y los valores específicos de la operación.
- Introduzca el Campo externo y el Valor.
- Introduzca el Campo externo y el Valor.
- Outbound Payload (Carga útil saliente): carga que debe pasarse a la aplicación externa. 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.
- Haga clic en Continuar para crear la configuración de la respuesta. La sección Response Configuration (Configuración de la respuesta) se utiliza para procesar los datos o la respuesta recibida del servicio web externo.
- Inbound Mapping (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 la generación de habilidades como operaciones de terceros, evaluación de reglas, definición de respuestas de bot y asignación de valores a los atributos personalizados del usuario.
...
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, etc.
Para establecer la asignación de entrada, siga los pasos a continuación:
- Agregar 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.
- Utilice Expression Type (Tipo de expresión) → Value (Valor) cuando un valor se asigna al atributo,por ejemplo, @{response.body}, @{response.code}.
- Use Expression Type (Tipo de expresión) y JSONPath cuando un valor de la respuesta de JSON recibida se asignará al atributo, por ejemplo, Expression (Expresión) apunta a una ruta de acceso a JSON.
- 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
- 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/AddResult.
Set Output to Attribute (Establecer salida en atributo): se utiliza para almacenar los datos.
- Scope (Alcance): representa el alcance del atributo que se utilizará para contener los valores entrantes.
- 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.
- 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.
- 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.
- Attribute (Atributo): es el nombre del atributo.
- Data Type (Tipo de dato): representa el tipo de dato del valor. Entero, largo, booleano, etc.
- Scope (Alcance): representa el alcance del atributo que se utilizará para contener los valores entrantes.
- Agregar 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.
- Para utilizar la función Transformation (Transformación), utilice Transform (Transformar) en Set Attribute (Establecer atributo). Para obtener más información sobre cómo utilizar las funciones de transformación, consulte Funciones de transformación.
- Error Handling (Manejo de errores): 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:
- 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 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:
- Es igual a
- No es igual a
- es mayor que
- es mayor o igual que
- es menor que
- es menor o igual que
- Comienza con
- No comienza con
- Termina con
- No termina con
- Contiene
- No contiene
- está vació
- no está vacío
- coincide con el patrón
- 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:
- No data Handling (Sin manejo de datos): esta sección se utiliza para definir el comportamiento y la respuesta del bot para el usuario cuando la ejecución de la operación no produce datos. Se pueden crear varias reglas sin ningún escenario de datos desde las operaciones del servicio web. Siga los valores de la devolución de la API de los sistemas externos desde los cuales recibe los datos, y escriba o evalúe los valores correspondientes en la sección Rules/conditions (Reglas/condiciones).
- Success Handling (Manejo de operaciones correctas): esta sección sea utiliza para definir el comportamiento y la respuesta del bot al usuario cuando la ejecución de la operación se ha realizado correctamente. Cree múltiples reglas que gestionen satisfactoriamente las operaciones del servicio web.
...