Administratorhandbuch zur Learn365-Webpart-Suite

Einführung

Dieser Artikel vermittelt einen Überblick und eine allgemeine Anleitung zur Learn365-Webpart-Suite, die von Zensai Professional Services bereitgestellt wird.

 

Verfügbarkeit

Die Webpart-Suite steht ausschließlich Success Plus- und Success Premium-Kunden zur Verfügung.

 

Plattform

• Entwickelt für SharePoint (nicht verfügbar für Teams)
• Webparts können auf beliebigen SharePoint-Seiten im Mandanten des Kunden platziert werden.
• Getestet mit den neuesten Versionen der Browser Chrome, Edge und Safari

 

Sprachunterstützung

Verfügbar auf Englisch, Französisch, Deutsch, Italienisch, Portugiesisch und Spanisch

 

Support und Wartung

• Wenn Probleme bei der Nutzung dieser Webparts auftreten, wenden Sie sich an das Zensai-Produktsupportteam.
• Auch wenn Sie Feedback geben oder uns Ihre Ideen vorschlagen möchten, wenden Sie sich bitte an Ihren Zensai Customer Success Manager.

 

Überblick

Dieser Leitfaden behandelt folgende Themen:

• Webpart-Suite zu Apps in SharePoint hinzufügen
• Probleme bei der API-Anfragegenehmigung beheben
• Webpart-Suite zu einer SharePoint-Website hinzufügen
• Der Learn365-Webpart „Vereinheitlichter Kurskatalog“
• Der Learn365-Webpart „Meine Schulungen“
• Der Learn365-Webpart „Verfügbare Kurse“
• Der Learn365-Webpart „Kurse durchsuchen“
• Version der Webpart-Suite aktualisieren
• Webpart-Suite auf einer SharePoint-Website manuell aktualisieren

 

Webpart-Suite zu Apps in SharePoint hinzufügen

Erforderliche Rolle: globaler Microsoft 365-Administrator

 

 

Warum wird diese API-Anfrage benötigt?

Wenn der Benutzer sich bei SharePoint anmeldet, verwendet die API-Anfrage zum Benutzeridentitätswechsel die Identität dieses Benutzers, um relevante Informationen aus der Learn365-API in den Webpart abzurufen und dort anzuzeigen. Auf diese Weise erhält der Webpart die korrekten Daten, die sich auf den jeweiligen angemeldeten Benutzer beziehen.

 

Gehen Sie wie folgt vor, um die Suite mit den benutzerdefinierten Webparts zu Apps in SharePoint hinzuzufügen:

1. Navigieren Sie zum SharePoint Admin Center Ihres Mandanten.

2. Wählen Sie Mehr Features in der linken Navigationsleiste aus.

3. Klicken Sie im Abschnitt Apps auf Öffnen. Die Seite Apps verwalten wird geöffnet.

4. Wählen Sie Hochladen aus.

5. Wählen Sie die Datei für die Learn365-Webpart-Suite aus, die Sie von Ihrem Learn365-Berater erhalten haben.

Alternativ können Sie, sofern Sie über die erforderlichen Berechtigungen verfügen, die Datei über diesen Artikel herunterladen.

6. Klicken Sie im Feld App aktivieren auf Nur diese App aktivieren.

7. Klicken Sie auf App aktivieren.

8. Klicken Sie auf die Schaltfläche Zur Seite API-Zugriff.

 

 

9. Wählen Sie LMS365-API aus.

10. Klicken Sie oben auf der Seite auf Genehmigen.

11. Klicken Sie im Feld Zugriff genehmigen unten auf Genehmigen.

12. Kehren Sie zur Seite Apps verwalten zurück.

13. Klicken Sie im geöffneten Dialogfeld entweder oben rechts auf das X oder aber auf Ich erledige das später, um zu Ihrer SharePoint-Apps-Seite zurückzukehren.

Weitere Informationen entnehmen Sie dem folgenden Video.

 

 

Probleme bei der API-Anfragegenehmigung beheben

Erforderliche Rolle: globaler Microsoft 365-Administrator

 

