Instalar ferramentas, filtro e plug-ins de relatórios do Ally

As versões 3.3 dos plug-ins são compatíveis com o Moodle 3.2.

  1. Baixe ou clone a versão necessária da ferramenta do administrador do Ally no github.

    1. Baixar como um arquivo ZIP
      1. Se necessário, altere a versão da ramificação.
      2. Revise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        A atualização "3.4.3" deve funcionar com as instalações do Moodle 3.4. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

        Mais sobre os números de versão e atualizações do Moodle correspondentes

      3. Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
    2. Como clonar a pasta git
      1. Acessar a pasta de ferramentas.

        cd [moodle location]/admin/tool

      2. Clonar a pasta
        • Como usar o SSH

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • Como usar o HTTP

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. Verifique a ramificação correspondente, por exemplo, para o Moodle 3.4 é o MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        A verificação da ramificação também pode ser usada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

  2. Baixe ou clone a versão necessária do filtro do Ally do github.

    1. Baixar como um arquivo ZIP
      1. Se necessário, altere a versão da ramificação
      2. Revise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        A atualização "3.4.3" deve funcionar com as instalações do Moodle 3.4. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

        Mais sobre os números de versão e atualizações do Moodle correspondentes.

      3. Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
    2. Como clonar a pasta git
      1. Acessar a pasta de filtros.

        cd [moodle location]/filter

      2. Clonar a pasta
        • Como usar o SSH

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • Como usar o http

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. Verifique a ramificação correspondente, por exemplo, para o Moodle 3.4 é o MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        A verificação da ramificação também pode ser usada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

  3. Baixe ou clone a versão necessária da ferramenta de LTI do relatório do Ally pelo github.

    1. Baixar como um arquivo ZIP
      1. Se necessário, altere a versão da ramificação
      2. Revise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        A atualização "3.4.3" deve funcionar com as instalações do Moodle 3.4. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

        Mais sobre os números de versão e atualizações do Moodle correspondentes.

      3. Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
    2. Como clonar a pasta git
      1. Acessar a pasta de relatórios

        cd [moodle location]/report

      2. Clonar a pasta
        • Como usar o SSH

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • Como usar o HTTP

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. Verifique a ramificação correspondente, por exemplo, para o Moodle 3.4 é o MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        A verificação da ramificação também pode ser usada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

  4. Verificar a estrutura da pasta.

    O diretório de ferramenta do administrador deve ser nomeado ally. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/admin/tool/ally

    O diretório de filtro deve ser nomeado ally. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/filter/ally

    O diretório de relatório deve ser nomeado allylti. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/report/allylti

  5. Certifique-se de que cada pasta e seus conteúdos possam ser lidos pelo seu servidor da web.
  6. Faça logon no seu site do Moodle como usuário administrador e abra a página do administrador. Isso deve verificar se há novos plug-ins e apresentar a você uma opção para Atualizar o banco de dados do Moodle agora. Selecione este botão para instalar os plug-ins.
  7. Após instalar os plug-ins, navegue até Administração do sistema > Plug-ins > Ferramentas do administrador > Ally.
  8. Selecione Autoconfigurar o serviço da web do Ally.

    Na próxima tela haverá um código do serviço da web e um URL para testar o serviço da web do Ally.

    Este URL precisa ser acessível diretamente pela internet para que o Ally possa usá-lo.

    Se for bem sucedido, você terá que copiar o código de serviço da web do Ally e o link de serviço da web e fornecê-los ao seu consultor técnico do Ally por meio do compartilhamento do IronBox, que ele configurará e ao qual fornecerá acesso em um link por e-mail. Ele entrará em contato quando tiver terminado as configurações relevantes e fornecerá “chave”, “segredo”, “URL inicial”, “URL de atualizações de arquivo” e “código do cliente”.

    Se sua instância do Moodle usa campos obrigatórios personalizados para contas de usuários, “Fazer logon como” o usuário do serviço da web do Ally criado pelo plug-in de autoconfiguração garante que esses campos personalizados sejam preenchidos e salvos.


