English | Online Meeting Link

Diese Anleitung verteilt Online Meeting Link als benutzerdefinierte Anwendung über die Kataloge Ihrer Organisation, auch als Sideloading bezeichnet. Die App wird nicht im öffentlichen Teams-Store veröffentlicht. Entwickler-Debugmanifeste sind dafür nicht erforderlich.

Voraussetzungen

  • Ein Microsoft-365-Mandant mit SharePoint Online, Teams und einem mandantenweiten App-Katalog.
  • Berechtigungen zum Hochladen und Bereitstellen von Paketen in diesem App-Katalog sowie Teams-Verwaltungsrechte für App und Rollout.
  • Ein Administrator, der Microsoft-Graph-Berechtigungen über den SharePoint-API-Zugriff genehmigen darf. Verwenden Sie für die Graph-Genehmigung einen globalen Administrator; SharePoint-Verwaltungsrechte allein reichen dafür nicht aus.
  • Testbenutzer mit SharePoint-/Teams-Zugriff, erforderlichen Lizenzen und der Berechtigung, gemäß den Organisationsrichtlinien Teams-Besprechungen zu erstellen.
  • Ein geprüftes Freigabepaket. Der aktuelle Quellstand verwendet SPFx 1.24.1; führen Sie vor dem Produktiveinsatz die Abnahme im eigenen Mandanten durch.

Der Release-Verantwortliche muss vor der Paketierung Entwicklername, Website, Datenschutz-URL und Nutzungsbedingungen in der Lösungskonfiguration ergänzen. Diese Felder sind im aktuellen Quellstand leer.

1. Paket beschaffen

Der Produktionsbuild in src/spfx-kyanis-onlinemeeting verwendet npm run build. Das Ergebnis liegt relativ zu diesem Verzeichnis unter:

  sharepoint/solution/spfx-kyanis-onlinemeeting.sppkg

Verwenden Sie das freigegebene .sppkg, kein Quellcodearchiv und kein Paket der Vorgängeranwendung. Die Lösungs-ID lautet 1f482fa7-0e09-413d-8dda-e741d014f3fc, die Komponenten-ID 4bd25887-288a-414d-a098-ef9b0d051779. Bewahren Sie das zuletzt freigegebene Paket auf und dokumentieren Sie die bereitgestellte Version.

2. Hochladen und mandantenweit bereitstellen

  1. Öffnen Sie im SharePoint Admin Center Weitere Funktionen > Apps und anschließend den mandantenweiten App-Katalog beziehungsweise die App-Verwaltung.
  2. Laden Sie spfx-kyanis-onlinemeeting.sppkg hoch. Im klassischen Katalog verwenden Sie Apps für SharePoint. Prüfen Sie bei einem Update vor dem Ersetzen die vorhandene Lösungs-ID.
  3. Prüfen Sie den Vertrauens-/Bereitstellungsdialog und angeforderte Zugriffe.
  4. Aktivieren Sie die Option, die Lösung auf allen Websites der Organisation verfügbar zu machen. Bestätigen Sie je nach Katalogoberfläche mit Bereitstellen oder App aktivieren.
  5. Prüfen Sie, dass die Bereitstellung ohne Fehler abgeschlossen wurde.

Online Meeting Link setzt skipFeatureDeployment: true und ermöglicht damit die mandantenweite Bereitstellung. Clientseitige Ressourcen sind im Paket enthalten. Eine gesonderte App-Installation auf jeder Website ist nicht erforderlich. Mandantenweite Verfügbarkeit fügt jedoch keinen Webpart auf Seiten ein, installiert keine Teams-App und genehmigt keinen Graph-Zugriff.

3. Microsoft-Graph-Zugriff genehmigen

  1. Öffnen Sie im SharePoint Admin Center Erweitert > API-Zugriff.
  2. Prüfen Sie die ausstehende Anforderung dieser Bereitstellung für die Ressource Microsoft Graph, Bereich OnlineMeetings.ReadWrite.
  3. Lassen Sie den berechtigten Administrator die Anforderung nach Sicherheitsprüfung genehmigen. Ist der Bereich bereits genehmigt, prüfen Sie stattdessen die bestehende Genehmigung.
  4. Kontrollieren Sie den Eintrag in der Liste genehmigter Berechtigungen.

Es handelt sich um delegierten Zugriff über SPFx: Online Meeting Link erstellt Besprechungen als angemeldeter Benutzer über POST /me/onlineMeetings. Ersetzen Sie dies nicht durch Anwendungsberechtigungen. Ein geheimer Clientschlüssel oder eine separate App-Registrierung ist für diese Anleitung nicht erforderlich. SPFx-API-Genehmigungen werden von SPFx-Lösungen im Mandanten gemeinsam genutzt und sind keine isolierte Sicherheitsgrenze pro App. Die Genehmigung ersetzt keine Benutzerlizenzen, Besprechungsrichtlinien oder Zugriffskontrollen.

