Las API de Brightspace exponen la funcionalidad para permitir que los usuarios migren enlaces heredados 1.1 a Advantage 1.3. Esta API migra un enlace a la vez, lo que es más útil para los enlaces a nivel de organización que se comparten con varios cursos.
Los enlaces de nivel de organización de LTI 1.1 se realizan en la página de inicio de la instancia. Vaya a Herramientas de administración (el icono del engranaje) > Herramientas de aprendizaje externas > Administrar enlaces de herramientas (heredado)
Figura: Vaya a Administrar enlaces de herramientas (heredado) para comenzar el proceso de migración.
Los enlaces de nivel de organización compartidos con los cursos se encuentran dentro del curso. Vaya a Administrador del curso > Herramientas de aprendizaje externas > Administrar enlaces de herramientas (heredado). Estos aparecen en el archivo Título como elementos de la interfaz de usuario con los que no se puede interactuar.
Figura: Puede ver los enlaces de nivel de organización en la tabla. Estos aparecen en el archivo Título columna.
Para migrar el vínculo, necesita el DeploymentID, el LinkID y, opcionalmente, el ID del proveedor de la herramienta. Esta información se puede encontrar en conjuntos de datos y en las siguientes API:
Esta API GET devuelve una lista de todos los enlaces LTI 1.1 que pertenecen a una unidad de organización:
- GET /d2l/api/le/(Versión)/lti/enlace/(orgUnitId)/
Copie el LtiLinkId del vínculo que necesita migrar.
Figura: Seleccione y copie el valor de LtiLinkId.
Utilice esta API GET para obtener el DeploymentID de la implementación de LTI 1.3 Advantage a la que desea migrar este vínculo 1.1:
- GET /d2l/api/le/(Versión)/ltiadvantage/despliegue/
Figura: Seleccione y copie el ID de implementación y el nombre de la implementación de LTI 1.3 Advantage.
Ahora puede iniciar el proceso de migración. Utilice esta API:
https://docs.valence.desire2learn.com/res/ltiadvantage.html#post--d2l-api-le-(version)-ltiadvantage-migration-links-(linkId)
- POST /d2l/api/le/(Versión)/ltiadvantage/migración/enlaces/(linkId)
El cuerpo de esta API debe tener la siguiente información:
{
"DeploymentId": "GUID de la implementación",
"ToolProviderId": <strong>nulo</strong>
<strong>}</strong>
Para comprobar que esta API se ha realizado correctamente, vuelva a ejecutar la API get Links, ya que el enlace migrado no debería aparecer en esta lista. Este enlace migrado ahora aparece en la interfaz de usuario; Esto se puede encontrar navegando a Herramientas de administración (el icono del engranaje) > Herramientas de aprendizaje externas > Implementación de LTI Advantagey, a continuación, seleccione la implementación y haga clic en Ver enlaces.
Es importante comprobar que el enlace migrado funciona después de la migración. Coloque este enlace en el contenido y realice un lanzamiento de ese enlace. Esto requiere conocimiento de cómo funciona la herramienta para garantizar que el lanzamiento haya sido exitoso.
