Skip to main content

Integreiddiad Ally ar gyfer D2L Brightspace

I integreiddio Ally â'ch enghraifft D2L Brightspace bydd angen i chi ddilyn y camau hyn:

  1. Creu Defnyddiwr a Rôl. Mae angen gwneud hyn cyn unrhyw alwad â'r cyswllt Anthology Ally.

  2. Prif ffurfweddiad

  3. Ffurfweddu LTI

    • Ffurfweddu cleient

    • Adroddiad Sefydliadol

    • Adroddiad Hygyrchedd Cwrs

Creu Defnyddiwr a Rôl

  1. Creu rôl newydd 

    1. O'r ddewislen Gosodiadau (eicon gêr) llywiwch i Rolau a chaniatâd 

    2. Dechreuwch y broses creu rôl drwy ddewis y botwm Creu/Copïo 

    3. Creu rôl wag newydd drwy ddewis y botwm Dechrau Newydd 

    4. Gosodiadau rôl: 

      • Enw: Rôl REST Ally 

      • Disgrifiad: Y set o ganiatadau i ganiatáu i Ally gyfathrebu'n ddiogel â'r APIs REST Brightspace 

      • Galluogi Rôl Rhaeadru 

        Gadewch yr opsiwn Prif Hwylusydd wedi'i analluogi gan efallai na fydd ei angen mwyach

      • Ffugenw rôl: ally 

      • Does dim angen gwneud unrhyw newidiadau o dan Opsiynau Ymddygiad Offeryn, gall popeth aros yn analluog 

      • Does dim angen gwneud unrhyw newidiadau o dan Classlist Display Options, gall popeth aros yn analluog 

      • Dan Opsiynau Cyrchu Cwrs: 

        • Galluogwch bob opsiwn cyrchu: 

          • Mynediad at gyrsiau anweithredol 

          • Cyrchu cyrsiau blaenorol 

          • Mynediad at gyrsiau yn y dyfodol 

        • Gall Adrannau a Grwpiau aros wedi'i osod i Dim o'r uchod 

    5. Rhyngweithiadau rôl: 

      1. Dan Cofrestru Rôl REST Ally, dewiswch y blwch ticio ar groestoriad y rhes Gweinyddwr a'r golofn Mudiad. Mae hyn yn caniatáu creu defnyddiwr gyda'r rôl hon yn nes ymlaen. 

      2. Dan Chwilio Rôl REST Ally, dewiswch y blwch ticio ar groestoriad y rhes Gweinyddwr a'r golofn Mudiad. Mae hyn yn caniatáu chwilio am ddefnyddiwr gyda'r rôl hon yn nes ymlaen. 

      3. Nid oes angen gwneud unrhyw newidiadau ychwanegol.

  2. Ffurfweddu caniatâd y rôl 

    Ar ôl ei chadw, bydd y Rôl REST Ally newydd yn ymddangos ar waelod y rhestr rolau. Agorwch y gwymplen a dewiswch Golygu Caniatâd. Yn y sgrin hon, mae angen rhoi'r caniatâd canlynol: 

    1. Hidlo yn ôl yr offeryn Cynnwys a rhoi'r caniatâd canlynol yn y golofn Cynnig Cwrs: 

      • Gweld Cynnwys y Cwrs 

      • Crynhoi a Lawrlwytho Cynnwys 

      • Lawrlwytho Pynciau Cynnwys 

      • Gweld cynnwys sydd heb ei ryddhau 

      • Rheoli Cynnwys 

      • Creu a golygu modiwlau a phynciau 

      • Dileu Modiwlau a Phynciau (angenrheidiol i ddileu delweddau a allai achosi atafaelu)

    2. Consol Rheoli Cyrsiau

      • Gweler Gwybodaeth am y Cwrs (Cynnig Cwrs). Mae angen y caniatâd hwn er mwyn cael unedau trefniadaethol yr adran.

    3. Rhestr dosbarth

      • Mae Ganddo Fynediad at Restr y Dosbarth

    4. Trafodaethau 

      • Gweld trafodaethau (Cynnig Cwrs)

        Mae hyn yn angenrheidiol i restru dolenni i bwnc trafod mewn cwrs a'i dabl cynnwys. 

    5. Cwisiau 

      • Gweld cwisiau (Cynnig Cwrs)

        Mae hyn yn angenrheidiol i restru dolenni i gwisiau yn nhabl cynnwys cwrs. 

    6. Golygydd Unedau Org 

      • Gweld Golygydd Uned Org (Mudiad)  

      • Yn gallu ychwanegu a Golygu Mathau o Unedau Trefniadaethol (Mudiad).

        Mae angen y rôl hon arnom i restru'r semesterau. Yn anffodus, nid oes caniatâd "darllen yn unig" sydd ar gael. Ni fydd Ally byth yn creu nac yn golygu gwybodaeth math uned mudiadol.

    7. Diogelwch 

      • Gweld Rolau a Chaniatâd (Mudiad)

    8. Preifatrwydd Gwybodaeth Defnyddiwr

      1. Gweler Enwau Defnyddwyr (Cynnig Cwrs)

        Mae'r caniatâd hwn yn caniatáu i Ally weld dynodwr y Defnyddiwr, ond dim byd arall. Ni chedwir y wybodaeth hon byth, ond oherwydd rhesymau technegol, mae angen mynediad ati er mwyn pennu'r nifer o fyfyrwyr sydd wedi cofrestru ar gwrs.

      2. Gweler Enwau Cyntaf (Mudiad)

        Angenrheidiol i adfer enw ac e-bost y defnyddiwr pan fyddant yn gofyn am help. Ni chedwir y wybodaeth hon byth ar ochr Ally ac mae dim ond yn mynd trwy ein system yn yr e-bost help.

      3. Gweler Enwau Olaf (Mudiad)

        Angenrheidiol i adfer enw ac e-bost y defnyddiwr pan fyddant yn gofyn am help. Ni chedwir y wybodaeth hon byth ar ochr Ally ac mae dim ond yn mynd trwy ein system yn yr e-bost help.

      4. Gweler Cyfeiriadau E-bost (Mudiad)

        Angenrheidiol i adfer enw ac e-bost y defnyddiwr pan fyddant yn gofyn am help. Ni chedwir y wybodaeth hon byth ar ochr Ally ac mae dim ond yn mynd trwy ein system yn yr e-bost help.

    9. Defnyddwyr

      1. Gweld Cofrestriadau Defnyddiwr (Cynnig Cwrs)

      2. Chwilio am 'Myfyriwr' (Cynnig Cwrs)

        Myfyriwr yw'r enw diofyn ar gyfer rôl y myfyriwr. Os yw eich sefydliad yn defnyddio enw arall ar gyfer y math hwn o ddefnyddiwr, galluogwch Chwilio am '...' yn lle hynny. Mae angen y caniatâd hwn er mwyn cael y nifer o fyfyrwyr mewn cynnig cwrs. Anfonir y data hwn, ond mae wedi cael ei anonymeiddio.

      3. Gweld cyfeiriad e-bost y defnyddwyr (mudiad)

        Mae angen adfer e-bost y defnyddiwr pan fyddant yn gofyn am help. Ni chedwir y wybodaeth hon byth ar ochr Ally ac mae dim ond yn mynd trwy ein system yn yr e-bost help.

      4. Gweler yr Offeryn Rheoli Defnyddwyr (Mudiad)

        Mae angen adfer enw ac e-bost y defnyddiwr pan fyddant yn gofyn am help. Ni chedwir y wybodaeth hon byth ar ochr Ally ac mae dim ond yn mynd trwy ein system yn yr e-bost help.)

  3. Creu defnyddiwr

    Ar ôl i'r rôl gael ei ffurfweddu, gellir creu defnyddiwr newydd gyda'r set gyfyngedig hon o ganiatâd. 

    1. O'r ddewislen Gosodiadau (eicon gêr), llywiwch i Defnyddwyr 

    2. Dechreuwch y broses creu rôl drwy ddewis y botwm Defnyddiwr Newydd 

    3. Gosodiadau: 

      • Enw Cyntaf: Ally 

      • Enw Olaf: Defnyddiwr 

      • Rôl: Ally REST Rôl 

      • Enw defnyddiwr: allyuser 

      • Dewiswch Gosod cyfrinair â llaw a rhowch gyfrinair sy'n ddigon diogel yn y maes Cyfrinair. Mae'n hanfodol bod y cyfrinair hwn yn ddigon diogel oherwydd y bydd angen gosod popeth o'r newydd eto er mwyn newid y cyfrinair hwn yn nes ymlaen.

      • Cadw'r defnyddiwr drwy ddewis y botwm Cadw  