Wenn Sie während des Installationsprozesses versuchen, die API-Anfrage zu genehmigen, wird möglicherweise die Fehlermeldung „Die Anfrageberechtigung ist nicht gültig. Lehnen Sie diese Anfrage ab, und wenden Sie sich an den Entwickler, damit er das Problem behebt und die Lösung erneut bereitstellt“ angezeigt.

Dieser Fehler kann darauf zurückzuführen sein, dass Ihr O365-Mandant die veraltete Berechtigung lms365-api-prod anstelle des geänderten und korrekten Namens LMS365 API verwendet. In diesem Fall muss der Name der Berechtigung geändert werden, um Leistungsprobleme mit der Webpart-Suite zu vermeiden.

 

Gehen Sie wie folgt vor, um dieses Problem zu beheben:

1. Rufen Sie das Admin Center von Microsoft Entra (vormals Azure Active Directory) auf, und navigieren Sie zum Abschnitt Anwendungen > Enterprise-Anwendungen.

2. Suchen Sie hier nach „LMS365“, um festzustellen, ob die veraltete Berechtigung „lms365-api-prod“ unter Ihren Enterprise-Anwendungen aufgeführt ist.

3. Rufen Sie die drei Instanzen nacheinander auf und wechseln Sie zur jeweiligen Eigenschaftsseite.

4. Klicken Sie auf der Eigenschaftsseite auf die Option Löschen, um die aktuelle Enterprise-Anwendung zu entfernen.

5. Nachdem Sie alle drei Instanzen entfernt haben, müssen Sie den Genehmigungsprozess erneut starten.

6. Zu diesem Zweck müssen Sie ein Inkognito-Fenster öffnen und die URL lms.365.systems eingeben.

7. Vergewissern Sie sich, dass Sie sich bei einem Konto anmelden, das über globale Berechtigungen für Microsoft 365 verfügt.

8. Fahren Sie fort, und akzeptieren Sie die erforderlichen Berechtigungen.

9. Nach dem Akzeptieren werden Sie zum globalen Learn365 Admin Center weitergeleitet.

10. Hier geben Sie lms.365.systems/tenant/create/ ein, um die App im SharePoint-App-Katalog neu zu installieren.

 

Nach Abschluss der oben genannten Schritte sollten Sie die für die Learn365-Webpart-Suite erforderlichen Berechtigungen für die Learn365-API ohne Fehlermeldung akzeptieren können.

 

 

 

Webpart-Suite zu einer SharePoint-Website hinzufügen

Erforderliche Rolle: Berechtigungen als SharePoint-Websitebesitzer

 

Wenn Sie beim Hochladen der Webpart-Suite Nur diese App aktivieren ausgewählt haben, müssen Sie die Webpart-Suite manuell Ihrer SharePoint-Website hinzufügen, indem Sie eine neue App hinzufügen.

Gehen Sie wie folgt vor, um die benutzerdefinierte Webpart-Suite Ihrer SharePoint-Website hinzuzufügen:

1. Navigieren Sie zur betreffenden SharePoint-Website.

2. Klicken Sie oben rechts auf der Seite auf Einstellungen (Zahnradsymbol).

3. Klicken Sie auf Eine App hinzufügen.

 

 

4. Klicken Sie unter der App-Kachel LMS365-PS webparts bundle auf Hinzufügen.

Die App wird Ihrer Website hinzugefügt. Sie können nun zur Startseite der SharePoint-Website zurückkehren.

 

 

Der Learn365-Webpart „Vereinheitlichter Kurskatalog“

Der benutzerdefinierte Webpart Vereinheitlichter Kurskatalog kann auf jeder SharePoint-Website platziert werden. Dieser Webpart zeigt Kurse aus mehreren Kurskatalogen zentral an.

Gehen Sie wie folgt vor, um den Webpart Vereinheitlichter Kurskatalog Ihrer SharePoint-Website hinzuzufügen:

1. Navigieren Sie zu der SharePoint-Seite, auf der Sie den Webpart hinzufügen möchten.

