Operaciones con Strings para contenido dinámico de emails: Modifica Cadenas de Texto en Tiempo Real usando VTL

Cuando trabajas con plantillas de email en DANAconnect, puedes modificar y adaptar cadenas de texto en tiempo real utilizando VTL (Velocity Template Language). Estas operaciones son útiles para personalizar la forma en que los nombres, títulos o cualquier texto se presenta en tu comunicación. Puedes transformar cadenas a mayúsculas, minúsculas, capitalizar palabras, y más.

¿Qué Son las Operaciones con Strings?

Las operaciones con strings te permiten manipular cadenas de texto de varias maneras, como:
- Convertir texto a mayúsculas o minúsculas.
- Capitalizar palabras o frases.
- Reemplazar texto dentro de una cadena.
- Cortar texto o extraer solo una parte de la cadena.

Casos de Uso Comunes

1. Convertir a Mayúsculas

Si necesitas mostrar el nombre de un usuario o cualquier otro dato en mayúsculas, puedes utilizar la función toUpperCase().

Ejemplo:

#set( $nombreMayuscula = $s{nombre}.toUpperCase() )
Nombre en mayúsculas: $nombreMayuscula

Resultado:

Nombre en mayúsculas: JUAN PÉREZ

2. Convertir a Minúsculas

De manera similar, si prefieres que el texto esté en minúsculas, puedes usar toLowerCase().

Ejemplo:

#set( $nombreMinuscula = $s{nombre}.toLowerCase() )
Nombre en minúsculas: $nombreMinuscula

Resultado:

Nombre en minúsculas: juan pérez

3. Capitalizar la Primera Letra de Cada Palabra

Para capitalizar la primera letra de cada palabra, puedes usar una combinación de funciones.

Ejemplo:

#set( $nombreCapitalizado = $stringTool.capitalize($s{nombre}) )
Nombre capitalizado: $nombreCapitalizado

Resultado:

Nombre capitalizado: Juan Pérez

4. Reemplazar Texto Dentro de una Cadena

A veces es útil reemplazar una parte específica de un texto. Puedes hacerlo con replace().

Ejemplo:

#set( $stextoOriginal = "Gracias por tu compra, [nombre]" )
#set( $textoModificado = $textoOriginal.replace("[nombre]", $s{nombre}) )
Texto final: $textoModificado

Resultado:

Texto final: Gracias por tu compra, Juan Pérez

5. Extraer Parte de una Cadena

Puedes extraer una parte específica de una cadena utilizando substring().

Ejemplo:

Si tienes un código promocional y solo necesitas los primeros 5 caracteres:

#set( $codigoPromo = $s{codigoPromocional}.substring(0,5) )
Código promocional corto: $codigoPromo

Resultado:

Código promocional corto: ABC12

6. Determinar el Largo de una Cadena

Para obtener el largo de una cadena de texto, puedes usar length().

Ejemplo:

Longitud del nombre: $s{nombre}.length()

Resultado:

Longitud del nombre: 10

Ejemplos Prácticos

Personalización del Nombre del Cliente

En un email de bienvenida, puedes personalizar el saludo capitalizando el nombre del cliente.

#set( $nombreCapitalizado = $stringTool.capitalize($s{nombre}) )
Hola $nombreCapitalizado, bienvenido a nuestro servicio.

Resultado:

Hola Juan Pérez, bienvenido a nuestro servicio.

Ajustar el Estilo de Texto a Mayúsculas

Si en tu comunicación prefieres usar un estilo más formal o resaltar algo importante, puedes convertir el texto a mayúsculas.

#set( $mensaje = "Te recordamos que tienes un saldo pendiente." )
#set( $mensajeMayuscula = $mensaje.toUpperCase() )
Mensaje: $mensajeMayuscula

Resultado:

Mensaje: TE RECORDAMOS QUE TIENES UN SALDO PENDIENTE.

Conclusión

Las operaciones con strings en VTL te permiten modificar y adaptar cadenas de texto en tiempo real, para que se ajusten al estilo de tu comunicación. Ya sea que necesites convertir texto a mayúsculas, minúsculas, capitalizar palabras, o realizar cualquier tipo de modificación textual, estas herramientas te ayudarán a personalizar tus mensajes de manera efectiva.

Actualizado el: 21/10/2024