# Настройте топологию

## Основные понятия

**Холст**: это интерактивная рабочая область на странице редактирования топологии, где визуально отображаются все блоки и их ячейки.

**Блок**: логическая единица структуры. Блоком может быть любой элемент топологии (склад, контейнер, секция, линия, стойка, полка и т.д.), который размещается на холсте.

**Ячейка**: место для размещения одного устройства. Ячейки добавляются внутри блока.

**Индекс**: уникальный адрес ячейки, автоматически формируемый из названий объекта и блоков.

## Как создать топологию

При создании нового объекта (facility) система автоматически создает для него пустую топологию. Она сразу отображается на странице "Настройки" - "**Топология**".

<figure><img src="/files/Qujl3NDvhggs82qRllPl" alt=""><figcaption></figcaption></figure>

Чтобы наполнить топологию структурой, перейдите в нее и добавьте блоки (см. раздел «Как создать блок»).

> ⚠️ Каждый объект связан ровно с одной топологией. Создать вторую топологию для того же объекта невозможно.

## Как редактировать топологию

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. Внесите изменения: добавьте, отредактируйте или удалите блоки.
5. Нажмите на кнопку "**Сохранить**", чтобы зафиксировать изменения.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2FNRgtePDe5XvbpNTZpK3j%2FEdit%20topology_%D0%A0%D0%A3.mp4?alt=media&token=712212de-cb7e-4879-9aa7-7aa89768da6b>" %}

## Как создать блок

Блоки - основные элементы топологии. Они создаются на холсте и отображаются в виде карточек.

#### Родительский блок

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. На холсте нажмите на кнопку "**Добавить блок**", либо нажмите на иконку **⋮** на карточке любого существующего блока и выберите "**Добавить**" - откроется окно создания блока.
5. В открывшемся окне заполните параметры:
   * **Шаг 1 - Детали**

     Заполните основные параметры блока:

     * "**Название блока**" - единственное обязательное поле.
     * **"Ячеек в ряд"** и "**Уровни"** - задают количество ячеек по горизонтали и вертикали, соответственно.
     * Справа отображается превью - она обновляется в реальном времени при изменении значения.
   * **Шаг 2 - Настройки индекса**

     Настройте логику автоматической нумерации ячеек:

     * "**Начальный номер**" - начальное значение нумерации ячеек внутри блока.
     * "**Метод нумерации**" - определяет, перезапускается ли нумерация ячеек в блоке для каждого уровня или продолжается инкрементально.
     * "**Направление нумерации**" - направление заполнения индексов (слева направо, сверху вниз и т.д.).
     * Справа отображается превью - она обновляется в реальном времени при изменении значения.
   * **Шаг 3 - Сетка вложенных блоков**

     Задайте параметр отображения вложенных блоков на холсте:

     * **Blocks per row** / **Блоков в ряд** - определяет, сколько дочерних блоков будет располагаться в одном ряду, если позже внутрь этого блока будут добавлены вложенные блоки.
     * Справа отображается превью - она обновляется в реальном времени при изменении значения.
6. Нажмите на кнопку **Добавить** - блок отобразится на холсте.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2FOG2IqB33fpi2eJQV7Zzl%2FCreate%20block.mp4?alt=media&token=470a1d0b-c8b2-46f3-a354-4800b46cd839>" %}

#### Вложенный блок

Вложенный блок создается внутри уже существующего блока и позволяет детализировать структуру.

1. На холсте найдите нужный блок и нажмите на иконку **⋮** на его карточке.
2. Выберите "**Добавить**" - откроется модальное окно "**Добавить блок**".
3. Заполните параметры аналогично родительскому блоку.
4. Нажмите "**Добавить**" - блок отобразится на холсте.

**Пример структуры:** Container → Rack → ячейки.

> ⚠️ Максимальная глубина вложенности - 6 уровней блоков.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2FhxAUV0jU7HgGKFdsdtKW%2FInner%20block.mp4?alt=media&token=1bdfc24d-5405-45eb-97bb-9ace2e88a1a2>" %}

## Как дублировать блок

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. Нажмите на иконку **⋮** на карточке нужного блока и выберите "**Дублировать**".
5. В открывшемся модальном окне "Дублировать блок" выберите количество дубликатов.
6. Копии блока появятся на холсте рядом с исходным блоком со идентичными параметрами.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2F1SkWyhJoHvfQNeXT7f59%2FDublicate%20block.mp4?alt=media&token=cba77ac8-6575-47a1-907c-a33d76300765>" %}

## Как редактировать блок

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. Нажмите на иконку **⋮** на карточке нужного блока и выберите "**Редактировать**".
5. Внесите необходимые изменения в параметры блока.
6. Нажмите на кнопку "**Сохранить**".

> ⚠️ Если в блоке есть устройства, при сохранении изменений:
>
> * устройства будут перемещены в "Неимпортированные";
> * резервации ячеек будут сброшены.
>
> Система отобразит предупреждение перед подтверждением действия.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2Fa7GV3pjOlA01cbQudvvv%2FEdit%20block.mp4?alt=media&token=612b3911-c0dc-4f3b-9baa-e1feff14f760>" %}

