Learn365-Webparts über den App-Katalog der Websitecollection verwalten

Einführung

Learn365 unterstützt die Verwendung des Features SharePoint Online Site Collection App Catalogs in bestimmten Websitecollections (Kurskatalogen). Das Feature ermöglicht es SharePoint-Administratoren, den App-Katalog einer bestimmten Websitecollection so zu konfigurieren, dass Apps, die im App-Katalog der Websitecollection bereitgestellt werden, nur in genau dieser Websitecollection (Kurskatalog) installiert werden können – nicht aber auf allen Websites des Tenants.

Durch die Einbindung dieser Funktion können Sie Learn365 so konfigurieren, dass seine Webparts nur explizit in den Websitecollections (Kurskatalogen) angezeigt werden, denen die LMS365-App hinzugefügt wurde.

 

Verwendung der LMS365-App und ihrer Webparts in SharePoint

In Ihrem SharePoint-Tenant werden standardmäßig alle Apps in einem SharePoint-Tenant-App-Katalog installiert, sodass alle Apps in allen Websitecollections in Ihrem Tenant verfügbar sind. Dazu gehört auch die Bereitstellung der jeweiligen SharePoint-Webparts der Apps, damit diese in anderen Bereichen Ihrer SharePoint-Umgebung verwendet werden können.

Die LMS365-App ist für die Verwendung in bestimmten LMS365-Websitecollections vorgesehen, die als Kurskataloge bezeichnet werden.

Standardmäßig können die Learn365-Webparts (LMS365 Course Catalog, LMS365 Dashboard und LMS365 Course Homepage) wie im folgenden Bild gezeigt zusammen mit anderen SharePoint-Webparts zu jeder SharePoint-Website hinzugefügt werden.

Weitere Informationen zur Verwendung von Webparts auf SharePoint-Seiten finden Sie in diesem Microsoft-Dokumentationsartikel.

 

Eine Teamwebsite in SharePoint mit Zugriff auf die Learn365-Webparts

 

Wenn Sie versuchen, die Learn365-Webparts außerhalb der Websitecollections (Kurskataloge) zu verwenden – auf SharePoint-Websites, auf denen die LMS365-App nicht installiert ist –, führt dies zu einem Fehler. Das passiert, weil die Learn365-Webparts ihre entsprechenden Informationen aus der SharePoint-Websitecollection beziehen, in der die LMS365-App installiert ist.

 

Die Fehlermeldung, die angezeigt wird, wenn versucht wird, ein Learn365-Webpart auf einer Website zu verwenden, auf der die LMS365-App nicht installiert ist

 

Um dies zu vermeiden, können Sie festlegen, dass die Learn365-Webparts nur in Websitecollections (Kurskatalogen) angezeigt werden, in denen die Dateien der LMS365-App installiert sind, indem Sie die SharePoint-Funktion Site Collection App Catalog verwenden. Das bedeutet praktisch, dass Instanzen der LMS365-App nur in Websitecollections (Kurskatalogen) zur Verfügung stehen, in deren jeweiligen App-Katalogen der Websitecollection die Dateien der LMS365-App hinzugefügt sind.

Das bedeutet, dass Learn365 und seine Webparts nur auf die jeweiligen Websitecollections beschränkt sind, in denen die LMS365-App installiert ist.

 

Learn365-Webparts so konfigurieren, dass sie nur für bestimmte Websitecollections (Kurskataloge) gelten

Erforderliche Rolle: Microsoft 365 globaler Administrator

Um die Learn365-Webparts in Ihrem Tenant so zu konfigurieren, dass sie nur für bestimmte Websitecollections (Kurskataloge) gelten, folgen Sie den nachstehenden Anweisungen. Diese Anweisungen müssen für jede Websitecollection (Kurskatalog) ausgeführt werden, damit Learn365 dort ordnungsgemäß funktioniert.

 

Schritt #1: Deaktivieren Sie die LMS365-App in Ihrem SharePoint Tenant-App-Katalog

