Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Luma proporciona una variedad de funciones de transformación para permitir a los desarrolladores de habilidades modificar los datos según sea necesario, como Split (Dividir), Trim (Recortar), Substring (Subcadena), Replace (Reemplazar), Custom Date-Time (Fecha y hora personalizadas), entre otras.

Table of Contents

Cómo utilizar las funciones de transformación

Las funciones de transformación se puede pueden usar en las siguientes situaciones:

  • Al generar una habilidad como un elemento de conversación.

  • Al crear una operación de integración, en Inbound Response Mapping (Asignación de respuestas entrantes).

  • Al crear un seguimiento, en la definición de Message (Mensaje), Data Extraction (Extracción de datos) y , Recipients (Destinatarios) .y Message (Mensaje)

Mediante el uso de las funciones de transformación, los desarrolladores y administradores de habilidades pueden extraer una cadena o convertir parte de la información en datos necesarios para realizar la habilidad o la integración.
Para agregar las funciones de transformación, siga los pasos a continuación:

  1. El primer paso es agregar el segmento Set attribute → Transform (Establecer el atributo → Transformar).

    1. Al generar una habilidad, se pueden agregar funciones de transformación al flujo de trabajo de la conversación. Consulte Crear habilidades para obtener más información sobre cómo crear una habilidad.

      1. En la sección Skill builder-->Conversation flow (Generador Constructor de habilidades-->Flujo de conversación), seleccione Set Attribute (Establecer atributo) en Conversation Item (Elemento de conversación). StatustitleUnknown Attachment

        Image Added
      2. En el control Set Attribute (Establecer atributo), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo). StatustitleUnknown Attachment

        Image Added

    2. Al crear la una operación, las funciones de transformación se utilizan en la sección Inbound mapping (Asignación de entrada).

      1. En Create Operation--> Response Configuration (Crear operación--> Configuración de respuesta), seleccione Transform (Transformar) en la lista desplegable Add Attribute (Agregar atributo).

        Status
        titleUnknown Attachment

        Image Added

  2. Una vez que se agrega el segmento a la pantalla, puede seleccionar la función de transformación según sea necesario. Además de los parámetros específicos de la función, los siguientes detalles son necesarios para cada función:

    1. Transform Function (Función de transformacióntransformar): esta es la función de transformación obligatoria. Function Mode (Modo de función), Attribute to Transform (Atributo a para transformar) y otros campos específicos aparecen y se rellenan según la función de transformación seleccionada.

    2. Function Mode (Modo de función): representa los modos de transformación disponibles para la ejecución.

    3. Attribute to Transform (Atributo a para transformar): representa la cadena de entrada que se va a transformar. Puede agregar un atributo válido o una cadena al campo.

    4. Scope (Alcance): representa el ámbito del atributo de salida al que deben pasarse los datos transformados. Puede asignar el valor a un atributo de usuario local, global o personalizado.

    5. Attribute (Atributo): representa el nombre del atributo.

    6. Data Type (Tipo de dato): representa el tipo de dato del atributo. En el caso de los atributos de usuario globales y personalizados, el tipo de dato se rellena según la definición del atributo seleccionado. Cuando utiliza un atributo local, seleccione el tipo de dato en función del valor que guardará.

Las funciones de transformación disponibles en el sistema son las siguientes:

Dividir

La función “Split” (Dividir) se puede utilizar para dividir un texto o una respuesta de integración en cadenas más pequeñas. Divide la cadena en el carácter “delimitador” y extrae el texto en la posición del índice definido de la matriz extraída. La función devuelve un conjunto de cadenas más pequeñas según el orden en que aparecen en la cadena. Posteriormente, las cadenas extraídas se pueden pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Función de transformación

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Dividir

Dividir

Delimiter (Delimitador): es el carácter o expresión que se utiliza para dividir la cadena. En el ejemplo proporcionado, “@” es la expresión delimitadora.

Tenga en cuenta que el atributo de entrada @{user.email} contiene el valor Test@serviceaide.com.

