Skip to main content

Ally per l'integrazione D2L Brightspace

Per integrare Ally con la tua istanza D2L Brightspace, devi seguire questi passaggi:

  1. Creazione di utenti e ruoli. Questo deve essere fatto prima di qualsiasi chiamata con il contatto di Anthology Ally.

  2. Configurazione principale

  3. Configurazione LTI

    • Configurazione cliente

    • Relazione dell'istituto

    • Rapporto sull'accessibilità dei corsi

Creazione di utenti e ruoli

  1. Creare un nuovo ruolo 

    1. Dal menu Impostazioni (icona a forma di ingranaggio) vai a Ruoli e autorizzazioni 

    2. Avviare il processo di creazione del ruolo selezionando il pulsante Crea/Copia 

    3. Creare un nuovo ruolo vuoto selezionando il pulsante Inizia da capo 

    4. Impostazioni dei ruoli: 

      • Nome: Ruolo REST Ally 

      • Descrizione: l'insieme di autorizzazioni che consentono ad Ally di comunicare in modo sicuro con le API REST di Brightspace 

      • Abilita ruolo a cascata 

        Lascia disabilitata l'opzione Facilitatore principale poiché potrebbe non essere più necessaria

      • Alias ruolo: Ally 

      • Non è necessario apportare modifiche in Opzioni di comportamento dello strumento, tutto può rimanere disabilitato 

      • Non è necessario apportare modifiche in Opzioni di visualizzazione dell'elenco classi, tutto può rimanere disabilitato 

      • Nella sezione Opzioni di accesso al corso: 

        • Abilita tutte le opzioni di accesso: 

          • Accedere ai corsi inattivi 

          • Accedi ai corsi passati 

          • Accedi ai corsi futuri 

        • Sezioni e gruppi possono rimanere impostati su Nessuna delle opzioni precedenti 

    5. Interazioni tra i ruoli: 

      1. In Registra Ruolo REST Ally selezionare la casella di controllo all'intersezione tra la riga Amministratore e la colonna Organizzazione. Ciò consente di creare un utente con questo ruolo in un secondo momento. 

      2. In Cerca Ruolo REST Ally selezionare la casella di controllo all'intersezione tra la riga Amministratore e la colonna Organizzazione. Ciò consente di cercare un utente con questo ruolo in un secondo momento. 

      3. Non sono necessarie ulteriori modifiche.

  2. Configurare le autorizzazioni del ruolo 

    Una volta salvato, il nuovo ruolo REST di Ally apparirà in fondo all'elenco dei ruoli. Apri il menu a discesa e seleziona Modifica autorizzazioni. In questa schermata è necessario concedere le autorizzazioni seguenti: 

    1. Filtra in base allo strumento Contenuti e concedi le seguenti autorizzazioni nella colonna Offerta di corsi: 

      • Visualizza il contenuto del corso 

      • Compila e scarica contenuti 

      • Scarica gli argomenti dei contenuti 

      • Visualizzare il contenuto non rilasciato 

      • Gestisci contenuti 

      • Creazione e modifica di moduli e argomenti 

      • Elimina moduli e argomenti (necessario per eliminare immagini potenzialmente che inducono convulsioni)

    2. Console di gestione del corso

      • Vedi Informazioni sul corso (Offerta del corso). Questa autorizzazione è necessaria per consentire ad Ally di recuperare le unità organizzative del reparto.

    3. Lista classi

      • Ha accesso alla Classlist

    4. Discussioni 

      • Visualizza le discussioni (Offerta del corso)

        Questo è necessario per elencare i collegamenti agli argomenti di discussione in un corso e il suo sommario. 

    5. Quiz 

      • Visualizza i quiz (Offerta del corso)

        Questo è necessario per elencare i collegamenti ai quiz nel sommario di un corso. 

    6. Editor dell'unità organizzativa 

      • Visualizza Editor unità organizzativa (Organizzazione)  

      • Può aggiungere e modificare i tipi di unità organizzative (organizzazione).

        Abbiamo bisogno di questo ruolo per elencare i semestri. Purtroppo, non è disponibile alcuna autorizzazione di "sola lettura". Ally non creerà o modificherà mai informazioni di tipo unità organizzativa.

    7. Sicurezza 

      • Vedere Ruoli e autorizzazioni (Organizzazione)

    8. Privacy delle informazioni dell'utente

      1. Vedi Nomi utente (offerta del corso)

        Questa autorizzazione consente ad Ally di vedere l'identificatore dell'utente, ma nient'altro. Queste informazioni non vengono mai memorizzate, ma per motivi tecnici è necessario determinare quanti studenti sono iscritti a un corso.

      2. Vedi Nomi (Organizzazione)

        Necessario per recuperare il nome e l'e-mail dell'utente quando richiede aiuto. Questo non viene mai memorizzato da parte di Ally e passa solo nell'e-mail di aiuto.

      3. Vedi Cognomi (Organizzazione)

        Necessario per recuperare il nome e l'e-mail dell'utente quando richiede aiuto. Questo non viene mai memorizzato da parte di Ally e passa solo nell'e-mail di aiuto.

      4. Vedere Indirizzi e-mail (organizzazione)

        Necessario per recuperare il nome e l'e-mail dell'utente quando richiede aiuto. Questo non viene mai memorizzato da parte di Ally e passa solo nell'e-mail di aiuto.

    9. Gli utenti

      1. Visualizza le iscrizioni degli utenti (offerta di corsi)

      2. Cerca 'Studente' (Offerta del corso)

        Studente è il nome predefinito per il ruolo di studente. Se il tuo istituto utilizza un nome diverso per questo tipo di utente, abilita invece l'opzione Cerca '...'. Questo è necessario per recuperare il numero di studenti in un'offerta di corso. I dati che vengono inviati vengono resi anonimi.

      3. Visualizzare l'indirizzo e-mail degli utenti (organizzazione)

        È necessario recuperare l'e-mail dell'utente quando richiede aiuto. Questo non viene mai memorizzato da parte di Ally e passa solo nell'e-mail di aiuto.

      4. Vedere lo strumento di gestione degli utenti (organizzazione)

        È necessario recuperare il nome e l'e-mail dell'utente quando richiede aiuto. Questo non viene mai memorizzato da parte di Ally e passa solo nell'e-mail di aiuto.

  3. Creazione utente

    Una volta configurato il ruolo, è possibile creare un nuovo utente con questo set limitato di autorizzazioni. 

    1. Dal menu Impostazioni (icona a forma di ingranaggio), vai su Utenti 

    2. Avviare il processo di creazione del ruolo selezionando il pulsante Nuovo utente 

    3. Impostazioni: 

      • Nome: Ally 

      • Cognome: Utente 

      • Ruolo: Ruolo REST Ally 

      • Nome utente: allyuser 

      • Selezionare Imposta password manualmente e immettere una password adeguatamente sicura nel campo Password. È fondamentale che questa password sia sufficientemente sicura, poiché per cambiarla in seguito sarà necessario reimpostare tutto di nuovo.

      • Salvare l'utente selezionando il pulsante Salva 

