Importación y exportación
Antes de usar las API del navegador, completa la integración de importación y exportación. Tu aplicación debe implementar los contratos de carga, conversión, consulta de tareas y descarga autorizada. Las API de snapshot también necesitan un backend de conversión. El ejemplo Exchange demuestra Sheets; verifica por separado otros productos y formatos.
Formatos compatibles
La tabla describe las API del navegador de esta página. La conversión de archivos Office requiere un backend compatible con el mismo tipo de documento y formato.
| Importación | Exportación |
|---|---|
.doc, .docx | .docx |
Fachada API
Importación
Plugin mode note
Sólo el modo complemento requiere importar manualmente el paquete Facade. El modo Preestablecido ya incluye el paquete Fachada correspondiente, por lo que no se necesita ninguna importación adicional.
import '@univerjs-pro/exchange-client/facade'import '@univerjs-pro/docs-exchange-client/facade'Importando .docx
Importe el archivo .docx y obtenga unitId
Caution
Este método requiere colaboración: crea un documento de servidor y devuelve un unitId. Utilice la importación de
instantáneas si la colaboración no está habilitada.
Cuando la edición colaborativa está habilitada, cada documento tiene un unitId único. El uso de univerAPI.importDocToUnitIdAsync con el parámetro file devolverá el unitId, que se puede utilizar para acceder al documento. El parámetro file puede ser un objeto File o una URL de archivo remoto.
import '@univerjs-pro/collaboration-client/facade'const unitId = await univerAPI.importDocToUnitIdAsync(file)if (unitId) { await univerAPI.getCollaboration().loadDocAsync(unitId)}Importe el archivo .docx y obtenga IDocumentData
La importación de instantáneas no requiere colaboración. Utilice la importación unitId para documentos
colaborativos.
Utilizar univerAPI.importDocToSnapshotAsync para importar un archivo .docx devolverá los datos del documento en el formato IDocumentData.
// Accept a File objectconst snapshot = await univerAPI.importDocToSnapshotAsync(file)// Or accept a remote file URL// const snapshot = await univerAPI.importDocToSnapshotAsync('https://example.com/filename.docx');// Create a new document via snapshotif (snapshot) univerAPI.createDocument(snapshot)Exportando .docx
Exportar archivo .docx usando unitId
Caution
La exportación unitId requiere colaboración. Si la colaboración no está habilitada, utilice la exportación de
instantáneas.
Cuando la edición colaborativa está habilitada, cada documento tiene un unitId único. El uso de univerAPI.exportDocByUnitIdAsync con el parámetro unitId devolverá un objeto File.
const fDocument = univerAPI.getActiveDocument()const unitId = fDocument.getId()const file = await univerAPI.exportDocByUnitIdAsync(unitId)// Download the file through the Facade APIif (file) univerAPI.downloadFile(file, 'univer', 'docx')Exportar el archivo .docx usando IDocumentData
El uso de univerAPI.exportDocBySnapshotAsync con IDocumentData devolverá un File objeto.
const fDocument = univerAPI.getActiveDocument()const snapshot = fDocument.save()const file = await univerAPI.exportDocBySnapshotAsync(snapshot)// Download the file through the Facade APIif (file) univerAPI.downloadFile(file, 'univer', 'docx')Eliminación de los menús y las interacciones de UI de importación y exportación integrados
Univer eliminó los menús y las interacciones de UI de importación y exportación integrados. Los servicios subyacentes y las API de Facade siguen disponibles.
Si tu aplicación necesita conservar los menús y las interacciones de UI de importación y exportación existentes, consulta el ejemplo de migración de los menús y las interacciones de UI de importación y exportación integrados para migrar mediante un plugin personalizado. El ejemplo incluye el código fuente completo para consultarlo en línea y descargarlo.
¿Cómo es esta guía?