Wise Ed · Wise Technologies · English
Wise Ed in Moodle - navodila za skrbnika
Za skrbnika šolskega Moodla. Dve povezavi, vsaka zase in vsaka neobvezna: spletne storitve usklajujejo predmete, vpise in skupine v Moodlu z Wise Ed in preberejo redovalnico nazaj; LTI 1.3 odpre Wise Ed znotraj predmeta v Moodlu in z LTI Advantage izmenjuje ocene z redovalnico Moodla. Približno pol ure, z odprtim skrbništvom Moodla in zaslonom Nastavitve LMS v Wise Ed drug ob drugem.
Oznake Moodla so navedene v angleščini, kot jih kaže angleški vmesnik Moodla (v slovenskem vmesniku je Site administration Skrbništvo strani). Besede Wise Ed so navedene natanko tako, kot jih kažejo njegovi zasloni.
- Začetek prijave (login)
https://wise-tt.com/web/{school}/lti/login- Zagon (tool URL)
https://wise-tt.com/web/{school}/lti/launch- Naslov preusmeritve (Redirect URI)
https://wise-tt.com/web/{school}/lti/launch- Globoko povezovanje (izbira vsebine)
https://wise-tt.com/web/{school}/lti/launch- Javni ključi (JWKS)
https://wise-tt.com/web/{school}/lti/jwks
Odprto brez naslovov šole: {school} je šifra šole, ista kot v njenem naslovu Wise Timetable. Natančne naslove kaže tudi zaslon Nastavitve LMS v Wise Ed.
Preden začnete
- Moodle 3.2 ali novejši za spletne storitve (del A); Moodle 3.7 ali novejši za LTI 1.3 s storitvami ocen (del B). Priporočen je Moodle 4.x. Spodnje poti v meniju so iz Moodla 4.x; Moodle 3.x ima iste strani, včasih raven višje.
- Pravice skrbnika strani v Moodlu.
- Oseba iz referata z zasloni Wise Ed Nastavitve LMS, Moodle in Ocene iz Moodla - v Wise Ed vpiše, kar ji daste (žeton, podatke platforme), in požene predoglede.
- Moodle osebe povezuje po e-naslovu: študentov naslov v Moodlu mora biti šolski naslov, ki ga ima Wise Ed. Wise Ed nikoli ne ugiba - koga ne more povezati, imenuje na svojem zaslonu.
Del A - spletne storitve (usklajevanje z Moodlom)
Potrebno za: predmete za vsak predmet in leto, vpis študentov in učiteljev, skupine urnika kot skupine v Moodlu, branje redovalnice Moodla nazaj. Ni potrebno, če šola želi le Wise Ed znotraj predmetov v Moodlu (del B).
A1 - Vklopite spletne storitve
Site administration > General > Advanced features
Označite Enable web services in shranite.
A2 - Vklopite protokol REST
Site administration > Server > Web services > Manage protocols
Vklopite REST protocol (ikona očesa). Wise Ed uporablja REST in nič drugega.
A3 - Uporabnik za Wise Ed
Site administration > Users > Accounts > Add a new user
- Uporabniško ime:
wiseed(ime je poljubno; ta navodila ga imenujejo tako). - Način preverjanja (Authentication method): Web services authentication - prek spletne strani se ne more prijaviti. Če ga ni na izbiro, ga najprej vklopite (Site administration > Plugins > Authentication > Manage authentication) ali uporabite Manual accounts z dolgim naključnim geslom, ki ga nihče ne hrani.
- E-naslov: naslov šolske informatike (ne študenta ali učitelja - Wise Ed osebe povezuje po e-naslovu).
- Tega uporabnika ne vpišite v noben predmet.
A4 - Vloga z natanko tem, kar Wise Ed potrebuje
Site administration > Users > Permissions > Define roles > Add a new role
Use role archetype: No role. Kratko ime wiseedsync, polno ime Wise Ed sync, Context types where this role may be assigned: System. Te zmožnosti (capabilities) nastavite na Allow (seznam iščite po imenu zmožnosti):
| Zmožnost | Zakaj |
|---|---|
webservice/rest:use | da sploh sme uporabljati protokol REST |
moodle/category:manage | kategorija za vsak program in letnik ter vpogled v njihove številke ID |
moodle/category:viewhiddencategories | da najde kategorije, ki jih je naredil Wise Ed, tudi skrite |
moodle/course:create | predmet za vsak predmet in leto |
moodle/course:visibility | del izdelave predmeta (zahteva jo Moodlova definicija storitve) |
moodle/course:view | vpogled v vse predmete brez vpisa vanje |
moodle/course:viewhiddencourses | da najde predmete, ki jih je naredil Wise Ed, tudi skrite |
moodle/course:update | vpogled v številke ID predmetov, po katerih drugi zagon prepozna svoje predmete |
moodle/course:viewparticipants | branje, kdo je vpisan v predmet |
moodle/user:viewdetails, moodle/user:viewhiddendetails, moodle/course:useremail, moodle/user:update | iskanje računov po e-naslovu in branje vpisov (Moodlov lasten seznam za te funkcije) |
moodle/site:accessallgroups | branje vpisov vseh skupin |
enrol/manual:enrol | vpis študentov in učiteljev |
moodle/role:assign | dodelitev njihove vloge v predmetu (skupaj z A5) |
moodle/course:managegroups | izdelava skupin urnika in dodajanje študentov vanje |
gradereport/user:view, moodle/grade:viewall | branje redovalnice vseh študentov predmeta |
enrol/manual:unenrol | le če referat vklopi Odstrani, kdor ne sodi več tja (odstranijo se vedno le vpisi, ki jih je opravil Wise Ed) |
moodle/user:create | le če referat vklopi Ustvarjaj račune v Moodlu |
A5 - Vloga sme dodeljevati vloge v predmetu
Site administration > Users > Permissions > Define roles > Allow role assignments
V vrstici Wise Ed sync označite Student, Teacher in Non-editing teacher ter shranite. Brez tega Moodle odgovori wsusercannotassign. Če šola uporablja druge številke vlog kot Moodlove običajne 5 / 3 / 4, jih referat vpiše v nastavitve LMS v Wise Ed.
A6 - Uporabniku dodelite vlogo
Site administration > Users > Permissions > Assign system roles > Wise Ed sync
Dodajte uporabnika wiseed.
A7 - Storitev in njenih 15 funkcij
Site administration > Server > Web services > External services > Add
Ime Wise Ed, kratko ime wiseed, označite Enabled in Authorised users only, Add service. Nato Functions > Add functions in dodajte vse te - vse so standardne funkcije jedra Moodla:
| Funkcija | Za |
|---|---|
core_webservice_get_site_info | preverjanje povezave |
core_course_get_categories, core_course_create_categories | kategorije |
core_course_get_courses_by_field, core_course_create_courses | predmete |
core_user_get_users_by_field, core_user_create_users | račune (drugo le z Ustvarjaj račune v Moodlu) |
core_enrol_get_enrolled_users, enrol_manual_enrol_users, enrol_manual_unenrol_users | vpise |
core_group_get_course_groups, core_group_create_groups, core_group_get_group_members, core_group_add_group_members | skupine |
gradereport_user_get_grade_items | branje redovalnice nazaj |
Nato pri storitvi Authorised users: dodajte wiseed.
Predmeti potrebujejo način vpisa Manual enrolments, ki ga Moodle novim predmetom doda sam (Site administration > Plugins > Enrolments > Manage enrol plugins: Manual enrolments vklopljen; v njegovih nastavitvah označeno Add instance to new courses).
A8 - Žeton
Site administration > Server > Web services > Manage tokens > Create token
Uporabnik wiseed, storitev Wise Ed. Valid until in IP restriction lahko ostaneta prazna (če želite omejitev, naslov strežnika vprašajte pri Wise Technologies). Shranite in prepišite žeton: Moodle ga pokaže enkrat.
A9 - V Wise Ed
Referat odpre Nastavitve LMS > Moodle, vpiše Naslov Moodla (https://...) in Žeton spletne storitve ter shrani. Wise Ed žeton hrani zapečaten; nikoli več ni prikazan. Na zaslonu Moodle mora Preveri povezavo odgovoriti "Povezano s ... Dovoljene so vse funkcije, ki jih Wise Ed potrebuje." Če katera funkcija manjka, je imenovana - dodajte jo v A7.
Del B - orodje LTI 1.3
Potrebno za: Wise Ed znotraj predmeta v Moodlu (urnik predmeta, izpitni roki in prijava, ocene študenta, njegov napredek) in s storitvami ocen za točke in končne ocene Wise Ed v redovalnici Moodla ter ocene dejavnosti iz Moodla nazaj v Wise Ed - brez uporabnika spletnih storitev.
B1 - Novo orodje
Site administration > Plugins > Activity modules > External tool > Manage tools > configure a tool manually
B2 - Nastavitve orodja
| Polje v Moodlu | Vrednost |
|---|---|
| Tool name | Wise Ed |
| Tool URL | https://wise-tt.com/web/{school}/lti/launch |
| LTI version | LTI 1.3 |
| Client ID | Moodle ga izpolni ob shranjevanju - prepišete ga v B5 |
| Public key type | Keyset URL |
| Public keyset | https://wise-tt.com/web/{school}/lti/jwks |
| Initiate login URL | https://wise-tt.com/web/{school}/lti/login |
| Redirection URI(s) | https://wise-tt.com/web/{school}/lti/launch |
| Custom parameters | pustite prazno - vsaka povezava, ki jo naredi Wise Ed, nosi svoje |
| Tool configuration usage | Show in activity chooser and as a preconfigured tool |
| Default launch container | Embed, without blocks (ali New window) |
| Supports Deep Linking (Content-Item Message) | označeno |
| Content Selection URL | https://wise-tt.com/web/{school}/lti/launch |
B3 - Services: storitve ocen, ki jih označite
| Storitev | Izbira |
|---|---|
| IMS LTI Assignment and Grade Services | Use this service for grade sync and column management - Wise Ed naredi svoje stolpce (enega za vsak del ocenjevanja, enega za končno oceno) in bere stolpce predmeta |
| IMS LTI Names and Role Provisioning | Use this service to retrieve members' information as per privacy settings - Wise Ed izve, kdo so študenti predmeta, zato lahko pošlje točke tudi študentu, ki Wise Ed še ni odprl |
| Tool Settings | Do not use this service |
B4 - Privacy (zasebnost)
| Polje v Moodlu | Vrednost |
|---|---|
| Share launcher's name with tool | Always |
| Share launcher's email with tool | Always - Wise Ed študente in učitelje prepozna po e-naslovu |
| Accept grades from the tool | Always |
| Force SSL | označeno |
Save changes.
B5 - Kaj vam pokaže Moodle
Na kartici orodja pritisnite View configuration details (ikona seznama). Moodle pokaže šest vrednosti; potrebujete jih v B6: Platform ID, Client ID, Deployment ID, Public keyset URL, Access token URL, Authentication request URL.
B6 - Platforma v Wise Ed
Referat odpre Nastavitve LMS > Znotraj LMS (LTI 1.3) > Nova platforma:
| Polje v Wise Ed | Iz Moodla (B5) |
|---|---|
| Ime | kako jo imenuje referat, npr. Moodle fakultete |
| Izdajatelj | Platform ID |
| ID odjemalca | Client ID |
| ID-ji namestitev | Deployment ID |
| Naslov avtorizacije | Authentication request URL |
| Naslov žetonov | Access token URL |
| Naslov nabora ključev | Public keyset URL |
| Ocene prek LTI | Ročno za začetek (referat pritisne Pošlji); Vsako noč, ko mu referat zaupa |
| Pošlji | objavljene točke delov, potrjene končne ocene (eno ali oboje) |
| Ime stolpca končne ocene | kot ga bodo učitelji in študenti videli v redovalnici Moodla |
| Občinstvo žetona | za Moodle pustite prazno |
Dodaj platformo. Vklop ocen Wise Ed najprej vpraša; Vseeno shrani potrdi.
B7 - Wise Ed v predmetu
V predmetu: Edit mode > Add an activity or resource > Wise Ed > Select content. Odpre se Wise Ed in učitelj izbere, kaj prikaže - Urnik predmeta, Izpitni roki in prijava, Ocene študenta pri tem predmetu, Napredek študenta ali drug del, ki ga šola uporablja - ter pritisne Dodaj k predmetu. Shranite. Vsaka izbira je svoja povezava; predmet jih ima lahko več.
B8 - Prvo odprtje
Izmenjava ocen s predmetom se začne, ko nekdo iz njega odpre Wise Ed: ta zagon Wise Ed sporoči naslova redovalnice in seznama članov predmeta. Predmet se nato pokaže na zaslonu Ocene iz Moodla pod Predmeti v LMS, ki so odprli Wise Ed, s predmetom, ki ga je Wise Ed našel zanj (iz povezave, iz predmeta, ki ga je naredil Wise Ed, ali iz šifre predmeta kot kratkega imena). Referat tam po potrebi popravi predmet ali leto.
Del C - preizkus s predogledom
Branje predogleda v Moodle ničesar ne zapiše, na nobeni strani.
- Usklajevanje. Na zaslonu Moodle v Wise Ed: Preveri povezavo, nato preberite predogled: vsako kategorijo, predmet, vpis in skupino, ki bi jo naredil, z besedami, ter kaj ni mogoče izvesti in zakaj. Za prvi zagon referat v nastavitvah Samo ti programi omeji na en program. Uveljavi spremembe zapiše natanko predogled; drugo uveljavljanje nima več česa narediti.
- Ocene v Moodle. Na zaslonu Ocene iz Moodla: Predogled pošiljanja našteje stolpce, ki bi jih naredil v vsakem predmetu, točke in končne ocene, ki bi jih poslal, ter česa ne pošlje in zakaj. Pošlji pošlje natanko to. V Moodlu: Course > Grades > Grader report pokaže stolpce in točke. Drugo pošiljanje ne pošlje ničesar.
- Ocene iz Moodla. Preberi stolpce iz LMS prenese lastne dejavnosti predmeta (naloge, kvize) v seznam za povezovanje, označene s prek LTI. Referat eno poveže z delom ocenjevanja predmeta in pritisne Prenesi v Wise Ed; pred tem nič ne pride v noben zapis.
- Klici. Klici v LMS na istem zaslonu našteje vsak klic Wise Ed - kaj, kdaj, odgovor Moodla. Samo napake ga zoži.
Odpravljanje težav, po besedah zaslona
Usklajevanje (spletne storitve)
Wise Ed posreduje Moodlovo lastno kodo napake (Moodle's own code is "...").
| Koda Moodla | Kaj pomeni | Kaj storiti |
|---|---|---|
invalidtoken | žeton je napačen, potekel ali izbrisan | znova A8; referat vpiše nov žeton |
accessexception | funkcije ni v storitvi ali uporabnik ni njen pooblaščeni uporabnik ali vloga nima webservice/rest:use | A7 (funkcije, pooblaščeni uporabniki), A4 |
wsusercannotassign | vloga ne sme dodeljevati vlog Student / Teacher / Non-editing teacher | A5 |
nopermissions, requireloginerror | manjka zmožnost iz A4 | A4, A6 |
shortnametaken, categoryidnumbertaken | predmet ali kategorija s tem kratkim imenom / številko ID že obstaja (narejen ročno) | običajno nič: Wise Ed predmet, ki ga najde po kratkem imenu, poveže; če se ponavlja, obvestite Wise Technologies |
invalidrecord | predmet ali uporabnik, ki ga je Wise Ed poznal, je bil v Moodlu izbrisan | naslednji predogled ga naredi znova |
http_403, http_404, not_json | naslov ni naslov Moodla ali je REST izklopljen | naslov Moodla v Wise Ed; A2 |
unreachable | Moodle ni dosegljiv (požarni zid, Moodle le prek VPN) | Moodle mora biti dosegljiv iz interneta prek https |
Odpiranje Wise Ed iz predmeta (LTI 1.3)
| Wise Ed pravi | Kaj pomeni | Kaj storiti |
|---|---|---|
| Ta LMS v Wise Ed te šole še ni registriran. | Izdajatelj v Wise Ed ni Platform ID Moodla (ali se ID odjemalca razlikuje) | B5 / B6: prepišite ju znova, natančno |
| Zahteve LMS ni bilo mogoče preveriti. | preverjanje zagona ni uspelo: ključ, ID odjemalca, ID namestitve, ura na strežniku Moodla ali dvakrat odprta stran | B6 Naslov nabora ključev, ID odjemalca, ID-ji namestitev; ure strežnikov; Wise Ed znova odprite iz predmeta |
| Wise Ed trenutno ne more odgovoriti. Poskusite čez minuto. | pogosto: Wise Ed ni mogel prebrati Public keyset URL Moodla za preverjanje zagona | B6 Naslov nabora ključev; če ostane, obvestite Wise Technologies |
| Ta stran Wise Ed je potekla. | stran v predmetu je bila odprta več kot uro | odprite jo znova iz predmeta |
| Wise Ed vas po e-naslovu ni prepoznal. | Moodle ni poslal e-naslova ali to ni naslov, ki ga ima Wise Ed | B4 Share launcher's email Always; e-naslov osebe v Moodlu |
| Ta predmet v LMS ni povezan s predmetom v Wise Ed. | Wise Ed za predmet v Moodlu ni našel predmeta | referat ga izbere na zaslonu Ocene iz Moodla (B8) ali učitelj znova doda povezavo prek Select content |
| Kaj Wise Ed prikaže pri predmetu, izbere učitelj predmeta. | izbiro vsebine je odprl študent | nič - Wise Ed v predmet doda le učitelj |
Ocene prek LTI - kode v Klici v LMS in v predogledu
| Wise Ed pravi | Kaj storiti |
|---|---|
| Platforma v Wise Ed nima naslova za žeton. | B6: Naslov žetonov = Access token URL Moodla |
| Lastnega ključa LTI Wise Ed na tem strežniku ni mogoče uporabiti. | obvestite Wise Technologies |
| LMS ni sprejel podpisane zahteve Wise Ed za žeton. | v Moodlu mora biti Public keyset orodja naslov JWKS Wise Ed in Public key type Keyset URL (B2); v Wise Ed morata biti ID odjemalca in Naslov žetonov iz Moodla (B6); Občinstvo žetona prazno |
| LMS Wise Ed v tem predmetu ne dovoli storitve ocen ali seznama članov. | B3: grade sync and column management in seznam članov; nato Wise Ed še enkrat odprite iz predmeta |
| Ta predmet v LMS Wise Ed ni dal naslova redovalnice. | B3, nato Wise Ed enkrat odprite iz predmeta (B8) |
| LMS je Wise Ed zavrnil dostop do redovalnice tega predmeta. | orodje je morda skrito ali odstranjeno iz predmeta ali je predmet zaprt |
| LMS tega stolpca (ali predmeta) nima več. | v Moodlu je bil izbrisan; naslednje pošiljanje stolpec naredi znova |
| LMS je zavrnil, kar je poslal Wise Ed. | ob tem so besede Moodla - preberite jih |
| LMS ni dosegljiv. · LMS ni odgovoril pravočasno. · LMS je med odgovarjanjem odpovedal (napaka na njegovi strani). · LMS je Wise Ed prosil, naj upočasni. | nič: Wise Ed sam pošlje znova, vsakič z daljšim premorom (10, 30, 90, nato 270 minut, ob naslednjem zagonu časovnega opravila, ki teče dvakrat na uro); po petem poskusu jih navede kot ni sprejetih |
| LMS je odgovoril nekaj, česar Wise Ed ne more prebrati. | B6: naslovi morajo biti naslovi Moodla |
| Ni poslano (v predogledu) | Kaj storiti |
|---|---|
| ... je študent(ka) predmeta "..." v LMS, a noben študent v Wise Ed nima tega naslova. | študentov e-naslov v Moodlu se razlikuje od šolskega naslova v Wise Ed - popravite enega od njiju; B4 Share launcher's email Always |
| ... ima točke, a še ni odprl(a) Wise Ed iz "...", LMS pa ne deli seznama članov. | B3 seznam članov (Names and Role Provisioning) |
| Wise Ed ne ve, kateri predmet je "..." | referat ga izbere v Predmeti v LMS, ki so odprli Wise Ed |
| ... nima objavljenega načina ocenjevanja za ... | nosilec predmeta objavi način ocenjevanja v Wise Ed |
| "..." dobi točke iz stolpca v LMS, zato se ne pošljejo nazaj ... | nič - ta del se ocenjuje v Moodlu in pošiljanje nazaj bi bilo le odmev |
| Ocenjevalna lestvica šole šteje navzdol (1 je najboljša) ... | redovalnica take ocene ne more prikazati kot točke; končne ocene ostanejo v Wise Ed |
Canvas, Brightspace, Blackboard
Isto orodje, isti naslovi (zgoraj). V vsakem dovolite obsege LTI Advantage https://purl.imsglobal.org/spec/lti-ags/scope/lineitem, .../lineitem.readonly, .../result.readonly, .../score in https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly, delite ime in e-naslov uporabnika ter izdajatelja, ID odjemalca, ID namestitve in naslove avtorizacije, žetonov in ključev platforme prepišite v Wise Ed (B6).
- Canvas: Admin > Developer Keys > + Developer Key > LTI Key, Method: Manual Entry: Redirect URIs, Target Link URI, OpenID Connect Initiation Url in Public JWK URL iz okvirja zgoraj; vklopljene storitve LTI Advantage za stolpce, rezultate, točke in člane predmeta; Privacy level: Public; umestitev s tipom sporočila LtiDeepLinkingRequest za izbiro vsebine. Nato ključ namestite (Settings > Apps). Izdajatelj Canvasa je
https://canvas.instructure.com. - Brightspace (D2L): Manage Extensibility > LTI Advantage > Register Tool, nato namestitev (deployment) s storitvama ocen ter imen in vlog; v Wise Ed nastavite Občinstvo žetona na
https://api.brightspace.com/auth/token. - Blackboard Learn: orodje registrirajte na razvijalskem portalu Anthology z zgornjimi naslovi, nato ga dodajte pod LTI Tool Providers z njegovim ID odjemalca; izdajatelj
https://blackboard.com.
Te platforme občasno premaknejo menije; zadnja beseda je njihova lastna dokumentacija za orodja LTI 1.3. Wise Ed od njih ne zahteva ničesar, česar ni v standardu IMS LTI 1.3 / LTI Advantage.
Kaj potuje in kaj se hrani
- V Moodle (del A): imena predmetov, kategorije, vpisi (po e-naslovu) in skupine; prek LTI: točke z Moodlovimi lastnimi ID uporabnikov - brez imen, brez e-naslovov, nič drugega iz zapisa.
- Iz Moodla: redovalnica (del A); seznam članov predmeta (imena, e-naslovi, vloge) in rezultati njegovih stolpcev (del B). Nič iz Moodla ne pride v zapis Wise Ed, dokler ga oseba ne poveže in prenese.
- Žeton spletne storitve je shranjen zapečaten in nikoli več prikazan; dostopni žetoni LTI živijo le nekaj minut zagona in se nikamor ne zapišejo. Vsak klic v Moodle je v dnevniku klicev Wise Ed (nikoli žeton); vsaka sprememba nastavitve je v zgodovini.
- Izklop: Usklajevanje: Izklopljeno (del A) in Ocene prek LTI: Izklopljeno (del B) ustavita vse naenkrat; v Moodlu isto z vaše strani naredi začasna ukinitev žetona ali orodja.
Wise Technologies d.o.o. · Ljubljana · wise-tt.com