Configurazione principale

Importante

Assicurarsi che la configurazione dell'utente e del ruolo sia stata eseguita per prima. La seguente configurazione viene eseguita in una chiamata con un contatto Anthology Ally. Assicurarsi che la chiamata di configurazione sia pianificata per prima.

  1. Dal menu Impostazioni (icona a forma di ingranaggio), vai a Gestisci estendibilità

  2. Assicurati di essere nella scheda OAuth 2.0

  3. Seleziona il pulsante Registra un'app

  4. Compila il modulo come segue:

    • Nome: Ally

    • URI di reindirizzamento: <URI di reindirizzamento fornito dal contatto Anthology>

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

    • Ambito: contenuto:*:leggi contenuto:file:scrivi core:*:*personalizzato:contenutoaccess:leggi iscrizione:orgunit:leggi

    • Richiesta di consenso dell'utente: No

    • Abilita token di aggiornamento: Sì

    • Accetto il contratto per gli sviluppatori non commerciali: Sì

  5. Seleziona il pulsante Registrati

  6. A questo punto verranno presentati i dettagli dell'applicazione appena creata. Copia ID cliente e la chiave segreta, e condividili con il tuo contatto Anthology Ally.

  7. Dopo aver ricevuto la conferma di Anthology Ally, seleziona Aggiorna

  8. Accedi a Brightspace come ally utente

  9. Vai all'URL fornito dal tuo contatto Anthology Ally (sotto a Dettagli sull'integrazione del cliente amministratore di Ally). Anche se si tratta di un URL il cui nome host termina con .ally.ac verrai automaticamente reindirizzato alla tua istanza Brightspace. Brightspace presenterà una schermata che ti chiederà il permesso di interagire con l'API REST. Seleziona Accetta.

  10. Se tutto è andato bene, dovrebbe essere visualizzato il seguente messaggio di successo: L'integrazione REST è stata configurata con successo!

  11. Dal menu Impostazioni (icona a forma di ingranaggio), accedere a Config Variable Browser

  12. Individua le configurazioni di Ally utilizzando il menu ad albero a sinistra: 3rdParty > Ally

    L'integrazione Ally risiede in d2l.3rdParty.Ally.*

  13. Aggiungi i valori di configurazione con quelli forniti dal tuo contatto Blackboard

    • ID cliente

    • ClientSecret – Brightspace presenterà due input. Utilizzare il segreto LTI per entrambi gli input.

    • ScriptUrl

  14. Dal menu Impostazioni (icona a forma di ingranaggio), vai a Strumenti organizzativi

  15. Trova la riga per l'integrazione Ally e attiva la casella di controllo in modo che sia attivata

Configurazione LTI

Segui questo passaggio per configurare LTI e registrare gli strumenti Ally.