Skip to main content

Ally per a la integració a D2L Brightspace

Per integrar Ally amb la instància D2L Brightspace, heu de seguir els passos següents:

  1. Creació d’usuaris i rols. Això s’ha de fer abans de qualsevol trucada amb el contacte d’Anthology Ally.

  2. Configuració principal

  3. Configurar LTI

    • Configuració de client

    • Informe institucional

    • Informe d’accessibilitat del curs

Creació d’usuaris i rols

  1. Creeu un rol nou 

    1. Des del menú Configuració (icona d'engranatge), aneu a Rols i permisos 

    2. Inicieu el procés de creació de rol seleccionant el botó Crea/Copia 

    3. Creeu un rol nou en blanc seleccionant el botó Comença de zero 

    4. Configuració del rol: 

      • Nom: Rol REST d'Ally 

      • Descripció: el conjunt de permisos per permetre a Ally comunicar-se de manera segura amb les API REST de Brightspace 

      • Habilita Rol en cascada 

        Deixeu l’opció de Formador principal desactivada, ja que és possible que no la necessiteu més.

      • Àlies del rol: ally 

      • No cal fer cap canvi a les Opcions de comportament de l'eina, tot pot romandre desactivat 

      • No cal fer cap canvi a les Opcions de visualització de la llista de classes, tot pot romandre desactivat 

      • A Opcions d’accés al curs: 

        • Activa totes les opcions d’accés: 

          • Accedeix a cursos inactius 

          • Accedeix a cursos anteriors 

          • Accedeix a cursos futurs 

        • Seccions i grups es pot quedar establert a Cap de les anteriors 

    5. Interaccions de rols: 

      1. A Registre del rol d’Ally REST, marqueu la casella de selecció que hi ha a la intersecció de la fila Administrador i la columna Organització. Això permet crear un usuari amb aquest rol més endavant. 

      2. A Cerca del rol d’Ally REST, marqueu la casella de selecció que hi ha a la intersecció de la fila Administrador i la columna Organització. Això permet cercar un usuari amb aquest rol més endavant. 

      3. No cal fer més canvis.

  2. Configurar els permisos del rol 

    Un cop desat, el nou rol Ally REST apareixerà a la part inferior de la llista de rols. Obriu el menú desplegable i seleccioneu Edita permisos. En aquesta pantalla, cal concedir els permisos següents: 

    1. Filtreu per l’Eina de contingut i concediu els permisos següents a la columna Oferta de cursos: 

      • Veure el contingut del curs 

      • Compilar i descarregar el contingut 

      • Descarregar els temes del contingut 

      • Veure el contingut que no s’ha publicat 

      • Gestionar el contingut 

      • Crear i editar mòduls i temes 

      • Suprimir mòduls i temes (necessaris per eliminar imatges que poden provocar convulsions)

    2. Consola de gestió de cursos

      • Consulteu la informació del curs (oferta de cursos). Aquest permís és necessari perquè Ally recuperi les unitats organitzatives del departament.

    3. Llista de classes

      • Té accés a la llista de classes

    4. Debats 

      • Veure els debats (oferta de cursos)

        Això és necessari per llistar enllaços a temes de discussió en un curs i la seva taula de continguts. 

    5. Qüestionaris 

      • Veure els qüestionaris (oferta de cursos)

        Això és necessari per enumerar enllaços a qüestionaris a la taula de continguts d’un curs. 

    6. Editor de la unitat organitzativa 

      • Veure l’editor de la unitat organitzativa (organització)  

      • Pot afegir i editar tipus d’unitats organitzatives (organització).

        Necessitem aquest rol per enumerar els semestres. Malauradament, no hi ha cap permís de "només lectura" disponible. Ally mai crearà ni editarà informació sobre el tipus d’unitat organitzativa.

    7. Seguretat 

      • Veure els rols i permisos (organització)

    8. Privadesa de la informació de l’usuari

      1. Veure els noms d'usuari (oferta de cursos)

        Aquest permís permet a Ally veure l’identificador de l’usuari, però res més. Aquesta informació no es desa mai, però per motius tècnics cal determinar quants alumnes hi ha matriculats en un curs.

      2. Veure els noms (organització)

        Necessari per recuperar el nom i l'adreça electrònica de l'usuari quan sol·licita ajuda. Això Ally no ho emmagatzema mai i només passa al correu electrònic de l’assistència.

      3. Veure els cognoms (organització)

        Necessari per recuperar el nom i l'adreça electrònica de l'usuari quan sol·licita ajuda. Això Ally no ho emmagatzema mai i només passa al correu electrònic de l’assistència.

      4. Veure les adreces de correu electrònic (organització)

        Necessari per recuperar el nom i l'adreça electrònica de l'usuari quan sol·licita ajuda. Això Ally no ho emmagatzema mai i només passa al correu electrònic de l’assistència.

    9. Usuaris

      1. Veure les inscripcions d’usuaris (oferta de cursos)

      2. Cerca per 'Estudiant' (oferta de cursos)

        Estudiant és el nom per defecte del rol d'estudiant. Si la vostra institució utilitza un nom diferent per a aquest tipus d’usuari, activeu Cerca "...". Això és necessari per recuperar el recompte d’estudiants en una oferta de curs. Les dades que s’envien són anònimes.

      3. Veure l'adreça electrònica dels usuaris (organització)

        Cal recuperar l'adreça electrònica de l'usuari quan demani ajuda. Això Ally no ho emmagatzema mai i només passa al correu electrònic de l’assistència.

      4. Veure l'eina de gestió d'usuaris (organització)

        Cal recuperar el nom i l'adreça electrònica de l'usuari quan demani ajuda. Això Ally no ho emmagatzema mai i només passa al correu electrònic de l’assistència).

  3. Creació d'usuaris

    Un cop configurat el rol, es pot crear un nou usuari amb aquest conjunt limitat de permisos. 

    1. Des del menú Configuració (icona d’engranatge), aneu a Usuaris 

    2. Inicieu el procés de creació de rol seleccionant el botó de Nou usuari 

    3. Configuració: 

      • Nom: Ally 

      • Cognoms: Usuari 

      • Rol: Rol d'Ally REST 

      • Nom d'usuari: allyuser 

      • Seleccioneu Estableix la contrasenya manualment i introduïu una contrasenya segura al camp Contrasenya. És crucial que la contrasenya sigui prou segura, ja que per canviar-la més endavant caldrà configurar-ho tot de nou.

      • Deseu l’usuari seleccionant el botó Desa 