Führen Sie Schritt #1 zu einem Zeitpunkt aus, an dem Learn365 nicht verwendet wird, da dieser Schritt die gesamte Learn365-Instanz deaktiviert, bis die LMS365-Apps wieder zu Ihren neu erstellten App-Katalogen der Websitecollection hinzugefügt wurden.

Wenn Learn365 auf SharePoint installiert wird, wird die LMS365-App dem App-Katalog des SharePoint-Tenants hinzugefügt.

Als Ergebnis der Durchführung von Schritt 1 wird die LMS365-App im Tenant deaktiviert, und die Learn365-Webparts werden nicht mehr in der Liste der verfügbaren Webparts angezeigt, die zu SharePoint-Websites hinzugefügt werden können.

 

 

Um Learn365 im App-Katalog des SharePoint-Tenants zu deaktivieren, gehen Sie wie folgt vor:

1. Navigieren Sie zu Ihrem SharePoint Admin Center > Weitere Funktionen > zum Abschnitt Apps > Öffnen. 

2. Wählen Sie auf der geöffneten Seite Apps verwalten Weitere Funktionen > Tenantweite Erweiterungen > Öffnen.

3. Wählen Sie auf der geöffneten Seite Tenantweite Erweiterungen Apps für SharePoint aus

4. Wählen Sie auf der geöffneten Apps for SharePoint page das Edit-Symbol für die LMS365 app aus. 

 

 

5. Scrollen Sie auf der geöffneten Seite Bearbeiten nach unten und deaktivieren Sie das Kontrollkästchen Aktiviert. 

 

 

6. Wählen Sie Speichern aus, um die Änderungen zu speichern.

7. Wiederholen Sie auf der Seite Apps für SharePoint die Schritte 4–6 für LMS365.AccessApp.

 

Schritt #2: Eine Kopie der LMS365-App-Dateien herunterladen 

Learn365 wird in der Microsoft 365 SharePoint Online-Umgebung ausgeführt. Learn365 nutzt eine Vielzahl von Technologien, darunter Azure, SQL, Graph API und mehr. Aus diesem Grund müssen alle Installationen der Learn365 Cloud Suite zunächst zentral installiert und anschließend so konfiguriert werden, dass sie über die App-Katalog-Websites der Website-Sammlung auf Website-Sammlungsbasis zugänglich sind.

Da eine Standardinstallation von Learn365 die App-Installation über Microsoft AppSource erfordert, wodurch die App in Ihren Tenant-App-Katalog installiert wird, müssen Sie eine Kopie der LMS365-App-Dateien herunterladen, um sie auf den spezifischen Websites zu verwenden, auf denen Learn365 installiert ist.

 

 

Gehen Sie wie folgt vor, um eine Kopie der LMS365-App-Dateien herunterzuladen:

1. Navigieren Sie zu Ihrem SharePoint admin center > More features > zum Abschnitt Apps > Open. 

2. Wählen Sie auf der geöffneten Seite Manage apps More features > Tenant wide extensions > Open aus

3. Wählen Sie auf der geöffneten Tenant wide extensions Seite Apps for SharePoint aus

4. Wählen Sie auf der geöffneten Apps for SharePoint Seite die Datei LMS365 app aus.

5. Wählen Sie auf der Registerkarte Files Download a Copy aus. Die Datei LMS365.sppkg wird auf Ihr lokales Gerät heruntergeladen.

6. Wählen Sie auf der geöffneten Apps for SharePoint Seite die Datei LMS365.AccessApp aus und führen Sie Schritt 5 aus. Die Datei LMS365.AccessApp.app wird auf Ihr Gerät heruntergeladen.

Später laden Sie diese Dateien in die entsprechenden App-Kataloge der Websitesammlung hoch, in denen die LMS365-App verfügbar sein soll.

 

 

Schritt 3: App-Katalog für eine Website-Sammlung erstellen 

Um die LMS365-App auf die jeweiligen Kurskataloge (Websitesammlungen) zu beschränken, sollten Sie für jede Websitesammlung (Kurskatalog), in die Sie die LMS365-App einbinden möchten, einen App-Katalog der Websitesammlung erstellen.

