Integrowanie rozwiązania Microsoft OneDrive LTI z aplikacją Desire2Learn Brightspace

Ten przewodnik zawiera kroki administratorów IT dotyczące rejestrowania aplikacji LTI usługi OneDrive dla usługi Brightspace LMS Desire2Learn (D2L).

Aby zapoznać się z omówieniem rozwiązania Microsoft LTI, zobacz Integrowanie produktów firmy Microsoft z systemem zarządzania uczeniem się (LMS).

Kroki dodawania aplikacji LTI usługi OneDrive są następujące:

1. Krok 1. Dodawanie nowej aplikacji LTI usługi Microsoft OneDrive.
2. Krok 2. Wdrażanie aplikacji LTI w środowisku brightspace użytkowników.
3. Krok 3. Włącz nową aplikację OneDrive LTI na pasku działań Quicklinks.

Uwaga

Osoba, która wykonuje tę integrację, powinna być administratorem aplikacji Brightspace i administratorem dzierżawy platformy Microsoft 365.

Dokumentacja źródłowa ustawień LTI 1.3 znajduje się w przewodniku LTI Advantage — Administrator.

Krok 1. Dodawanie nowej aplikacji LTI usługi Microsoft OneDrive

Rejestrowanie nowej aplikacji LTI usługi Microsoft OneDrive

1. Zaloguj się do portalu rejestracji LTI usługi Microsoft OneDrive.

2. Wybierz przycisk Administracja Zgoda i zaakceptuj uprawnienia.

   Ważna

   Jeśli Administracja Zgoda nie zostanie zaakceptowana, następny krok spowoduje wyświetlenie błędu i będziesz musiał poczekać godzinę, zanim będzie można kontynuować.

3. Wybierz przycisk Utwórz nową dzierżawę LTI .

4. Na liście LTI Consumer Platform (Platforma konsumentów LTI ) wybierz pozycję D2L Brightspace.

5. W polu D2L Brightspace Base URL (Adres URL bazy D2L Brightspace ) wprowadź podstawowy adres URL usługi Brightspace, na przykład https://myschool.brightspace.com.

6. Wybierz przycisk Dalej . Zostanie załadowana strona Rejestrowanie aplikacji LTI 1.3 .
   Pozostaw tę stronę otwartą na własnej karcie podczas wykonywania następnego zestawu kroków. Wymagane wartości zostaną wygenerowane w następnych krokach.

Dodawanie aplikacji Microsoft LTI do aplikacji Brightspace

1. Na nowej karcie przeglądarki zaloguj się do usługi Brightspace LMS przy użyciu konta administratora lub administratora dla organizacji, do których chcesz dodać aplikację LTI usługi OneDrive.
2. Wybierz ikonę koła zębatego w prawym górnym rogu, aby uzyskać dostęp do narzędzi Administracja.
3. W kategorii Związane z organizacją znajdź pozycję Zarządzaj rozszerzalnością.
   Adres URL powinien wyglądać podobnie do następującego przykładu: https://<yourbrightspacedomain>/d2l/le/ltiadvantage/registrations/home.
4. Wybierz kartę LTI Advantage (Przewaga LTI ) u góry, a następnie wybierz pozycję Zarejestruj narzędzie.
5. Wybierz przycisk radiowy Standard dla typu rejestracji narzędzia.
6. Wprowadź nazwę aplikacji, na przykład Microsoft OneDrive LTI App.
7. W polu Domena wprowadź wartość https://onedrivelti.microsoft.com.
8. Przejdź do karty przeglądarki za pomocą portalu rejestracji LTI usługi Microsoft OneDrive, aby skopiować inne wymagane wartości:
   1. Wklej ToolOIDCLaunchRedirectUri wartość w polu Adresy URL przekierowania .

      Ważna

      Użyjesz tej wartości adresu URL przekierowania w kolejnych krokach.

   2. Wklej wartość "OIDCLoginInitiationUri" do pola Adres URL logowania programu OpenID Connect .
   3. Wklej ToolPublicJwksUri wartość w polu Adres URL zestawu kluczy .
