Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

Regla de redirección de artículos

Prev Next

Planes que admiten esta función: Professional Business Enterprise

Puedes configurar una regla de redirección de artículos para cualquier URL publicada o en borrador. La función de redirección es útil cuando cambias la URL de un artículo y esa misma URL ha sido referenciada en otros artículos de tu base de conocimiento. También puedes hacer una importación masiva de reglas de redirección.

Las reglas de redirección impiden que los usuarios hagan clic en enlaces muertos o rotos.


Añadir una regla de redirección de artículos

Puedes cambiar la URL o el slug de un artículo antes o después de publicar la página del artículo o de la categoría. La URL de una categoría de tipo índice también puede modificarse. Puedes hacer estos cambios directamente en el editor de artículos.

Para añadir la regla de redirección de artículos, sigue los pasos a continuación:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

    La página de reglas de redirección de artículos aparecerá con una lista de reglas existentes (si las hay).

  3. Haz clic en Nueva redirección para crear una nueva regla de redirección.

    Aparecerá el nuevo panel de reglas de redirección .

  4. Selecciona el tipo de redirección deseado:
    a. Termina en: Para establecer la regla de redirección de un artículo con el slug único al final de tu URL.
    b. Sustituir por: Para establecer la regla de redirección para el texto URL entre el nombre de dominio y el slug del artículo.

    NOTA

    En el campo de reglas de Redirección , se admiten los siguientes caracteres especiales: # % ^ & _ - + = | . ? /

Overview of article redirect rules in a knowledge base management system interface.

Termina con

  1. En el campo Ruta de origen , escribe el slug único al final de tu URL para la redirección.

NOTA

El slug de URL en la ruta de origen debe comenzar con una barra diagonal (/).

  1. En el campo URL de destino , escribe la URL de destino completa o el nuevo slug para redirección. Añadir una barra diagonal hacia adelante (/) al principio de la URL de destino es opcional.

Ejemplo: Para redirigir la URL del artículo desde https://docs.document360.com/docs/getting-started-with-document360 a https://docs.document360.com/docs/getting-started-video-library, añade la ruta de origen y la URL de destino como se menciona a continuación:
Ruta de origen: /getting-started-with-document360
URL de destino: getting-started-video-library

  1. Haz clic en Crear.

Sustituye por

  1. En el campo de ruta de fuente , escribe el texto entre el dominio y el slug del artículo que quieres redirigir.

Ejemplo: La ruta de origen en la URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started es /v1/docs/fr/.

NOTA

El camino fuente debe comenzar y terminar con una barra diagonal (/).

  1. En el campo Reemplazar texto , escribe el nuevo texto de la URL que quieres usar para la redirección.

Ejemplo: Sustituye /v1/docs/fr/ por /v2/docs/en/ en la URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started.

NOTA

El texto de reemplazo debe comenzar y terminar con una barra diagonal (/).

  1. Haz clic en Crear.


Mejores prácticas

Si gestionas una base de conocimiento multilingüe con múltiples espacios de trabajo de proyecto, establece reglas de redirección basadas en el idioma o espacio de trabajo. Por ejemplo, si se establece una regla con la ruta /customer-support de origen y el destino /sales-and-support, esto solo se aplica al lenguaje predeterminado del espacio de trabajo principal.

  • Para aplicar esta regla a otro idioma (por ejemplo, alemán: /de/), crea una nueva regla con la ruta /de/customer-support fuente y el destino /de/sales-and-support.

  • Para aplicar la regla en otro espacio de trabajo (por ejemplo, versión 1: /v1/), establezca la ruta /v1/docs/customer-support de origen y el destino /v1/docs/sales-and-support.


Regla de redirección a nivel de sitio

En la página de reglas de redirección de artículos , puedes establecer una regla de redirección de subcarpeta a nivel de sitio usando la opción Reemplazar por . Esto es útil para migrar desde otra plataforma o redirigir espacios de trabajo/idiomas eliminados o ocultos.

Ejemplo: Establece una regla de redirección para la subcarpeta /azure/serverless en /data/cloud360 las URLs como https://apidocs.serverless360.com/azure/serverless/article_slug.


Edición de una regla de redirección

Para editar la regla de redirección de artículos, sigue los siguientes pasos:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

    La página de reglas de redirección de artículos aparecerá con una lista de reglas existentes (si las hay).

  3. Usa el Filtro para encontrar la regla de redirección deseada.

  4. Pasa el cursor sobre la regla deseada y haz clic en el icono Editar ().

    Aparecerá el panel de reglas de Editar redirección .

  5. Actualiza el(los) campo(s) necesario(s).

  6. Haz clic en Actualizar.


Eliminación de una regla de redirección

