Allyn työkalujen sekä suodatin- ja raporttilisäosien asentaminen

Ally on yhteensopiva useiden Moodlen isännöintivaihtoehtojen ja teemojen kanssa. Ally tukee seuraavia versioita ja teemoja:

Moodle 3.11.x

  • Snap
  • Boost
  • Clean
  • More

Moodle 4.0.x

  • Snap
  • Boost

Moodle 4.1.x

  • Snap
  • Boost

Moodle 4.2.x

  • Snap
  • Boost


Ally-laajennus 4.1 OpenLMS -ympäristöihin
OpenLMS päivittää ympäristönsä 4.1 -versioon tulevien huoltotaukojen yhteydessä. Katso  OpenLMS EDU:n julkaisuaikataulu. 4.1-version Ally-laajennus on käytettävissä huoltotaukojen jälkeen, ja sen pitäisi olla saatavilla  OpenLMS-laajennusmatriisissa.


Ally toimii 3.10.x-versiota vanhempien Moodle-versioiden kanssa, mutta korjauksia ei tueta. Suosittelemme päivittämään tällaiset Moodle-versiot uudempiin. Ohjeet ovat saatavilla Moodlen versiotuesta. 

Huomautus: Ally ei tue muita teemoja ja versioita, joita ei luetella tässä.

Jos haluat määrittää Allyn ja Moodlen itse isännöidyssä ympäristössä, määritä seuraavat lisäosat:

  • Ally-hallintatyökalut
  • Ally-suodatin
  • Ally-raportin LTI

OpenLMS:n käyttöönottamat ympäristöt on jo integroitu Allyyn. 

Määritysohjeet

  1. Lataa tai kloonaa Allyn hallintatyökalun tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.

      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkiksi Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        3.11.6-julkaisun pitäisi toimia Moodle 3.11 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista

      3. Lataa tiedostopankki valitsemalla "klooni tai download > Download ZIP
    2. Git-tiedostopankin kloonaaminen

      1. Siirry tools-kansioon.

        cd [moodle location]/admin/tool

      2. Tiedostopankin kloonaaminen

        • SSH:n avulla

          git clone [email protected]:anthology-ally/moodle-tool_ally ally

        • HTTP:n avulla

          git clone https://github.com/anthology-ally/moodle-tool_ally.git ally

      3. Lataa vastaava haara. Esimerkiksi Moodle 3.11:lle se on MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Kuittaamalla haaran ulos voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain kuitata ulos vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  2. Lataa tai kloonaa Ally-suodattimen tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.

      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkiksi Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        3.11.6-julkaisun pitäisi toimia Moodle 3.11 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lue lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista.

      3. Lataa tiedostopankki valitsemalla "Kloonaa tai lataa > Lataa ZIP"
    2. Git-tiedostopankin kloonaaminen

      1. Siirry filters-kansioon.

        cd [moodle location]/filter

      2. Tiedostopankin kloonaaminen

        • SSH:n avulla

          git clone [email protected]:anthology-ally/moodle-filter_ally ally

        • HTTP:n avulla

          git clone https://github.com/anthology-ally/moodle-filter_ally.git ally

      3. Lataa vastaava haara. Esimerkiksi Moodle 3.11:lle se on MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Lataammalla haaran voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain ladata vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  3. Lataa tai kloonaa Ally-raportin LTI-työkalun tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.

      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkiksi Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        3.11.6-julkaisun pitäisi toimia Moodle 3.11 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lue lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista.

      3. Lataa tiedostopankki valitsemalla "Kloonaa tai lataa > Lataa ZIP"
    2. Git-tiedostopankin kloonaaminen

      1. Siirry reports-kansioon.

        cd [moodle location]/report

      2. Tiedostopankin kloonaaminen

        • SSH:n avulla

          git clone [email protected]:anthology-ally/moodle-report_allylti ally

        • HTTP:n avulla

          git clone https://github.com/anthology-ally/moodle-report_allylti.git ally

      3. Lataa vastaava haara. Esimerkiksi Moodle 3.11:lle se on MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Lataammalla haaran voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain ladata vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  4. Tarkista kansiorakenne.

    Hallintatyökalun hakemiston nimen pitäisi olla ally. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/admin/tool/ally

    Suodatinhakemiston nimen pitäisi olla ally. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/filter/ally

    Raporttihakemiston nimen pitäisi olla allylti. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/report/allylti

  5. Varmista, että kukin kansio ja sen sisältö ovat luettavissa verkkopalvelimellasi.
  6. Kirjaudu Moodle-sivustoosi ylläpitäjänä ja avaa ylläpitosivu. Tämän pitäisi tarkistaa uusien lisäosien saatavuus ja tarjota sinulle mahdollisuus päivittää Moodle-tietokanta nyt napsauttamalla Upgrade Moodle database now -painiketta. Asenna lisäosat napsauttamalla tätä painiketta.
  7. Kun lisäosat on asennettu, valitse Järjestelmän ylläpito &gt Lisäosat > Ylläpitäjän työkalut > Ally.

  8. Valitse Määritä Ally-verkkopalvelu automaattisesti.

    Seuraavassa näytössä näet verkkopalvelun tunnuksen ja URL-osoitteen, joilla voit testata Ally-verkkopalvelua.

    URL-osoitteen täytyy olla suoraan käytettävissä Internetissä, jotta Ally voi käyttää sitä.

    Jos testi onnistuu, sinun täytyy kopioida Ally-verkkopalvelun tunnus ja linkki sekä toimittaa ne tekniselle Ally-konsultillesi tai tuki-insinöörille. Tekninen konsultti ottaa sinuun yhteyttä, kun hän on määrittänyt kaiken. Hän toimittaa sinulle avaimen, salaisuuden, URL-käynnistysosoitteen, tiedostopäivitysten URL-osoitteen ja asiakastunnuksen.

    Jos Moodle-esiintymäsi käyttää mukautettuja pakollisia kenttiä käyttäjätileille, Kirjaudu käyttäjänä -toiminnolla käytetty Allyn verkkopalvelun käyttäjä luodaan lisäosan automaattisen määrityksen yhteydessä, jotta nämä mukautetut kentät täytetään ja tallennetaan.

