Abrir un enlace heredado de artículo de ayuda en la app
Abre un enlace antiguo de documentación de la app que usa un parámetro de consulta articleId. En una sesión autenticada, Antylogic carga el índice de documentación actual, resuelve el id heredado en el idioma actual, reescribe la ruta a la sección y el artículo canónicos y muestra la vista normal de solo lectura del artículo.
En este artículo
Usa esta guía cuando soporte, éxito de cliente u operadores necesiten confirmar que un enlace antiguo de ayuda de la app sigue abriendo el artículo correcto de Documentación después de que el contenido de ayuda haya pasado a slugs canónicos de sección y artículo.
En la sesión demo de ES en español, antylogic://docs?articleId=es-access-users-create-location-internal resuelve al artículo de Accesos Crear un usuario interno de ubicación.
Antes de empezar
- El operador ha iniciado sesión en la app de Antylogic, por ejemplo como usuario demo en la sesión demo de ES en español.
- La cuenta está activa y no está bloqueada por pendiente de eliminación.
- El enlace incluye un parámetro de consulta articleId no vacío, como antylogic://docs?articleId=es-access-users-create-location-internal.
- La app puede cargar el índice autenticado de documentación para el idioma, el tamaño de pantalla y el tema actuales.
- El artículo de destino existe en el índice del locale cargado con un slug de artículo o un id de artículo convertido a slug coincidente.
Instrucciones
- 1.
Abre el enlace heredado de ayuda
Abre el enlace con cadena de consulta antylogic://docs?articleId=es-access-users-create-location-internal desde una sesión autenticada de la app. Usa articleId como parámetro de consulta; una ruta como antylogic://docs/es-access-users-create-location-internal no es el formato heredado de id de artículo.
- 2.
Deja que Documentación resuelva el artículo
La pantalla de Documentación carga el índice autenticado de docs para el idioma, la plataforma y el tema actuales. Recorta y normaliza el articleId heredado y después lo compara localmente con los resúmenes de artículo cargados.
- 3.
Confirma el artículo resuelto
Cuando se encuentra un resumen coincidente, la app abre el detalle canónico del artículo. En la demo de ES en español, se abre la sección Accesos y el título del artículo Crear un usuario interno de ubicación es visible.
- 4.
Gestiona los enlaces que no resuelven
Si el índice se está cargando, espera a que Documentación termine. Si el índice falla, usa el error de carga de docs. Si el id heredado no coincide con el índice del locale actual, no se carga ningún artículo de detalle y el área de artículo pide al operador que seleccione un artículo.
Validaciones y límites
- La app permanece en el área autenticada de la App en lugar de mostrar Inicio de sesión.
- articleId se resuelve localmente a partir del índice cargado y no se envía al backend.
- La coincidencia se limita al slug del resumen de artículo o al id del resumen de artículo convertido a slug.
- La petición de detalle usa la ruta canónica /api/app/docs/accesos/es-access-users-create-location-internal.
- Tras una coincidencia, el estado de navegación se normaliza a sectionSlug y articleSlug y articleId se limpia.
- Un par canónico sectionSlug y articleSlug tiene prioridad sobre articleId, incluso cuando el par es inválido.
- Un id heredado en español puede no resolver mientras la app esté usando el índice de docs en inglés.
- Los ids heredados sin coincidencia muestran actualmente el estado genérico de seleccionar artículo en lugar de un mensaje dedicado de no encontrado.
Resultado esperado
El enlace antiguo de ayuda abre el artículo normal de Documentación de solo lectura para el locale actual. La ruta se reescribe a los slugs canónicos de sección y artículo, y no se crea ningún ticket de soporte, edición de artículo ni dato operativo del dominio.