# Структура данных книги

- Human documentation: [https://docs.univer.ai/ru-RU/guides/sheets/model/workbook-data](https://docs.univer.ai/ru-RU/guides/sheets/model/workbook-data)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/sheets/model/workbook-data.md](https://docs.univer.ai/ru-RU/guides/sheets/model/workbook-data.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [sheets/model/workbook-data.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/model/workbook-data.ru-RU.mdx)

---

## IWorkbookData

[`IWorkbookData`](https://docs.univer.ai/ru-RU/reference/types/workbook-data.md) представляет снимок книги в Univer Sheets.

### Свойства

| Свойство   | Тип                                              | Описание                                                    |
| ---------- | ------------------------------------------------ | ----------------------------------------------------------- |
| id         | `string`                                         | Уникальный идентификатор книги Univer Sheets.               |
| name       | `string`                                         | Название книги Univer Sheets.                               |
| appVersion | `string`                                         | Версия определения модели Univer.                           |
| locale     | `LocaleType`                                     | Локаль документа.                                           |
| styles     | `Record<string, Nullable<IStyleData>>`           | Ссылки на стили книги.                                      |
| sheetOrder | `string[]`                                       | Массив идентификаторов листов, определяющий порядок листов. |
| sheets     | `{ [sheetId: string]: Partial<IWorksheetData> }` | Объект с данными каждого листа.                             |
| resources? | `IResources`                                     | Хранилище данных плагинов.                                  |

### Пример

```typescript
const workbookData: IWorkbookData = {
  id: 'unique-workbook-id',
  name: 'My Workbook',
  appVersion: '0.10.2',
  locale: LocaleType.EN_US,
  styles: {/* style definitions */},
  sheetOrder: ['sheet1', 'sheet2'],
  sheets: {
    sheet1: {/* sheet data */},
    sheet2: {/* sheet data */},
  },
}
```

### Использование

IWorkbookData — объект для хранения данных в Univer Sheets. В основном он используется для следующих задач:

1. [Создание книги Univer Sheets с помощью IWorkbookData](https://docs.univer.ai/ru-RU/guides/sheets/features/core/sheets-api.md#create-worksheet)
2. [Сохранение IWorkbookData из Univer Sheets](https://docs.univer.ai/ru-RU/guides/sheets/features/core/sheets-api.md#get-workbook-data)

Свойство `resources` используется для хранения данных плагинов. Подробнее см. в разделе [Пользовательская модель плагина](/blog/custom-model).