Este artigo descreve as declarações de progressão e conclusão da xAPI que a Udemy Business envia para um LMS/LXP terceirizado.
- Para saber como configurar a integração, consulte Integração do sistema de gestão do aprendizado da Udemy Business: xAPI.
Observação: a integração com LMS/LXP está disponível apenas para o Plano Enterprise.
Autorização
Declarações compatíveis
A Udemy Business enviará os seguintes verbos:
Declarações de curso:
- Evento de progresso: acompanha o progresso do aluno em um curso específico.
- Evento de conclusão: registra a conclusão de um curso pelo aluno.
Declarações de trilha de aprendizado:
- Evento de progresso: captura o progresso do aluno em uma série de conteúdo de aprendizado em uma trilha de aprendizado designada.
- Evento de conclusão: indica que o aluno concluiu todo o conteúdo de aprendizado em uma trilha de aprendizado.
Todas essas declarações da xAPI são transmitidas para o sistema LMS/LXP quase em tempo real conforme os eventos ocorrem, garantindo atualizações oportunas sobre as atividades e conquistas dos alunos.
As trilhas de aprendizado podem incluir vários tipos de conteúdo, como cursos da Udemy, cursos personalizados, partes de cursos da Udemy, links para artigos, vídeo externo, podcasts, páginas de Wiki etc. Para contas que possuem Udemy Business Pro, também existe a opção de adicionar uma avaliação ou um laboratório na trilha de aprendizado.
Ator
Por padrão, o ator na declaração da xAPI será identificado usando a propriedade mbox (ou seja, e-mail). No entanto, alguns sistemas LMS/LXP não exigem e-mail para que os alunos acessem seus sistemas. Portanto, também há suporte para identificar o ator usando um objeto de conta. No entanto, para o objeto de conta ser usado como identificador, o LMS/LXP deve enviar um lmsUserID do aluno para a Udemy Business como parte do reconhecimento do SSO. Consulte este artigo da Central de ajuda sobre como configurar o lmsUserID como parte do SSO.
Exemplo de um ator identificado usando o objeto mbox:
Exemplo de um ator identificado usando o objeto account:
Os LMS/LXPs para onde vamos enviar um objeto de conta como identificação do ator por padrão será o seguinte:
- SumTotal LMS
Para LMS/LXPs integrados via xAPI à Udemy Business não listados acima, a Udemy vai enviar o identificador mbox por padrão.
Verbo
Declarações de curso
Progresso
A declaração de progresso será usada para enviar o progresso do aluno em um curso. O progresso é calculado com base na proporção de aulas concluídas em relação ao número total de aulas no curso. Por exemplo, se um curso contém 4 aulas de 30 min, 40 min, 50 min e 60 min de duração, respectivamente, e o aluno concluir a primeira aula, o progresso será marcado como 25% (1/4). A duração de cada aula não será considerada para o cálculo da porcentagem de progresso.
A porcentagem de progresso será enviada no objeto resultado com o atributo conclusão definido como falso e a porcentagem representada como uma pontuação escalonada entre 0 e 1.
Veja abaixo um exemplo de declaração de progresso:
Conclusão
A declaração de conclusão será usada para enviar a conclusão do aluno no curso. Assim como a declaração de progresso, a declaração de conclusão conterá um objeto resultado que terá o atributo conclusão definido como verdadeiro e a pontuação escalonada definida como 1 para indicar uma conclusão de 100%.
Veja abaixo um exemplo de declaração de conclusão:
Declarações de trilha de aprendizado
Progresso
A declaração de progresso será usada para enviar o progresso do aluno em uma trilha de aprendizado. O progresso é calculado com base na proporção de conteúdo de aprendizado concluído em relação ao número total de conteúdo de aprendizado na trilha de aprendizado. Por exemplo, se uma trilha de aprendizado contém 5 cursos, 2 links e 3 partes de cursos, e o aluno concluir 3 cursos e 2 links, então o progresso será marcado como 50% (5/10). A duração de cada conteúdo não será considerada para o cálculo da porcentagem de progresso.
A porcentagem de progresso será enviada no objeto resultado com o atributo conclusão definido como falso e a porcentagem representada em objetos extensão como uma pontuação escalonada entre 0 e 100.
Veja abaixo um exemplo de declaração de progresso:
Conclusão
A declaração de conclusão será usada para enviar a conclusão do aluno na trilha de aprendizado. Assim como a declaração de progresso, a declaração de conclusão conterá um objeto resultado que terá o atributo conclusão definido como verdadeiro e a pontuação escalonada definida como 100 para indicar a conclusão.
Veja abaixo um exemplo de declaração de conclusão:
Objeto
Objeto Curso
O objeto da declaração será do tipo Curso e o ID da atividade será definido como o URL do curso, para identificar de maneira exclusiva um objeto de curso. Veja abaixo um exemplo de curso da UB enviado como objeto:
Objeto Trilha de aprendizado
O objeto da declaração será do tipo Coleção e o ID da atividade será definido como o URL da trilha de aprendizado, para identificar de maneira exclusiva um objeto de trilha de aprendizado. Veja abaixo um exemplo de trilha de aprendizado da UB enviado como objeto:
Para integração de LMS/LXP do SumTotal, o campo ID começa com as informações de subdomínio da organização, que é sumtotaldemo como visto no exemplo a seguir.
O objeto da declaração será do tipo Curso e o ID da atividade será definido como o URL do curso, para identificar de maneira exclusiva um objeto de curso. Veja abaixo um exemplo de curso da Udemy Business enviado como objeto:
Observação: para referenciar o ID de atividade do objeto da declaração da xAPI ao curso adequado na carga da API do curso, um novo atributo xapi_activity_id foi incluído na API do curso.
Erro ao manipular - Lógica de nova tentativa
Em caso de falha ao enviar o evento para o LMS/LXP, a Udemy Business vai tentar novamente quaisquer declarações com falha duas vezes por dia, durante cinco dias.