Uso da xAPI no Learning Manager
Configure o seu aplicativo
-
Faça logon como administrador de integração. Selecione Aplicativos > Registrar.
-
Registre um novo aplicativo.
-
Defina o escopo do aplicativo.
- Se Acesso de leitura e gravação xAPI da função de administrador estiver ativado, o administrador poderá publicar e obter instruções e documentos xAPI.
- Se Acesso de leitura e gravação xAPI da função do aluno estiver ativado, o administrador poderá publicar e obter instruções e documentos xAPI.
-
Salve a alterações. Você recebe sua ID de desenvolvedor e seu segredo.
Pontos de extremidade:
Clique no link abaixo para exibir o documento swagger xAPI:
https://learningmanagereu.adobe.com/docs/primeapi/xapi/
Observação: a versão da xAPI compatível com o Learning Manager é 1.0.3.
Autenticação da API
A xAPI do Learning Manager usa a estrutura OAuth 2.0 para autenticar e autorizar os seus aplicativos cliente. Depois de registrar o aplicativo, você pode obter a clientId e o clientSecret. Obter URL é usado no navegador ao autenticar os usuários do Learning Manager usando suas contas pré-configuradas, como SSO e Adobe ID.
GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<admin:xapi or learner:xapi>&response_type=CODE.
Rastreamento de instruções xAPI como OA do Learning Manager
Como autor, agora você pode escolher o módulo xAPI ao criar cursos para monitorar a experiência do usuário fora do Learning Manager. Por exemplo, você pode usar esse recurso para avaliar as atividades dos usuários em uma plataforma de terceiros usada para a realização do curso.
-
Ao criar um Módulo de Atividade, na opção Tipo use o menu pop-up para selecionar o Módulo baseado em xAPI.
-
Você deve fornecer um IRI. Se não for fornecido, o Learning Manager gera um automaticamente.
O IRI de uma atividade é exclusivo em uma conta. Ou seja, dois módulos no Learning Manager não podem ter o mesmo IRI. Um novo IRI é gerado nos seguintes casos:
- Quando um curso com o módulo xAPI é compartilhado entre contas.
- Quando uma certificação com o módulo xAPI for repetida
Qualquer instrução xAPI com o IRI mencionado é rastreada no módulo acima e é refletida nos relatórios do Learning Manager.
-
Para copiar o IRI gerado automaticamente, veja novamente a página Módulo de atividade.
-
Publique o módulo.
Pontos a observar:
-
No momento, o Learning Manager oferece suporte somente ao mbox como um identificador. Outros identificadores, incluindo mboz_sha1, openid, account, não são suportados.
-
A stateId e a profileId são UUID quando usadas com o Learning Manager.
-
A solicitação de PUT não substitui o documento para agentes/perfil xAPIs, atividade/perfil e atividade/estado
-
O grupo não identificado não tem suporte no Ator.
-
O parâmetro “related_activities” não tem suporte na instrução GET.
-
Os parâmetros 'format=ids' e 'format=canonical' não são suportados em instruções GET.
-
A anulação da instrução xAPI não desfaz as ações que ocorreram no Learning Manager quando a instrução foi publicada.
Gerar relatórios
Os relatórios xAPI podem ser gerados como relatórios do Excel. Como administrador, abra Relatórios > Relatórios do Excel > Relatório de atividades da xAPI.
O relatório baixado busca todas as informações publicadas pelo aluno e administrador para qualquer instrução.
Os mesmos relatórios podem ser gerados/agendados usando conectores FTP e Box para qualquer integração de terceiros. Siga estas etapas:
Faça logon como Administrador de integração > Abra o conector FTP/Box > Selecione o relatório de atividades da xAPI no painel esquerdo > Opte por agendar/gerar um relatório.
-
Quando apenas a pontuação bruta é enviada na instrução xAPI sem pontuação máxima, a pontuação do quiz não é exibida no LT.
-
Para obter a pontuação percentual no Learning Manager, as pontuações dimensionadas são enviadas por meio da xAPI.
