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

Lisäosien 3.3-versiot ovat yhteensopivia Moodle 3.2:n kanssa

  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. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -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 Clone or 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]:blackboard-open-source/moodle-tool_ally ally

        • HTTP:n avulla

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

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_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. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -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 Clone or download > Download ZIP.
    2. Git-tiedostopankin kloonaaminen
      1. Siirry filters-kansioon.

        cd [moodle location]/filter

      2. Tiedostopankin kloonaaminen
        • SSH:n avulla

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

        • HTTP:n avulla

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

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_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

  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. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -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 Clone or download > Download ZIP.
    2. Git-tiedostopankin kloonaaminen
      1. Siirry reports-kansioon.

        cd [moodle location]/report

      2. Tiedostopankin kloonaaminen
        • SSH:n avulla

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

        • HTTP:n avulla

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

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_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

  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 olet asentanut lisäosat, valitse Järjestelmän ylläpito > 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 IronBox-tiedostonjakopalvelun avulla, jotta hän voi määrittää käytön ja tarjota sinulla käyttömahdollisuuden sähköpostilinkin avulla. 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.
  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 et voi käyttää niitä, tee 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.

Valitse Ota käyttöön tulevissa kursseissa, jos haluat, että Ally otetaan automaattisesti käyttöön kaikissa uusissa 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. 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.

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


Kurssin helppokäyttöisyysraportin määrittäminen Blackboard Open LMS:ssä

Tämä ominaisuus on tällä hetkellä käytettävissä vain Blackboard Open LMS:ssä. Kurssin helppokäyttöisyysraportin käytettävyys Moodlessa edellyttää Ally Moodle -lisäosien päivittämistä. Tämä päivitys julkaistaan lähiviikkoina, ja siitä lähetetään erillinen julkaisuilmoitus.