# Univer Boards API

> Aprende a usar la API Facade en una aplicación Univer Boards.

- Human documentation: [https://docs.univer.ai/es-ES/guides/boards/features/core/boards-api](https://docs.univer.ai/es-ES/guides/boards/features/core/boards-api)

- Agent Markdown: [https://docs.univer.ai/es-ES/guides/boards/features/core/boards-api.md](https://docs.univer.ai/es-ES/guides/boards/features/core/boards-api.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [boards/features/core/boards-api.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/boards/features/core/boards-api.es-ES.mdx)

---

La API de Facade proporciona una capa orientada a la aplicación sobre los servicios y modelos de unidades de Univer. Úselo para operaciones comunes del tablero, como crear tableros, leer páginas activas, agregar elementos, actualizar contenedores y administrar carriles.

> [!WARNING: Precaución]
> Las mutaciones de Board son síncronas y devuelven `boolean` o un identificador anulable. Compruebe el valor devuelto.

## Habilite la entrada de fachada

Los tableros se distribuyen como complementos de Web SDK. Importe la entrada de fachada para la capacidad del tablero utilizada por su aplicación:

```ts
import { FUniver } from '@univerjs/core/facade'
import '@univerjs-pro/boards/facade'
```

Cree el objeto API después de que se registren la instancia de Univer y los complementos necesarios:

```ts
const univerAPI = FUniver.newAPI(univer)
```

## Cree y lea un tablero

Utilice `createBoard` para crear una unidad de tablero a través de la capa de fachada. En el código de configuración de nivel inferior, cree la unidad con `univer.createUnit(UniverInstanceType.UNIVER_BOARD, snapshot)`.

```ts
const board = univerAPI.createBoard({
  id: 'board-demo',
  name: 'Board Demo',
})

const activeBoard = univerAPI.getActiveBoard()
const sameBoard = univerAPI.getBoard(board.getId())
```

## Continuar con las funciones principales

El objeto `FBoard` devuelto es el punto de entrada a la página activa y su contenido. Continúa con las guías específicas para ver las operaciones detalladas:

* [Elementos](https://docs.univer.ai/es-ES/guides/boards/features/core/elements.md) explica cómo leer, insertar, conectar, transformar, organizar y eliminar elementos del Board.
* [Contenedores y carriles](https://docs.univer.ai/es-ES/guides/boards/features/core/containers.md) explica los grupos enmarcados, la pertenencia y la estructura de los carriles.

## Referencia

* [API general](https://docs.univer.ai/es-ES/guides/boards/features/core/general-api.md)
* [Referencia de fachada de tableros](https://docs.univer.ai/es-ES/reference/facade/board.md)
* [Modelo de datos del tablero](https://docs.univer.ai/es-ES/guides/boards/model/board-data.md)
* [Elementos del tablero](https://docs.univer.ai/es-ES/guides/boards/model/board-elements.md)