Das Ziel dieses Dokuments ist es, dass ein Symbol auf der Microsoft Teams-App-Navigationsleiste für eine SharePoint-Website angeheftet angezeigt wird, die allen Benutzern von Teams oder bestimmten Personen zur Verfügung stehen soll. Es spielt keine Rolle, ob sie Mitglieder eines Teams oder Kanals sind. Die Lösung bietet neuen Benutzern Zugriff auf ein kundeneigenes Portal für Teamschulungen, bevor sie jemals ihrem ersten Team beigetreten sind oder dieses erstellt haben.
1 Teams-App-Steuerelemente in der Admin-Konsole
2 Steuern, wer benutzerdefinierte Apps hochladen kann
3 Überprüfen, welche Richtlinien auf einen Benutzer angewendet werden
4 Steuern von Berechtigungen für Teams-Apps
5 App erstellen
6 App testen
7 Packen der App
8 Hochladen der App
9 Bereitstellung der App
10 Endgültige Lösung
Teams-App-Steuerelemente in der Admin-Konsole
Apps, die in der Teams-Apps-Leiste angezeigt werden, werden über die Teams-Verwaltungskonsole im Mandanten gesteuert. Teams-Apps > Richtlinien einrichten.
Achtung ! Wenn Sie Ihren Mandanten nicht rechtzeitig auf das Hochladen einer benutzerdefinierten App vorbereiten, wird später in diesem Dokument die folgende Meldung angezeigt.
Achtung ! Wenn Sie Ihren Mandanten nicht darauf vorbereiten, nur bestimmten Personen das Hochladen benutzerdefinierter Apps zu gestatten, kann jeder Apps in Ihren App Store hochladen.
Steuern, wer benutzerdefinierte Apps hochladen kann
- Erstellen Sie auf der Seite App-Setup-Richtlinien eine neue benutzerdefinierte Richtlinie.
Wir haben den Namen „ App-Upload-Richtlinie “ gewählt, aber Sie können alle verwenden, was sinnvoll ist. Schalten Sie in der neuen Richtlinie die Möglichkeit zum Hochladen benutzerdefinierter Apps auf „ EIN “, wenn Ihre Benutzer-ID dieser Richtlinie zugewiesen ist.
- Ignorieren Sie alle anderen Einstellungen und klicken Sie auf „ Speichern “ .
- Wählen Sie auf dem Richtlinienbildschirm die neue Richtlinie aus und klicken Sie auf „ Benutzer verwalten “ .
- Geben Sie auf der Seite „Verwaltete Benutzer“ die Namen der Benutzer ein, denen Sie diese Richtlinie zuweisen möchten.
- Alle Benutzer, die nicht Teil dieser Richtlinie sind, erhalten die folgende Fehlermeldung, wenn sie versuchen, eine App hochzuladen.
Achtung ! Nach dem Speichern dieser Richtlinieneinstellungen kann es Stunden dauern, bis sie wirksam werden.
Überprüfen, welche Richtlinien auf einen Benutzer angewendet werden
- Navigieren Sie im Teams Admin Center zur Registerkarte „ Benutzer “.
- Suchen Sie nach einem Benutzer, auf den Sie gerade die Richtlinie im vorherigen Schritt angewendet haben, und aktivieren Sie dann das Kontrollkästchen neben dem Benutzer. Dadurch können Sie sehen, wie viele Richtlinien für diesen Benutzer gelten.
- Sie können dann die Option „ Einstellungen bearbeiten“ auswählen , um die Richtlinieneinstellungen des Benutzers zu bearbeiten.
- Suchen Sie die Option „ App-Setup-Richtlinie “ und klicken Sie auf das Dropdown-Menü.
- Sie sehen alle aktuellen App-Setup-Richtlinien, die den Zugriff dieses Benutzers auf Teams-Apps steuern.
Steuern von Berechtigungen für Teams-Apps
- Suchen Sie in der Teams-Verwaltungskonsole unter „ Teams-Apps “ nach der Registerkarte „ Berechtigungsrichtlinien “.
- Klicken Sie auf die Schaltfläche „ Organisationsweite App-Einstellungen “, um die aktuellen Berechtigungen zur Verwendung von Teams-Apps in Ihrem Mandanten zu überprüfen.
Achtung ! Wenn der Administrator Ihres Mandanten die unten aufgeführten Optionen in Grün auf „ Aus “ gesetzt hat, können Sie diese Dokumentenmission zum Hinzufügen und Verwenden einer benutzerdefinierten App in Teams nicht erfolgreich abschließen.
- Als Nächstes müssen wir die App-Berechtigung auf Richtlinienebene überprüfen, wenn die vorherigen Einstellungen aktiviert zu sein schienen.
- Wählen Sie in den „ App Permission policies “ die Richtlinie „ Global (Org-wide default) for is settings“ aus, indem Sie die Policy markieren und auf „ Edit “ klicken.
- Das beste Szenario ist, dass das Kästchen in Grün auf alle Apps gesetzt ist und Benutzer dieser Richtlinie unterliegen. Dies ist die Standardeinstellung und keine andere Richtlinie schränkt diese Einstellungen ein.
Warnung! Wenn der Administrator die Standard-App-Berechtigung auf etwas anderes als „ Alle Apps zulassen “ geändert hat, müssen wir unsere benutzerdefinierte App am Ende dieses Dokuments und die „ Teams Apps Studio “-App von Anfang an auf die Whitelist setzen, damit sie von ihnen gesehen werden können die Benutzer in Teams.
- Zu diesem Zeitpunkt wurde unsere Portal-App noch nicht erstellt, sodass wir sie nicht auf die Whitelist setzen können, bis wir die Schritte in diesem Dokument abgeschlossen und die benutzerdefinierte App in den Mandanten-App-Katalog hochgeladen haben.
- Stellen Sie sicher, dass Sie alle vorgenommenen Änderungen speichern, und warten Sie, bis die Richtlinienänderungen wirksam werden.
Erstellen der App
Nachdem wir unsere App- und Berechtigungsrichtlinien vorbereitet haben, können wir die benutzerdefinierte App erstellen, um das mit unserem SharePoint-Portal verknüpfte Symbol in der Navigationsleiste der Teams-App anzuzeigen.
- Melden Sie sich bei der Webversion oder Desktop-Version von Teams als Benutzer an, den wir der „ App-Upload-Richtlinie “ hinzugefügt haben.
- Klicken Sie in Teams auf das App Store-Symbol in der App-Navigationsleiste links von Teams.
- Wenn der Store geöffnet wird, geben Sie „ App Studio “ ein, um die App zu finden, die wir installieren müssen, damit dieser Benutzer unsere benutzerdefinierte App erstellen kann.
- Klicken Sie auf die Schaltfläche „ Hinzufügen “, um die App zu installieren
- Nachdem sich die App Studio App geöffnet hat, klicken Sie auf „ Manifest Editor “ .
- Suchen Sie auf der Registerkarte „Manifest-Editor“ nach „ Neue App erstellen “ .
- Als nächstes sehen Sie den folgenden Bildschirm mit vielen Feldern, die wir ausfüllen müssen. Wir werden ihnen einen Abschnitt nach dem anderen nehmen.
- App-Details Warnung ! Fügen Sie nicht „ Microsoft “ in den Namen ein. Wenn Sie den „Kurznamen“ zu lang machen , wird er abgeschnitten und neben dem Namen wird eine Ellipse angezeigt.
Im Identifikationsbereich müssen Sie auf die Schaltfläche „ Generieren “ klicken, um einen eindeutigen Schlüssel für diese App zu generieren. Sie müssen den „ Paketnamen “ eingeben . Sie können beliebige Namen verwenden, folgen Sie einfach dem oben gezeigten Format. Die „ Version “ muss ebenfalls eingestellt werden.
- Beschreibung Achtung ! Fügen Sie nicht „ Microsoft “ in den Namen ein
Die Entwicklerinformationen geben lediglich an, wer die App und eine Website erstellt hat, auf der Sie mehr über den Entwickler erfahren können. Ich würde vorschlagen, auf eine Seite zu verlinken, auf der die Leute mehr über die Entwicklung und den Zweck der App erfahren können. In diesem Beispiel verweisen wir nur zurück auf die SharePoint-Website, die die Learning Pathways-Website in einem Mandanten startet.
Die URL zur „ Datenschutzerklärung “ verweist auf die Datenschutzerklärung von Microsoft, da dieses Beispiel das Microsoft Learning Pathways Portal verwendet. Die „ Nutzungsbedingungen “ verweisen lediglich auf die Dokumentation für das Learning Pathways Portal. Es wird empfohlen, dass diese URLs nicht auf extern gehostete Websites verweisen. Beim späteren Testen dieser App werden wir die folgenden Warnungen sehen.
Sie benötigen mindestens zwei Logos von der Branding-Seite. Sie müssen genau die in ihrer Beschreibung angegebene Größe haben. Sie haben nun alle Optionen auf der Registerkarte „ Apps-Details “ abgeschlossen. Wechseln Sie nun auf die Registerkarte „ Tabs “ unter „ Fähigkeiten “.
- Klicken Sie auf „ Eine persönliche Registerkarte hinzufügen “
- Wählen Sie auf der Registerkarte Name einen Namen aus, der auf der Webseite des Portals angezeigt wird, wie unten gezeigt.
- Legen Sie eine beliebige Zahl als Entitäts-ID fest.
- Die „ Inhalts-URL “, die wir haben, verweist zurück auf unser Learning Pathways-Portal.
- Die „ Website-URL “, die auf unser Learning Pathways-Portal verweist, klicken Sie auf Speichern.
- Einmaliges Anmelden bei Web-Apps
- Die AAD-Anwendungs-ID in diesem Beispiel gilt für eine SharePoint-Website. Die offizielle Nummer ist 00000003-0000-0ff1-ce00-000000000000. Verwenden Sie für dieses Beispiel keine andere Nummer.
- Die „ Ressourcen-URL “ muss Ihren eindeutigen Mandantennamen anstelle von „ m365x360288 “ enthalten. Drücken Sie nach dem Ausfüllen der Felder auf Speichern.
- Wir haben jetzt die Einrichtung unserer benutzerdefinierten App abgeschlossen.
Testen der App
- Wählen Sie unter der Überschrift „ Fertig stellen “ in der App Studio App „ Testen und verteilen “
- Als nächstes sehen Sie den folgenden Bildschirm mit einer Reihe von Warnungen. Machen Sie sich keine Gedanken über die Warnungen in diesem Anwendungsbeispiel. In einer Produktionsumgebung sollten Sie der Anleitung folgen, sie zu internen URLs zu portieren.
- Wenn Sie die Dinge nicht richtig eingegeben haben, sehen Sie die folgende Warnung.
- Wenn Sie alles richtig gemacht haben, erscheint das App-Installationsprogramm, damit Sie es testen können. Fügen Sie es Ihren Teams hinzu. Bevor Sie auf „Hinzufügen“ klicken, überprüfen Sie die Informationen zum „about“ . Sie werden sehen, wie die Informationen von oben verwendet wurden.
- Nach der App-Installation wird das Learning Pathways Portal geladen, wenn es funktioniert.
Packen der App
- Kehren Sie zur App Studio-App zurück, indem Sie auf die Ellipse in der App-Navigationsleiste klicken.
- Das folgende Fenster wird geöffnet und zeigt die „ App Studio “-App und die „ Contoso Learning “-App an, die wir gerade getestet und unserem Benutzerteam hinzugefügt haben. Klicken Sie auf das Symbol „ App Studio “, um die App neu zu starten. Wählen Sie den „ Manifest-Editor “
- Suchen Sie unter „ Kürzlich erstellte Apps “ nach der App „ Contoso Learning “ und klicken Sie darauf.
- Klicken Sie auf die Registerkarte „ Testen und verteilen “.
- Klicken Sie auf die Schaltfläche „ Herunterladen “, um die App für den Import zu packen.
- Sie sehen ein Popup-Fenster, das angibt, dass das Paket exportiert wurde, und seinen Dateinamen.
- Der Speicherort ist der Download-Ordner auf dem PC. Merken Sie sich diesen Speicherort für den Upload in das Mieter-App-Portal.
Hochladen der App
- Gehen Sie zurück zu Teams und suchen Sie in der App-Navigationsleiste nach dem Symbol „ Apps “.
- Wenn Ihrer Benutzer-ID die richtige Berechtigung zum Hochladen einer benutzerdefinierten App erteilt wurde, können Sie unten in der Liste auf „ Eine benutzerdefinierte App hochladen“ klicken. Klick es an. Klicken Sie dann zum Hochladen auf Ihren Mandanten. Nicht sicher, warum es ein Doppelklick ist. Durchsuchen Sie den Download-Ordner, um unser Paket zu finden, und klicken Sie auf „ Öffnen “ .
- Wenn Sie kein Konto verwenden, das in der von uns erstellten „ Richtlinie zum Hochladen von Apps“ enthalten ist, wird der folgende Fehler angezeigt.
- Bei Erfolg erscheint die App nun im Mandanten-App-Katalog
- Wenn Sie im App-Katalog nach dieser App suchen und auf „Hinzufügen“ klicken, wird die App wie bei der Testinstallation unter der Ellipse installiert. PAUSE! Wir werden die App nicht auf diese Weise installieren. Stattdessen werden wir die App mithilfe unserer „ App-Einrichtungsrichtlinie“ an die App-Navigationsleiste anheften .
Bereitstellen der App
- Suchen Sie die zuvor erstellte App-Setup-Richtlinie und aktivieren Sie das Kontrollkästchen. Klicken Sie dann auf „ Bearbeiten “
- Klicken Sie unter „ Angeheftete Apps “ auf „ Apps hinzufügen “ .
- Suchen Sie nach der App „ Lernen “, wählen Sie sie aus und klicken Sie auf „ Hinzufügen “ . Klicken Sie dann unten auf die Schaltfläche „ Hinzufügen “, um den Bildschirm zu schließen.
- Sie sehen nun die App, wie ich in der App-Navigationsleiste erscheinen werde. Die Standardeinstellung ist unten. Sie können die App markieren und nach oben verschieben. Wenn Sie mit der Position zufrieden sind, klicken Sie auf „ Speichern “ .
Endgültige Lösung
- Jetzt warten wir, bis die Richtlinieneinstellungen auf Microsoft 365-Back-End-Systemen synchronisiert sind, bevor wir die Ergebnisse unserer Arbeit sehen. Unsere neue App wird etwa 2 Stunden lang nicht in der App-Navigationsleiste angezeigt.
- Klicken Sie auf das Symbol „Neue App“ und sehen Sie sich das fertige Projekt an.