Dies gilt auch für zukünftige Kurskataloge. 

Nach Ausführung des folgenden Skripts wird die Bibliothek Apps for SharePoint zu Ihrem Kurskatalog (Website-Sammlung) hinzugefügt, in dem Sie Learn365 bereitstellen können.

In den folgenden Schritten wird die SharePoint Online Management Shell verwendet, um einen App-Katalog für die Websitesammlung zu erstellen. Weitere Optionen zum Konfigurieren von App-Katalogen für Websitesammlungen finden Sie in diesem Microsoft-Dokumentationsartikel.

 

So erstellen Sie einen App-Katalog für die Websitesammlung:

1. Führen Sie in der SharePoint Online Management Shell als SharePoint-Tenant-Admin, den folgenden Befehl aus und ersetzen Sie TENANT durch den Namen Ihrer Tenant-Subdomain.

 

  Connect-SPOService -Url https://TENANT-admin.sharepoint.com

 

2. Führen Sie die folgenden Befehle für jede Websitesammlung (Kurskatalog) aus, in der die LMS365-App bereits installiert ist. Dabei ist TENANT Ihre Tenant-Subdomain und SITE der Ort Ihrer LMS365-Kurskatalog-Website.

 

  $site = Get-SPOSite https://TENANT.sharepoint.com/sites/SITE
  Add-SPOSiteCollectionAppCatalog -Site $site

 

Schritt #4: Learn365-Dateien zu einem App-Katalog für die Websitesammlung hinzufügen

1. Nachdem Sie Schritt #3 ausgeführt haben, navigieren Sie im SharePoint-Bereich Websiteinhalte zu dem Kurskatalog, an dem Sie gerade arbeiten. Jetzt gibt es im Tab Inhalt eine neue Liste Apps für SharePoint. Wählen Sie die Liste Apps für SharePoint aus, um die Bibliothek Apps für SharePoint zu öffnen.

 

 

2. Wenn Sie sich in der Bibliothek Apps für SharePoint befinden, laden Sie die Dateien LMS365.sppkg und LMS365.AccessApp.app hoch, die Sie in Schritt #2 auf Ihr Gerät heruntergeladen haben. Laden Sie sie einzeln hoch, indem Sie entweder Upload auswählen oder die Dateien von Ihrem Gerät in die Bibliothek ziehen und dort ablegen.

3. Wenn Sie aufgefordert werden, "Diese Lösung für alle Websites in der Organisation verfügbar zu machen", aktivieren Sie diese Option und wählen Sie dann Deploy aus.

Trotz der Formulierung ist Learn365 sofort verfügbar, sobald Sie dieses Kontrollkästchen aktivieren, jedoch nur in derselben Websitesammlung (Kurskatalog), in der die LMS365-App-Dateien hinzugefügt wurden.

 

 

Da Sie in diesem Fall in einen App-Katalog für die Websitesammlung und nicht in den Tenant-App-Katalog hochladen, ermöglichen Sie, dass die LMS365-App auf allen Seiten der Websitesammlung (Kurskatalog) verfügbar ist – nicht für die gesamte Organisation.

Dadurch wird sichergestellt, dass Schulungen, die innerhalb des Kurskatalogs erstellt werden, über die erforderlichen Webparts verfügen, um zu funktionieren, da alle Kurse in Learn365 als Seiten in der Websitesammlung des Kurskatalogs erstellt werden.

Nach der Bereitstellung werden Sie feststellen, dass Ihre Learn365-Website wieder ordnungsgemäß funktioniert und dass die Learn365-Webparts auf Websites, auf denen Learn365 nicht installiert ist, nicht mehr angezeigt werden.

 

Neu erstellte Kurskataloge konfigurieren

Wenn Sie nach Durchführung der Schritte #1–#4 in Ihrem Tenant einen neuen Kurskatalog (Website-Sammlung) erstellen, müssen Sie zusätzliche Konfigurationen vornehmen, um Learn365 für den neu erstellten Kurskatalog ordnungsgemäß verwenden zu können.

