Instal·lació d'eines, filtres i complements d'informes d'Ally

Les versions 3.3 dels complements són compatibles amb Moodle 3.2.

  1. Descarregueu o cloneu de github la versió que necessiteu de l'eina d'administració d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca, si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta d'eines

        cd [moodle location]/admin/tool

      2. Clonació del repositori
        • Amb SSH

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

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  2. Descarregueu o cloneu de github la versió que necessiteu del filtre d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió.

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta de fitxers.

        cd [moodle location]/filter

      2. Clonació del repositori
        • Amb SSH

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

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  3. Descarregueu de github la versió que necessiteu de l'eina LTI de l'informe d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió.

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta d'informes

        cd [moodle location]/report

      2. Clonació del repositori
        • Amb SSH

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

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  4. Verifiqueu l'estructura de carpetes

    El directori d'eines d'administració s'hauria d'anomenar ally. Hauria de tenir un camí com aquest:

    [yourmoodledir]/admin/tool/ally

    El directori de filtres s'hauria d'anomenar ally. Hauria de tenir un camí com aquest:

    [yourmoodledir]/filter/ally

    El directori d'eines d'informe s'hauria d'anomenar allylti. Hauria de tenir un camí com aquest:

    [yourmoodledir]/report/allylti

  5. Assegureu-vos que el vostre servidor web pot llegir totes les carpetes i els continguts que contenen.
  6. Inicieu la sessió com a usuari administrador al vostre lloc de Moodle i obriu la pàgina d'administració. En fer-ho, es comprova si hi ha nous complements i s'ofereix l'opció Actualitza la base de dades de Moodle ara. Seleccioneu aquest botó per instal·lar els complements.
  7. Després d'instal·lar els complements, aneu a Administració del sistema > Complements > Eines d'administració > Ally.
  8. Seleccioneu Configura el servei Ally automàticament'.

    A la pantalla següent hi haurà un testimoni del servei web i un URL per provar el servei web d'Ally.

    Perquè Ally pugui fer-lo servir, aquest URL ha de ser accessible directament des d'Internet.

    Si funciona correctament, haureu de copiar el testimoni del servei web d'Ally i l'enllaç del servei web i proporcionar-lo a l'assessor tècnic d'Ally a través de l'espai compartit d'IronBox perquè us el configuri i us hi doni accés a través d'un enllaç enviat per correu electrònic. Quan ho hagin configurat tot, us ho comunicaran i us enviaran la clau, el secret, l'URL de llançament, l'URL d'actualitzacions de fitxer i l'identificador de client.

    Si la vostra instància de Moodle utilitza els camps obligatoris personalitzats per als comptes d'usuari, inicieu la sessió amb l'usuari del servei web d'Ally que crea el complement de configuració automàtica per assegurar que els camps personalitzats s'emplenen i es desen.


Configuració del complement de Moodle

L'assessor tècnic d'Ally crearà el client d'Ally amb el testimoni del servei web de Moodle que es genera a la secció anterior i us proporcionarà els detalls per configurar el complement d'Ally.

  1. Inicia la sessió com a administrador de Moodle.
  2. A Administració del lloc, seleccioneu Complements i Eines d'administració. Seleccioneu Configuració d'Ally.
  3. Introduïu els detalls següents
    • Autors de contingut: Els rols d'usuari que són autors de contingut. Han de ser: Gestor, Creador de curs, Docent (els predeterminats).

      Això generalment no s'ha de canviar i es recomana que no ho feu sense consultar-ho abans amb l'assessor tècnic d'Ally.

    • Clau: La clau d'LTI que us ha proporcionat l'assessor tècnic d'Ally.
    • Secret: El secret d'LTI que us ha proporcionat l'assessor tècnic d'Ally.
    • URL de llançament: L'URL de llançament que us ha proporcionat l'assessor tècnic d'Ally.
    • URL d'actualització del fitxer: L'URL d'esdeveniment o actualització del fitxer que us ha proporcionat l'assessor tècnic d'Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • Identificador de client: L'identificador de client que us ha proporcionat l'assessor tècnic d'Ally.
  4. Deseu els canvis.

Informe institucional d'Ally

Quan s'hagi configurat el complement d'Ally, podreu accedir a l'informe institucional d'Ally.

No hi haurà cap dada a l'informe fins que s'hagi dut a terme la sincronització del curs d'Ally i s'hagi generat l'informe inicial.

Per accedir a l'informe institucional d'Ally, aneu a Administració del lloc i seleccioneu Informes. Seleccioneu Accessibilitat.

Més informació sobre l'informe institucional d'Ally


Filtre d'Ally

Quan estigueu preparat per tenir els indicadors de puntuació d'accessibilitat d'Ally i l'opció de descàrrega de la versió accessible alternativa dins de Moodle, haureu d'activar el filtre d'Ally.

Activació del filtre d'Ally

  1. Des de l'opció Administració del lloc seleccioneu Complements i Descripció general dels complements.
  2. Baixeu fins a la secció Filtres de text i activeu el filtre d'Ally.
  3. Moveu el filtre d'Ally a dalt de tot de la llista de filtres.

Accés a la IU de configuració d'Ally

Us proporcionem les instruccions per accedir a la Configuració d’Ally  durant la instal·lació. Si no hi teniu accés, envieu una sol·licitud a Behind the Blackboard.

Configuració d’Ally per als cursos


