Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Entwickler
Verwenden Sie Fluid Framework, wenn Ihre SharePoint Embedded-App einen freigegebenen Echtzeitzustand benötigt, z. B. gemeinsame Steuerelemente, Live-Leistungsindikatoren, Cursor, Anmerkungen oder den Zustand von Formularen mit mehreren Benutzern. Fluid stellt Clientbibliotheken zum Verteilen, Synchronisieren und Speichern freigegebener Daten bereit.
Vorbereiten von SharePoint Embedded
Erstellen oder identifizieren Sie eine SharePoint Embedded-Anwendung, bevor Sie das Fluid-Beispiel ausführen. Sie benötigen Administratoranmeldeinformationen für einen Microsoft 365-Mandanten, die Anwendungsclient-ID, die Containertyp-ID und mindestens einen Container, der für diesen Containertyp erstellt wurde.
Wenn Sie die SharePoint Embedded Visual Studio Code-Erweiterung verwendet haben, verwenden Sie die generierte Beispielkonfiguration, um nach und ClientIDzu suchenContainerTypeId. Die Client-ID finden Sie auch in Microsoft Entra ID unter App-Registrierungen.
Um SharePoint Embedded kostenlos zu testen, erstellen Sie einen Testcontainertyp. Weitere Informationen finden Sie unter Erstellen und Konfigurieren eines Containertyps.
Ausführen des Beispiels für den Elementzähler
Das item-counter-spe Beispiel befindet sich im Repository Fluid Examples.
git clone https://github.com/microsoft/FluidExamples.git
cd FluidExamples\item-counter-spe
Erstellen Sie eine leere .env Datei im Beispielordner, und fügen Sie die SharePoint Embedded-Bezeichner hinzu.
SPE_CLIENT_ID=YOUR_CLIENTID
SPE_CONTAINER_TYPE_ID=YOUR_CONTAINERTYPE_ID
Installieren Sie Pakete, und starten Sie den Entwicklungsserver.
npm install
npm run dev
Öffnen https://localhost:8080Sie nach Abschluss von Webpack , melden Sie sich mit Mandantenanmeldeinformationen an, und erteilen Sie die Administratoreinwilligung für die App, wenn Sie dazu aufgefordert werden. Öffnen Sie dieselbe URL auf einer anderen Browserregisterkarte, oder senden Sie sie an einen anderen Benutzer im selben Mandanten. Änderungen am Elementzähler werden über verbundene Clients hinweg synchronisiert.
Entscheiden, was in Fluid gehört
Verwenden Sie Fluid für den gemeinsamen Anwendungszustand, der von der Synchronisierung mit geringer Latenz profitiert. Speichern sie dauerhafte Dokumente und Dateien in SharePoint Embedded-Containern. Speichern Sie die endgültige Geschäftsausgabe in Ihrem eigenen dauerhaften Modell oder in SharePoint Embedded-Dateien, wenn Ihr Szenario Überwachung, Aufbewahrung, Suche oder Berichterstellung erfordert.
Behandeln Sie freigegebene Fluid-Objekte als vom Benutzer sichtbaren Zusammenarbeitszustand. Platzieren Sie keine Geheimnisse, Zugriffstoken, SAS-URLs oder privilegierte Graph-Antworten in freigegebenen Datenstrukturen.
Behandeln von Identität und Zugriff
Ihre App benötigt weiterhin die SharePoint Embedded-Client-ID und containertyp-ID, um die richtigen Token und Zugriffscontainer abzurufen. Testen Sie das Beispiel mit einer Registerkarte, zwei Registerkarten für denselben Benutzer und zwei verschiedenen Benutzern aus dem Mandanten. Überprüfen Sie das Verhalten von Benutzern, die den Container anzeigen können, aber den Zustand der Zusammenarbeit nicht bearbeiten sollten.
Wechseln vom Beispiel zum App-Design
Verwenden Sie das Beispiel für den Elementzähler, um die Mandanteneinrichtung, die Zustimmung und die Clientkonnektivität nachzuweisen. Planen Sie in Ihrer eigenen App das Verhalten der erneuten Verbindung, tokenaktualisierung, Offlineübergänge, Containerwechsel und Bereinigung für gemeinsame Sitzungen, die Benutzer abbrechen.