Configuració principal

Important

Assegureu-vos que la configuració d’usuari i rol s’hagi fet primer. La configuració següent es fa en una trucada amb un contacte d’Anthology Ally. Assegureu-vos que la trucada de configuració s’hagi programat primer.

  1.  Des del menú Configuració (icona d’engranatge), aneu a Gestiona l’ampliabilitat

  2. Assegureu-vos de ser a la pestanya OAuth 2.0

  3. Seleccioneu el botó Registra una aplicació

  4. Ompliu el formulari de la següent manera:

    • Nom: Ally

    • URI de redirecció: <URL de redirecció proporcionat pel contacte d'Anthology>

      per exemple, https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • Àmbit: content:*:read content:file:write core:*:* custom:contentaccess:read enrollment:orgunit:read

    • Sol·licitud de consentiment de l'usuari: No

    • Activa els testimonis d'actualització: sí

    • Accepto l'acord de desenvolupador no comercial: sí

  5. Seleccioneu el botó Registra

  6. Ara se us presentaran els detalls de l’aplicació acabada de crear. Copieu l’identificador del client i la clau secreta i compartiu-los amb el vostre contacte d’Anthology Ally.

  7. Després de tenir la confirmació de l’Anthology Ally, seleccioneu Actualitza

  8. Inicieu la sessió a Brightspace com a allyuser

  9. Aneu a l’URL que us ha proporcionat el vostre contacte d’Anthology Ally (a Dades d’integració del client d’administrador d’Ally). Tot i que és un URL el nom d’amfitrió del qual acaba en .ally.ac, se us redirigirà automàticament a la instància de Brightspace. Brightspace mostrarà una pantalla que us demanarà permís perquè Ally interactuï amb l’API REST. Seleccioneu Accepta.

  10. Si tot ha anat bé, hauria de mostrar el missatge d'èxit següent: La integració REST s'ha configurat correctament!

  11. Des del menú Configuració (icona d’engranatge), aneu a Configuració del navegador de variables

  12. Localitzeu les configuracions d’Ally utilitzant el menú d’arbre de l’esquerra: 3rdParty > Ally

    La integració d'ally és a d2l.3rdParty.Ally.*

  13. Afegiu els valors de configuració amb els que us proporcioni el vostre contacte de Blackboard

    • ID de client

    • ClientSecret: Brightspace presentarà dues entrades. Utilitzeu el secret LTI per a les dues entrades.

    • ScriptUrl

  14. Des del menú Configuració (icona d’engranatge), aneu a Eines organitzatives

  15. Cerqueu la fila de la integració d’Ally i activeu la casella de selecció perquè quedi activa

Configurar LTI

Seguiu aquest pas per configurar l’LTI i registrar les eines d’Ally.