Moodle-lisäosan määritys

Tekninen Ally-konsultti luo Ally-asiakkaan edellisessä osiossa luodun Moodle-verkkopalvelutunnuksen avulla ja toimittaa sinulle tiedot Ally-lisäosan määrittämiseen.

  1. Kirjaudu sisään Moodle-ylläpitäjänä.
  2. Valitse Sivuston hallinta > Lisäosat > Ylläpitäjän työkalut. Valitse Ally-määritykset.
  3. Anna seuraavat tiedot:

    • Content Authors: Nämä ovat sisällöntuottajien käyttämät käyttäjäroolit. Roolin täytyy olla Hallinnoija, Kurssinluoja tai Opettaja (oletukset).

      Näitä ei tulisi yleensä muuttaa. Älä muuta näitä konsultoimatta ensin Allyn teknistä konsulttia.

    • Key: tämä on teknisen Ally-konsultin toimittama avain.
    • Secret: tämä on teknisen Ally-konsultin toimittama LTI-salaisuus.
    • Launch URL: tämä on teknisen Ally-konsultin toimittama LTI-käynnistysosoite.
    • File Update URL: tämä on teknisen Ally-konsultin toimittama tiedostojen päivittämisen ja tapahtumien URL-osoite. https://[AllyEnvironment].ally.ac/api/v1/events
    • Client ID: tämä on teknisen Ally-konsultin toimittama asiakastunnus.
    • Log range: tämän arvon tulisi olla Light.
  4. Tallenna muutokset.

Allyn oppilaitosraportti

Kun Ally-lisäosa on määritetty, voit käyttää Allyn oppilaitosraporttia.

Raportissa ei ole mitään tietoja, ennen kuin Ally-kurssit on synkronoitu ja ensimmäinen raportti luotu.

Pääset Allyn oppilaitosraporttiin valitsemalla Sivuston hallinta > Raportit. Valitse Helppokäyttöisyys.

Lisätietoja Allyn oppilaitosraportista

Ally-suodatin