Der Grund dafür ist, dass das Learn365 Admin Center auf die zentral gespeicherte Datei LMS365.sppkg im Tenant-App-Katalog angewiesen ist, um ordnungsgemäß zu funktionieren. Das bedeutet, dass es zwei Optionen gibt, um Ihren neu erstellten Kurskatalog für die Verwendung mit dem App-Katalog der Website-Sammlung zu konfigurieren.

 

Option 1

Aktivieren Sie vor dem Erstellen eines neuen Kurskatalogs die LMS365-App im Tenant-App-Katalog vorübergehend. 

Dies ist der empfohlene Weg, da er einfacher ist und weniger administrativen Aufwand erfordert, hat jedoch den Nachteil, dass die LMS365-Apps Ihrer gesamten Tenant-Umgebung angezeigt werden, wenn sie wieder aktiviert werden. Planen Sie entsprechend für diese und alle anderen Änderungen, die während dieses Zeitraums auftreten können.

Um Option 1 auszuführen, befolgen Sie diese Schritte:

1. Um die LMS365-App im Tenant-App-Katalog vorübergehend zu aktivieren, navigieren Sie wie in Schritt #1 beschrieben zum Tenant-App-Katalog und aktivieren Sie das Kontrollkästchen Enabled. Speichern Sie die Änderungen.

2. Erstellen Sie einen neuen Kurskatalog wie in diesem Artikel beschrieben

3. Führen Sie Schritt #3 und #4 für die neu erstellte Website-Sammlung (Kurskatalog) aus.

4. Führen Sie Schritt #1 aus.

 

Option 2

Lassen Sie die LMS365-App im Tenant-App-Katalog deaktiviert und konfigurieren Sie die Learn365-Webparts manuell im neu erstellten Kurskatalog und auf dessen Seiten.

Diese Option hat den Vorteil, dass die bereits ausgeführten Schritte beibehalten werden und die LMS365-App zentral deaktiviert bleibt, erfordert jedoch mehr administrativen Aufwand für die Durchführung und Konfiguration.

1. Erstellen Sie einen neuen Kurskatalog, wie in diesem Artikel beschrieben

2. Führen Sie Schritt #3 und #4 für die neu erstellte Website-Sammlung (Kurskatalog) aus.

3. Fügen Sie die LMS365-App zur neu erstellten Websitesammlung (Kurskatalog) hinzu.

Gehen Sie dazu in SharePoint zu Websiteinhalte des Kurskatalogs und wählen Sie +Neu > App aus.

 

 

4. Wählen Sie auf der geöffneten Seite für die LMS365-App Hinzufügen aus

Wählen Sie im geöffneten Fenster Trust it aus, um zu bestätigen, dass Sie der App vertrauen.

 

 

5. Fügen Sie Learn365-Webparts zur Kurskatalogseite und zur Seite Mein Schulungs-Dashboard hinzu. Navigieren Sie dazu zur entsprechenden Seite und fügen Sie die jeweiligen Webparts im standardmäßigen SharePoint-Bearbeitungsmodus hinzu.

• Das Webpart LMS365-Kurskatalog für die Kurskatalogseite, wie in der Abbildung unten dargestellt.

 

 

• Das Webpart LMS365-Dashboard für die Seite Mein Schulungs-Dashboard, wie in der Abbildung unten dargestellt.

 

 

Zusammenfassung

Wir wissen, dass SharePoint-Admins die Benutzererfahrung für ihre Benutzer gern feinabstimmen, und die Verwendung der SharePoint-Online-Funktion Websitesammlungs-App-Katalog ermöglicht es uns, unsere SharePoint-Apps von Drittanbietern – einschließlich unserer Learn365-Installation – einfacher einzugrenzen.

Kontaktieren Sie den Zensai Produkt-Support, wenn bei einem der in diesem Artikel beschriebenen Schritte Probleme auftreten, und teilen Sie uns eventuelle Fehler mit, die bei der Ausführung dieser Schritte angezeigt werden.