Skip to main content

Configure o Ally no Blackboard

Configure o Building Block do Ally

O building block Integração ao Ally já está instalado no seu ambiente do Blackboard. No Painel do administrador, selecione Building Blocks e Ferramentas instaladas para encontrá-lo. Um consultor técnico do Blackboard configura este building block para você.

A configuração do building block do Ally inclui estas etapas:

  1. Disponibiliza a integração nas configurações de integração do Ally.

  2. Cria um usuário. Ninguém será autenticado como este usuário. Esse usuário é criado para ser executado na integração do REST API e terá determinadas permissões para o que ele pode fazer. Os nomes de usuário geralmente são "allyuser" ou "allyintegration".

    Importante

    Não exclua o usuário Ally. Se você excluir o usuário, a integração não funcionará.

  3. Adiciona informações do provedor de ferramentas e parâmetros personalizados. Chave, Segredo, Código do Cliente, URL e Script personalizado são utilizados para permitir que formatos alternativos, comentários dos instrutores e relatórios do Ally sejam lançados no seu ambiente do Blackboard.

    Nota

    Os parâmetros de script personalizados são adicionados para que o Ally funcione na visualização original.

    Importante

    O código do cliente é exclusivo para cada ambiente. Ele não pode ser o mesmo para seus ambientes de preparo e de produção.

O que a configuração do Building Block adiciona ao seu ambiente?

Depois que o building block for configurado, você verá essas contas, funções e ferramentas adicionadas ao seu ambiente:

  • Usuário de integração do Ally

  • Função do sistema de integração do Ally atribuída ao usuário de integração do Ally

  • Configuração do Ally

  • Relatório do Ally

Sobre a função de usuário e do sistema do Ally

Depois que o building block da Integração do Ally for configurado, um usuário de integração e uma função do sistema do Ally são adicionados ao seu ambiente.

Ninguém é autenticado com a conta do usuário. Este usuário é criado para ser executado na integração do REST API. A função de integração do Ally é utilizada apenas pelo usuário do Ally e não deve ser atribuída a um usuário normal. Ocorrerão erros se uma conta de usuário regular tentar fazer logon com a função de sistema de integração do Ally.

O usuário recebe uma função de sistema da Integração do Ally adicionada ao seu ambiente. A função do sistema tem um conjunto de privilégios que define como a integração funciona com o ambiente.

Importante

Não exclua a função do usuário e do sistema do Ally. Se você excluir a função do usuário ou do sistema, a integração não funcionará.

Privilégios da função do sistema de integração do Ally

  • Adicionar/editar conteúdo confiável com scripts: Permite que os comentários do instrutor mantenham o conteúdo igual ao que os instrutores criaram originalmente. Sem esse privilégio, o Ally pode excluir acidentalmente algo do conteúdo que um instrutor adicionou.

  • Painel de Controle de Curso/Organização (Ferramentas) > Gerenciamento de Datas: Permite que o Ally tenha acesso à ferramenta de gerenciamento de datas na visualização original do curso.

  • Ferramenta Blackboard Predict Advisor: Permite que o Ally tenha acesso à ferramenta Predict Advisor.

  • Painel de Administrador (Usuários) > Usuários > Editar > Ver Matrículas da Organização: Permite que o Ally forneça uma contagem de alunos para cada organização.

    Nota

    O Ally se refere a organizações como cursos nos relatórios institucionais e do curso.

  • Painel de Administrador (Usuários) > Usuários > Editar > Ver Matrículas de Cursos: Permite que o Ally forneça uma contagem de alunos para cada curso.

  • O Painel de Controle de Curso/Organização (ferramentas) > testes, pesquisas e pools > desenvolvimento de testes, testes e visualizar o desenvolvimento e as configurações dos testes Permite que o Ally digitalize e pontue arquivos anexados ou imagens integradas à Descrição do Link de Conteúdo WYSIWYG de testes e pesquisas. Esses privilégios funcionam juntos e devem ser todos selecionados.

    • Painel de controle do curso/organização (Ferramentas) > Testes, pesquisas e bancos de dados > Testes > Elaborar teste

    • Painel de controle de curso/organização (Ferramentas) > Testes, pesquisas e bancos de dados > Testes

    • Painel de Controle de Curso/Organização (Ferramentas) > Testes, Pesquisas e Pools > Testes > Visualizar Desenvolvimento e Configurações de Teste

  • Curso/Organização (Áreas de Conteúdo) > Editar Materiais: Permite que o Ally atualize atributos de imagem nas descrições dos itens de conteúdo.

  • Ler, Escrever, Excluir, Executar acesso ao sistema de arquivos do Sistema de Conteúdo: Permite que o Ally grave arquivos no ambiente quando os instrutores os enviam por meio dos Comentários do Instrutor. Esse privilégio também permite que o Ally exclua arquivos de indução de captura dos Comentários do instrutor.

  • Acesso somente leitura ao sistema de arquivos do Sistema de Conteúdo: Permite que o Ally leia arquivos para processamento. Por exemplo, integrados e sincronizações de curso.

Configure a integração do REST API

Configure o REST API para permitir que o Ally recupere conteúdo e informações do curso do seu ambiente. Um consultor técnico da Blackboard configura a integração do REST API para você.

A configuração da integração do REST API do Ally inclui estas etapas:

  1. Adiciona o Código de aplicativo. O Código de aplicativo é sempre o mesmo e pode ser reutilizado. ID do aplicativo: 85d3b720-1a00-45e4-a3ee-c2be80de7295

  2. Adiciona o usuário de integração do Ally. Os nomes de usuário geralmente são "allyuser" ou "allyintegration".

  3. Fornece ao REST API o Acesso de usuário final. Clique em Sim para fazer com que a integração do Ally atue como o usuário em vez de um único usuário em todo o sistema.

  4. Autoriza o REST API para atuar como um usuário. Clique em Sim para permitir que o Ally atualize o conteúdo no local original.

Configura o relatório do curso

Configure o relatório do curso para adicioná-lo aos cursos no seu ambiente. Um consultor técnico Blackboard configura o relatório do curso para você.