Kun olet valmis tarjoamaan Allyn helppokäyttöisyysarvojen ilmaisimet ja vaihtoehtoisten versioiden lataamismahdollisuuden Moodlessa, sinun täytyy ottaa Ally-suodatin käyttöön.

Ally-suodattimen käyttöönotto

  1. Valitse Sivuston hallinta > Lisäosat > Moduulien yhteenveto.
  2. Siirry alas tekstisuodattimien osioon ja ota Ally-suodatin käyttöön.
  3. Siirrä Ally-suodatin suodatinluettelon ensimmäiseksi.

Ally-määrityskäyttöliittymän avaaminen

Tarjoamme sinulle ohjeet Ally-määritysten käyttöön käyttöönoton yhteydessä. Jos sinulla ei ole käyttöoikeutta, lähetä tukipyyntö Behind the Blackboard -palvelussa.

Allyn kurssien määrittäminen

Kurssien määrittäminen

Siirry Ally-määritysten sivulle ja ota Ally käyttöön kaikilla kursseilla tai päätä käytöstä kurssikohtaisesti. Valinta on sinun.

  1. Voit tarkistaa Allya käyttävien kurssien määrän.
  2. Voit ottaa Allyn käyttöön tai poistaa sen käytöstä kaikissa nykyisissä kursseissa. Voit myös päättää etukäteen, otetaanko se käyttöön kaikissa tulevissa kursseissa.
  3. Voit hakea yksittäisiä kursseja tai suodattaa kaikki kurssit käytön ja lukukauden mukaan
  4. Voit ottaa Allyn käyttöön yksittäisellä kurssilla tai poistaa sen käytöstä yksittäisellä kurssilla.

Allyn ottaminen käyttöön / poistaminen käytöstä yksittäisellä kurssilla

Kun Ally on käytössä, Allyn tarjoamat helppokäyttöisyysarvot, ohjaajan palautteet ja vaihtoehtoiset muodot ovat ohjaajien ja opiskelijoiden käytettävissä.

Institutionaalinen raportti on saatavilla kaikille kursseille. Sillä ei ole väliä, onko Ally käytössä kurssilla vai ei. Kurssi näytetään institutionaalisessa raportissa.

Etsi Ally-määrityksistä kurssi, jonka haluat päivittää. Käytä hakukenttää ja suodattimia. Voit käyttää haussa kurssin otsikkoa, kurssin tunnusta ja kurssikoodia.

Määritä, otetaanko Ally käyttöön vai ei valitsemalla Ota käyttöön tai Poista käytöstä Käytössä-sarakkeesta.

  • Ally ei ole käytössä: Ota
    käyttöön valitsemalla Ota käyttöön kurssin käyttöliittymäintegrointi.
  • Ally on käytössä: Poista
    käytöstä valitsemalla Poista kurssin käyttöliittymäintegrointi käytöstä.

Allyn ottaminen käyttöön tai poistaminen käytöstä kaikilla kursseilla

Etkö tiedä, käytetäänkö Allya kaikissa kursseissa? Näet Allyn määritys -sivun yläreunasta, kuinka monella kurssilla Ally on tällä hetkellä käytössä.

Kun Ally on käytössä, Allyn tarjoamat helppokäyttöisyysarvot, ohjaajan palautteet ja vaihtoehtoiset muodot ovat ohjaajien ja opiskelijoiden käytettävissä.

Institutionaalinen raportti on saatavilla kaikille kursseille. Sillä ei ole väliä, onko Ally käytössä kurssilla vai ei. Kurssi näytetään institutionaalisessa raportissa.

Voit ottaa Allyn käyttöön tai poistaa sen käytöstä jokaisessa nykyisessä kurssissa Allyn määritys -sivun kautta. Valitse Poista käytöstä / ota käyttöön kaikki kurssit ja valitse sitten Poista käytöstä tai Ota käyttöön.

Jos haluat, että Ally otetaan automaattisesti käyttöön kaikissa uusissa kursseissa, valitse Ota käyttöön tulevissa kursseissa.

Jos et valitse tätä vaihtoehtoa, Ally ei ole käytössä uusissa kursseissa. Jos haluat ottaa Allyn käyttöön myöhemmin, ota Ally käyttöön yksittäisissä kursseissa.

