# Importación y exportación

- Human documentation: [https://docs.univer.ai/es-ES/guides/pdfs/features/import-export](https://docs.univer.ai/es-ES/guides/pdfs/features/import-export)

- Agent Markdown: [https://docs.univer.ai/es-ES/guides/pdfs/features/import-export.md](https://docs.univer.ai/es-ES/guides/pdfs/features/import-export.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [pdfs/features/import-export.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/features/import-export.es-ES.mdx)

---

Antes de usar las API del navegador, completa la [integración de importación y exportación](https://docs.univer.ai/es-ES/server/import-export.md). 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](https://docs.univer.ai/es-ES/server/collaboration/examples.md#exchange) demuestra Sheets; verifica por separado otros productos y formatos.

#### Package metadata

```json
{
  "preset": [],
  "plugins": [
    {
      "client": "@univerjs-pro/exchange-client",
      "facade": "@univerjs-pro/exchange-client/facade"
    },
    {
      "client": "@univerjs-pro/pdfs-exchange-client",
      "facade": "@univerjs-pro/pdfs-exchange-client/facade"
    }
  ],
  "license": true,
  "server": true
}
```

## 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 |
| ----------- | ----------- |
| `.pdf`      | `.pdf`      |

## Elegir una ruta de datos

| Ruta         | Conserva una unidad del servidor | Requiere colaboración | Servidor de conversión |
| ------------ | :------------------------------: | :-------------------: | :--------------------: |
| ID de unidad |                Sí                |           Sí          |       Obligatorio      |
| Instantánea  |                No                |           No          |       Obligatorio      |

### Importar a una unidad persistente

La entrada puede ser un `File` del navegador o una URL. Cargue la unidad devuelta mediante el cliente de colaboración configurado.

```ts
const unitId = await univerAPI.importPdfToUnitIdAsync(file)

if (unitId) {
  const pdf = await univerAPI.getCollaboration().loadPdfAsync(unitId)
  console.log(pdf?.getName())
}
```

### Importar a una instantánea

Utilice la importación a instantánea para una unidad PDF local que no deba conservarse como parte de la tarea de conversión:

```ts
const snapshot = await univerAPI.importPdfToSnapshotAsync(file)

if (snapshot) {
  univerAPI.createPdf(snapshot)
}
```

### Exportar y descargar

Exporte una unidad persistente mediante su ID:

```ts
const file = await univerAPI.exportPdfByUnitIdAsync(unitId)

if (file) {
  univerAPI.downloadFile(file, 'project-brief', 'pdf')
}
```

Exporte la instantánea local actual sin conservarla primero:

```ts
const pdf = univerAPI.getActivePdf()

if (pdf) {
  const file = await univerAPI.exportPdfBySnapshotAsync(pdf.save())

  if (file) {
    univerAPI.downloadFile(file, pdf.getName(), 'pdf')
  }
}
```

Estas API devuelven un `File`. La impresión desde el navegador es un flujo independiente que abre el diálogo de impresión del sistema; consulte [Imprimir](https://docs.univer.ai/es-ES/guides/pdfs/features/print.md).

## 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](https://office.univer.ai/showcase/pdfs/custom-import-export) para migrar mediante un plugin personalizado. El ejemplo incluye el código fuente completo para consultarlo en línea y descargarlo.