La dirección de correo electrónico del usuario que inició sesión que aparece en el atributo de usuario @{user.email} se divide en el carácter “@” y se devuelve la subcadena en la posición del índice [1].

serviceaide.com

Index Position (Posición del índice): representa la posición del índice para recuperar el texto de la cadena resultante.
Tenga en cuenta que la primera subcadena de la matriz se representa con el índice 0.

...

Recortar

La función “Recortar” se utiliza para eliminar espacios en blanco de la cadena de entrada o del valor del atributo. Devuelve una cadena después de eliminar los espacios en blanco iniciales, finales o adicionales. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Recortar

Recortar

No aplicable

Por ejemplo, si la cadena de entrada es “Luma VSA”.

Se eliminarán todos los espacios en blanco adicionales de la cadena de entrada.

Luma VSA

Status
titleUnknown Attachment

...

Replace - Replace Substring (Reemplazar: Reemplazar subcadena)

La función “Replace” (Reemplazar) busca y reemplaza una subcadena con otra en el texto de entrada. El modo de función “Replace Substring”(Reemplazar subcadena) se utiliza si debe reemplazar todas las ocurrencias de la subcadena en la cadena de entrada. Devuelve una cadena después de reemplazar las ocurrencias de la subcadena con la cadena sustituta especificada. El reemplazo comienza desde el inicio hasta el final de la cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Reemplazar

Reemplazar subcadena

Find (Buscar): representa la subcadena a reemplazar. En el siguiente ejemplo, la subcadena es “VSA”

Por ejemplo, si la cadena de entrada es “VSA Luma VSA”
La búsqueda es “VSA”
El reemplazo es “Virtual Agent”

Cada ocurrencia de la subcadena se reemplazará por la nueva cadena.

Virtual Agent Luma Virtual Agent

Replacement (Reemplazo): representa la cadena sustituta, la que reemplazará la subcadena en el campo Find (Buscar). En el siguiente ejemplo, la subcadena sustituta es “Virtual Agent”.

Status
titleUnknown Attachment

...

Replace - Replace First Substring (Reemplazar: Reemplazar

...

primera subcadena)

La función “Replace” (Reemplazar) busca y reemplaza una subcadena con otra en el texto de entrada. El modo de función “Replace Substring”(Reemplazar subcadena) se utiliza si debe reemplazar la primera ocurrencia de la subcadena en la cadena de entrada. Devuelve una cadena después de reemplazar la primera ocurrencia de la subcadena por la cadena sustituta especificada. El reemplazo comienza desde el inicio hasta el final de la cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Reemplazar

Reemplazar primera subcadena

Find (Buscar): representa la subcadena a reemplazar. En el siguiente ejemplo, la subcadena es “VSA”

Por ejemplo, si la cadena de entrada es “VSA Luma VSA”
La búsqueda es “VSA”
El reemplazo es “Virtual Agent”

La primera aparición de la subcadena se reemplazará por la nueva cadena.

Virtual Agent Luma VSA

Replacement (Reemplazo): representa la cadena sustituta, la que reemplazará la subcadena en el campo Find (Buscar). En el siguiente ejemplo, la subcadena sustituta es “Virtual Agent”.

...

Info

La barra diagonal inversa (\) o del signo de dólar ($) en la cadena de reemplazo pueden afectar el resultado de la transformación. Utilice una expresión regular para reemplazar una cadena o partes de una cadena.

Subcadena

La función “SubString” (subcadena) extrae la subcadena especificada de una cadena de texto para crear otra cadena. La función selecciona caracteres entre ubicaciones especificadas y devuelve lo mismo pero como una nueva cadena. Posteriormente, la cadena extraída se puede pasar a un atributo.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Subcadena

Extraer

Start Position (Posición

de inicio

inicial): especifica la posición del carácter de inicio en la cadena de entrada para iniciar la extracción. En el siguiente ejemplo, la posición

de inicio

inicial es 0.

Tenga en cuenta que el atributo de entrada @{user.email} contiene la dirección de correo electrónico del usuario que inició sesión, Test@serviceaide.com.
La posición