Configurar o plug-in do Moodle

A consultoria técnica do Ally criará um cliente do Ally usando o código de serviço da web do Moodle gerado na seção anterior e lhe fornecerá detalhes para configurar o plug-in do Ally.

  1. Faça logon como administrador do Moodle.
  2. Em Administração do site selecione Plug-ins e Ferramentas do administrador. Selecione Configuração do Ally.
  3. Insira os seguintes detalhes
    • Autores de conteúdo: as funções de usuários que são autores de conteúdo. Devem ser: Gerente, Criador do curso, Professor (os padrões).

      Normalmente, isto não deve ser alterado; não faça alterações sem perguntar ao consultor técnico do Ally.

    • Chave: a chave de LTI fornecida pelo consultor técnico do Ally
    • Segredo: o segredo de LTI fornecido pelo consultor técnico do Ally
    • URL inicial: o URL inicial de LTI fornecido pelo consultor técnico do Ally
    • URL de atualização de arquivo: o URL de evento/atualização de arquivo fornecido pelo consultor técnico do Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • Código do cliente: o código do cliente fornecido pelo consultor técnico do Ally
  4. Salvar alterações.

Relatório institucional do Ally

Assim que o plug-in do Ally for configurado, você terá acesso ao Relatório institucional do Ally.

Nenhum dado será apresentado no relatório até que ocorra a sincronização do curso do Ally e o relatório inicial seja gerado.

Para acessar o Relatório institucional do Ally, vá para Administração do site e selecione Relatórios. Selecione Acessibilidade.

Mais sobre o Relatório institucional do Ally


Filtro do Ally

Quando você estiver pronto para obter os indicadores de pontuação de acessibilidade do Ally, e a opção para baixar a versão de acessibilidade alternativa ficar disponível dentro do Moodle, você precisará habilitar o filtro.

Habilitar o filtro do Ally

  1. Em Administração do site  selecione Plug-ins  e Visão geral dos plug-ins.
  2. Desça até seção dos Filtros de texto e habilite o filtro do Ally.
  3. Mova o filtro do Ally para o topo da lista Filtro.

Acessar a interface de usuário da configuração do Ally

Fornecemos as instruções sobre como acessar a Configuração do Ally durante a configuração. Se você não tiver acesso, envie uma solicitação no Behind the Blackboard.

Configurar cursos do Ally


Configurar cursos

Acesse a página Configuração do Ally e ative o Ally para todos os cursos ou decida curso por curso. Você decide.

  1. Veja quantos de seus cursos utilizam o Ally.
  2. Ative ou desative o Ally em todos os cursos existentes. Decida com antecedência se você o deseja ativado em todos os seus cursos futuros.
  3. Procure por cursos individuais ou filtre todos os cursos por status (ativado/desativado) e por período.
  4. Ative ou desative o Ally em cada curso, individualmente.

Ative ou desative o Ally em um único curso

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

O Relatório institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso aparece no relatório institucional.

Em Configuração do Ally, encontre o curso que deseja atualizar. Use o campo Busca e os filtros para pesquisar por título e código do curso.

Selecione Ativar ou Desativar na coluna Ativado para ativar ou desativar o Ally.

  • Ally está desativado: Selecione Habilitar integração de UI do curso para ativar
  • Ally está ativado: Selecione Desabilitar integração de UI do curso para desativar

Ativar ou desativar o Ally em todos os cursos

Não sabe ao certo se todos os seus cursos estão ou não usando o Ally? No topo da página de Configuração do Ally, veja quantos de seus cursos estão utilizando-o atualmente.

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

O Relatório institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso aparece no relatório institucional.

É possível ativar ou desativar o Ally em todos os cursos existentes na página de Configuração do Ally. Selecione Ativar/desativar todos os cursos e, em seguida, Desativar ou Ativar.

Selecione Ativar nos próximos cursos se quiser o Ally automaticamente ativo em todos os seus novos cursos.

Se não selecionar essa opção, os novos cursos não terão o Ally habilitado. Se você quiser o Ally posteriormente, ative o Ally em cursos individuais.

Depois de escolher ativar ou desativar em todos os cursos, é preciso confirmar a ação. Selecione Ativar ou Desativar, dependendo da sua escolha. Selecione Cancelar se mudar de ideia e não quiser alterar nada.


Ative o Ally apenas em todos os cursos novos

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

O Relatório institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso aparece no relatório institucional.

Selecione Ativar nos próximos cursos se quiser o Ally automaticamente ativo em todos os seus novos cursos.

Se não selecionar essa opção, os novos cursos não terão o Ally habilitado. Se você quiser o Ally posteriormente, ative o Ally em cursos individuais.

Configurar os ajustes da ajuda do Ally


Configurar os ajustes da ajuda do usuário do Ally

Configure mensagens padronizadas que são exibidas nos modais Formatos alternativos e Comentários do instrutor. As mensagens de ajuda personalizadas podem ser usadas para indicar documentação institucional aos alunos e instrutores, compartilhar informações de contato e assim por diante. O conteúdo da ajuda personalizada pode ser configurado na UI de Configuração do Ally e usa o formato Markdown, que ajuda a fornecer uma mensagem estruturada e acessível.

Quando nenhuma mensagem personalizada for configurada, os links da Ajuda direcionam para estas páginas na ajuda da Blackboard:

  1. Vá até sua Configuração do Ally e selecione Configurações da ajuda.
  2. Escolha a opção de ajuda padrão ou personalizada, tanto para a Ajuda dos comentários do instrutor quanto para a Ajuda dos formatos alternativos.
  3. Caso escolha a opção personalizada, edite a Mensagem personalizada.

    Use o formato Markdown para ajudar a fornecer uma mensagem estruturada e acessível.

  4. Selecione Salvar alterações.

Configure a ajuda especializada

Ofereça a seus instrutores e alunos fácil acesso a sua equipe de especialistas em acessibilidade. Ative a ajuda especializada para que seus usuários possam solicitar auxílio diretamente dos formatos alternativos e painéis de comentários do instrutor.

Quando uma solicitação é feita, um e-mail contendo o pedido de ajuda, os detalhes do curso em andamento, o item de conteúdo e usuário é enviado ao endereço de e-mail que você configurou.

  1. Vá até sua Configuração do Ally e selecione Configurações da ajuda.
  2. Escolha Oferecer ajuda personalizada tanto para a ajuda dos comentários do instrutor quanto para a ajuda dos formatos alternativos.
  3. Selecione Ativar ajuda especializada.
  4. Digite o endereço de e-mail para sua equipe de especialistas em acessibilidade.
  5. Selecione Salvar alterações.

O usuário API do Ally para a integração do Blackboard Learn precisa receber a permissão “Painel do administrador (Usuários) e Usuários” ou “exibição.do.sistema.do.usuário” para permitir que o Ally inclua o nome do aluno e o endereço de e-mail no e-mail de solicitação de ajuda. O usuário API do Ally para a integração do Moodle precisa receber a permissão “moodle/usuário:exibirtodososdetalhes” para permitir que o Ally inclua o nome do aluno e o endereço de e-mail no e-mail de solicitação de ajuda.

Customize Ally Features


Customize Ally features

You can turn some features on or off to customize Ally to suit your institutional preferences.

In Ally Configuration, decide what features you want enabled.

  1. Go to Ally Configuration and select Features.
  2. Find the feature you want to turn on or off and select it.
  3. Select Enable or Disable to turn the feature on or off.

Configurar relatório de acessibilidade do curso no Blackboard Open LMS

No momento, este recurso está disponível apenas para o Blackboard Open LMS. A disponibilidade do relatório de acessibilidade do curso no Moodle requer uma atualização dos plug-ins do Ally Moodle. Esta atualização será disponibilizada nas próximas semanas e um aviso separado de liberação será enviado.