O Integrity Advocate, em parceria com a D2L, fornece supervisão diretamente da ferramenta de questionários do Brightspace.
O Integrity Advocate é um aplicativo de inspeção on-line, monitoramento de participação e verificação de identificação que se integra ao Brightspace. Ele combina a tecnologia de IA com revisores ao vivo para garantir que cada sessão do aluno seja analisada cuidadosamente. O Integrity Advocate não requer downloads para o usuário e funciona em todos os navegadores modernos (exceções se aplicam quando a opção para usar um navegador seguro está selecionada).
|
Observação: os administradores devem seguir o processo de Registro dinâmico do LTI 1.3 para configurar a ferramenta e adicionar o widget LTI recém-criado às páginas iniciais do curso. |
Disponibilidade e ativação do Integrity Advocate
O Integrity Advocate é uma compra complementar do pacote Brightspace Core. Se você tiver dúvidas sobre essa integração ou estiver interessado em acessar o Integrity Advocate em sua instituição, entre em contato com seu Gerente de contas.
Ativar e configurar o Integrity Advocate
O Integrity Advocate é ativado por padrão no nível da instância. No entanto, ele é desativado no nível da organização.
Para ativar e configurar o Integrity Advocate:
- No menu Ferramentas de administração, selecione Ferramentas da organização.
- Procure o Integrity Advocate e ative-o.
- No menu Ferramentas administrativas, selecione Navegador de variável de configuração.
- Pesquise a variável de configuração d2l.3rdParty.IntegrityAdvocate.AppId.
- Digite seu AppId completo fornecido pelo Integrity Advocate como o valor da instância.
Para definir as configurações do Integrity Advocate:
- No menu Ferramentas de administração, selecione Ferramentas da organização.
- Procure o Integrity Advocate e alterne a opção para ligado.
- No menu Ferramentas administrativas, selecione Configuração do Integrity Advocate.
- Em ID do aplicativo, digite seu ID do aplicativo Integrity Advocate.
Observação: Para saber seu ID, entre em contato com o Integrity Advocate pelo e-mail sales@integrityadvocate.com
-
Em funções supervisionadas, selecione a(s) função(ões), como Aluno e qualquer outra função de Aluno, para a(s) qual(is) você deseja que a supervisão do Integrity Advocate esteja habilitada.
-
Clique em Salvar e fechar.
Registrar uma ferramenta de aprendizagem externa no Integrity Advocate
- Anote seu AppId fornecido pelo Integrity Advocate.
- No menu Ferramentas administrativas, clique em Gerenciar extensibilidade.
- Na guia LTI Advantage, clique em Registrar ferramenta.
- Selecione o botão de opção Dinâmico.
- No campo Endpoint do registro de inicialização da ferramenta*, digite a seguinte URL e adicione seu AppId no final:
https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id={SeuAppId}
Por exemplo:
https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id=xc186xxx-xxxx-xxxx-xxxx-xxacb09d5xxx
- Selecione a caixa de seleção Configurar a implantação.
- Clique em Registrar e siga as instruções. Uma mensagem de êxito é exibida.
- Após a conclusão, navegue até Gerenciar extensibilidade e verifique o registro e a implantação de sua nova ferramenta.
- No nível de implantação, compartilhe corretamente a implantação da nova ferramenta com os cursos para os quais você deseja disponibilizar a supervisão.
- No nível de implantação, verifique também se as seguintes configurações de segurança foram ativadas:
- Informações da unidade organizacional
- Nome
- Sobrenome
- E-mail
- ID do usuário
- Em Disponibilizar ferramenta para, clique em Adicionar unidades organizacionais.
- Selecione os cursos desejados ou apenas adicione a unidade organizacional principal e todos os descendentes.
- Clique em Adicionar.
- Clique em Salvar.
- Role até a parte inferior e clique em Exibir links.
- Clique no nome do link Integrity Advocate LTI 1.3.
- Defina o campo Altura como 1.000.
- Clique em Salvar e fechar.
Ativar a supervisão em um questionário
- No Brightspace, navegue até a página inicial de um curso.
- No widget do Integrity Advocate, clique na guia Questionários para exibir a lista de questionários no curso atual.
- Localize o questionário no qual deseja ativar a supervisão e marque a caixa de seleção na coluna Ativar o Integrity Advocate.
- Para associar um item de nota aos resultados de supervisão, marque a caixa de seleção usar Usar item de nota.
Observação: ativar a supervisão em um questionário também permite a pontuação automática, o que garante que as conclusões do questionário naveguem automaticamente para uma visualização dos envios do questionário. Todos os questionários são redirecionados para uma visualização padrão, a menos que sejam substituídos nas configurações do questionário. Consulte Configurações do questionário, opções da guia Visualização dos envios.
Uso da API
O Integrity Advocate utiliza as chamadas de API para enviar e receber dados do Brightspace.
Os usuários familiarizados com APIs do Brightspace sabem que, na primeira vez que um usuário acessa um aplicativo de API do Brightspace, uma mensagem de consentimento de permissões é exibida. Esta mensagem solicita que um usuário individual autorize o aplicativo a fazer chamadas de API no nome dele. Este aviso é mantido em vigor para fins de segurança.
A integração usa as seguintes APIs do Brightspace:
Sincronizar o valor da nota para um objeto de nota específico, para um usuário específico
Obter detalhes de uma nota específica
Criar um novo item de nota (aprovado/reprovado)
Atualizar o valor de um item de notas (aprovado/reprovado)
Excluir um item de notas (aprovado/reprovado)
Obter todos os questionários em um curso específico
Atualizar questionário (campos de cabeçalho e instrução)
Criar conta e função de serviço do Integrity Advocate
O Integrity Advocate utiliza uma função de conta de serviço e usuário para fazer chamadas de API para sua instância D2L Brightspace.
Para criar a função:
- Faça o download do arquivo de importação de função para configurar a conta de serviço Integrity Advocate.
- No menu Ferramentas administrativas, selecione Funções e permissões.
- Clique em Criar/Copiar.
- Selecione Iniciar nova e crie a nova função com as seguintes configurações:
- Nome: conta de serviço Integrity Advocate
- Descrição: função de conta de serviço para integração do Integrity Advocate
- Ativar função em cascata
Selecione as seguintes caixas de seleção:- Acessar cursos inativos
- Acessar cursos passados
- Acesse cursos futuros selecionando os seguintes botões de opção:
- Acessar todas as seções do curso
- Acessar todos os grupos de cursos
Clique em Salvar.
Na página Interações de função, marque todas as caixas de seleção de administrador apropriadas para permitir Pesquisar, Inscrever e Representar.
Clique em Salvar.
Clique em Importar/exportar.
Selecione Importar permissões de função de um arquivo CSV e clique em Próximo.
Selecione a nova função Conta de serviço do Integrity Advocate e clique em Próximo.
Clique no controle Escolher arquivo e selecione o arquivo de exportação de função da Etapa 1 e clique em Próximo.
Na página Visualizar importação, ignore todos os erros e clique em Importar.
Observação: Os erros são para controles que você não instalou ou habilitou e podem ser ignorados com segurança.
Clique em OK.
Definir mapeamentos de função IMS para a conta de serviço do Integrity Advocate
- No menu Ferramentas de administração, selecione Configuração do IMS.
- Clique em Editar mapeamento de função na coluna Função da instituição.
- Marque as caixas Administrador, Corpo docente (somente 1.1) e Instrutor.
- Clique em Salvar.
- Clique em Editar mapeamento de função na coluna Função de contexto.
- Marque as caixas Administrador e Instrutor.
- Clique em Salvar.
Criar o usuário da conta de serviço do Integrity Advocate
O Integrity Advocate utiliza uma função de conta de serviço e usuário para fazer chamadas de API para sua instância D2L Brightspace.
Para criar o usuário:
- No menu Ferramentas de administração, selecione Usuários.
- Clique em Novo usuário.
- Na página de criação do novo usuário, insira os seguintes detalhes:
- OrgDefinedId: ia.serviceaccount
- Primeiro nome legal: IA
- Sobrenome legal: ServiceAccount
- E-mail: noreply@integrityadvocate.com
- Função: conta de serviço do Integrity Advocate
- Nome de usuário: ia.serviceaccount
- Senha: criar uma senha forte
Observação: A D2L recomenda o uso de um gerador de senhas aleatórias, como https://passwordsgenerator.net
Clique em Salvar.
Envie as seguintes informações ao seu gerente de conta do Integrity Advocate:
Atualizar a função da conta de serviço do Integrity Advocate
Este tópico só se aplica ao atualizar o Integrity Advocate e não é necessário ao configurar uma nova instalação.
O Integrity Advocate utiliza uma função de conta de serviço e usuário para fazer chamadas de API para sua instância D2L Brightspace. A nova integração do Integrity Advocate da D2L permite a adição do Integrity Advocate não apenas a questionários, mas também a atividades e tarefas de conteúdo. É necessário atualizar as permissões de função para dar ao nosso sistema acesso a essas atividades.
Para atualizar a função:
- Faça o download do arquivo de importação de função para configurar a conta de serviço Integrity Advocate.
- No menu Ferramentas administrativas, selecione Funções e permissões.
- Clique em Importar/exportar.
- Selecione Importar permissões de função de um arquivo CSV e clique em Próximo.
- Selecione a função de Conta de serviço do Integrity Advocate e clique em Próximo.
- Clique no controle Escolher arquivo e selecione o arquivo de exportação de função da Etapa 1 e clique em Próximo.
- Na página Visualizar importação, ignore todos os erros e clique em Importar.
Observação: Os erros são para controles que você não instalou ou habilitou e podem ser ignorados com segurança.
- Clique em OK.
Redefinir a senha da conta de serviço
Este tópico só se aplica ao atualizar o Integrity Advocate e não é necessário ao configurar uma nova instalação.
A nova integração do Integrity Advocate da D2L usa a conta de serviço existente que criamos quando configuramos inicialmente o Integrity Advocate em sua instância. Redefiniremos a senha para que o novo aplicativo global Integrity Advocate seja autorizado a se integrar à sua instância.
- Crie uma nova senha forte.
Observação: A D2L recomenda o uso de um gerador de senhas aleatórias, como https://passwordsgenerator.net
- No menu Ferramentas de administração, selecione Usuários.
- Pesquise ia.serviceaccount e clique no nome da conta para editá-la.
- Atualize a senha de acordo com a que você gerou na Etapa 1 e clique em Salvar.
- Envie a senha atualizada para o gerente de conta do Integrity Advocate.
Configurar e usar a ferramenta externa do Integrity Advocate (widget)
O Integrity Advocate usa uma ferramenta LTI 1.3 para fornecer funcionalidade integrada. Nesse widget, você pode revisar os resultados dos participantes, definir opções de administrador, revisar o consumo de crédito e ler as notícias/atualizações da ferramenta Integrity Advocate.
Para registrar a ferramenta externa do Integrity Advocate
- No menu Ferramentas administrativas, clique em Gerenciar extensibilidade.
- Na guia LTI Advantage, clique em Registrar ferramenta.
- Selecione o botão de opção Dinâmico.
- No campo Endpoint do registro de inicialização da ferramenta, digite a seguinte URL e adicione o ID do aplicativo do Integrity Advocate no final. Por exemplo, https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id=SEU-APPID-AQUI
- Marque a caixa de seleção Configurar implantação.
- Clique em Registrar.
- Uma nova janela é aberta e exibe a mensagem "Sucesso!". Feche a janela de mensagem de sucesso e retorne à sua instância do D2L Brightspace.
- No menu Ferramentas administrativas, clique em Gerenciar extensibilidade.
- Clique na guia LTI Advantage e mude da visualização Ativada para a visualização Todos. Em seguida, clique em Todos.
- Clique no nome da ferramenta Integrity Advocate LTI 1.3.
- Clique na opção Ativada.
- Clique em Salvar.
- Role até a parte inferior e clique em Exibir implantações.
- Clique no nome da implantação do Integrity Advocate LTI 1.3 e marque as seguintes caixas em configurações de segurança:
- Informações da unidade organizacional
- Nome
- Sobrenome
- E-mail
- ID do usuário
- Em Disponibilizar ferramenta para, clique em Adicionar unidades organizacionais.
- Selecione os cursos desejados ou apenas adicione a unidade organizacional principal e todos os descendentes.
- Clique em Adicionar.
- Clique em Salvar.
- Role até a parte inferior e clique em Exibir links.
- Clique no nome do link Integrity Advocate LTI 1.3.
- Defina o campo Altura como 1.000.
- Clique em Salvar e fechar.
Adicionar o widget do Integrity Advocate às Páginas iniciais
- No menu Ferramentas de administração, selecione Gerenciamento de página inicial.
- Selecione a página inicial à qual deseja adicionar o widget do Integrity Advocate.
OBSERVAÇÃO:A D2L recomenda uma tela de largura total (altura 1.000) para o widget do Integrity Advocate. Se estiver usando o layout Básico, clique em Alterar layout e selecione Básico Plus e clique em Atualizar.
- Clique em Adicionar widgets na seção de largura total e procure Integrity Advocate.
- Selecione Integrity Advocate LTI 1.3 e clique em Adicionar.
- Clique em Salvar e fechar.
Usar o widget do Integrity Advocate
Há quatro guias no widget do Integrity Advocate LTI 1.3.
Participantes: pesquise os resultados da revisão do participante referentes a todas as atividades neste curso em que o Integrity Advocate esteja ativado.
Atividades: gerencie as configurações do Integrity Advocate para cada atividade em seu curso. Ativar/desativar, criar uma nota e selecionar regras para cada atividade.
Administrador: atualizar as configurações administrativas (informações de contato) e revisar os detalhes de consumo de crédito.
Novidades: revise todas as atualizações mais recentes sobre os novos recursos do Integrity Advocate e versões futuras/anteriores.
Remover o widget do Integrity Advocate LTI 1.0 das páginas iniciais do curso
Este tópico só se aplica ao atualizar o Integrity Advocate e não é necessário ao configurar uma nova instalação.
A nova integração D2L Brightspace/Integrity Advocate usa o padrão LTI 1.3 para se integrar à sua instância Brightspace e fornecer acesso aos resultados dos participantes do Integrity Advocate, opções de administração, consumo de crédito etc.
Remova o widget do Integrity Advocate LTI existente de qualquer página inicial do curso onde ele é exibido atualmente. Para remover o widget do Integrity Advocate LTI de uma página do curso:
- No menu Ferramentas administrativas, selecione Gerenciamento da página inicial.
- Clique no nome de uma página inicial que tenha o widget do Integrity Advocate LTI 1.0.
- Role até a seção Widgets e clique no X para remover o widget do Integrity Advocate.
- Clique em Salvar e fechar.
Ativar o Integrity Advocate em uma atividade
Para ativar o Integrity Advocate em uma atividade do curso:
- No widget do Integrity Advocate LTI 1.3, clique na guia Atividades.
- Encontre a atividade que deseja ativar para supervisão do Integrity Advocate.
- Marque a caixa Ativar o Integrity Advocate da atividade desejada.
- Se quiser usar uma nota, marque a caixa Usar nota na atividade desejada.
OBSERVAÇÃO: Isso cria uma nova nota atualizada pelo Integrity Advocate com um status de revisão. O Integrity Advocate não altera as notas que você configurou.
- Clique em Selecionar regras e marque as caixas das regras desejadas para a atividade.
- Clique em Enviar.
Remover o código do Integrity Advocate dos questionários
Este tópico só se aplica ao atualizar o Integrity Advocate e não é necessário ao configurar uma nova instalação.
A nova integração do D2L Brightspace/Integrity Advocate não requer mais que os instrutores ou administradores colem o código nas exibições Introdução, Cabeçalho e Visualizações dos envios de questionários. Esses blocos de código devem ser removidos em todos os questionários que você pretende usar no futuro.
Para remover o código do Integrity Advocate dos questionários:
- Determine quais cursos têm questionários que usam o Integrity Advocate.
- Na Página inicial do curso aplicável, clique em Questionários na barra de navegação ou clique em Ferramentas do curso e selecione Questionários no menu suspenso.
- Encontre os questionários que têm o Integrity Advocate instalado.
- Clique no nome do questionário aplicável para editar as configurações.
- No campo Introdução, clique no ícone </> do editor e remova o seguinte código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateHeader.html" style="height: 0px; width: 0px; border: none;"></iframe>
- No Cabeçalho da página, clique no ícone </> do editor e remova o seguinte código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateHeader.html" style="height: 0px; width: 0px; border: none;"></iframe>
- Role para cima e clique na guia Visualizações dos envios.
- Clique no nome da visualização das submissões para editá-la.
- No campo Mensagem, clique no ícone </>no editor e remova o seguinte código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateClose.html" style="height: 0px; width: 0px; border: none;"></iframe>
- Clique em Salvar.
Excluir arquivos compartilhados do Integrity Advocate
Este tópico só se aplica ao atualizar o Integrity Advocate e não é necessário ao configurar uma nova instalação.
Durante a instalação original do Integrity Advocate, os arquivos eram adicionados à seção de arquivos compartilhados da sua instância. A nova versão da integração não usa esses arquivos, e eles devem ser excluídos.
Para excluir os arquivos compartilhados do Integrity Advocate:
- No menu Ferramentas administrativas, selecione Arquivos compartilhados.
- Localize a pasta do Integrity Advocate e marque a caixa de seleção ao lado dela.
- Clique no ícone da lixeira na parte superior da pasta e da lista de arquivos para excluir a pasta.
Solução de problemas e perguntas frequentes
A supervisão não inicia ao responder um questionário
Como aluno, se você fizer um questionário que não inicia a supervisão, pode haver um problema de implantação nesse questionário.
- No widget do Integrity Advocate, na guia Configurações do questionário, verifique se o questionário está habilitado para supervisão.
- Verifique se a ferramenta Integrity Advocate está Ativada tanto no nível do curso quanto no nível da organização.
- Verifique se as variáveis de configuração em d2l.3rdParty.IntegrityAdvocate. estão configuradas com os valores corretos.
As chamadas de API para a integração estão falhando
Essa integração usa chamadas GET básicas (veja acima) para obter objetos específicos dos cursos. Se o widget não carregar uma lista de questionários, provavelmente, o usuário que está visualizando o widget não tem permissões para obter/visualizar a lista de questionários.
- Normalmente, questionários ocultos/invisíveis não estarão disponíveis para os alunos.
- Os questionários que ainda não começaram provavelmente não aparecerão para os alunos.
- Normalmente, todos os objetos aparecem para instrutores e administradores, estejam eles definidos como visíveis ou não.
Os resultados da supervisão não estão aparecendo no widget
Se você observar que os resultados da supervisão não aparecem no widget da página inicial do Integrity Advocate:
- É possível que o usuário não tenha fechado a sessão de supervisão. Nesses casos, é preciso aguardar o tempo limite automático de 10 minutos para que a sessão seja fechada e enviada para revisão.
Não é possível ver o widget Integrity Advocate na página inicial
Se um usuário disser que não pode ver o widget Integrity Advocate na página inicial do curso:
- Verifique se o widget está adicionado à página inicial atualmente em uso no curso.
- Verifique se o widget foi compartilhado com o curso atualizando as regras de compartilhamento de implantação do LTI 1.3.
O sistema sinalizou uma sessão como com falha, mas deve ser uma aprovação
Para substituir os resultados de atividade no nível do curso no widget do Integrity Advocate:
- Clique na guia Participantes.
- Selecione um envio e clique em Substituir para substituir os resultados de supervisão manualmente.
Observe que as substituições causam a atualização de todos os itens de nota supervisionados com Aprovação/Falha associados ao Integrity Advocate. A substituição é uma alteração no nível do curso e não reflete uma atividade individual.
Cliente existente que deseja atualizar
Você já é um cliente do Integrity Advocate? Se você tiver configurado a integração antes de maio de 2021, você está usando a versão clássica do Integrity Advocate. Nessa versão, a D2L recomenda que todos os clientes antigos considerem a atualização para a versão mais recente do Integrity Advocate, que fornece fluxos de trabalho aprimorados e maior flexibilidade no uso diário.
Dicas e práticas recomendadas da D2L para usar a versão mais recente:
- A integração clássica usa o LTI 1.1. A versão mais recente usa o LTI 1.3. Ambas as integrações podem residir em sua plataforma em conjunto e não entrarão em conflito umas com as outras.
Por exemplo, os widgets do LTI 1.1 e do LTI 1.3 podem ser adicionados à mesma página inicial. Ambos exibirão a mesma página. No entanto, a D2L recomenda ter apenas um deles por vez na página para evitar que o usuário se confunda.
- Configure a nova versão da integração e deixe a integração antiga em vigor. Não remova ou exclua as configurações antigas. Para gerenciar o acesso do usuário com segurança, recomendamos remover apenas as Regras de compartilhamento de seus provedores de ferramentas LTI, links LTI e plug-in remoto.
- Remova o widget do LTI 1.1 clássico das páginas iniciais do curso. Isso simplesmente o remove das páginas iniciais e não exclui nem remove nenhum dado do curso. Adicioná-lo novamente às páginas iniciais traz de volta todos os dados do curso.
- Quando você remover o widget antigo, adicione o novo widget do LTI 1.3.
- Informe aos instrutores que eles não precisam mais copiar e colar scripts HTML em seus questionários. Eles só precisam habilitar a supervisão no widget para começar a trabalhar.
Recursos Adicionais
IntegrationHub: Integrity Advocate
Integrity Advocate
Grupo da Comunidade Brightspace do Partners
Notas de versão
Assine as atualizações das Notas de versão do Brightspace para receber notificações de novas atualizações. Você também pode visualizar as Notas de versão do Integrity Advocate
Procurando ajuda?
Entre em contato com seu gerente de conta para tirar dúvidas sobre:
- Compra do Integrity Advocate
- Configuração da conta
- Faturamento
Entre em contato com o suporte técnico da D2L se precisar de atendimento relacionado à integração com o Brightspace.
Entre em contato com o Integrity Advocate para enviar um tíquete se o Integrity Advocate não estiver funcionando como esperado.