4. SharePoint prüfen

  1. Bearbeiten Sie mit einem berechtigten Konto eine moderne SharePoint-Seite.
  2. Fügen Sie Online Meeting Link beziehungsweise Teams-Besprechung aus der Webpart-Auswahl hinzu und veröffentlichen Sie die Seite.
  3. Öffnen Sie die Seite als Testbenutzer. Geben Sie Betreff sowie gültige Start- und Endzeit ein.
  4. Erstellen Sie eine Besprechung, prüfen Sie die Beitrittsinformationen und kopieren Sie diese in die vorgesehene Zielanwendung. Prüfen Sie, ob der Beitrittslink geöffnet werden kann.

Die App versendet keine Einladungen und erstellt keinen Outlook-Kalendereintrag. Auch der Vollseiten-Host ist als unterstützt deklariert; testen Sie ihn, falls Ihre Bereitstellung ihn verwendet.

5. App in Teams veröffentlichen

  1. Wählen Sie im mandantenweiten App-Katalog die bereitgestellte Lösung Online Meeting Link aus.
  2. Verwenden Sie Zu Teams hinzufügen (Add to Teams) oder Mit Teams synchronisieren (Sync to Teams). Die Bezeichnung hängt von der Katalogoberfläche ab.
  3. Warten Sie auf die Bestätigung. SharePoint veröffentlicht das im Lösungspaket enthaltene, entwicklerseitig erstellte TeamsSPFxApp.zip im Teams-Katalog der Organisation. Das Paket enthält deutsche und englische App-Beschreibungen.
  4. Öffnen Sie Teams Admin Center > Teams-Apps > Apps verwalten. Prüfen Sie Identität, Status und Verfügbarkeit der richtigen App für Ihre Testbenutzer. Wenden Sie die App-Prüfungs- und Zugriffsregeln Ihrer Organisation an.
  5. Fügen Sie die App als Testbenutzer aus dem Organisationskatalog in Teams hinzu. Prüfen Sie die persönliche App. Das aktuelle Paket deklariert keine Kanal- oder Besprechungsregisterkarte.

Katalogveröffentlichung ist keine automatische Installation. Für eine ausgewählte Zielgruppe folgen Sie der Gruppeninstallation mit Anheften. Branding wird unter Teams-Anpassung beschrieben.

Abnahme und Fehlerbehebung

Führen Sie diese Prüfungen im Zielmandanten durch. Eine lokale Vorschau ersetzt sie nicht.

Symptom/PrüfungZu kontrollieren
Webpart nicht verfügbarRichtiger Mandantenkatalog, erfolgreiche Bereitstellung, mandantenweite Option, Seitenberechtigungen und aktualisierter Seiteneditor
Besprechungserstellung verweigertGenehmigter Graph-Bereich, angemeldetes Konto, Lizenzen, Besprechungsrichtlinien und angezeigter Fehler
App fehlt in TeamsErfolgreiches Hinzufügen/Synchronisieren, richtige App-Identität, erlaubte Zielgruppe und Katalogverteilung
App vorhanden, aber nicht installiert oder angeheftetGesonderte Installationszuweisung und wirksame Setuprichtlinie
Kopieren schlägt fehlZwischenablageberechtigungen von Browser/Client; angebotene Ausgabe zum manuellen Kopieren verwenden
Erstellungsergebnis unklarNetzwerk-/Serverfehler können nach der Erstellung auftreten; Warnung vor einem erneuten Versuch beachten, um Duplikate zu vermeiden

Prüfen Sie deutsche und englische Oberfläche, die verwendeten Hosts, helle, dunkle und kontrastreiche Teams-Themes sowie das Kopieren in Teams Desktop und Web. Dokumentieren Sie Konto, Paketversion, Client, Fehler und Ergebnis, ohne unnötig Besprechungsdetails zu erfassen.

Updates und Rollback

Behalten Sie für ein geprüftes Update Lösungs- und Komponentenidentitäten bei. Verwenden Sie ein passend versioniertes Paket, ersetzen und verteilen Sie es im selben Katalog, prüfen Sie neue Berechtigungsanforderungen, synchronisieren Sie erneut mit Teams und wiederholen Sie die Abnahme. Prüfen Sie danach Branding und Gruppenzuweisungen.

Stoppen Sie bei einem fehlerhaften Update den weiteren Rollout. Der Release-Verantwortliche soll aus dem zuletzt freigegebenen Quellstand ein korrekt versioniertes Rollback-Paket erstellen. Setzen Sie nicht voraus, dass eine niedrigere Paketversion hochgeladen werden kann. Erneut bereitstellen, synchronisieren und testen. Löschen Sie nicht als schnellen Rollback die Lösung und entziehen Sie keine gemeinsam genutzten SPFx-API-Genehmigungen.

Microsoft Learn