2. Klicken Sie oben rechts auf der SharePoint-Seite auf Bearbeiten.

3. Klicken Sie links auf der Seite auf die Plusschaltfläche (+).

4. Wählen Sie die Option „Volle Breite“ aus.

5. Wählen Sie den Webpart LMS365 - PS Unified Course Catalog aus.

6. Klicken Sie auf das Stiftsymbol, um den Webpart zu bearbeiten.

7. Wählen Sie im Dropdown-Menü Kataloge aus.

8. Wählen Sie die Kataloge aus, die Sie im LMS365-Webpart „Vereinheitlichter Kurskatalog“ anzeigen möchten.

9. Wählen Sie aus, ob ausgeblendete Kurse angezeigt werden sollen (optional).

10. Ändern Sie die Anzahl der Ergebnisse pro Seite (optional).

11. Ändern Sie die Einstellungen für die Kurskacheln, um farbige Balken auszublenden (optional).

12. Wählen Sie die relevanten Registrierungsoptionen aus.

13. Ändern Sie die Einstellungen der Schieberegler (optional).

14. Wählen Sie die Kalenderansichtsoptionen aus (optional).

15. Ändern Sie die Filtereinstellungen (optional).

16. Passen Sie die Filterreihenfolge an (optional).

17. Klicken Sie auf Anwenden.

18. Wählen Sie oben links auf der Seite Erneut veröffentlichen aus.

Weitere Informationen entnehmen Sie dem folgenden Video.

 

 

Der Learn365-Webpart „Meine Schulungen“

Erforderliche Rolle: SharePoint-Mitgliedsberechtigungen oder höher. Berechtigungen als globaler Microsoft 365-Administrator oder SharePoint-Administrator sind nicht erforderlich.

Der benutzerdefinierte Webpart Meine Schulungen kann auf jeder SharePoint-Website platziert werden. Der Webpart zeigt Informationen über Registrierungen, in Kürze fällige, überfällige und abgeschlossene Kurse für den Benutzer an, der die Seite anzeigt.

Gehen Sie wie folgt vor, um den Webpart Meine Schulungen Ihrer SharePoint-Website hinzuzufügen:

1. Navigieren Sie zu der SharePoint-Seite, auf der Sie den Webpart hinzufügen möchten.

2. Klicken Sie oben rechts auf der SharePoint-Seite auf Bearbeiten.

3. Klicken Sie links auf der Seite auf die Plusschaltfläche (+).

4. Wählen Sie Abschnitt in voller Breite aus.

5. Wählen Sie den Webpart LMS365 - PS My Learning aus.

6. Klicken Sie auf das Stiftsymbol, um den Webpart zu bearbeiten.

7. Wählen Sie im Dropdown-Menü Kataloge aus.

8. Wählen Sie die Kataloge aus, die Sie im Webpart Meine Schulungen anzeigen möchten.

9. Ändern Sie die Einstellungen für den Link „Nach oben“ (optional).

10. Ändern Sie die übrigen Einstellungen (optional).

11. Klicken Sie auf Anwenden.

12. Wählen Sie oben links auf der Seite Erneut veröffentlichen aus.

Weitere Informationen entnehmen Sie dem folgenden Video.

 

 

Der Learn365-Webpart „Verfügbare Kurse“

Erforderliche Rolle: SharePoint-Mitgliedsberechtigungen oder höher. Berechtigungen als globaler Microsoft 365-Administrator oder SharePoint-Administrator sind nicht erforderlich.

Der benutzerdefinierte Webpart Verfügbare Kurse kann auf jeder SharePoint-Website platziert werden. Der Webpart zeigt verfügbare Kurse aus allen Kurskatalogen an, die nach Kategorien vorgegeben sind.

Gehen Sie wie folgt vor, um den Webpart Verfügbare Kurse Ihrer SharePoint-Website hinzuzufügen:

1. Navigieren Sie zu der SharePoint-Seite, auf der Sie den Webpart hinzufügen möchten.

2. Klicken Sie oben rechts auf der SharePoint-Seite auf Bearbeiten.

