Presentación
En el contexto de las aplicaciones móviles, los enlaces profundos consisten en la utilización de un "identificador de recursos uniforme" (URI, el enlace se abre en una nueva pestaña) que se vincula a una ubicación concreta dentro de una aplicación móvil, en lugar de simplemente lanzar la aplicación.
Si hablamos de la aplicación Go.Learn de Docebo y la aplicación de marca, el uso de enlaces profundos posibilita que haya en la aplicación una amplia serie de escenarios de integración en los cuales la mayoría de los parámetros de inicio y navegación de la aplicación se transfieren a la aplicación mientras se ejecuta. La URL de la plataforma LMS, la autorización del usuario o los cursos de destino son solo algunos ejemplos de información que se puede automatizar mediante enlaces profundos. Es decir, no hace falta que los usuarios finales conozcan las funciones técnicas que se desarrollan en las entrañas de la aplicación para acceder sin problemas a su aplicación y a los cursos.
Tenga en cuenta que los enlaces profundos son una función muy técnica. Para configurarlos, debería contactar con su desarrollador de contenidos o con alguien del departamento informático de su empresa. Asimismo, no olvide que esta función no es igual que la función de enlaces para la inscripción en cursos de Docebo, que se detalla en el artículo Gestión de enlaces para la inscripción en cursos.
Casos prácticos
El uso de enlaces profundos abre muchas posibilidades, como por ejemplo:
- crear enlaces que lleven al usuario hasta un curso determinado en el que esté inscrito, evitando que tenga que iniciar sesión;
- ejecutar en Go.Learn o en la aplicación de marca un material de formación determinado desde otra aplicación;
- compartir un enlace a activos informales desde publicaciones en redes sociales (con un redireccionamiento JS adecuado).
A tener en cuenta: Esta última es una característica muy técnica. Para hacer esto, tiene que configurar un redireccionamiento web en su servidor convirtiendo la URL "http" en un enlace profundo con el formato adecuado (tiene todo lo que necesita saber para realizar dicha conversión en esta guía). Este redireccionamiento se realiza a través de un javascript colocado en la sección del documento HTML.
URI y esquema de los enlaces profundos
El esquema predeterminado de la aplicación Go.Learn de Docebo es golearn:// .
Para iniciar la aplicación, solo tiene que iniciar este URI (golearn:// ) desde cualquier otra aplicación o página web.
Aquí debajo puede ver un ejemplo de la estructura de un enlace profundo de Go.Learn:
golearn://allchannelspage?domain=ZGVtby5jb20=&token=eyJhbGc.jM5MDIyf.EowmOx6Iy
- golearn:// : esquema
- allchannelspage : ruta de destino
- domain=ZGVtby5jb20= : parámetro del dominio
- token=eyJhbGc.jM5MDIyf.EowmOx6Iy : parámetro de token JWT
Solo hay un elemento obligatorio: el esquema, que activa el inicio de la aplicación. Utilice la ruta de destino para navegar a una página o a un material de formación específicos y el parámetro Dominio —un parámetro opcional— para convertir la URL del LMS al formato Base64. La última parte, el parámetro Token JWT —un parámetro opcional—, es el portador de la autorización.
Cómo navegar a las páginas
Consulte la tabla Páginas para ver la lista completa de enlaces profundos compatibles.
Cómo navegar al contenido
Consulte la tabla Contenido para ver la lista completa de enlaces profundos compatibles.
Parámetros de acceso
Los parámetros opcionales Dominio y Token están disponibles para simplificar los procesos de acceso e inicio de sesión. De hecho, mediante el uso de estos parámetros, puede especificar directamente la URL de la plataforma en la que desea iniciar sesión y el portador de las credenciales que se utilizarán para iniciar sesión en el enlace profundo.
El parámetro Dominio
El parámetro Dominio contiene la URL de la plataforma codificada en formato Base64. golearn://allchannelspage?domain=bXlwbGF0Zm9ybS5kb2NlYm9zYWFzLmNvbQ== navega a la página Todos los canales de la aplicación en la plataforma myplatform.docebosaas.com.
A tener en cuenta: Si el usuario de Go.Learn ya ha iniciado sesión en la plataforma en cuestión, Go.Learn navega directamente a la página especificada en la sección Ruta de destino del enlace profundo. Si ningún usuario tiene la sesión iniciada, Go.Learn navega a la página de inicio de sesión en la URL especificada de la plataforma. A continuación, si el inicio de sesión se lleva a cabo correctamente, navega a la página especificada en la sección Ruta de destino del enlace profundo.
Si un usuario tiene la sesión iniciada en ese momento, pero en una plataforma diferente, se cierra su sesión y Go.Learn navega a la página de inicio de sesión en la URL especificada de la plataforma. Por último, si el inicio de sesión se lleva a cabo correctamente, navega a la página especificada en la sección Ruta de destino del enlace profundo.
A tener en cuenta adicionalmente: En una aplicación móvil de marca con dominio fijo, el parámetro Dominio se ignorará. Puede prescindir de este parámetro, ya que no se utilizará.
El parámetro Token
El parámetro Token debe ser un token JWT que contenga la autorización para acceder a la plataforma. Aprenda a crear un token JWT adecuado. No olvide que, si utiliza un dominio personalizado, debe incluir el dominio original del SAAS (software como servicio) de Docebo como nombre de host en el campo "aud" (audiencia) del token JWT.
golearn://allchannelspage?token=eyJhbGc.jM5MDIyf.EowmOx6Iy&domain=bXlwbGF0Zm9ybS5kb2NlYm9zYWFzLmNvbQ== navega a la página Todos los canales de la aplicación en la plataforma myplatform.docebosaas.com utilizando las credenciales especificadas en el token JWT del parámetro Token.
Tenga en cuenta que el parámetro Token debe contener la cadena JWT y que la clave de acceso no es un valor válido para este parámetro.
Prácticas recomendadas
Por razones de seguridad, es importante que no se incrusten enlaces profundos en un documento HTML estático. Por el contrario, se recomienda navegar a enlaces profundos como resultado de una función que solicite que el enlace profundo provenga del lado del servidor.
No todas las ID que se usan para componer un enlace profundo son inamovibles. Si cree que el ID de un objeto puede cambiar con el tiempo, es mejor generar el enlace profundo sobre la marcha usando funciones.