Para eliminar una regla de redirección de artículo, sigue los siguientes pasos:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

    La página de reglas de redirección de artículos aparecerá con una lista de reglas existentes (si las hay).

  3. Usa Filtro para encontrar la regla de redirección deseada.

  4. Pasa el cursor sobre la regla deseada y haz clic en el icono Borrar ().

  5. Para eliminar varias reglas, selecciona las casillas de verificación junto a las reglas y haz clic en Eliminar.

  6. Haz clic en en el panel de confirmación de Eliminar .

NOTA

Las reglas de redirección eliminadas no pueden ser recuperadas.


Filtrar una regla de redirección

Para filtrar la regla de redirección deseada, sigue los pasos siguientes:

  1. Búsqueda: Introduce una palabra clave desde la ruta de origen o la URL de destino en la barra de búsqueda, y el resultado se llena.

  2. Tipo: Filtrar por el tipo de redirección: Termina con, Reemplazar con, o Ambos.

  3. Fecha de modificación: Filtra las reglas por la última fecha de modificación, con opciones como 1 año, 3 meses, 30 días o 7 días. Haz clic en Fecha personalizada para elegir cualquier rango de fechas personalizado y selecciona el rango deseado.


Importación de reglas de redirección

Para importar reglas de redirección masiva de una vez, sube un CSV que coincida con la siguiente plantilla:

Fuente

Destino

RedirectionType

/myoldarticle

newarticle

Termina con

/en/customers/

/v1/docs/

reemplazar con

NOTA

El tamaño del archivo debe ser menor o igual a 1MB.

Plantilla de archivo de reglas de importación de redirección

También puedes descargar la plantilla aquí:

Para importar reglas de redirección en masa:

  1. Prepara un archivo CSV que coincida con la plantilla proporcionada (tamaño de archivo ≤ 1MB).

  2. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  3. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

  4. Haz clic en la regla de importar redirección.

    Aparecerá el panel de reglas de redirección de importación .

    Instructions for importing redirect rules from a CSV file with upload options.

  5. Arrastra y suelta el archivo CSV o selecciona Haz clic para subir.

  6. Revisa la lista de normas válidas e inválidas.

    NOTA

    Haz clic en el icono Descargar () cerca del recuento de reglas inválidas para descargar la lista de reglas inválidas.

  7. Haz clic en Importar para aplicar las reglas válidas.

    Importing redirect rules from a CSV file with validation summary details displayed.


Reglas de redirección de exportación

Para exportar las reglas de redirección como archivo CSV, sigue los pasos siguientes:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

  3. Haz clic en Exportar para descargar las reglas como archivo CSV.


Solución de problemas

Artículo publicado que redirige o muestra un error 404

Un artículo publicado en el sitio de la base de conocimiento puede redirigir a otro artículo o provocar un error 404 debido a una regla de redirección mal configurada aplicada al enlace del artículo.

Pasos para resolver:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

  3. Utiliza la barra de búsqueda para encontrar el slug del artículo y comprueba si se aplica una regla de redirección.

  4. Si se aplica una regla de redirección, revisa su propósito. Si la regla no es necesaria o está mal configurada, elimínala.

  5. Guarda los cambios y revisa el artículo para asegurarte de que se muestra como se espera en la página de la base de conocimientos.

Si el problema persiste después de seguir estos pasos, póngase en contacto con el equipo de soporte de Document360 para obtener más ayuda: Póngase en contacto con el equipo de soporte de Document360

Encontrarse con un error al guardar una regla de redirección de artículo.

Error: No se ha podido guardar la regla de redirección del artículo. La fuente dada ya forma parte de un destino existente.

Este error ocurre cuando se utiliza un slug de destino (el objetivo de una regla de redirección existente) como camino fuente para otra redirección. Una vez que un destino se establece en una regla de redirección, se convierte en un destino estático y no puede reutilizarse como fuente en una nueva regla.

Pasos para resolver:

  • Asegúrate de que el slug de destino no se utilice como camino fuente en ninguna regla de redirección existente o nueva.

  • Revisa y actualiza tus normas de redirección para evitar conflictos.

An error message indicating failure to save article redirection rule in the Knowledge base portal.

Cómo evitar errores 404 tras eliminar lenguajes en la base de conocimientos

Cuando los idiomas se eliminan o se ocultan del sitio de la Base de conocimientos, los lectores pueden encontrarse con errores 404 si intentan acceder a versiones eliminadas de los artículos.

Una vez que un idioma es eliminado del proyecto, todos los artículos asociados a ese idioma dejan de estar disponibles. Sin embargo, los usuarios con enlaces marcados o acceso directo a esas URLs pueden intentar abrirlas, lo que provoca errores 404.

Pasos para resolver:

Para evitar errores 404 y redirigir a los usuarios a la versión principal del artículo, establece reglas de redirección para los idiomas eliminados:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Reglas de redireccionamiento de artículos.

  3. Haz clic en Nueva redirección para añadir una nueva regla de redirección.

    Aparecerá el nuevo panel de reglas de redirección .

  4. Elige Reemplazar con en la sección de tipo Redirección .

  5. En el camino de Fuente, introduce /docs/<language_code> (por ejemplo, /docs/fr para francés, /docs/es español, /docs/de alemán).

  6. En el texto Reemplazar, introduce / para redirigir todos los enlaces de artículos específicos del idioma al idioma principal.

  7. Haz clic en Crear para guardar la regla.

    Repite el proceso para cada idioma eliminado. Una vez aplicadas estas reglas de redirección, cualquier intento de acceder a un artículo eliminado redirigirá automáticamente a los usuarios a la versión principal, evitando errores 404 incluso si los enlaces están marcados.

Creating a new redirect rule with source path and replace text fields filled.


Preguntas más frecuentes

¿Qué son los enlaces muertos?

Los enlaces muertos, o enlaces rotos, son hipervínculos que ya no funcionan debido a problemas como cambios en URLs, URLs incorrectas o artículos restringidos/privados. Normalmente dan lugar a una página de error 404.

¿Qué es una de artículo?

Un slug es la parte de una URL que identifica de forma única un artículo o página específica. Viene después de la / URL raíz de tu proyecto.

Ejemplo:
URL del artículo: https://docs.document360.com/docs/why-did-we-build-document360

:/why-did-we-build-document360

¿Cuántas reglas de redirección puedo configurar en un proyecto?

Puedes configurar un máximo de 10.000 reglas de redirección por proyecto. Si superas el límite, por favor contacta con nuestro equipo de soporte.

¿Hay límites para la función de reglas de importación de redirección?

Puedes importar hasta 1.000 reglas de redirección al día y usar la función de importación hasta cinco veces al día. Si superas el límite, por favor contacta con nuestro equipo de soporte.

¿Por qué veo el error "El sitio de la base de datos se redirige demasiadas veces cuando se accede"?

Este error ocurre debido a un bucle de redirección, a menudo causado por establecer la URL del sitio de la base de conocimientos de Document360 como la URL de inicio de sesión para la autenticación JWT. Asegúrate de que la URL de inicio de sesión para la autenticación JWT no sea la misma que la URL del sitio de Document360 KB. Utiliza una página de autenticación dedicada como URL de inicio de sesión para evitar bucles de redirección y resolver el error.

¿Cómo podemos abordar el problema de los errores 404 cuando descontinuamos funcionalidades que llevan a enlaces entrantes desde fuentes que no podemos controlar?

Para funciones descontinuadas, para gestionar eficazmente los errores 404, crea un artículo estándar informando a los usuarios sobre la discontinuación de una funcionalidad, que puede usarse para redirigir artículos relevantes.

Para múltiples funcionalidades descontinuadas, considera establecer una página centralizada que consolide toda la información relacionada, asegurando que los usuarios puedan acceder fácilmente a las actualizaciones y reduciendo la ocurrencia de enlaces caídos.

¿Cómo redirijo un artículo de una página a otra usando JavaScript personalizado?

Para redirigir un artículo de una página a otra usando JavaScript personalizado, sigue los pasos a continuación:

  1. Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.

  2. En el panel de navegación izquierdo, navega a Personalizar el sitio.

  3. Haz clic en CSS y JavaScript personalizados.

  4. Pega el siguiente código en la pestaña de JavaScript :

    $(document).ready(function() {
      if(panel.location.href=="source URL") {
        panel.location.replace("destination URL");
      }
    });
    
  5. Sustituye la URL de origen y la URL de destino en el código.

  6. Haz clic en Guardar.

¿Cómo escribo una regla de redirección para reemplazar el nombre del espacio de trabajo en la URL?

Puedes usar reglas de redirección al migrar de otra plataforma a Document360.

  • Estructura antigua de URLs: https://docs.document360.com/{oldworkspace}/section/page

  • Nueva estructura de URL: https://docs.document360.com/{newworkspace}/section/page

El mismo dominio debe estar asignado a ambas plataformas para que la redirección funcione. Por ejemplo,
Si el espacio de trabajo antiguo es v1 y el nuevo es v2:

Fuente

Destino

Gobierno

/v1

/

Termina con

/v1/

/v2

reemplazar con

Esta regla garantiza que todas las peticiones que apuntan al antiguo espacio de trabajo v1 sean redirigidas al nuevo espacio de trabajo v2.

¿Cómo puedo redirigir una URL específica de un artículo/categoría a la página principal de mi documentación?

Para redirigir una URL específica a la página principal de mi documentación, cambia la URL de destino por '/'.
Por ejemplo, si deseas redirigir la URL a , establece la URL de origen como /docs/welcome y la URL de destino como '/' en la regla de reemplazar por redirección. https://docs.radixdlt.com https://docs.radixdlt.com/docs/welcome