Skip to main content

Ally para a integração com D2L Brightspace

Para integrar o Ally com sua instância do D2L Brightspace, você precisa seguir estas etapas:

  1. Criação de usuários e funções. Isso precisa ser feito antes de qualquer ligação com o contato do Anthology Ally.

  2. Configuração principal

  3. Configurar LTI

    • Configuração do cliente

    • Relatório Institucional

    • Relatório de Acessibilidade aos Cursos

Criação de usuários e funções

  1. Crie uma nova função 

    1. No menu de Configurações (ícone de engrenagem), navegue até Funções e permissões 

    2. Inicie o processo de criação de função clicando no botão Criar/Copiar 

    3. Crie uma nova função em branco clicando no botão Reiniciar 

    4. Configurações da função: 

      • Nome:  Função REST do Ally 

      • Descrição: O conjunto de permissões para que o Ally se comunique de forma segura com as APIs REST do Brightspace 

      • Habilite a Função em Cascata 

        Deixe a opção Facilitador Primário desabilitada, pois pode não ser mais necessária

      • Nome de função: ally 

      • Não é necessário fazer alterações em Opções de Comportamento da Ferramenta. Tudo pode permanecer desabilitado 

      • Não é necessário fazer alterações em Opções de Exibição da Lista de Classes. Tudo pode permanecer desabilitado 

      • Em Opções de acesso ao curso: 

        • Habilitar todas as opções de acesso 

          • Acesse cursos inativos 

          • Acesse cursos anteriores 

          • Acesse cursos futuros 

        • Seções e Grupos podem permanecer definidos como Nenhum dos anteriores 

    5. Interações de função: 

      1. Em Inscrever-se Função REST do Ally, marque a caixa de seleção na interseção da linha do administrador e da coluna da Organização. Permite criar um usuário com essa função posteriormente. 

      2. Em Pesquisar Função REST no Ally, marque a caixa de seleção na interseção da linha do administrador e da coluna Organização. Permite buscar um usuário com essa função posteriormente. 

      3. Nenhuma alteração é necessária.

  2. Configure as permissões da função 

    Uma vez gravado, a nova função Ally REST será exibida no final da lista de funções. Abra o menu suspenso e selecione Editar permissões. Nesta tela, é necessário conceder as seguintes permissões: 

    1. Filtre pela ferramenta Conteúdo e conceda as seguintes permissões na coluna Oferta de Cursos: 

      • Veja o conteúdo do curso 

      • Compilar e Baixar Conteúdo 

      • Baixar Tópicos de Conteúdo 

      • Veja o conteúdo que não foi divulgado 

      • Gerenciar Conteúdo 

      • Criar e Editar Módulos e Tópicos 

      • Exclua Módulos e Tópicos (necessário para excluir imagens que podem causar convulsões)

    2. Console de gerenciamento do curso

      • Ver Informações do Curso (Oferta de Cursos). Esta permissão é necessária para o Ally recuperar as unidades organizacionais do departamento.

    3. Lista de aula

      • Tem acesso à lista de aula

    4. Discussões 

      • Ver discussões (Oferta de Cursos)

        Necessário para relacionar links de tópicos de discussão em um curso e o respetivo sumário. 

    5. Questionários 

      • Veja quizzes (Oferta de Cursos)

        Necessário para relacionar links para quizzes no sumário do curso. 

    6. Editor da Unidade Org 

      • Ver Editor da Unidade Org (Organização)  

      • Pode adicionar e editar tipos de unidade organizacional (organização).

        Precisamos desse cargo para relacionar os semestres. Infelizmente, não há nenhuma permissão "somente leitura" disponível. O Ally nunca cria ou edita informações do tipo unidade organizacional.

    7. Segurança 

      • Ver Funções e Permissões (Organização)

    8. Privacidade das Informações do Usuário

      1. Veja Nomes de Usuário (Oferta de Cursos)

        Essa permissão permite que o Ally veja o identificador do Usuário, mas nada mais. Essas informações nunca são armazenadas. Mas por razões técnicas, é necessário determinar quantos alunos estão matriculados em um curso.

      2. Ver Nomes (Organização)

        É necessário para recuperar o nome e o e-mail do usuário quando ele pedir ajuda. Esses dados nunca são armazenados pelo Ally e só são transmitidos no e-mail de ajuda.

      3. Ver Sobrenomes (Organização)

        É necessário para recuperar o nome e o e-mail do usuário quando ele pedir ajuda. Esses dados nunca são armazenados pelo Ally e só são transmitidos no e-mail de ajuda.

      4. Ver Endereços de E-mail (Organização)

        É necessário para recuperar o nome e o e-mail do usuário quando ele pedir ajuda. Esses dados nunca são armazenados pelo Ally e só são transmitidos no e-mail de ajuda.

    9. Usuários

      1. Visualizar matrículas do usuário (oferta de curso)

      2. Procure por 'Aluno' (Oferta de Cursos)

        Aluno é o nome padrão para a função de aluno. Se a sua instituição usa um nome diferente para este tipo de usuário, habilite Pesquisa por “...” em vez disso. Necessário para recuperar a contagem de alunos em uma oferta de curso. Os dados enviados são anônimos.

      3. Ver o endereço de e-mail dos usuários (organização)

        É necessário recuperar o e-mail do usuário quando ele solicita ajuda. Esses dados nunca são armazenados pelo Ally e só são transmitidos no e-mail de ajuda.

      4. Veja a Ferramenta de Gerenciamento de Usuários (Organização)

        É necessário recuperar o nome e o e-mail do usuário quando ele pedir ajuda. Esses dados nunca são armazenados pelo Ally e só são transmitidos no e-mail de ajuda.)

  3. Criação de usuários

    Uma vez configurada a função, um novo usuário pode ser criado com esse conjunto limitado de permissões. 

    1. No menu de Configurações (ícone de engrenagem), navegue até Usuários 

    2. Inicie o processo de criação de função clicando no botão Novo Usuário 

    3. Configurações: 

      • Nome: Ally 

      • Sobrenome: Usuário 

      • Função: Função REST do Ally 

      • Nome de usuário: allyuser 

      • Clique em Definir senha manualmente e digite uma senha adequada e segura no campo Senha. É fundamental que esta senha seja suficientemente segura, uma vez que alterá-la posteriormente exigirá configurar tudo de novo.

      • Salve o usuário clicando no botão Salvar  