9. W obszarze Rozszerzenia zaznacz pole wyboru Łączenie głębokie .
10. Wybierz przycisk Zarejestruj w dolnej części strony.
    Zostaną wyświetlone szczegóły rejestracji aplikacji Brightspace. Pozostaw tę stronę otwartą na własnej karcie podczas wykonywania następnego zestawu kroków.

Dodawanie szczegółów rejestracji platformy BRIGHTSPACE LTI do portalu rejestracji LTI usługi Microsoft OneDrive

Po zarejestrowaniu aplikacji w aplikacji Brightspace skopiujesz wartości z portalu rejestracji usługi Brightspace do portalu rejestracji LTI firmy Microsoft.

1. Przejdź z powrotem do otwartej karty przeglądarki na stronie portalu rejestracji LTI usługi OneDrive firmy Microsoft.
2. Skopiuj wymaganą stronę szczegółów rejestracji aplikacji Brightspace i wklej je w portalu rejestracji LTI firmy Microsoft.
   1. Wklej wartość Wystawcy Brightspace do pola Wystawcy LTI firmy Microsoft.
   2. Wklej wartość punktu końcowego uwierzytelniania openid connect programu Brightspace do pola Adres URL autoryzacji LTI firmy Microsoft.
   3. Wklej wartość adresu URL zestawu kluczy Brightspace firmy Brightspace do pola Adres URL publicznych jwków LTI firmy Microsoft.
   4. Wklej wartość adresu URL tokenu dostępu brightspace OAuth2 brightspace do pola Adres URL tokenu dostępu LTI firmy Microsoft.
   5. Wklej wartość identyfikatora klienta usługi Brightspace do pola Identyfikator klienta LTI firmy Microsoft.
3. Wybierz pozycję Dalej>zapisz.
   Zostanie wyświetlony komunikat informujący o pomyślnym utworzeniu konsumenta LTI.
   Opcjonalnie: możesz przejrzeć szczegóły rejestracji, wybierając przycisk Wyświetl dzierżawy LTI na stronie głównej.

Krok 2. Wdrażanie aplikacji LTI w środowisku brightspace użytkowników

Po nawiązaniu połączenia z usługami Microsoft OneDrive LTI i Brightspace należy wdrożyć aplikację LTI usługi OneDrive w środowisku brightspace użytkowników.

1. Na karcie ze środowiskiem administratora usługi Brightspace przejdź do obszaru Administracja ToolsManage Extensibility LTI Advantage (Narzędzia> do zarządzania korzyściąLTI rozszerzalności>), aby wyświetlić listę aplikacji LTI Advantage.
2. Wybierz nazwę aplikacji LTI Advantage utworzonej w poprzednim kroku.
3. Przewiń do dołu strony i wybierz link Wyświetl wdrożenia .
   Adres URL powinien wyglądać podobnie do tego przykładu: https://<yourbrightspacedomain>/d2l/le/ltiadvantage/deployments/home
4. Wybierz pozycję Nowe wdrożenie.
5. Wybierz aplikację według nazwy wprowadzonej podczas tworzenia rejestracji aplikacji Brightspace, na przykład Microsoft OneDrive LTI App.
6. Wprowadź nazwę wdrożenia dla tego wdrożenia, na przykład Microsoft OneDrive Deployment.
7. W sekcji Rozszerzenia wybierz pozycję Łączenie głębokie.
8. Zaznacz wszystkie pola wyboru ustawień zabezpieczeń z wyjątkiem opcji Classlist i Anonymous.
9. Nie wybieraj żadnych ustawień konfiguracji, parametrów podstawiania ani parametrów klienta.
10. Wybierz pozycję Dodaj jednostki organizacji i wybierz jednostki organizacji, których chcesz użyć nowej aplikacji LTI.
    Możesz wybrać następujące opcje:
    • Organizacja root wraz z opcją Wszystkie elementy potomne, aby uwzględnić wszystkich.
    • Poszczególne jednostki organizacyjne, które mają uwzględniać tylko te jednostki.
    • Wszystkie jednostki podrzędne za pomocą przycisków radiowych w kolumnie Opcje.
