Agregar colaboración en tiempo real con Microsoft Fluid Framework

Se aplica a: Desarrollador

Use Fluid Framework cuando la aplicación de SharePoint Embedded necesite estados compartidos en tiempo real, como controles de colaboración, contadores dinámicos, cursores, anotaciones o estados de formulario de varios usuarios. Fluid proporciona bibliotecas cliente para distribuir, sincronizar y guardar datos compartidos.

Preparar SharePoint Embedded

Cree o identifique una aplicación de SharePoint Embedded antes de ejecutar el ejemplo de Fluid. Necesita credenciales de administrador para un inquilino de Microsoft 365, el identificador de cliente de la aplicación, el identificador de tipo de contenedor y al menos un contenedor creado para ese tipo de contenedor.

Si utilizó la extensión SharePoint Embedded Visual Studio Code, use la configuración de ejemplo generada para buscar ContainerTypeId y ClientId. También puede encontrar el ID de cliente en Microsoft Entra ID en Registros de aplicaciones.

Para probar SharePoint Embedded sin coste alguno, cree un tipo de contenedor de prueba. Consulte Creación y configuración de un tipo de contenedor.

Ejecutar el ejemplo de contador de artículos

El item-counter-spe ejemplo se encuentra en el repositorio de ejemplos de Fluid.

git clone https://github.com/microsoft/FluidExamples.git
cd FluidExamples\item-counter-spe

Cree un archivo vacío .env en la carpeta de ejemplo y agregue los identificadores de SharePoint Embedded.

SPE_CLIENT_ID=YOUR_CLIENTID
SPE_CONTAINER_TYPE_ID=YOUR_CONTAINERTYPE_ID
SPE_ENTRA_TENANT_ID=YOUR_ENTRA_TENANT_ID

Instale los paquetes e inicie el servidor de desarrollo.

npm install
npm run dev

Una vez completado el paquete web, abra http://localhost:8080, inicie sesión con las credenciales del inquilino y conceda el consentimiento del administrador para la aplicación cuando se le solicite. Abra la misma dirección URL en otra pestaña del explorador o envíela a otro usuario del mismo espacio empresarial. Los cambios en el contador de artículos se sincronizan entre los clientes conectados.

Si no puede iniciar sesión en el ejemplo o muestra una página en blanco, consulte Solución de problemas para redirigir URI y API permission checks.

Decide qué pertenece a Fluid

Use Fluid para el estado de aplicación colaborativa que se beneficia de la sincronización de baja latencia. Almacene documentos y archivos duraderos en contenedores de SharePoint Embedded. Conserve la salida final empresarial en su propio modelo duradero o en archivos de SharePoint Embedded cuando su escenario necesite auditoría, retención, búsqueda o informes.

Trate los objetos compartidos de Fluid como un estado de colaboración visible para el usuario. No coloque secretos, tokens de acceso, direcciones URL de SAS o respuestas de Graph con privilegios en estructuras de datos compartidas.

Controlar identidad y acceso

La aplicación sigue necesitando el identificador de cliente y el identificador de tipo de contenedor de SharePoint Embedded para adquirir los tokens correctos y los contenedores de acceso. Pruebe el ejemplo con una pestaña, dos pestañas para el mismo usuario y dos usuarios diferentes del inquilino. Compruebe el comportamiento de los usuarios que pueden ver el contenedor, pero no deben editar el estado de colaboración.

Pasar del ejemplo al diseño de la aplicación

Use el ejemplo de contador de elementos para demostrar la configuración del inquilino, el consentimiento y la conectividad del cliente. En su propia aplicación, planifique el comportamiento de reconexión, la actualización de tokens, las transiciones sin conexión, el cambio de contenedor y la limpieza de las sesiones de colaboración que los usuarios abandonan.

Pasos siguientes

• Configurar SharePoint Embedded como un origen de conocimiento de Fundición