Configuração principal

Importante

Certifique-se de que a configuração de Usuário e Função seja feita primeiro. A seguinte configuração é feita durante uma ligação com um contato do Anthology Ally. Certifique-se de que a ligação de configuração seja programada primeiro.

  1. No menu de Configurações (ícone de engrenagem), navegue para Gerenciar extensibilidade

  2. Certifique-se de estar na guia OAuth 2.0

  3. Clique no botão Cadastrar um App

  4. Preencha o formulário da seguinte maneira:

    • Nome: Ally

    • URL de redirecionamento: <URL de redirecionamento fornecida pelo contato da Anthology>

      ex.: https://[Ally env]/api/v1/d2l/callback?clientId=[Código do Cliente Ally]

    • Escopo: conteúdo:*:ler conteúdo:arquivo:write core:*:* personalizado:contentaccess:read matrícula:orgunit:read

    • Pedido de consentimento do usuário: Não

    • Habilitar códigos de atualização: Sim

    • Aceito o acordo de Desenvolvedor Não Comercial: Sim

  5. Clique no botão Registrar

  6. Agora os detalhes do aplicativo recém-criado serão apresentados. Copie o código do cliente e a chave secreta, e compartilhe-os com seu contato do Anthology Ally.

  7. Depois de obter a confirmação do Anthology Ally, selecione Atualizar

  8. Entrar no Brightspace como o allyuser

  9. Acesse a URL fornecida pelo seu contato do Anthology Ally (em Detalhes de integração do administração de clientes do Ally). Embora seja uma URL cujo nome do host termina em .ally.ac, você será redirecionado automaticamente para a sua instância do Brightspace. O Brightspace apresentará uma tela pedindo sua permissão para o Ally interagir com a API REST. Clique em Aceitar.

  10. Se tudo correu bem, a seguinte mensagem de sucesso deve ser exibida: A integração com o REST foi configurada com sucesso!

  11. No menu de Configurações (ícone de engrenagem), navegue até Configurar navegador variável

  12. Localize as configurações do Ally utilizando o menu de árvore à esquerda: 3ª Parte > Ally

    A integração do Ally está disponível em d2l.3rdParty.Ally.*

  13. Adicione os valores de configuração aos fornecidos pelo seu contato do Blackboard

    • Código do cliente

    • ClientSecret – O Brightspace exibirá duas entradas. Use o segredo LTI do usuário para ambas as entradas.

    • ScriptUrl

  14. No menu de Configurações (ícone de engrenagem), navegue até Ferramentas organizacionais

  15. Encontre a linha para a Integração do Ally e alterne a caixa de seleção para que ela seja ativada

Configurar LTI

Siga esta etapa para configurar os dados LTI e registrar as ferramentas do Ally.