11. Wybierz pozycję Utwórz wdrożenie.
    Nowe wdrożenie zostanie wyświetlone na liście. Pozostaw tę opcję karty i kontynuuj kolejne kroki.

Tworzenie linków do aplikacji LTI usługi OneDrive w usłudze Brightspace

Ten krok powoduje dodanie aplikacji OneDrive LTI do menu w usłudze Brightspace LMS, w której użytkownicy wybierają wstawianie plików usługi OneDrive.

1. Na karcie ze środowiskiem administratora usługi Brightspace przejdź do obszaru Administracja ToolsManage Extensibility LTI Advantage (Narzędzia> do zarządzania korzyściąLTI rozszerzalności>), aby wyświetlić listę aplikacji LTI Advantage.
2. Wybierz nazwę utworzonej aplikacji LTI Advantage.
3. Przewiń do dołu strony i wybierz link Wyświetl wdrożenia .
4. Wybierz nazwę wdrożenia utworzonego w poprzednim kroku.
5. Przewiń do dołu strony i wybierz pozycję Wyświetl linki.

Utwórz link szybkiego łączenia głębokiego dla aplikacji, który będzie wyświetlany w menu Quicklinks

1. Na stronie Wyświetl łącza wybierz pozycję Nowy link.
2. Wprowadź nazwę linku, na przykład Microsoft OneDrive.
   Ta nazwa będzie widoczna dla użytkowników w środowisku brightspace.
3. Wklej adres URL przekierowania do pola Adres URL .
   Jest to ten sam adres URL przekierowania użyty w poprzednich krokach, wymieniony jako w portalu ToolOIDCLaunchRedirectUri rejestracji LTI usługi OneDrive firmy Microsoft.
4. Ustaw wartość Szybki link typu na Szybkie łączenie głębokie.
5. Wybierz pozycję +Dodaj parametr klienta i wprowadź launchType wartość dla pola Nazwa i linkSelection pola Wartość .
6. Wybierz przycisk Zapisz i zamknij .

Tworzenie linku Wstaw elementy z linku Link do łączenia głębokiego dla aplikacji, który będzie wyświetlany w menu Wstawianie rzeczy

1. Na stronie Wyświetl łącza wybierz pozycję Nowy link.
2. Wprowadź nazwę linku, na przykład Microsoft OneDrive.
   Ta nazwa będzie widoczna dla użytkowników w środowisku brightspace.
3. Wklej adres URL przekierowania do pola Adres URL .
   Jest to ten sam adres URL przekierowania użyty w poprzednich krokach, wymieniony jako w portalu ToolOIDCLaunchRedirectUri rejestracji LTI usługi OneDrive firmy Microsoft.
4. Ustaw typ na wartość Wstaw elementy z linkami głębokimi.
5. Wybierz przycisk Zapisz i zamknij .

Krok 3. Włączanie nowej aplikacji OneDrive LTI na pasku działań Quicklinks

Aplikacja LTI usługi OneDrive jest teraz dostępna dla użytkowników, ale starsza aplikacja OneDrive musi być teraz wyłączona.

1. Zaloguj się do portalu administracyjnego usługi Brightspace.
2. Przejdź do Administracja>Config Variable Browser
3. Znajdź zmienną o nazwie d2l.3rdParty.OneDrive.EnableOneDrivePicker i ustaw wartość na wyłączoną.

Aby dodać aplikację LTI usługi OneDrive do paska aktywności usługi Brightspace w celu uzyskania szybkiego dostępu, należy ustawić zmienną konfiguracji jednostki organizacyjnej na identyfikator linku aplikacji LTI.

Uwaga

