Server SDK
Prepara los servicios de documentos, el almacenamiento y los permisos de acceso de tu aplicación.
Univer Server SDK ofrece módulos combinables. Integra los que necesites en tu backend y despliega esa aplicación. La autenticación, los permisos, la propiedad de documentos, el almacenamiento de archivos y la operación son responsabilidad de la aplicación.
Esta página trata la configuración del backend, el almacenamiento y los permisos. La integración de colaboración conecta el editor con documentos compartidos. La integración de intercambio de archivos cubre subida, conversión y descarga. Sigue la guía de la función que necesites. Si requiere licencia, empieza por configurar la licencia. La edición solo en el navegador no necesita un servicio de colaboración.
Orden de integración
- Quick Start: comprobar edición bidireccional en dos contextos de navegador independientes.
- Persistencia: reiniciar SQLite y comprobar el valor.
- Identidad y permisos: verificar editor y viewer.
- Frontend de negocio: sustituir identidad, creación de documentos y URL de demostración.
- Extensiones: añadir historial, comentarios, Worktree o Exchange después del flujo básico. Para conversión sola, empezar por Exchange.
Elegir los servicios necesarios
| Necesidad | Preparación del backend | Guía |
|---|---|---|
| Edición de documentos compartidos | Collaboration SDK, almacenamiento y permisos | Inicio rápido de colaboración |
| Importar y exportar archivos Office | Conversión, subidas, consultas de tareas y descargas | Conversión de archivos y ejemplo Exchange |
| Historial o comentarios compartidos | Sus respectivos servicios, almacenamiento y permisos | Módulos de extensión |
Elige solo las capacidades necesarias. Convertir archivos no requiere edición colaborativa. Prepara el entorno de los SDK y mantén compatibles las versiones de los paquetes Univer.
Conectar la aplicación y el almacenamiento
Ejecuta el ejemplo del servicio elegido y conéctalo al backend. Para documentos colaborativos, tu aplicación crea el documento, registra su propietario y devuelve el ID al navegador. Consulta las API de creación en Límites de los módulos. Tu aplicación sigue gestionando usuarios, proyectos y carpetas.
El ejemplo de colaboración usa almacenamiento en memoria y pierde el contenido al reiniciar. Sigue Adaptadores de base de datos para conectar una base de datos y verifica que los documentos guardados sobrevivan al reinicio.
La conversión también necesita almacenar y limpiar subidas, tareas y descargas. Sigue el ejemplo Exchange.
Conectar el inicio de sesión y los permisos
Sigue Identidad y autorización para validar las credenciales existentes y comprobar si un usuario puede leer o modificar un documento. Sustituye los usuarios fijos y las reglas que permiten todo del ejemplo.
Protege las lecturas, conexiones de colaboración, envíos de cambios y cualquier historial, comentario o descarga habilitados. Un editor de solo lectura en el navegador no sustituye las comprobaciones del servidor.
Desplegar y conectar el frontend
Despliega las interfaces en el dominio de tu aplicación. Para colaborar, los proxies deben reenviar HTTP y WebSocket; las páginas HTTPS deben usar WSS. Limita las subidas y gestiona los fallos y tiempos de espera de conversión. Para pasar de una sola máquina a un nodo de importación y exportación separado y a varios nodos de colaboración, sigue la Guía de despliegue.
Cuando el backend esté listo, completa la integración correspondiente:
- Integración de colaboración: conecta el editor, crea y abre documentos compartidos y verifica la sincronización.
- Integración de intercambio de archivos: conecta subida, conversión y descarga y comprueba archivos reales.
¿Cómo es esta guía?