3. Klicken Sie links auf der Seite auf die Plusschaltfläche (+).

4. Wählen Sie die Option „Volle Breite“ aus.

5. Wählen Sie den Webpart LMS365 - PS Available Courses aus.

6. Klicken Sie auf das Stiftsymbol, um den Webpart zu bearbeiten.

7. Wählen Sie im Dropdown-Menü Kataloge aus.

8. Wählen Sie die Kataloge aus, die Sie im Webpart Verfügbare Kurse anzeigen möchten.

9. Wählen Sie im Dropdown-Menü die Option Kategorien aus.

10. Wählen Sie die Kategorien aus, die Sie im Webpart Verfügbare Kurse anzeigen möchten.

11. Ändern Sie die Einstellungen für den Link „Nach oben“ (optional).

12. Wählen Sie die bevorzugten Registrierungsoptionen aus.

13. Ändern Sie die übrigen Einstellungen (optional).

14. Klicken Sie auf Anwenden.

15. Wählen Sie oben links auf der Seite Erneut veröffentlichen aus.

Weitere Informationen entnehmen Sie dem folgenden Video.

 

 

Der Learn365-Webpart „Kurse durchsuchen“

Erforderliche Rolle: SharePoint-Mitgliedsberechtigungen oder höher. Berechtigungen als globaler Microsoft 365-Administrator oder SharePoint-Administrator sind nicht erforderlich.

Der benutzerdefinierte Webpart Kurse durchsuchen kann auf jeder SharePoint-Website platziert werden. Dieser Webpart wird in Verbindung mit dem Webpart „Vereinheitlichter Kurskatalog“ verwendet, um auf der Grundlage von Kategorien, Titeln und Beschreibungen nach Schulungen zu suchen.

 

Voraussetzungen

Kopieren Sie die URL Ihres Kurskatalogs in die Zwischenablage.

Hängen Sie nach .aspx den folgenden Text an die URL an:

?2bitscc={"types":[],"categories":[],"catalogs":[],"isRequired":[],"ratings":[],"enrollments":[],"sessionTypes":[],"search":"[search]"}

Gehen Sie wie folgt vor, um den Webpart Kurse durchsuchen Ihrer SharePoint-Website hinzuzufügen:

1. Navigieren Sie zu der SharePoint-Seite, auf der Sie den Webpart hinzufügen möchten.

2. Klicken Sie oben rechts auf der SharePoint-Seite auf Bearbeiten.

3. Klicken Sie links auf der Seite auf die Plusschaltfläche (+).

4. Wählen Sie Zwei Spalten aus.

5. Klicken Sie in der rechten Spalte auf das Pluszeichen +, um den Webpart LMS365 - PS Search Courses Box in dieser Spalte hinzuzufügen.

6. Wählen Sie den Webpart LMS365 - PS Search Courses Box aus. Unter Umständen müssen Sie auf der Seite ein wenig nach unten scrollen, um diesen Webpart zu finden.

7. Klicken Sie auf das Stiftsymbol, um den Webpart zu bearbeiten.

8. Fügen Sie die URL, die Sie im Abschnitt Voraussetzungen zu Beginn dieses Artikels kopiert haben, in das Feld Basis-URL ein.

9. Klicken Sie auf Anwenden.

10. Klicken Sie in der linken Spalte auf das Pluszeichen (+), und wählen Sie dann Text aus, um ein Textfeld hinzuzufügen.

11. Geben Sie einen Text ein, der den Lernenden beim Verwenden der Suchfunktion unterstützt.

12. Klicken Sie oben auf der Seite auf Erneut veröffentlichen.

Weitere Informationen entnehmen Sie dem folgenden Video. Im nachfolgenden Video wird gezeigt, wie der Webpart auf der Startseite hinzugefügt wird.

 

 

Version der Webpart-Suite aktualisieren

Erforderliche Rolle: globaler Microsoft 365-Administrator

 

 

Gehen Sie wie folgt vor, um die Version der benutzerdefinierten Webpart-Suite in Ihren SharePoint-Apps zu aktualisieren:

1. Navigieren Sie zum SharePoint Admin Center Ihres Mandanten.

2. Wählen Sie Mehr Features in der linken Navigationsleiste aus.

3. Klicken Sie im Abschnitt Apps auf Öffnen. Die Seite Apps verwalten wird geöffnet.

4. Wählen Sie die aktuelle Version der Web Part-Suite aus, die auf Ihrer Seite „Apps für SharePoint“ verfügbar ist.

5. Klicken Sie auf die Schaltfläche Löschen in der oberen Menüleiste.

6. Bestätigen Sie das Löschen der vorherigen Version.

7. Nachdem das Löschen der App abgeschlossen ist, klicken Sie auf die Schaltfläche Hochladen.

8. Laden Sie die SharePoint-Paketdatei der neuesten Version hoch, die Ihnen von Zensai Professional Services bereitgestellt wurde.

9. Im Feld App aktivieren wählen Sie Nur diese App aktivieren aus.

10. Klicken Sie auf App aktivieren.

11. Klicken Sie auf die Schaltfläche Zur Seite API-Zugriff, um zu bestätigen, dass Sie über die korrekten API-Berechtigungen verfügen.

 

 

12. Vergewissern Sie sich, dass die API-Berechtigung „user_impersonation“ im Feld Zugriff genehmigen aufgeführt ist.

13. Wenn die API-Berechtigung „user_impersonation“ im Abschnitt „Ausstehende Anfragen“ aufgeführt oder mehrfach vorhanden ist, ziehen Sie ggf. das vorliegende Administratorhandbuch zurate, um Probleme mit API-Anfragen zu beheben.

14. Schließen Sie die Seite „API-Zugriff“, und kehren Sie zur Seite Apps verwalten zurück.

15. Klicken Sie im geöffneten Dialogfeld entweder oben rechts auf das X oder aber auf Ich erledige das später, um zu Ihrer SharePoint-Apps-Seite zurückzukehren.

 

 

Webpart-Suite auf einer SharePoint-Website manuell aktualisieren

Erforderliche Rolle: Berechtigungen als SharePoint-Websitebesitzer

 

Gehen Sie wie folgt vor, um die aktuelle Version der benutzerdefinierten Webpart-Suite auf Ihrer SharePoint-Website zu aktualisieren:

1. Navigieren Sie zur betreffenden SharePoint-Website, auf der die Webpart-Suite installiert ist.

2. Klicken Sie oben rechts auf der Seite auf Einstellungen (Zahnradsymbol).

3. Wählen Sie Website-Inhalte aus.

4. Suchen Sie nach der installierten Webpart-Suite, und wählen Sie das Menü Aktionen anzeigen aus.

5. Klicken Sie im Dropdown-Menü auf Details.

6. Auf der Detailseite zum benutzerdefinierten Webpart klicken Sie auf die Schaltfläche Herunterladen, um die gegenwärtige Version zu aktualisieren.

7. Nach einigen Sekunden werden Sie zur Seite „Website-Inhalte“ weitergeleitet. Hier wird die Webpart-Suite zunächst mit abgeblendetem Titel angezeigt.

8. Nach etwa einer Minute können Sie die Seite neu laden und zur Startseite der SharePoint-Website zurückkehren.

9. Sie können sich von der Versionsaktualisierung in jedem benutzerdefinierten Webpart überzeugen. Hierzu bearbeiten Sie die SharePoint-Seite, wählen einen benutzerdefinierten Webpart aus und klicken auf das Symbol zum Bearbeiten des Webparts.

10. Im Einstellungsmenü des Webparts sehen Sie die installierte Versionsnummer.

Im folgenden Video erhalten Sie eine ausführliche Anleitung zur Durchführung dieser Schritte.

 

Selbstinstallation

Wenn Sie eine Selbstinstallation der benutzerdefinierten Webpart-Suite durchführen möchten, wenden Sie sich bitte an Ihren Customer Success Manager, um die Installationsdateien zu erhalten.