Należy powtórzyć te kroki dla każdego identyfikatora organizacji (lub nadrzędnego identyfikatora organizacji), w którym aplikacja LTI usługi OneDrive ma być wyświetlana na pasku działań.

Zbieranie identyfikatora łącza

1. Zaloguj się do aplikacji Brightspace jako administrator lub administrator superadministrator.
2. Przejdź do pozycji narzędzia Administracja, wybierając ikonę koła zębatego w prawym górnym rogu.
3. Wybierz pozycję Zarządzaj rozszerzalnością , aby wyświetlić listę wdrożeń korzyści lti .
4. Wybierz nazwę utworzonej aplikacji LTI Advantage.
5. Przewiń do dołu strony i wybierz pozycję Wyświetl wdrożenia.
6. Wybierz nazwę utworzonego wdrożenia aplikacji.
7. Przewiń w dół do dołu strony i wybierz pozycję Wyświetl linki.
8. Wybierz nazwę linku z typem Szybki link do łączenia głębokiego .
9. Przenieś myszą na pasek adresu URL w przeglądarce.
10. Skopiuj cyfry liczbowe po zakończeniu / w adresie URL.
    Jeśli na przykład adres URL linku to https://example.desire2learn.com/d2l/le/ltiadvantage/deployments/3bfcc0b7-2fb6-4ffe-b353-95b520d4bae6/links/details/259, skopiuj 259 wartość liczbową.

Aktualizowanie zmiennych konfiguracji

1. W portalu administracyjnym usługi Brightspace przejdź do obszaru narzędzia Administracja, wybierając ikonę koła zębatego w prawym górnym rogu.
2. Wybierz pozycję Config Variable Browser.
3. W menu Wszystkie zmienne po lewej stronie przejdź do strony 3rdParty>Microsoft> i wybierz pozycję OneDriveLTI.
   Nazwa 3rdparty.microsoft.onedriveLTI.linkId zmiennej powinna być widoczna w okienku po prawej stronie.
4. Wybierz nazwę zmiennej LinkId .
5. Na ekranie konfiguracji LinkId wybierz pozycję Dodaj wartość , aby wybrać jednostkę organizacyjną i wkleić wcześniej zebraną wartość identyfikatora łącza liczbowego.
   Należy powtórzyć tę czynność dla każdej jednostki organizacji, której chcesz użyć na pasku działań Quicklinks.
6. Aby to ustawienie było stosowane do dodanych typów organizacji malejących, możesz edytować kaskadowe typy jednostek organizacji i wybrać typy i kolejność, w jakiej będą stosowane ustawienia.

Aplikacja OneDrive LTI będzie teraz wyświetlana w menu Dodaj istniejącą zawartość, Szybkie linki i Wstaw rzeczy w aplikacji Brightspace.

Użytkownicy będą widzieć ogólną ikonę linku, a nie ikonę chmury usługi OneDrive. Nazwa wyświetlana w menu będzie nazwą podaną w ustawieniach linku LTI aplikacji.

Te linki można wyłączyć i włączyć zgodnie z potrzebami i kierować je do określonych organizacji i decedentów przez konfigurację.

Aby uzyskać więcej informacji na temat konfigurowania aplikacji w usłudze Brightspace, odwiedź stronę Brightspace Help (Pomoc usługi Brightspace).

Typowe pytania dotyczące aplikacji OneDrive LTI

Czy nowy plik LTI usługi OneDrive Obsługuje konta osobiste?

Tak, konta osobiste mogą otwierać usługę OneDrive w celu przekazania plików. Istnieje pole wyboru w aplikacji w portalu rejestracji LTI usługi OneDrive, aby zezwolić na wiele kont. Jeśli to pole wyboru, konta osobiste są dozwolone.

Czy plik FilePicker obsługuje wiele języków?

Element FilePicker LTI usługi OneDrive analizuje parametr ustawienia języka LTI przekazany z usługi LMS i (jako kopię zapasową) ustawienie przeglądarki (ponieważ pierwsze jest opcjonalnym roszczeniem) w celu określenia języka do użycia.