Os serviços de atividade e nota (AGS) é uma extensão do LTI. O LTI 1.3 é projetado para lidar com interações avançadas de notas entre uma ferramenta e uma plataforma. Ele proporciona aos desenvolvedores uma série de subserviços que permitem o gerenciamento de objetos e valores de nota dentro do Brightspace.
Os serviços de atividade e nota (AGS) incluem três serviços:
- Serviço LineItem
- Serviço de resultados
- Serviço de pontuação
Entender o comportamento de Notas com AGS
Os administradores devem estar cientes das seguintes considerações que afetam o comportamento das notas ao usar o Serviços de atividades e notas. As pontuações do AGS são armazenadas somente quando a opção Pode ser avaliado em Notas está ativada para o usuário que está sendo avaliado. Se um item de notas for enviado para um usuário com uma função que não pode ser avaliada, a nota não será mais armazenada e uma mensagem de erro será enviada para a ferramenta de envio.
Para definir os comportamentos das ferramentas:
- Na página inicial da organização, clique em Ferramentas administrativas.
- Na seção Segurança, clique em Funções e permissões.
- Clique no menu Mais ações ao lado da função para a qual você deseja definir a opção Pode ser avaliado em Notas.
- Clique em Editar configurações.
- Em Opções de comportamento da ferramenta, selecione Pode ser avaliado em Notas.
- Clique em Salvar e fechar.
Figura: quando você ativa a opção Pode ser avaliado em Notas, você pode avaliar os usuários inscritos com a função na ferramenta Notas.
Os administradores também devem estar cientes de que se Pode Exceder não estiver definido para uma nota e uma ferramenta enviar ao livro de notas uma nota maior do que o máximo definido para a nota:
- A pontuação máxima permitida (não a nota superior enviada) é exibida no livro de notas.
- A pontuação enviada pela ferramenta que for maior que o máximo é registrada em uma tabela interna para referência futura.
Observação: as ferramentas LTI e os clientes da D2L não têm acesso a esta tabela interna.
Para ativar ou desativar o status Pode exceder para uma nota.
- Na barra de navegação do curso, clique em Notas.
- Clique na guia Gerenciar Notas e selecione a nota.
- Na guia Propriedades, em Avaliação, confirme ou atualize a caixa de seleção Pode exceder, conforme aplicável.
Figura: a opção Pode exceder na área Avaliação das Propriedades de uma nota.
Serviço LineItem
O serviço LineItem é usado para gerenciar as notas em ferramentas de aprendizagem. Ele permite que uma ferramenta crie, exclua e obtenha detalhes das notas que a ferramenta possui. Este serviço oferece os seguintes recursos:
- LineItems.url: o URL do ponto de extremidade para acessar o contêiner LineItem para o contexto atual.
- LineItem.url: o URL do ponto de extremidade para acessar o item de linha quando houver apenas um item de linha associado ao link do recurso. Se houver mais de um item, essa propriedade deve ficar em branco.
Há diferentes tipos de mídia definidos pelo Serviço LineItem:
-
Application/vnd.ims.lis.v2.lineitem+json, com uma amostra:
{ "id" : https://lms.example.com/context/2923/lineitems/1, "scoreMaximum" : 60, "label" : "Math 202 Quiz", "resourceId" : "a-9334df-33", "tag" : "grade", "resourceLinkId" : "1g3k4dlk49fk", "startDateTime": "2019-03-06T20:05:02Z", "endDateTime": "2019-04-06T22:05:03Z" }
- application/vnd.ims.lis.v2.lineitemcontainer+json, with a sample:
[{ "id": "https://lms.example.com/context/2923/lineitems/1", "scoreMaximum": 60, "label": "Math 202 Quiz", "resourceId": "a-9334df-33", "tag": "grade", "resourceLinkId": "1g3k4dlk49fk", "endDateTime": "2019-04-06T22:05:03Z"}, { "id": "https://lms.example.com/context/2923/lineitems/47", "scoreMaximum": 100, "label": "Week 3 Assignment", "resourceId": "a-9334df-33", "tag": "originality", "resourceLinkId": "1g3k4dlk49fk" }, {"id": "https://lms.example.com/context/2923/lineitems/69", "scoreMaximum": 60, "label": "Week 4 Assignment", "tag": "grade" }]
Ao tentar uma solicitação GET para a extremidade do contêiner, você pode filtrar os seguintes resultados:
- resource_link_id: retorna apenas os itens associados ao ID de recurso da plataforma da ferramenta especificada para o link no conteúdo.
- resource_id: retorna apenas os itens associados ao identificador de recurso da ferramenta especificada. Vários itens de linha podem compartilhar o mesmo resourceId dentro de um contexto.
- tag: retorna apenas os itens associados à tag especificada. Sempre uma série.
- limit: Restringe o número de itens de linha retornados. Se houver mais itens seguindo os retornados, um cabeçalho http de 'Link' com um URL apontando para a próxima página e um valor ''rel' de 'next' DEVE ser incluído na resposta. A D2L limita as chamadas GET a 200.
|
Observação: recomenda-se o uso de um QuickLink em vez de um LineItem, pois há limitações quanto ao funcionamento da passagem de retorno do LineItem ao adicionar via Insert Stuff ou por meio do link rápido do deep link do criador de cursos.
Para o fluxo de trabalho do criador de cursos, clicar no link no painel permite que a ferramenta envie as informações para criar o LineItem.
|
Amostra de um novo item de linha
Para criar uma nova nota
Você deve PUBLICAR em application/vnd.ims.lis.v2.lineitem no LineItems.url. Ele pode aparecer da seguinte forma:
{ "scoreMaximum" : 60, "label" : "Math 101 Quiz", "resourceId" : "quiz-2031", "tag" : "math", "startDateTime": "2019-07-07T20:05:02Z", "endDateTime": "2019-07-07T22:05:03Z", }
Serviço de resultados
O serviço Resultado permite aos usuários fazer com que a ferramenta consulte a plataforma para obter os valores atuais dos objetos de nota que possui. O resultado do termo em si representa uma nota atual para um determinado objeto ou para um determinado usuário. Para sincronizar novas notas, consulte a seção Serviço de pontuação deste tópico.
Observação: um resultado não pode ser alterado diretamente através deste serviço, de modo que somente os comandos GET são suportados.
O ponto de extremidade do serviço é um subcaminho do URL do recurso do item de linha. O URL do recurso tem o caminho anexado com '/results'. Este serviço suporta apenas operações GET e retorna todos os resultados para o item de linha. Por exemplo: [{ "id": "https://lms.example.com/context/2923/lineitems/1/results/5323497", "scoreOf": "https://lms.example.com/context/2923/lineitems/1", "userId": "5323497", "resultScore": 0.83, "resultMaximum": 1, "comment": "This is exceptional work." }]As ferramentas podem filtrar esses resultados usando os seguintes parâmetros de consulta:
- user_id: Filtre os resultados para um único usuário com base em seu ID.
- limit: restringe o número de resultados retornados. A D2L limita os resultados a 200.
Serviço de pontuação
Uma pontuação representa o valor de uma atividade que um usuário acabou de concluir. O termo "pontuação" refere-se a esse valor no momento em que a atividade foi realizada. O Serviço de pontuação é usado por uma ferramenta para publicar a pontuação mais recente no Brightspace. Como o Brightspace só publica novas pontuações, esse serviço é somente gravação. Quando acessado posteriormente, a D2L o acessa como resultado usando o serviço de resultados, que é somente leitura.
Há apenas um tipo de mídia definido por este serviço: application/vnd.ims.lis.v1.score+json. Veja a seguir como um resultado de amostra pode aparecer: {"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "This is exceptional work.", "activityProgress" : "Completed", "gradingProgress": "FullyGraded", "userId" : "5323497" >}O registro de data/hora (timestamp) é um valor obrigatório que indica quando a pontuação foi alterada e deve ser usado pela plataforma para proteção contra atualizações de pontuação fora de ordem. O valor do timestamp é a data e a hora no padrão ISO 8601 do servidor quando o estado da pontuação foi modificado. Para proteger os dados historicamente, espera-se que esse valor aumente a cada solicitação.
O Progresso da atividade indica o status de uma atividade específica nesse momento. Embora o o IMS documente vários valores disponíveis, o Brightspace ignora esses valores e, em vez disso, baseia-se apenas do valor do status Progresso da avaliação.
Notas finais
O progresso da avaliação de campo tem muitos valores disponíveis, conforme documentados pela 1EdTech. No entanto, o Brightspace atualmente só reconhece o valor FullyGraded: o processo de avaliação é concluído e o valor da pontuação, se houver, representa a Nota final atual. Consulte os detalhes de Progresso da avaliação na documentação oficial do IMS.
Quando selecionada, as notas criadas por meio do AGS são incluídas no cálculo da nota final por padrão. Quando não selecionada, as notas criadas por meio do AGS serão excluídas do cálculo da nota final por padrão.
A sincronização de notas funciona em um modelo de "última atualização", ou seja, se um membro do corpo docente atualizar o boletim no Brightspace e acionar novamente uma sincronização da ferramenta, a nota será substituída. No entanto, você pode verificar o log do evento de nota para mostrar as alterações que ocorrem para um objeto de nota específico.
Você pode excluir as notas criadas usando o LTI Advantage se enviar um comando de exclusão dos serviços de atividades e notas (AGS). Se a nota tiver uma pontuação, o item de linha AGS será excluído, mas a nota no Brightspace permanecerá.
Criação automática de notas
As ferramentas LTI 1.3 podem, opcionalmente, criar notas automáticas se nenhuma estiver configurada. A opção de criação automática de notas é controlada pela configuração Criar notas automaticamente da implantação do LTI Advantage (o valor padrão é DESATIVADO).
Para ativar a criação automática de notas- No menu Ferramentas administrativas, clique em Ferramentas de aprendizagem externas.
- Selecione a guia LTI Advantage. Execute um dos seguintes procedimentos:
- Se você quiser criar uma nova implantação, clique em Nova implantação.
- Se você quiser fazer alterações em uma implantação existente, clique no nome correspondente da implantação na tabela.
- Na área Configurações, selecione Criar notas automaticamente.
Figura: a configuração Criar notas automaticamente da implantação do LTI Advantage está ATIVADA.
- Execute um dos seguintes procedimentos:
- Clique em Criar implantação (para criar novas implantações).
- Clique em Salvar e fechar (para editar implantações).
Como resultado, as notas são criadas automaticamente no Livro de notas depois de receber uma pontuação da ferramenta LTI pela primeira vez, mesmo se já houver uma associação de notas.
Vincular posicionamentos e notas
Cada posicionamento de um link em um curso é associado ao mesmo objeto de nota. Isso ocorre porque cada posicionamento do link tem o mesmo ID do link de recursos dentro do curso. Se itens de linha adicionais forem necessários para um link específico, links adicionais poderão ser criados por meio de Ferramentas de aprendizagem externas > LTI Advantage ou, se a ferramenta oferecer suporte ao Deep Linking, o recurso selecionado por meio da inicialização de vínculo profundo tem um ID de link de recurso LTI distinto e uma associação de item de linha.
O AGS pode ser usado para criar manualmente uma nota associada a um link incluindo o ID do link de recurso recebido da inicialização. Isso funciona para todos os links, exceto para widgets.
Editor de HTML e Deep Linking
Os itens de linha podem ser criados usando o editor de HTML e a vinculação profunda de duas maneiras:
- Ao usar Criar notas automaticamente: o item de linha é criado automaticamente. A nota está entre 100 e todas as atualizações adicionais ao item de linha devem ser feitas por meio do AGS.
- Através do AGS: uma ferramenta pode usar o AGS para criar manualmente um item de linha. Para garantir que a nota tenha a associação de link correta, a ferramenta deve incluir o ResourceLinkId recebido da inicialização ao criar o item de linha.
Pontuação máxima
Se a opção Pode exceder não estiver selecionada e uma ferramenta enviar uma pontuação maior que o máximo permitido, a pontuação máxima será mostrada no livro de notas, e a pontuação real enviada pela ferramenta será armazenada em uma tabela interna. Ferramentas e clientes não têm acesso a essa tabela.