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.


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.