Ally no Moodle

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

O Ally oferece suporte ao Moodle 3.4 e posterior.

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. 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

      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. 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

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. 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.

      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. 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

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. 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.

      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. 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

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: Código do cliente fornecido pelo consultor técnico do Ally
   • Intervalo de log: Leve
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.