Kun olet valinnut käytöstä poistamisen tai käyttöön ottamisen kaikissa kursseissa, valinta on vahvistettava. Valitse Ota käyttöön tai Poista käytöstä valintasi mukaan. Jos muutit mieltäsi etkä halua muuttaa mitään, valitse Peruuta.

Allyn ottaminen käyttöön vain uusilla kursseilla

Kun Ally on käytössä, Allyn tarjoamat helppokäyttöisyysarvot, ohjaajan palautteet ja vaihtoehtoiset muodot ovat ohjaajien ja opiskelijoiden käytettävissä.

Institutionaalinen raportti on saatavilla kaikille kursseille. Sillä ei ole väliä, onko Ally käytössä kurssilla vai ei. Kurssi näytetään institutionaalisessa raportissa.

Jos haluat, että Ally otetaan automaattisesti käyttöön kaikissa uusissa kursseissa, valitse Ota käyttöön tulevissa kursseissa.

Jos et valitse tätä vaihtoehtoa, Ally ei ole käytössä uusissa kursseissa. Jos haluat ottaa Allyn käyttöön myöhemmin, ota Ally käyttöön yksittäisissä kursseissa.

Allyn ohjeasetusten määrittäminen

Allyn käyttäjäohjeasetusten määrittäminen

Määritä mukautetut ohjeviestit, jotka näytetään vaihtoehtoisten muotojen ja ohjaajan palautteen ikkunoissa. Mukautetuilla ohjeviesteillä voit ohjata opiskelijoita ja ohjaajia oppilaitoksen olemassa oleviin käyttöohjeisiin, jakaa yhteystietoja ja niin edelleen. Jos mukautettuja viestejä ei ole määritetty, Ohje-linkit vievät seuraavilla sivuille Blackboard-ohjeissa:

  • Vaihtoehtoiset muodot: tällä sivulla kerrotaan, miten ja milloin erilaisia vaihtoehtoisia muotoja voi käyttää.
  • Ohjaajien ohjeet: täältä ohjaajat voivat lukea kaiken tarvittavan Allyn käytöstä kursseillaan.

Voit määrittää mukautetun ohjesisällön Ally-määrityksissä. Siinä käytetään Markdown-muotoa, joka mahdollistaa jäsennetyt ja helppokäyttöiset viestit.

  1. Siirry Ally-määrityksiin ja valitse Ohjeasetukset.
  2. Valitse ohjaajien palautteen ja vaihtoehtoisten muotojen ohjeille joko oletusohjeet tai mukautetut ohjeet.
  3. Jos valitset mukautetut ohjeet, muokkaa mukautettua viestiä.

    Käytä Markdown-muotoa, joka mahdollistaa jäsennetyt (ja helppokäyttöiset) viestit.

  4. Valitse Tallenna muutokset.

Asiantuntijaohjeen määrittäminen

Voit mahdollistaa ohjaajille ja opiskelijoille helppokäyttöisyysasiantuntijoiden tiimin avun helpon hyödyntämisen. Ottamalla käyttöön asiantuntijaohjeen voit lisätä käyttäjille menetelmän, jolla he voivat pyytää apua suoraan vaihtoehtoisten muotojen paneelissa ja ohjaajan palautepaneelissa.

Kun käyttäjä tekee ohjepyynnön, määrittämääsi sähköpostiosoitteeseen lähetetään viesti, joka sisältää käynnissä olevaa kurssia, sisältökohdetta ja käyttäjää koskevat tiedot.

  1. Siirry Ally-määrityksiin ja valitse Ohjeasetukset.
  2. Valitse sekä ohjaajien palautteen ohjeen että vaihtoehtoisten muotojen ohjeen kohdalla Anna mukautettu ohje.
  3. Valitse Ota käyttöön asiantuntijaohje.
  4. Kirjoita helppokäyttöisyysasiantuntijoiden tiimin sähköpostiosoite.
  5. Valitse Tallenna muutokset.

