Das neue Viva Connections habe ich vor kurzem bereits vorgestellt, in diesem Beitrag geht es um die praktischen Schritte zur Installation, als Ergänzung zum Video. Ursprünglich wurde Connections unter dem Namen Homesite-App vorgestellt, als einfache Möglichkeit, um SharePoint-Intranets über die App-Leiste in Teams zu integrieren.
Viva Connections nutzt dabei die globalen Navigationslinks von SharePoint und ergänzt sie mit personalisierten Inhalten, die der Microsoft Graph zur Verfügung stellt. Da die globale Navigation in der SharePoint Homesite konfiguriert wird, empfiehlt sich auch als erster Schritt das Einrichten der Homesite in SharePoint. Zwingend erforderlich ist das allerdings nicht, prinzipiell können Sie dafür auch jede anderen SharePoint Modern Site im Tenant verwenden.
Hier zum Video und folgend auch die Schritt für Schritt Anleitung:
Schritt 1: Einrichten der SharePoint Homesite
Um eine Homesite in SharePoint Online einzurichten benötigen Sie die PowerShell. Derzeit kann es übrigens nur eine Homesite pro Tenant geben. Starten Sie dazu die PowerShell im Administrator-Modus über Windows (rechter Mausklick auf die Starttaste) und geben Sie folgende cmdlets ein:?
Connect to SPO: Connect-SPOService -Url https://contoso-admin.sharepoint.com
Setup Home Site: Set-SPOHomeSite -HomeSiteUrl
Mehr über die Grundlagen zum Einsatz der PowerShell sowie dem Einsatz mit Teams beschreiben die folgenden Artikel:
- Get started with SharePoint Online Management Shell (Microsoft, englisch)
- Set a site as your home site (Microsoft, englisch)
Shritt 2: So konfigurieren Sie die globale Navigation
Grundsätzlich empfiehlt es sich, wegen der Integration in Teams die globale Navigation für die Homesite zu aktivieren. Jedoch ist das kein Muss, die Viva Connections-App funktioniert auch mit der klassischen Navigation. Wie Sie die globale Navigation in der SharePoint Homesite aktivieren, erfahren Sie in diesem Microsoft Artikel: Enable global navigation & configure the global Navigation
Das müssen Sie über die globale Navigation wissen:
- Um die globale Navigation anzupassen ist eine Homesite erforderlich.
- Im Ausgangszustand, in dem die globale Navigation deaktiviert ist, ist das Home-Symbol mit der SharePoint-Startseite verknüpft.
- Zum Aktivieren der globalen Navigation benötigen Sie Site Owner-Berechtigungen (oder höher) auf der Homesite.
- Damit den Benutzen Links der globalen Navigation angezeigt werden, benötigen sie Lesezugriff (oder höher) auf die Startseite.
- Das Zuweisen Rollen- oder Gruppen-spezifischer Inhalte und Seiten (Audience Targeting) lässt sich in der globalen Navigation auf Menülinks anwenden.
- Nach der Aktivierung der globalen Navigation kann es bis zu 24 Stunden dauern, bis diese angezeigt wird.
Schritt 3: Viva Connections herunterladen und einrichten
Viva Connections wird als App-Paket heruntergeladen und installiert. Für das Benutzerkonto, mit dem Sie das Desktop-Paket erstellen benötigen Sie Site Owner-Rechte auf der Homesite in SharePoint. Das PowerShell Skript zum Erstellen des App Paktes können Sie hier herunter: Viva Connections for desktop PowerShell script
Bei der Installation in PowerShell müssen Sie folgende Werte setzen:
- URL of your tenant?s home site: Geben Sie die URL der Home-Site des Tenants an, die mit ?https://? beginnt. Diese Seite wird zur Standard-Landingpage für Viva Connections.
- Name: Der Name Ihres Viva Connections Desktop-Pakets, wie er in Teams App-Leiste erscheinen sollte.
- App short description (80 characters): Eine kurze Beschreibung für Ihre App, die in Teams App-Katalog erscheint.
- App long description (4000 characters): Eine lange Beschreibung für Ihre App, die in Teams App-Katalog erscheinen wird.
- Privacy policy: Die Datenschutzrichtlinie für benutzerdefinierte Teams-Apps in Ihrer Organisation (muss mit https:// beginnen). Wenn Sie keine separate Datenschutzrichtlinie haben, drücken Sie die Eingabetaste und das Skript verwendet die standardmäßige SharePoint-Datenschutzrichtlinie von Microsoft.
- Terms of use: Die Nutzungsbedingungen für benutzerdefinierte Teams-Apps in Ihrer Organisation (muss mit https:// beginnen). Wenn Sie keine separaten Nutzungsbedingungen haben, drücken Sie die Eingabetaste und das Skript verwendet die standardmäßigen SharePoint-Nutzungsbedingungen von Microsoft.
- Company name: Ihr Organisationsname, der auf der App-Seite in Teams App-Katalog im Abschnitt ?Erstellt von? sichtbar ist.
- Company website: Die öffentliche Website Ihres Unternehmens (muss mit https:// beginnen), die mit dem App-Namen Ihres Unternehmens auf der App-Seite in Teams App-Katalog im Abschnitt ?Erstellt von? verknüpft wird.
- Icons: Sie müssen zwei PNG-Symbole bereitstellen, die zur Darstellung Ihrer Viva Connections Desktop-App in Teams verwendet werden; ein 192X192 Pixel großes farbiges Symbol für den Teams-App-Katalog und ein 32X32 Pixel großes monochromes Symbol für die Teams-App-Leiste.
Ergebnis
Die erfolgreiche Installation wird mit folgender Meldung quittiert:
Your Viva Connections desktop app has been successfully created! Please find the app manifest in location ?C:\Users\%name%\Desktop?, filename ?Viva-Connections?.zip. Please upload this app in Teams Admin Center to proceed:
Um das Viva Connections Desktop-Paket im Teams Admin Center hochzuladen, gehen Sie auf Teams Apps und Manage Apps:
Nun sorgen Sie noch dafür, dass die App standardmäßig für Ihre Benutzer in die Navigationsleiste im Teams-Client angepinnt ist, und zwar über Setup-Policies, Pinned Apps:
Fertig. So präsentiert sich das angepinnte App-Symbol beim nächsten Starten von Teams für die Anwender in der linken Leiste:
