As APIs do Brightspace expõem a funcionalidade para permitir que os usuários migrem links legados 1.1 para o Advantage 1.3. Essa API migra um link por vez, o que é mais útil para links no nível da organização que são compartilhados com vários cursos.
Os links no nível da organização LTI 1.1 são feitos na página inicial da instância. Navegue até Ferramentas de administração (o ícone de engrenagem) > Ferramentas de aprendizagem externas > Gerenciar links de ferramentas (herdado)
Figura: Navegue até Gerenciar links de ferramentas (herdado) para iniciar o processo de migração.
Os links no nível da organização compartilhados com os cursos são encontrados no curso. Navegue até Administração do curso > Ferramentas de aprendizagem externas > Gerenciar links de ferramentas (herdado). Eles aparecem no Título como elementos de interface do usuário não interacionáveis.
Figura: Você pode visualizar links no nível da organização na tabela. Eles aparecem no Título coluna.
Para migrar o link, você precisa do DeploymentID, LinkID e, opcionalmente, do ID do provedor da ferramenta. Essas informações podem ser encontradas em conjuntos de dados e nas seguintes APIs:
Essa API GET retorna uma lista de todos os links LTI 1.1 pertencentes a uma unidade organizacional:
- GET /d2l/api/le/(Versão)/lti/link/(orgUnitId)/
Copie o LtiLinkId para o link que você precisa migrar.
Figura: Selecione e copie o valor do LtiLinkId.
Use esta API GET para obter o DeploymentID da implantação do LTI 1.3 Advantage para onde você deseja migrar este link 1.1:
- GET /d2l/api/le/(Versão)/ltiadvantage/implantação/
Figura: Selecione e copie o DeploymentID e o Nome da implantação do LTI 1.3 Advantage.
Agora você pode iniciar o processo de migração. Use esta API:
https://docs.valence.desire2learn.com/res/ltiadvantage.html#post--d2l-api-le-(version)-ltiadvantage-migration-links-(linkId)
- POST /d2l/api/le/(Versão)/ltiadvantage/migration/links/(linkId)
O corpo dessa API deve ter as seguintes informações:
{
"DeploymentId": "GUID da implantação",
"ToolProviderId": <strong>zero</strong>
<strong>}</strong>
Para verificar se essa API foi bem-sucedida, execute a API get Links novamente, o link migrado não deve aparecer nessa lista. Esse link migrado agora aparece na interface do usuário; isso pode ser encontrado navegando até Ferramentas de administração (o ícone de engrenagem) > Ferramentas de aprendizagem externas > Implantação do LTI Advantage, selecione sua implantação e clique em Ver links.
É importante verificar se o link migrado funciona após a migração. Coloque esse link no conteúdo e execute um lançamento desse link. Isso requer conhecimento de como a ferramenta funciona para garantir que o lançamento foi bem-sucedido.