de inicio

inicial es 0
La posición

de cierre

final es 4

La subcadena entre las posiciones especificadas se extraerá en una nueva cadena.

Prueba

End Position (Posición

de cierre

final): especifica la posición del carácter final en la cadena de entrada para detener la extracción. En el siguiente ejemplo, la posición

de inicio

inicial es 4.

...

...

titleUnknown Attachment

Random- Random Number (Aleatorio: número aleatorio)

La función “Random” (Aleatorio) genera un número aleatorio. Los números aleatorios se utilizan principalmente para la autenticación y verificación de usuarios. Por ejemplo, en la generación de OTP para la autenticación de usuarios. El modo de función Random Number (Número aleatorio) seutiliza para generar un número aleatorio con el número especificado de dígitos.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Aleatorio

Número aleatorio

No of digits (

Número

Cantidad de dígitos): representa el número de dígitos necesarios para el número aleatorio.

En el siguiente ejemplo,

el número

la cantidad de dígitos se estableció en 5.

La función genera un número aleatorio de cinco dígitos.

57895 (cualquier número aleatorio)

Status
titleUnknown Attachment

...

Random- Random UUID (Aleatorio: UUID aleatorio (mayúsculas))

La función Random UUID (Uppercase) (UID UUID aleatorio (mayúsculas)) genera un identificador único universal mediante el uso de un código hexadecimal para los caracteres en mayúscula de la A a la F, el mismo se puede guardar en un atributo y utilizar durante la generación de habilidades.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Aleatorio

UUID aleatorio (mayúsculas)

No aplicable

La función genera un código hexadecimal único.

Nota: La función no requiere ningún valor de entrada.

0DBEE5E0-525E-4A12-8A0D-163657286C7F (un UUID aleatorio)

Status
titleUnknown Attachment

...

Epoch Time - Current UTC Time (ms) (Tiempo Epoch: Hora UTC actual (en ms))

La función Epoch Time- Current UTC Time (ms) (Tiempo Epoch: Hora UTC actual (en ms)) se utiliza para generar la hora Unix actual del sistema. La función devuelve la fecha y hora Unix en milisegundos según la zona horaria UTC.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Tiempo Epoch

Hora UTC actual (en ms)

No aplicable

La función devuelve la hora actual de Unix en milisegundos en la zona horaria UTC.

Nota: La función no requiere ningún valor de entrada.

1600330046722 (hora actual)

...

Epoch Time - ISO To Epoch in milliseconds (Tiempo Epoch: ISO a Epoch en milisegundos)

La función Epoch Time - ISO To Epoch in milliseconds (Hora Tiempo Epoch: ISO a Epoch en milisegundos) se utiliza para convertir el formato de hora ISO a tiempo Epoch (Unix) en milisegundos. La función convierte el formato horario ISO-8601 de entrada y devuelve la fecha y hora en formato de milisegundos Epoch.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Tiempo Epoch

ISO a Epoch en milisegundos

No aplicable

Por ejemplo, si la cadena de entrada es
2020-07-16T19:20:30.45+01:00

La función devuelve la fecha y hora en milisegundos Epoch según formato horario ISO-8601 especificado.

1594923630000

...

Epoch Time - ISO To Epoch in seconds (

...

Tiempo Epoch: ISO a Epoch en segundos)

La función Epoch Time - ISO To Epoch in seconds (Hora Tiempo Epoch: ISO a Epoch en segundos) se utiliza para convertir el formato fecha y hora ISO a Epoch (Unix) en segundos. La función convierte el formato de fecha y hora ISO-8601 de entrada y lo devuelve en formato de segundos Epoch.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Tiempo Epoch

ISO a Epoch en segundos

No aplicable

Por ejemplo, si la cadena de entrada es
2020-07-16T19:20:30.45+01:00

La función devuelve la hora Unix en milisegundos para la fecha y hora especificada en formato ISO-8601.

1594923630

Status
titleUnknown Attachment

...

