Las variables son elementos de texto reutilizables que te permiten definir un valor una vez e insertarlo en varios artículos y páginas de categoría. Cuando cambia el valor, actualizas la variable en un solo lugar y cada artículo que lo usa se actualiza automáticamente.
Por ejemplo, si tu correo de soporte aparece en 40 artículos y cambia, actualizar la variable una vez actualiza los 40 artículos al instante.
Cuándo usar variables
Utiliza variables para contenido corto basado en texto que:
- Aparece en varios artículos o páginas de categorías.
- Es probable que cambien con el tiempo, como datos de contacto, números de versión, nombres de productos, URLs, etiquetas de campos o avisos legales.
- Debe mantenerse coherente en toda la base de conocimiento.
Para contenido más largo o con formato, como párrafos, tablas, llamados o imágenes, utiliza Fragmentos .
Variables vs. fragmentos
| Variables | Fragmentos | |
|---|---|---|
| Tipo de contenido | Texto plano, números, enlaces, frases cortas. | Bloques formateados como párrafos, tablas, imágenes, señales y código. |
| Uso típico | Nombres de productos, números de versión, correos de soporte. | Avisos, pasos compartidos, bloqueos de contacto, advertencias repetidas. |
| Límite de caracteres | 300 caracteres. | Sin límite de caracteres. |
| Soporte de formato | Solo formato básico en línea. | Formato completo del editor. |
| Insertado mediante | Barra de herramientas, sintaxis de fusión de código o comando de barra. | Sintaxis de la barra de herramientas o del código de fusión. |
Empieza con variables
Crear y gestionar variables
Crea una variable y configura su nombre, fusiona código, lenguaje y contenido. Editar, eliminar, eliminar en masa y ver dependencias de artículos.
Más información →Uso y traducción de variables
Inserta variables en los artículos usando la barra de herramientas, la sintaxis de fusión de código o el comando de barra. Traduce variables para bases de conocimiento multilingües.
Más información →Mejores prácticas
- Usa variables para contenido que cambia, no para contenido que permanece fijo. Las variables son más valiosas cuando el contenido necesita actualizarse periódicamente. Si un valor es poco probable que cambie, escribirlo en línea es más sencillo y fácil de revisar.
- Solo usa variables cuando el mismo contenido aparece en tres o más lugares. Si algo aparece en uno o dos artículos, actualizarlos directamente es más rápido que crear y gestionar una variable.
- Usa nombres descriptivos y específicos. Nombra variables para que los colaboradores puedan identificar la correcta de un vistazo. Por ejemplo,
SupportEmailoProductVersion_iOSes más clara queemail1ov1. Nombres vagos ralentizan la autoría y hacen que se inserte la variable incorrecta. - Establece el alcance del lenguaje intencionadamente. Usa Global para valores que son iguales en todos los idiomas, como un nombre de producto que nunca se traduce. Utiliza variables específicas del idioma para valores que varían según la localidad, como un número de teléfono regional o una URL localizada.
- Comprueba la columna Usado en antes de editar o eliminar. Una edición en una variable actualiza inmediatamente todos los artículos que la usan, incluidos los publicados. Antes de hacer un cambio, revisa qué artículos se ven afectados para poder verificar que el valor actualizado se lee correctamente en todos los contextos.
- No uses variables dentro de fragmentos. Las variables dentro de fragmentos no se renderizan correctamente en la vista previa del editor ni en las exportaciones de PDF. Si un fragmento necesita valores dinámicos, gestiona los datos por separado.