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 Echtzeitstatus benötigt, z. B. kollaborative Steuerelemente, Livezähler, Cursor, Anmerkungen oder einen Formularstatus für mehrere Benutzer. Fluid bietet Clientbibliotheken zum Verteilen, Synchronisieren und Speichern freigegebener Daten.
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 zu finden ContainerTypeIdClientId. Sie finden die Client-ID 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 Fluid Examples-Repository.
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-IDs hinzu.
SPE_CLIENT_ID=YOUR_CLIENTID
SPE_CONTAINER_TYPE_ID=YOUR_CONTAINERTYPE_ID
SPE_ENTRA_TENANT_ID=YOUR_ENTRA_TENANT_ID
Installieren Sie Pakete, und starten Sie den Entwicklungsserver.
npm install
npm run dev
Öffnen Sie http://localhost:8080nach Abschluss von Webpack , melden Sie sich mit Mandantenanmeldeinformationen an, und erteilen Sie die Administratorzustimmung für die App, wenn Sie dazu aufgefordert werden. Öffnen Sie dieselbe URL in einer anderen Browserregisterkarte, oder senden Sie sie an einen anderen Benutzer im selben Mandanten. Änderungen am Elementzähler werden über verbundene Clients hinweg synchronisiert.
Wenn Sie sich nicht beim Beispiel anmelden können oder eine leere Seite angezeigt wird, finden Sie weitere Informationen unter Problembehandlung für Umleitungs-URI- und API-Berechtigungsprüfungen.
Entscheiden Sie, was in Fluid gehört
Verwenden Sie Fluid für einen kollaborativen Anwendungsstatus, der von einer Synchronisation mit geringer Latenz profitiert. Speichern Sie dauerhafte Dokumente und Dateien in SharePoint Embedded-Containern. Übernehmen Sie die endgültige Geschäftsausgabe dauerhaft in Ihrem eigenen Modell oder in eingebetteten SharePoint-Dateien, wenn Ihr Szenario Überwachung, Aufbewahrung, Suche oder Berichterstellung erfordert.
Behandeln freigegebener Fluid-Objekte als vom Benutzer sichtbaren Status für die Zusammenarbeit. Platzieren Sie keine Geheimnisse, Zugriffstoken, SAS-URLs oder privilegierten Graph-Antworten in freigegebenen Datenstrukturen.
Behandeln von Identität und Zugriff
Ihre App benötigt weiterhin die SharePoint Embedded-Client-ID und die Containertyp-ID, um die richtigen Token abzurufen und auf Container zuzugreifen. 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 für Benutzer, die den Container anzeigen, aber den kollaborativen Status nicht bearbeiten sollten.
Wechseln vom Beispiel zum App-Design
Verwenden Sie das Elementindikatorbeispiel, um die Mandanteneinrichtung, die Zustimmung und die Clientkonnektivität nachzuweisen. Planen Sie in Ihrer eigenen App das Verhalten der Wiederverbindung, die Tokenaktualisierung, Offlineübergänge, das Wechseln von Containern und die Bereinigung für kollaborative Sitzungen, die Benutzer abbrechen.