Instalar ferramentas e plug-ins de relatórios do Ally
O Ally oferece suporte ao Moodle 3.4 e posterior.
-
Baixe ou clone a versão necessária da ferramenta do administrador do Ally no github.
- Baixar como um arquivo ZIP
- Se necessário, altere a versão da ramificação.
-
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. Ex. 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
- Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
- Como clonar a pasta git
- Acessar a pasta de ferramentas.
cd [moodle location]/admin/tool
- 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
- Como usar o SSH
- Confira a ramificação correspondente, ou seja, para Moodle 3.4 é 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
- Acessar a pasta de ferramentas.
- Baixar como um arquivo ZIP
-
Baixe ou clone a versão necessária do filtro do Ally do github.
- Baixar como um arquivo ZIP
- Se necessário, altere a versão da ramificação
- 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. Ex. 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.
- Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
- Como clonar a pasta git
- Acessar a pasta de filtros.
cd [moodle location]/filter
- 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
- Como usar o SSH
- Confira a filial correspondente, ou seja, para Moodle 3.4 é 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
- Acessar a pasta de filtros.
- Baixar como um arquivo ZIP
-
Baixe ou clone a versão necessária da ferramenta de LTI do relatório do Ally pelo github.
- Baixar como um arquivo ZIP
- Se necessário, altere a versão da ramificação
- 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. Ex. 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.
- Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
- Como clonar a pasta git
- Acessar a pasta de relatórios
cd [moodle location]/report
- 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
- Como usar o SSH
- Confira a ramificação correspondente, ou seja, para Moodle 3.4 é 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
- Acessar a pasta de relatórios
- Baixar como um arquivo ZIP
-
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
- Certifique-se de que cada pasta e seus conteúdos possam ser lidos pelo seu servidor da web.
- 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.
- Após instalar os plug-ins, navegue até Administração do sistema > Plug-ins > Ferramentas do administrador > Ally.
- 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.
- Faça logon como administrador do Moodle.
- Em Administração do site selecione Plug-ins e Ferramentas do administrador. Selecione Configuração do Ally.
- 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: Código do cliente fornecido pelo consultor técnico do Ally
- Intervalo de log: Leve
- 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).
- 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.
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
- Em Administração do site selecione Plug-ins e Visão geral dos plug-ins.
- Desça até seção dos Filtros de texto e habilite o filtro do Ally.
- 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.
- Veja quantos de seus cursos utilizam o Ally.
- 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.
- Procure por cursos individuais ou filtre todos os cursos por status (ativado/desativado) e por período.
- 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. Quando nenhuma mensagem personalizada for configurada, os links da Ajuda direcionam para estas páginas na ajuda da Blackboard:
- Formatos alternativos: essa página explica como e quando os formatos alternativos podem ser usados
- Ajuda do instrutor: Tudo o que os instrutores precisam saber sobre o Ally em seus cursos
O conteúdo da ajuda personalizada pode ser configurado na UI de Configuração do Ally e usa o formato Markdown, que ajuda a passar uma mensagem estruturada e acessível.
- Acesse Configuração do Ally e selecione Configurações da ajuda.
- 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.
- Caso escolha a opção personalizada, edite a Mensagem personalizada.
Use o formato Markdown para ajudar a fornecer uma mensagem estruturada e acessível.
- 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.
- Acesse Configuração do Ally e selecione Configurações da ajuda.
- Escolha Oferecer ajuda personalizada tanto para a ajuda dos comentários do instrutor quanto para a ajuda dos formatos alternativos.
- Selecione Ativar ajuda especializada.
- Digite o endereço de e-mail para sua equipe de especialistas em acessibilidade.
- Selecione Salvar alterações.
O usuário API do Ally para a integração do Blackboard Learn precisa receber a permissão “Administrator Panel (Users) > Users” ou “system.user.view” 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/user:viewalldetails” 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.
Personalizar recursos do Ally
Personalizar recursos de referência do Ally
Você pode ativar ou desativar alguns recursos para personalizar o Ally às suas preferências institucionais.
Em Configuração do Ally, escolha quais recursos deseja ativar.
- Acesse Configuração do Ally e selecione Recursos.
- Encontre o recurso que deseja ativar ou desativar e selecione-o.
- Formato alternativo de versão traduzida: Os alunos podem fazer o download de um formato alternativo traduzido de um arquivo original.
- Formato alternativo do BeeLine Reader: Os alunos podem baixar um formato alternativo do BeeLine Reader.
- Acesse os comentários do instrutor pelo relatório institucional: Dê aos administradores, aos serviços para alunos com necessidades especiais e aos designers de instrução acesso aos comentários do instrutor.
- Comentários do instrutor sobre o conteúdo do editor de texto com formatação: Os instrutores e administradores podem acessar os comentários sobre o conteúdo criado no editor LMS WYSIWYG.
Saiba mais sobre a acessibilidade do WYSIWYG para instrutores
- Integração de dados do Ally ao Impact by Instructure (antigo EesySoft): as instituições uma licença do Impact by Instructure podem permitir um monitoramento mais detalhado das interações no modal de formatos alternativos, nos comentários do instrutor e no relatório de acessibilidade do curso. As instituições podem usar esses dados para relatórios de adoção e campanhas no Impact by Instructure. A integração do Impact by Instructure está desativada por padrão.
Essa integração requer uma licença Impact by Instructure.
- Selecione Habilitar ou Desabilitar para ativar ou desativar o recurso.