A diferencia de los datos asociados a un flujo, los valores almacenados en caché permanecen disponibles incluso después de alcanzar el nodo Step Close. Además, puedes configurar si los datos serán exclusivos de una sesión o estarán disponibles para todas las sesiones de la instancia.
Configuración del nodoA continuación, encontrarás la descripción de los campos disponibles para configurar el nodo:
1. Name:
Permite personalizar el nombre del nodo, que será visible en el workspace de Studio.
2. Key (obligatorio):
Define el nombre de la clave con la que se almacenará el dato en caché y que utilizarás posteriormente para recuperarlo.
Este campo admite la sintaxis Mustache {{varExample}} para acceder a propiedades del objeto msg, por ejemplo, msg.varExample.3. Global:
Define el alcance de los datos almacenados:
- False: el valor estará disponible únicamente en la sesión del usuario en la que se almacenó.
- True: el valor estará disponible para todas las sesiones de la instancia.
Permite seleccionar uno de los cuatro métodos disponibles para operar sobre los datos almacenados en caché: GET, SET, INCREMENT y DELETE.
GETPermite recuperar un dato almacenado previamente en caché. La disponibilidad del dato dependerá del valor configurado en Global al momento de almacenarlo:
- True: estará disponible para todas las sesiones, como un caché compartido del bot.
- False: estará disponible únicamente en la sesión donde se guardó.
Si el valor no existe, el resultado será null.Este método incluye los siguientes campos:
- Output: define el nombre de la variable donde se almacenará el valor recuperado. Puedes utilizar una variable existente o crear una nueva.
- Decrypt: permite descifrar los datos almacenados previamente mediante la opción Encrypt.
SETPermite almacenar información en caché mediante una clave para recuperarla posteriormente.
Incluye los siguientes campos:
- Input: indica el nombre de la variable de msg, string o JSON que deseas almacenar.
- Expires: define el tiempo de permanencia de los datos en caché, expresado en minutos. El valor predeterminado es 60 minutos. Puedes configurar un mínimo de 1 minuto y un máximo de 1440 minutos (24 horas).
- Encrypt: permite cifrar los datos antes de almacenarlos. Si habilitas esta opción, deberás activar Decrypt al recuperarlos para poder leer su contenido.
INCREMENTFunciona como un contador y cada vez que se ejecuta, incrementa el valor almacenado en 1. Si la variable no existe, se inicializa automáticamente en 1.
En este método, deberás completar el campo Output, al igual que en GET, para definir dónde se almacenará el resultado.
DELETEPermite eliminar una clave y el valor asociado que se hayan almacenado previamente en caché. Para hacerlo, deberás indicar la clave correspondiente en el campo Key.
Cuando un dato almacenado en caché expira o se elimina, su valor pasa a ser null.
El valor de Global debe coincidir con el utilizado al guardar el dato. Por ejemplo, si se almacenó con Global = True, el nodo DELETE también deberá configurarse con Global = True. Lo mismo aplica cuando se utiliza False.
Datos clavePara garantizar el correcto funcionamiento del nodo, ten en cuenta las siguientes consideraciones:
1. Propiedad msg._studio
No debes eliminar ni modificar esta propiedad, ya que es necesaria para el funcionamiento del nodo.
El agentbot user id debe estar almacenado en la propiedad msg._studio.sessionId. Las configuraciones existentes que utilicen otros identificadores de sesión continuarán funcionando con normalidad.
2. Variables vacías o no definidas
Si intentas almacenar un dato de una variable del objeto msg cuyo valor está vacío, es null o no está definido, se mostrará una advertencia en la consola Debug con el siguiente formato:
"Warning: {{msg property name}} maybe empty or undefined."
3. Ausencia del agentbot user id
Si utilizas cualquiera de los métodos disponibles (GET, DELETE, INCREMENT o SET) con Global = False y el agentbot user id no está presente cuando el nodo recibe la petición, se mostrará el siguiente mensaje de advertencia en la ventana Debug de Studio:
"The agentbot user ID is not present in the msg object, and global is false. Stored data may be unreachable."
En este escenario, el dato se almacenará de forma global y deberás recuperarlo utilizando también Global = True.4. Uso del nodo Cache con HTTP_IN
Si utilizas el nodo Cache junto con un nodo HTTP_IN, deberás establecer manualmente el ID de sesión. Puedes hacerlo en cualquiera de las siguientes propiedades, respetando este orden de precedencia:
- msg._studio.sessionId
- msg.payload.agentbot_user.id
- msg.payload.id
Puedes descargar el flujo de ejemplo en este link.
En el siguiente video te mostramos cómo configurar el nodo: