# Conceptos básicos

- Human documentation: [https://docs.univer.ai/es-ES/guides/sheets/getting-started/quickstart](https://docs.univer.ai/es-ES/guides/sheets/getting-started/quickstart)

- Agent Markdown: [https://docs.univer.ai/es-ES/guides/sheets/getting-started/quickstart.md](https://docs.univer.ai/es-ES/guides/sheets/getting-started/quickstart.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [sheets/getting-started/quickstart.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/getting-started/quickstart.es-ES.mdx)

---

Conozca los plugins, instantáneas, comandos y API de Facade de Univer Sheets. Para crear un editor, continúe con la [instalación y el uso básico](https://docs.univer.ai/es-ES/guides/sheets/getting-started/installation.md).

## Conceptos básicos

Antes de profundizar en Univer, lea este documento para comprender los conceptos básicos de Univer, que le ayudarán a utilizar Univer con mayor fluidez.

Los conceptos básicos incluyen:

* Complemento
* Instantánea
* Comando
* API de Fachada

### Complementos

Todas las características de Univer son proporcionadas por complementos, que son los básicos bloques de construcción de la Universidad. Varios complementos combinados forman una aplicación Univer.

Las responsabilidades de los complementos incluyen:

1. Implementar características, como `@univerjs/sheets-filter` proporciona funcionalidad de filtrado.
2. Proporcionar algunas capacidades básicas, como `@univerjs/engine-render` proporciona capacidades de renderizado.

Puede combinar los complementos de Univer para personalizar una aplicación Univer que cumpla con sus requisitos y evite cargar código innecesario. También puede ampliar la funcionalidad de Univer escribiendo complementos para satisfacer necesidades personalizadas.

#### Enlaces relacionados

1. [Escribir un complemento de importación CSV](/blog/csv-import-plugin) para aprender a escribir un complemento.
2. [Arquitectura de Univer](/blog/univer) para obtener más información sobre el diseño arquitectónico de Univer.

### Instantánea

Debe cargar una instantánea en Univer para cargar un documento. Cada tipo de documento proporciona su propio formato de instantánea. Consulte la documentación API anterior para aprender cómo escribir una instantánea que cumpla con los requisitos de formato:

1. El formato de instantánea de una hoja de cálculo es [`IWorkbookData`](https://docs.univer.ai/es-ES/guides/sheets/model/workbook-data.md#iworkbookdata).
2. El formato de instantánea de un documento es [`IDocumentData`](https://docs.univer.ai/es-ES/reference/types/document-data.md).

Funcional Los complementos pueden almacenar recursos, como imágenes, etc., a través del campo `resources`. Para obtener más información, consulte [Complemento de modelo personalizado](/blog/custom-model).

> [!WARNING: Caution]
> ¡Nota! La instantánea de Univer solo se utiliza para almacenar datos. ¡No refleja el último estado del documento en
> tiempo de ejecución! Si desea guardar el estado del documento como una instantánea, utilice el método para guardar la
> instantánea en la API de Facade.

### Comando

En Univer, todas las modificaciones de datos deben ejecutarse mediante comandos. El enfoque basado en comandos puede realizar un mejor seguimiento de los cambios en los valores, implementar funciones como deshacer, rehacer y edición colaborativa, manejar una lógica asociada compleja entre funciones, etc.

Si desea modificar los datos del documento mediante comandos, consulte [Cómo encontrar el ID del comando](/blog/find-the-command-id). Si elige modificar los datos del documento a través de la API de Facade, la API de Facade preparará los parámetros para usted y ejecutará comandos detrás de escena.

> [!WARNING: Caution]
> **¡No modifique la instantánea directamente!** Esto no tendrá efecto y no activará la actualización de las vistas o la
> interfaz de usuario. Modifique los datos mediante comandos o la API de Facade.

### API de Facade

Debido a la alta complejidad de las aplicaciones de oficina, la arquitectura de Univer también es muy compleja. Para facilitar el uso de Univer a los desarrolladores, proporcionamos la API de Facade, que es un contenedor para los complementos propios de Univer, que proporciona interfaces más simples que facilitan a los desarrolladores el uso de Univer.

La API de Facade se está mejorando activamente. Si tiene alguna pregunta o requisito, envíe un problema en GitHub.

La API Facade es una API de alto nivel que abstrae los detalles subyacentes. Si bien simplifica las tareas comunes, las características complejas pueden requerir comprender la arquitectura de Univer y usar la API de bajo nivel directamente.

#### Enlaces relacionados

1. [Uso de Facade API](https://docs.univer.ai/es-ES/guides/sheets/getting-started/facade.md)
2. [API general](https://docs.univer.ai/es-ES/guides/sheets/features/core/general-api.md)
3. [Univer Sheets API](https://docs.univer.ai/es-ES/guides/sheets/features/core/sheets-api.md)

## Modo preset y modo plugin

Un preset agrupa plugins preconfigurados. Ambos modos ofrecen las mismas capacidades si incluyen los mismos plugins. Los presets simplifican la configuración; el modo plugin permite controlar la composición y la carga.

> [!WARNING]
> Mantenga versiones compatibles entre todas las dependencias de Univer. No vuelva a registrar un plugin que ya esté incluido en un preset.

| Modo plugin                                    | Modo preset                                    |
| ---------------------------------------------- | ---------------------------------------------- |
| Importar explícitamente las extensiones Facade | Extensiones Facade incluidas                   |
| Controlar el orden de registro                 | El preset gestiona sus plugins                 |
| Cargar plugins cuando se necesiten             | Cargar los presets configurados al inicializar |
