-
Integração do sistema de gestão do aprendizado da Udemy Business: declarações da xAPI
Ler artigoEste artigo descreve as declarações que a Udemy Business envia para informar o progresso do aluno e a conclusão de um curso, por meio da integração da xAPI com um sistema de terceiros, como LMS/LXP/LRS.
- Para ver 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 no Plano Enterprise.
Authorization
Declarações compatíveis
A Udemy Business envia os seguintes verbos correspondentes ao progresso de um aluno e à conclusão de um curso:
- Evento de progresso
- Evento de conclusão
Essas declarações serão POSTADAS no sistema de LMS/LXP em tempo quase real conforme os eventos ocorrem.
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 lmsUserId como parte do SSO.
Exemplo de um ator identificado usando o objeto mbox:
Exemplo de um ator identificado usando o objeto de conta:
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, vamos enviar o identificador mbox por padrão.
Verbo
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:
Concluído
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:
ObjetoO 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 enviar 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.