Blackboard Learn -integroinnissa Allyn ohjelmointirajapinnan käyttäjälle tulee antaa käyttöoikeus "Pääkäyttäjän liittymä (Käyttäjät) > Käyttäjät" tai "system.user.view", jotta Ally voi sisällyttää opiskelijan nimen ja sähköpostiosoitteen ohjepyynnön sähköpostiviestiin. Moodle-integroinnissa Allyn ohjelmointirajapinnan käyttäjälle tulee antaa käyttöoikeus ”moodle/user:viewalldetails”, jotta Ally voi sisällyttää opiskelijan nimen ja sähköpostiosoitteen ohjepyynnön sähköpostiviestiin.

Ally-toimintojen räätälöinti

Ally-toimintojen räätälöinti

Voit ottaa Allyn toimintoja käyttöön ja poistaa niitä käytöstä oppilaitoksesi tarpeiden mukaisesti.

Valitse Ally-määrityksissä, mitä toimintoja haluat käyttöön.

  1. Siirry Ally-määrityksiin ja valitse Toiminnot.
  2. Etsi toiminto, jonka haluat ottaa käyttöön tai poistaa käytöstä, ja valitse se.
    • Vaihtoehtoisten kuvausten generoiminen kuville tekoälyn avulla: Jos kuvista puuttuu vaihtoehtoinen teksti, ohjaajat voivat luoda ehdotuksia tekstiksi vaivattomasti AI Alt Text Assistant -toiminnon avulla. Ottamalla tämän ominaisuuden käyttöön hyväksyt käyttöehtomme. Lisätietoja tämän ominaisuuden riskeistä ja rajoituksista on avoimuusilmoituksessamme.
    • Syventävän lukuohjelman vaihtoehtoinen muoto: Opiskelijat voivat parantaa lukukokemustaan tämän verkko-ominaisuuden avulla.
    • Käännetyn version vaihtoehtoinen muoto: Oppilaat voivat ladata alkuperäisen tiedoston käännetyn vaihtoehtoisen muodon.
    • BeeLine Readerin vaihtoehtoinen muoto: Oppilaat voivat ladata BeeLine Readerin vaihtoehtoisen muodon.
    • Kaikkien kurssien arvon ilmaisimet ylläpitäjille: Ylläpitäjät näkevät kaikkien kurssien Allyn helppokäyttöisyysarvon ilmaisimet, myös kursseista, joilta Ally on poistettu käytöstä Ally-määrityskäyttöliittymän kautta. Näin he voivat korjata ongelmia ilman, että heidän tarvitsee sallia Allyn käyttö kurssilla.

    • Tämä merkintätoiminto on käytettävissä D2L Brightspacessa, Instructure Canvasissa, Moodlessa ja Schoologyssa.

    • Avaa oppilaitosraportin ohjaajan palaute: Anna ylläpitäjille, vammaispalveluille ja koulutussuunnittelijoille ohjaajan palautteen käyttöoikeus.
    • WYSIWYG-sisällön ohjaajan palaute (Rich Text -editorin sisällöstä): Kouluttajilla ja ylläpitäjillä on LMS WYSIWYG -editorissa luodun sisältöpalautteen käyttöoikeus. Merkitse "Ota käyttöön myös LMS:n oma tarkistus" -valintaruutu, jos haluat ottaa käyttöön molemmat helppokäyttöisyyden tarkistukset. 

    • Lisätietoja WYSIWYG-helppokäyttöisyydestä kouluttajille

      Tämä merkintätoiminto poistaa käytöstä ohjaajan palautetteen tai HTML-tiedostojen pikakorjaukset, jotka on ladattu D2L Brightspacesta tai luotu sillä.

    • Ally-tietojen integrointi Impact by Instructureen (aiemmin EasySoft): Oppilaitokset, joilla on Impact by Instructure -lisenssi, voivat sallia tarkemman vuorovaikutusten valvonnan vaihtoehtoisten muotojen mallissa, ohjaajan palautteessa ja kurssin käytettävyysraportissa. Oppilaitokset voivat käyttää näitä tietoja osallistumisraporteissa ja kampanjoissa Impact by Instructuressa. Impact by Instructure -integrointi on oletusarvoisesti poissa käytöstä.

      Tämä integrointi vaatii Impact by Instructure -lisenssin.

  3. Jos haluat ottaa sen käyttöön, valitse Ota käyttöön. Jos haluat poistaa sen käytöstä, valitse Poista käytöstä.