Planes compatibles con el widget de la base de conocimientos
Plans supporting this feature: Business Enterprise
La funci贸n de mapeo de URL dentro del widget de la base de conocimientos le permite personalizar la visualizaci贸n de art铆culos y categor铆as espec铆ficos en funci贸n de las p谩ginas que visitan sus usuarios finales. Esta funcionalidad no solo mejora la experiencia del usuario al dirigirlos a contenido relevante, sino que tambi茅n le permite ocultar el widget de la base de conocimientos en ciertas URL o proporcionar una barra de b煤squeda con marcadores de posici贸n personalizados, guiando a los usuarios sobre qu茅 buscar.
Uso de la asignaci贸n de URL
Para configurar la asignaci贸n de URL, realice acciones espec铆ficas dentro del widget de la base de conocimientos para las URL designadas.
Acciones
Hay cuatro acciones que puedes ejecutar con el mapeo de URL:
Mostrar art铆culo: Muestra un solo art铆culo en la direcci贸n URL especificada.
Mostrar lista de art铆culos: Enumera los art铆culos seleccionados en la secci贸n Recomendados dentro del widget de la base de conocimientos en la URL especificada.
Mostrar resultados de b煤squeda: Le permite establecer un t茅rmino de b煤squeda espec铆fico para consultar su base de conocimientos, devolviendo resultados de b煤squeda relevantes en la URL especificada.
Ocultar widget: Evita que el icono del widget de la base de conocimientos aparezca en la URL especificada.
Puedes encontrar estas acciones en la pesta帽a Asignaci贸n de URL o al editar una asignaci贸n existente.
NOTA
Para que la asignaci贸n de URL funcione, el widget de la base de conocimientos debe estar instalado en tu sitio o aplicaci贸n. Para obtener m谩s informaci贸n, lea el art铆culo sobre Installing the Knowledge base widget.
Par谩metros de URL
Al configurar la URL del widget de la base de conocimientos, puede incluir tres tipos de par谩metros:
Incluir ruta:
/thisis/a/path
Incluir consulta:
?animal=bear
Incluir hash:
#inbox
Tambi茅n puede habilitar el bot贸n de alternancia Is Regex para incorporar expresiones regulares en las configuraciones de URL.
Agregar mapeo de URL a su widget
Para integrar el widget deseado en el sitio de la base de conocimientos, siga estos pasos:
Vaya a la pesta帽a Mapeo de URL en el Widget () en el Knowledge base portal.
Haga clic en Nueva asignaci贸n de URL y especifique lo siguiente:
Nombre : el nombre de la asignaci贸n de URL solo se mostrar谩 en el registro de asignaci贸n de URL dentro de Document360
Estructura de URL : seleccione el tipo de par谩metro de URL deseado (Incluir ruta/Incluir consulta/Incluir hash). Debe habilitar al menos un par谩metro de URL
Escriba la URL en la que desea que se muestre el art铆culo/categor铆a o que se realice la acci贸n.
NOTA
Su nombre de dominio no est谩 incluido en la ruta de la URL. Por ejemplo,
https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/
, la ruta de su URL ser铆a/ebook/rapid-guide-to-launch-your-knowledge-base/
Acci贸n : seleccione la acci贸n deseada.
Seleccionar espacio de trabajo : seleccione la versi贸n deseada (si tiene varias versiones).
Idioma a : seleccione el idioma deseado (si tiene varios idiomas).
Art铆culo para mostrar : en la barra de b煤squeda, seleccione los art铆culos o categor铆as que desea mostrar en la documentaci贸n de la base de conocimientos.
NOTA
Las categor铆as de carpetas no est谩n disponibles para su selecci贸n. Solo los tipos de categor铆a de p谩gina e 铆ndice est谩n disponibles para su selecci贸n.
Haga clic en Crear.
Una vez que un usuario final acceda a la ruta URL especificada y abra el widget de la base de conocimientos, ver谩 el art铆culo/categor铆a asignado. Esta informaci贸n permanece coherente a medida que navegan entre las pesta帽as del widget de la base de conocimientos dentro de la misma versi贸n e idioma.
Edici贸n de la asignaci贸n de URL
Para modificar una asignaci贸n de URL existente:
Vaya a Widget () en el Knowledge base portal.
Coloque el cursor sobre el widget de la base de conocimientos deseado y haga clic en el icono Editar ().
En la pesta帽a Asignaci贸n de URL , puede encontrar la lista de asignaciones de URL disponibles.
Coloque el cursor sobre la asignaci贸n de URL deseada y haga clic en el icono Editar ().
Aparecer谩 la hoja Actualizar asignaci贸n de URL .
Actualice la informaci贸n deseada y haga clic en Actualizar.
Eliminaci贸n de la asignaci贸n de URL
Puede eliminar una asignaci贸n de URL establecida.
Vaya a Widget () en el Knowledge base portal.
Coloque el cursor sobre el widget de la base de conocimientos deseado y haga clic en el icono Editar ().
En la pesta帽a Asignaci贸n de URL , puede encontrar la lista de asignaciones de URL disponibles.
Coloque el cursor sobre la asignaci贸n de URL deseada y haga clic en el icono Eliminar ().
Haga clic en S铆 en el mensaje de confirmaci贸n Eliminar .
Configuraci贸n de mapeo de URL
Puede definir el comportamiento del widget de la base de conocimientos para las URL que no tienen una asignaci贸n configurada. Definir este comportamiento puede mejorar la experiencia del usuario y la accesibilidad a la documentaci贸n.
Vaya a Widget () en el Knowledge base portal > Configurar y conectar.
En la secci贸n Establecer controles , expanda la secci贸n Configuraci贸n de asignaci贸n de URL .
Seleccione la opci贸n deseada:
Navegar a la p谩gina de ayuda/base de conocimientos: seleccione esta opci贸n para mostrar el art铆culo/categor铆a en la p谩gina de ayuda o en la pesta帽a Base de conocimientos en el widget.
No realizar ning煤n cambio en la configuraci贸n existente: Seleccione esta opci贸n para mostrar el 煤ltimo art铆culo/categor铆a abierto en el widget.
Haga clic en Guardar.
Coincidencia b谩sica de URL
Comprender la coincidencia de URL es crucial para un mapeo de URL efectivo. Una expresi贸n regular de uso general para hacer coincidir las URL t铆picas tiene el siguiente aspecto:
^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$
Explicaci贸n de los componentes
^https?://?
: Coincide con el protocolo (por ejemplo,http://
ohttps://
). Esto?
hace que el protocolo sea opcional.NOTA
Aseg煤rese de agregar una barra diagonal inversa (\) antes de cada barra diagonal (/) mientras prueba su URL en https://regex101.com.
[a-zA-Z0-9.-]+
: Coincide con el nombre de dominio, incluidas letras, n煤meros, puntos (.
) y guiones (-
)./[a-zA-Z0-9/._-]*?
: Coincide con la ruta despu茅s del dominio, lo que permite barras diagonales, caracteres alfanum茅ricos, puntos, guiones bajos y guiones.?[a-zA-Z0-9=&._-]*?
: Coincide con los par谩metros de consulta opcionales (por ejemplo,?key=value
), lo que hace que esta parte sea opcional.#[a-zA-Z0-9_-]*?
: Coincide con el fragmento (por ejemplo,#section
), que tambi茅n es opcional.
Ejemplos de mapeo de URL con Regex
Mapeo de URL con rutas espec铆ficas
Para asignar un patr贸n de URL como /users/{id}
, use:
^/users/[0-9]+$
Esto captura un ID de usuario de forma din谩mica.
Ejemplos de coincidencias
/users/123
/users/456
Asignaci贸n de direcciones URL con par谩metros de consulta
Para URL como /search?q={query}
, la expresi贸n regular ser铆a:
^/search?q=[a-zA-Z0-9]+$
Ejemplos de coincidencias
/search?q=apple
/search?q=123abc
Asignaci贸n de URL con par谩metros opcionales
Para un patr贸n de URL como /products/{category}/{id}
, donde category es opcional:
^/products/[a-zA-Z]+?/[0-9]+$
Ejemplos de coincidencias
/products/123
/products/electronics/123
Asignaci贸n de direcciones URL con comodines o varias rutas
Para /blog/*
:
^/blog/.*?$
Ejemplos de coincidencias
/blog
/blog/how-to-code
/blog/2021/10
Mapeo de URL con subdominios
En el caso de las URL de subdominio:
^https?://?[a-zA-Z0-9-]+.example.com$
Ejemplos de coincidencias
http://blog.example.com
https://shop.example.com
Combinaci贸n de m煤ltiples componentes
Para manejar asignaciones de URL m谩s complejas, puede combinar los distintos componentes seg煤n sea necesario. La expresi贸n regular completa que coincide con una direcci贸n URL con un protocolo, dominio, ruta de acceso, par谩metros de consulta y fragmento opcionales tiene el siguiente aspecto:
^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$
Preguntas frecuentes
驴C贸mo puedo eliminar la ayuda de la p谩gina y la barra de b煤squeda del widget cuando se configura la asignaci贸n de URL para un solo art铆culo?
Para eliminar la ayuda de la p谩gina y la barra de b煤squeda del widget cuando se configura la asignaci贸n de URL para un solo art铆culo:
Vaya a Widget () en el portal de la base de conocimientos.
Coloque el cursor sobre el widget deseado y haga clic en el icono Editar ().
Pegue el c贸digo proporcionado en la pesta帽a CSS personalizado :
li#page-help-tab { display: none; } .article-header .article-back-icon { display: none; } .search-container { display: none !Important; }
Pegue el c贸digo proporcionado en la pesta帽a JavaScript personalizado :
setTimeout(function() { $('.search-container').hide();}, 2000); setTimeout(function() { $("#knowledge-base-tab").click();}, 2000);
Haga clic en Guardar.
Esto ocultar谩 la pesta帽a de ayuda de la p谩gina y la barra de b煤squeda en el widget del sitio de la base de conocimientos cuando se configure la asignaci贸n de URL para un solo art铆culo.
驴C贸mo puedo ver las actualizaciones inmediatamente en el widget de KB despu茅s de agregar o actualizar un mapa de URL?
Las actualizaciones se almacenan en cach茅 en el servidor por motivos de rendimiento y se actualizar谩n autom谩ticamente cada 15 minutos. Sin embargo, si necesita ver los cambios de inmediato, puede borrar el cach茅 de la aplicaci贸n.