Prif ffurfweddiad

Pwysig

Gwnewch yn siŵr bod y ffurfweddiadau Defnyddiwr a Rôl wedi'u gwneud yn gyntaf. Mae'r ffurfweddiad canlynol yn cael ei wneud mewn galwad â chyswllt Anthology Ally. Gwnewch yn siŵr bod yr alwad ffurfweddu wedi'i threfnu yn gyntaf.

  1. O'r ddewislen Gosodiadau (eicon gêr), llywiwch i  Rheoli estynadwyedd

  2. Gwnewch yn siŵr eich bod ar y tab OAuth 2.0

  3. Dewiswch y botwm Cofrestru App

  4. Llenwch y ffurflen fel a ganlyn:

    • Enw: Ally

    • URI ailgyfeirio: <URI ailgyfeirio a ddarperir gan gyswllt Anthology>

      e.e. https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • Cwmpas: content:*:read content:file:write core:*:* custom:contentaccess:read cofrestriad:orgunit:read

    • Gofyn am ganiatâd y defnyddiwr: Na

    • Galluogi tocynnau adnewyddu: Ydw

    • Rwy'n derbyn y cytundeb Datblygwr Anfasnachol: Ydw

  5. Dewiswch y botwm Cofrestru

  6. Byddwch nawr yn gweld manylion y rhaglen sydd newydd ei chreu. Copïwch id y cleient a'r allwedd gyfrinachol, a'u rhannu â'ch cyswllt Anthology Ally.

  7. Ar ôl cael cadarnhad Anthology Ally, dewiswch Diweddar

  8. Mewngofnodwch i Brightspace fel y defnyddiwrally

  9. Ewch i'r URL mae eich cyswllt Anthology Ally wedi'i ddarparu (dan Gweinyddu Ally Manylion Integreiddiad Cleient). Er ei fod yn URL sy'n gorffen gyda .ally.ac, cewch eich ailgyfeirio'n awtomatig i'ch enghraifft Brightspace. Bydd Brightspace yn dangos sgrin a fydd yn gofyn i chi ganiatáu i Ally ryngweithio â'r API REST. Dewiswch Derbyn.

  10. Os aeth popeth yn dda, dylai'r neges lwyddiant ganlynol ddangos: Mae'r integreiddiad REST wedi'i sefydlu'n llwyddiannus!

  11. O'r ddewislen Gosodiadau (eicon gêr), llywiwch i  Ffurfweddu Porwr Newidiol

  12. Lleolwch y cyfluniadau Ally trwy ddefnyddio'r ddewislen coeden ar y chwith: 3rdParty > Ally

    Mae'r integreiddio cynghreiriaid yn byw yn d2l.3rdParty.Ally.*

  13. Ychwanegu'r gwerthoedd cyfluniad gyda'r rhai a ddarperir i chi gan eich cyswllt Blackboard

    • IDCleient

    • CyfrinachCleient - Bydd Brightspace yn dangos dau fewnbwn. Defnyddiwch gyfrinach yr LTI ar gyfer y ddau fewnbwn.

    • UrlSgript

  14. O'r ddewislen Gosodiadau (eicon gêr), llywiwch i Offer Trefniadaethol

  15. Dewch o hyd i res yr integreiddiad Ally a toglwch y blwch ticio er mwyn iddo fod ymlaen

Ffurfweddu LTI

Dilynwch y cam hwn i ffurfweddu'r LTI a chofrestru'r offer Ally.