Los tokens de watermark permiten convertir un único diseño en output específico por destinatario. En lugar de escribir un nombre distinto para cada persona, puede insertar un token compatible como {NAME} y dejar que XERIA lo resuelva con los datos del destinatario durante la generación personalizada.
Esto es especialmente útil en workflows batch porque el diseño se mantiene igual mientras cambia automáticamente el valor del destinatario en cada PDF. Los tokens reducen trabajo repetitivo, pero hacen más importante la calidad de los datos: un nombre incorrecto puede propagarse a muchas copias.
Respuesta breve
Cree o seleccione la lista de destinatarios, abra los ajustes de texto del watermark en el workflow personalizado, inserte un token compatible como {NAME} y combínelo con texto fijo si lo necesita. XERIA resolverá el token de forma independiente para cada destinatario.
Un token es un placeholder, no el texto visible final. Por ejemplo, en “Confidential — {NAME}”, la palabra “Confidential” permanece fija mientras {NAME} se sustituye por el nombre del registro activo.
Qué hace un token de watermark
Un token vincula el texto del watermark con los datos del destinatario. La plantilla se crea una sola vez y el valor final se obtiene del registro correspondiente durante la generación. Así, el mismo PDF y el mismo diseño pueden producir muchas copias diferentes.
Los tokens resultan especialmente útiles en el modo batch personalizado. A diferencia de un watermark fijo, el texto final se resuelve durante el procesamiento según el destinatario.
1. Prepare primero los datos de destinatarios
Antes de usar tokens, revise la lista que suministrará los datos. Los nombres deben ser correctos, coherentes y adecuados para mostrarse de forma visible. Registros de prueba, nombres vacíos, duplicados o valores de otro proyecto pueden generar watermarks engañosos.
- Seleccione la lista prevista antes de producción
- Revise nombres y demás valores usados por el workflow
- Elimine o excluya destinatarios de prueba
- Compruebe duplicados y registros obsoletos
- Mantenga coherente la identidad con trace y delivery records
- Use nombres claros de lista para reducir selecciones accidentales
2. Inserte y use un token de watermark
Paso 1: abra el workflow de watermark personalizado
Abra en XERIA el workflow donde se configura la generación específica por destinatario. Seleccione la lista y el PDF fuente, y abra los ajustes de texto del watermark que se aplicarán a las copias.
Paso 2: inserte un token compatible
Inserte un token ofrecido por XERIA. El ejemplo confirmado es {NAME}, que representa el nombre del destinatario. Mantenga exactamente la escritura y las llaves para que el placeholder se reconozca correctamente.
Paso 3: añada texto fijo alrededor del token
Puede combinar el token con texto normal. “Prepared for {NAME}” o “Confidential — {NAME}” mantienen la parte fija y cambian solo el nombre en cada copia.
Paso 4: configure el aspecto del watermark
Después configure posición, ángulo, opacidad, color y demás ajustes visuales. El token cambia el valor del texto, no sustituye la configuración visual.
Paso 5: pruebe antes de producción
Ejecute una pequeña prueba con algunos destinatarios conocidos antes del lote completo. Confirme que el token se resuelve al nombre esperado, que el texto fijo permanece correcto y que el watermark sigue siendo legible.
3. Combine texto dinámico y fijo
Los diseños más prácticos mezclan una frase fija con un valor dinámico. La frase fija explica el contexto y el token asocia la copia al destinatario. Ejemplos: “Confidential — {NAME}”, “Prepared for {NAME}” o “Recipient copy: {NAME}”.
Mantenga el texto corto. Los nombres largos combinados con frases largas pueden saturar el diseño, especialmente en watermarks tiled o repetidos. Pruebe el nombre más largo realista de la lista.
4. Revise el watermark resuelto antes de un lote grande
Incluso un token válido puede dar un resultado no deseado si los datos son incorrectos o el diseño no admite valores largos. Pruebe nombres cortos y largos, alfabetos distintos cuando corresponda y casos límite relevantes.
- Confirme que {NAME} se sustituye y no se imprime literalmente
- Compruebe que los nombres largos caben en el diseño
- Revise opacidad y contraste en zonas claras y oscuras
- Compruebe ángulo y posición
- Verifique la legibilidad de watermarks repetidos o tiled
- Confirme que la lista correcta suministra los valores
5. Use tokens en generación batch personalizada
Los tokens aportan más valor cuando un PDF fuente debe prepararse para muchos destinatarios. XERIA puede generar copias separadas con la lista seleccionada y resolver el token para cada registro. Así se evita editar manualmente el texto antes de cada archivo.
La lista es la fuente de datos y el diseño del watermark es la plantilla. Si necesita preparar primero la lista, consulte [Crear y gestionar listas de destinatarios en XERIA](/resources/articles/create-manage-recipient-lists-in-xeria/). Revise la lista antes de cada producción importante.
6. Tokens y trace information están relacionados, pero no son lo mismo
Un token visible y las funciones de trace de XERIA apoyan objetivos similares de accountability, pero son mecanismos distintos. {NAME} muestra datos del destinatario en el watermark. Los trace codes y la información QR opcional aportan datos adicionales orientados a trazabilidad.
No suponga que un campo de trace tiene automáticamente una sintaxis de token concreta salvo que XERIA la muestre explícitamente. Mantenga coherentes tokens visibles, trace codes, QR, filenames y registros de destinatario.
Errores comunes que conviene evitar
La mayoría de los problemas provienen de la escritura, los datos del destinatario o la selección del workflow. Un token mal escrito puede quedar sin resolver y una lista equivocada puede producir valores inesperados.
- Usar un token no compatible o inventado
- Cambiar las llaves o la escritura requerida
- Usar la lista equivocada para el batch
- Dejar nombres vacíos o destinatarios de prueba
- Diseñar texto fijo demasiado largo para nombres reales
- Suponer que el token demuestra quién copió o redistribuyó después el documento
Buenas prácticas
Trate la plantilla y la lista como dos partes de un workflow controlado. Mantenga la sintaxis tal como la ofrece XERIA, use datos limpios, pruebe valores largos y verifique una muestra antes de la producción completa. Considere el watermark visible como una capa de deterrence y accountability, no como prevención absoluta de copias.
- Use solo tokens que muestre la interfaz actual de XERIA
- Mantenga el texto fijo corto y claro
- Pruebe nombres cortos, largos y no latinos cuando corresponda
- Revise la lista seleccionada antes de producción
- Mantenga coherente la identidad entre watermark, trace y delivery
- No describa el watermark visible como prevención absoluta de copias
Cómo encajan los tokens en XERIA
XERIA usa tokens como parte de su workflow de PDF específico por destinatario. Un token compatible puede insertar datos del destinatario en el texto visible mientras el resto del diseño se reutiliza en todo el batch.
Esto puede combinarse con generación batch personalizada, watermarks visibles, trace codes, QR opcional, contraseña y permisos, e-mail controlado, outputs cloud y Mail Log. Cada control cubre una parte distinta del workflow de distribución.
Preguntas frecuentes
¿Qué hace {NAME} en XERIA?
{NAME} es un token confirmado para el nombre del destinatario. Durante la generación personalizada, XERIA lo sustituye por el nombre del registro correspondiente.
¿Puedo escribir cualquier campo entre llaves y usarlo como token?
No lo suponga. Use únicamente tokens que XERIA muestre como compatibles. Que exista un campo en la base de datos no significa que exista automáticamente un token con el mismo nombre.
¿Puedo combinar un token con texto normal?
Sí. Puede usar frases como “Prepared for {NAME}” o “Confidential — {NAME}”. El texto fijo permanece igual y el token se resuelve para cada destinatario.
¿Un watermark personalizado impide que el destinatario copie el documento?
No. Puede apoyar deterrence, accountability y atribución posterior, pero un usuario autorizado aún puede hacer capturas, fotos, reescribir contenido o redistribuir el archivo.
Conclusión
Los tokens hacen que el workflow de watermark personalizado de XERIA sea reutilizable y escalable. Prepare datos limpios, use solo tokens compatibles como {NAME}, combínelos con texto fijo breve, pruebe el resultado y después ejecute el batch personalizado.