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.

API de fachada

Importar

import '@univerjs-pro/exchange-client/facade'import '@univerjs-pro/sheets-exchange-client/facade'

Importar .xlsx

Importar el archivo .xlsx y obtener unitId

Cuando la edición colaborativa está habilitada, cada documento tiene un unitId único. El uso de univerAPI.importSheetToUnitIdAsync 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.importSheetToUnitIdAsync(file)if (unitId) {  await univerAPI.getCollaboration().loadSheetAsync(unitId)}

Importe el archivo .xlsx y obtenga IWorkbookData

Usar univerAPI.importSheetToSnapshotAsync para importar un archivo .xlsx devolverá los datos del documento en el formato IWorkbookData.

// Accept a File objectconst snapshot = await univerAPI.importSheetToSnapshotAsync(file)// Or accept a remote file URL// const snapshot = await univerAPI.importSheetToSnapshotAsync('https://example.com/filename.xlsx');// Create a new workbook via snapshotif (snapshot) univerAPI.createWorkbook(snapshot)

Exportar .xlsx

Exportar .xlsx archivo usando unitId

Cuando la edición colaborativa está habilitada, cada documento tiene un unitId único. El uso de univerAPI.exportSheetByUnitIdAsync con el parámetro unitId devolverá un objeto File.

const fWorkbook = univerAPI.getActiveWorkbook()const unitId = fWorkbook.getId()const file = await univerAPI.exportSheetByUnitIdAsync(unitId)// Download the file through the Facade APIif (file) univerAPI.downloadFile(file, 'univer', 'xlsx')

Exportar el archivo .xlsx usando IWorkbookData

Usar univerAPI.exportSheetBySnapshotAsync con IWorkbookData devolverá un objeto File.

const fWorkbook = univerAPI.getActiveWorkbook()const snapshot = fWorkbook.save()const file = await univerAPI.exportSheetBySnapshotAsync(snapshot)// Download the file through the Facade APIif (file) univerAPI.downloadFile(file, 'univer', 'xlsx')

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.