Custom Date format - Using ISO Date Time (Formato de fecha personalizado: uso de la fecha y hora ISO)

La función de Custom Date Format (Formato de fecha personalizado) convierte el formato de fecha ISO al formato de fecha y hora requerido. La función devuelve la fecha y hora de entrada en el formato de fecha especificado, como dd-mm-aaaa, mm-dd-aaaa, entre otras opciones.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Formato de fecha personalizado

Uso de la fecha y hora ISO

Format (Formato): representa el formato de fecha y hora al que se debe transformar la cadena de entrada.

ISO Date Time (Fecha y hora ISO): representa la fecha y hora de entrada en formato ISO 1806. Aquí puede proporcionar un atributo que contenga una fecha y hora en formato ISO o una cadena.

Tenga en cuenta que la fecha y hora ISO de entrada es
2020-07-16T19:20:30.45+01:00
y el formato es d-m-a

La función devuelve la hora de entrada en formato de hora ISO-8601 a d-m-a (día-mes-año)

16-7-2020

Status
titleUnknown Attachment

...

Custom Date format - Using Epoch Time (Formato de fecha personalizado: uso

...

del tiempo Epoch)

La función de formato Custom Date Format (Formato de fecha personalizado (Custom Date format) convierte el tiempo Epoch a la fecha y hora en la zona y el formato especificados. La función devuelve el tiempo Epoch de entrada en milisegundos en la zona y el formato de fecha y hora especificados, como d-m-a, m-d-a h:m, entre otras opciones.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Formato de fecha personalizado

Uso de la fecha y hora ISO

Format (Formato): representa el formato de fecha y hora al que se debe transformar la cadena de entrada.

Epoch Time (Milliseconds) (Tiempo Epoch [milisegundos]): representa

la fecha y hora

el tiempo Epoch de entrada en milisegundos que se debe convertir al formato especificado.
Aquí puede proporcionar un atributo que contenga

la fecha y hora

el tiempo Epoch o una cadena.

Zoneid (ID de

la

zona): representa la zona horaria a la que se debe convertir la cadena de entrada. Por ejemplo, America/Sao_Paulo, America/New_York, Asia/Kolkata, Asia/Shanghai,

entre otras

etc.

Si en la entrada
el tiempo Epoch es “1594923630000”,
el formato es d-M-a H m,
y el ID de

la

zona es “Asia/Kolkata” (Calcuta).

La función devuelve la fecha y hora de entrada en d-M-a H m (día-mes-año hora minutos)

16-7-2020 23 50

Status
titleUnknown Attachment

...

Custom Date format - ISO Zoned Date Time (Formato de fecha personalizado: uso de fecha y hora con zona ISO)

La función de Custom Date Format (Formato de fecha personalizado) convierte la fecha y hora ISO a una zona y un formato específicos. La función devuelve la fecha y hora ISO en la zona especificada.

Agregue los siguientes detalles para utilizar la función:

Función

Modo de función

Campos específicos de la función

Ejemplo

Resultado

Formato de fecha personalizado

Fecha y hora con zona ISO

ISO Date Time (Fecha y hora ISO): representa la fecha y hora ISO que se convertirá al formato especificado. Aquí puede proporcionar un atributo que contenga la fecha y hora ISO o una cadena.

ZoneId (ID de zona): representa la zona horaria a la que se debe convertir la fecha y hora de entrada. Por ejemplo, America/Sao_Paulo, America/New_York, Asia/Kolkata, Asia/Shanghai, etc.

Si en la entrada
La fecha y hora ISO es 2021-04-01T19:35:46Z
y el ID de zona es “Asia/Kolkata” (Calcuta).

La función devuelve la fecha y hora en la zona horaria seleccionada.

2021-04-02T01:05:46+05:30

...

Nota: Los formatos de fecha y hora deben proporcionarse mediante los siguientes símbolos. Por ejemplo, utilice d-M-y para día-mes-año o d/M/y H: m para día-mes-año horas: minutos. StatustitleUnknown Attachment

...