Configuració dels cursos

Aneu a la pàgina Configuració d’Ally i activeu Ally per a tots els cursos o trieu si activar-lo o no curs per curs. És decisió vostra.

  1. Consulteu quants dels vostres cursos utilitzen Ally.
  2. Activeu o desactiveu Ally per a tots els cursos existents. Decidiu amb antelació si voleu activar-lo també per als cursos futurs.
  3. Cerqueu cursos individuals o filtreu tots els cursos segons si el tenen activat o no i segons el trimestre.
  4. Activeu o desactiveu Ally per a cursos individuals.

Activació o desactivació d’Ally per a un sol curs

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

Configuració d’Ally, cerqueu el curs que voleu actualitzar. Utilitzeu el camp Cerca i els filtres per cercar per títol, identificador i codi del curs.

Seleccioneu Activa o Desactiva a la columna Activat per activar o desactivar Ally.

  • Ally està desactivat: seleccioneu Activa la integració d'IU del curs per activar-lo.
  • Ally està activat: seleccioneu Desactiva la integració d'IU del curs per desactivar-lo.

Activació o desactivació d’Ally per a tots els cursos

Teniu dubtes de si tots els cursos utilitzen Ally o no? Podeu consultar el nombre de cursos que utilitzen Ally actualment a la part superior de la pàgina Configuració d'Ally.

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

Podeu activar o desactivar Ally en qualsevol curs existent des de la pàgina Configuració d'Ally. Seleccioneu Activa/Desactiva tots els cursos i seleccioneu Desactiva o Activa.

Seleccioneu Activa en cursos futurs si voleu que Ally s'activi automàticament a tots els cursos nous.

Si no seleccioneu aquesta opció, els cursos nous no tindran Ally activat. Si voleu utilitzar Ally més endavant, activeu-lo per a cursos individuals.

Després de triar entre activar o desactivar Ally a tots els cursos, heu de confirmar-ho. Seleccioneu Activa o Desactiva, segons què trieu. Seleccioneu Cancel·la si heu canviat d'idea i no voleu modificar res.


Activació d’Ally només per als cursos nous

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

Seleccioneu Activa en cursos futurs si voleu que Ally s'activi automàticament a tots els cursos nous.

Si no seleccioneu aquesta opció, els cursos nous no tindran Ally activat. Si voleu fer servir Ally més endavant, activeu Ally per a cursos individuals.

Configuració dels paràmetres d’ajuda d’Ally


Configuració dels paràmetres d'ajuda a l'usuari d'Ally

Configuració dels missatges d'ajuda personalitzats que es mostren en els modes Formats alternatius i Comentaris de l'instructor. Els missatges d'ajuda personalitzats es poden utilitzar per indicar als estudiants i als instructors quina és la documentació institucional existent o per compartir la informació de contacte, entre altres coses. El contingut d'ajuda personalitzat es pot configurar a la IU de la Configuració d'Ally i utilitza el format Markdown per ajudar a proporcionar un missatge estructurat (i accessible).

Quan no hi ha cap missatge configurat, els enllaços d'Ajuda dirigeixen a aquestes pàgines de l'ajuda de Blackboard:

  1. Aneu a Configuració d'Ally i seleccioneu Configuració d'ajuda.
  2. Trieu l'opció predeterminada o personalitzada, tant de l'ajuda dels Comentaris de l'instructor com dels Formats alternatius.
  3. Si trieu l'opció personalitzada, editeu el missatge personalitzat.

    Feu servir el format Markdown per proporcionar un missatge estructurat (i accessible).

  4. Seleccioneu Desa els canvis.

Configuració de l'ajuda experta

Proporcioneu als vostres instructors i estudiants una manera d'accedir fàcilment al vostre equip d'experts en accessibilitat. Activeu l'ajuda experta per afegir una manera que els usuaris puguin sol·licitar ajuda directament des dels taulers de formats alternatius i comentaris de l'instructor.

Quan es realitza una sol·licitud s'envia un correu electrònic amb els detalls de la sol·licitud i les dades sobre el curs actual, l'element de contingut i l'usuari a l'adreça electrònica que teniu configurada.

  1. Aneu a Configuració d'Ally i seleccioneu Configuració d'ajuda.
  2. Trieu Proporciona ajuda personalitzada, tant per l'ajuda dels Comentaris de l'instructor com pels Formats alternatius.
  3. Seleccioneu Activa ajuda experta.
  4. Escriviu l'adreça electrònica del vostre equip d'experts en accessibilitat.
  5. Seleccioneu Desa els canvis.

L'usuari de l'API d'Ally per la integració amb Blackboard Learn ha de tenir els permisos "Tauler d'administrador (Usuaris) > Usuaris" o "system.user.view" perquè Ally inclogui el nom i l'adreça electrònica de l'estudiant al correu de sol·licitud d'ajuda. L'usuari de l'API d'Ally per la integració amb Moodle ha de tenir el permís "moodle/user:viewalldetails" perquè Ally inclogui el nom i l'adreça electrònica de l'estudiant al correu de sol·licitud d'ajuda.


Configuració de l’informe d’accessibilitat a Blackboard Open LMS

De moment, només està disponible per a Blackboard Open LMS. La disponibilitat de l’informe d'accessibilitat del curs a Moodle requereix una actualització dels connectors de Moodle d’Ally que estarà disponible pròximament; s’enviarà un avís de llançament per separat.