## Как переместить блок

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. Нажмите на иконку **⋮** на карточке нужного блока и выберите "**Переместить**".
5. Укажите новое расположение блока в структуре топологии.
6. Подтвердите перемещение.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2FzHruIpsKIHBfPQ7O2vSB%2FMove%20block.mp4?alt=media&token=842b0c8f-a306-4410-87dd-26f0d18d8ae2>" %}

## Как удалить блок

1. Перейдите на страницу "Настройки" - "**Топология**".
2. Нажмите на иконку "**Редактировать топологию**" напротив нужной топологии.
3. Откроется страница "**Редактировать топологию**".
4. Нажмите на иконку **⋮** на карточке нужного блока и выберите "**Удалить**".
5. Подтвердите удаление в модальном окне.

> ⚠️ Удаление блока удаляет все вложенные блоки и ячейки внутри него. Устройства из удаляемого блока перемещаются в "Неимпортированные".

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3AuVab2ie4lSGVzgH5P2%2Fuploads%2FoxodVdpfnIo38pPmB13h%2FDelete%20block.mp4?alt=media&token=f11b0c1f-a524-4aff-ba2d-2db131456feb>" %}

## Как использовать топологию в работе

После настройки топология становится инструментом для ежедневной работы техников и операторов.

* **Просмотр загруженности.** На холсте каждая карточка блока показывает соотношение занятых и общих ячеек в формате X / Y. Например, 48 / 60 означает, что 12 ячеек свободны. Тот же показатель отображается в списке топологий на странице "Топология" в колонках "Занятые ячейки" и "Всего ячеек".
* **Визуальное различие ячеек.** Занятые ячейки отображаются темнее, свободные - светлее. Это позволяет мгновенно оценить загруженность блока без ручных подсчетов.

  <figure><img src="/files/qbCbWSTMNQfBZRVPMq6b" alt=""><figcaption></figcaption></figure>
* **Просмотр деталей устройства.** Клик по занятой ячейке открывает поповер с информацией об устройстве: индекс, серийный номер, IP-адрес, MAC. Любое значение можно скопировать в буфер обмена, при необходимости.

  <figure><img src="/files/CyVXLDn1PlJxeev22cfG" alt=""><figcaption></figcaption></figure>
* **Навигация по холсту.** Для удобного взаимодействия со структурой объекта холст поддерживает масштабирование (кнопки + / − или скролл мышью) и перемещение (зажмите холст и потяните в нужную сторону). Кнопка Fit view возвращает обзор ко всей топологии.

## FAQ

<details>

<summary><strong>Зачем нужна топология?</strong></summary>

Топология позволяет грамотно организовать размещение оборудования, упростить навигацию и ускорить процессы на объекте. Это повышает производительность и помогает предотвратить сбои или задержки в работе.

</details>

<details>

<summary><strong>Можно ли создать блок без ячеек?</strong></summary>

Да. Блоки могут быть пустыми - без ячеек. Ячейки можно добавить позже при редактировании блока. Пустой блок можно использовать как контейнер для вложенных блоков.

</details>

<details>

<summary><strong>Что такое индекс ячейки и как он формируется?</strong></summary>

Индекс - уникальный адрес ячейки в системе. Он формируется автоматически из названий объекта и блоков. Пример: TEX1-Room1-R5-10, где TEX1 - название объекта, Room1 и R5 - блоки, 10 - номер ячейки.

</details>

<details>

<summary><strong>Можно ли изменить структуру топологии после создания?</strong></summary>

Да. Вы можете добавлять, редактировать, перемещать и удалять блоки в любое время. Изменения вступают в силу сразу после их сохранений.

</details>

<details>

<summary><strong>Что происходит с устройствами при удалении блока?</strong></summary>

Устройства перемещаются во вкладку "Неимпортированные". Они не удаляются из системы - их можно переназначить в другие ячейки.

</details>

<details>

<summary><strong>Сколько топологий можно создать для одного объекта?</strong></summary>

Одну. Топология создается автоматически при создании объекта и связана с ним по принципу 1:1. Создать вторую топологию для того же объекта невозможно.

</details>

<details>

<summary><strong>Могу ли я просмотреть топологию без права на редактирование?</strong></summary>

Да. Для пользователей с ролью View-only топология доступна в режиме просмотра без возможности вносить изменения.

</details>

<details>

<summary><strong>Как найти свободную ячейку для нового устройства?</strong></summary>

Перейдите на страницу просмотра топологии и обратите внимание на холст: свободные ячейки отображаются светлее занятых.

</details>

<details>

<summary><strong>Как быстро узнать IP или серийный номер устройства?</strong></summary>

Кликните по занятой ячейке на холсте - откроется поповер с деталями устройства, включая серийный номер, IP-адрес и MAC. Любое значение копируется в буфер обмена кликом по нему.

</details>

***

**Мы всегда на связи!**

Напишите нам в [Telegram](https://t.me/moondmc_bot).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.moonone.online/ru/nachalo-raboty/configure_the_topology.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.