Правки

Author: leobrn

docs/theory/data_blocking.md

@@ -314,13 +314,13 @@ title: Блокировки
 **Симптом**: Две транзакции ждут друг друга.
 
 **Причины**:
-- Недостаточный уровень изоляции
+- **Недостаточный уровень изоляции**
 
     Транзакции считывают данные под разделяемой блокировкой (S), а затем пытаются обновить их, что требует установки монопольной блокировки (X).
 
     Если две транзакции одновременно удерживают S-блокировки на одних и тех же ресурсах и запрашивают X-блокировки для их изменения, возникает взаимоблокировка.
 
-- Неоптимальный порядок блокировок
+- **Неоптимальный порядок блокировок**
 
     Пример: Два документа — «Поступление товаров» и «Реализация товаров» — при проведении обращаются к одним и тем же виртуальным таблицам регистров, но порядок вызова методов записи различен:
 

docs/theory/index_types.md

@@ -7,8 +7,6 @@ title: Индексы
 
     * **Что такое индекс**: Служебный объект БД, созданный на основе одного или нескольких полей
 
-    * **Структура**: Содержит значения ключевых полей + ссылки на записи таблицы
-
     * **Главная задача**: Ускорение поиска данных в СУБД (особенно на больших объемах)
 
     * **Без индекса**: Полное сканирование таблицы (Table Scan) — неэффективно

docs/theory/skd.md

@@ -39,6 +39,22 @@ title: СКД
 *   **`ПроцессорКомпоновкиДанных`** — Исполняет макет, выдает элементы результата. Ключевые методы `Инициализировать(Макет)`, `Следующий()`.
 *   **`ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент`** — Выводит элементы в табличный документ.
 
+### Основные элементы схемы компоновки
+
+1.  **Поля:**
+    *   Формируются автоматически из запроса.
+    *   Имеют **роли** («Период», «Измерение», «Остаток»), критичные для корректного расчета итогов по регистрам (остатки, обороты).
+    *   Можно настраивать оформление, подсказки, формы выбора.
+
+2.  **Ресурсы:**
+    *   Поля, по которым считаются **итоги** (агрегаты: сумма, среднее, количество).
+    *   Итоги рассчитываются на уровне всей СКД, а не в запросе.
+    *   Можно задавать сложные выражения и агрегатные функции.
+
+3.  **Параметры:**
+    *   Используются для динамической фильтрации данных (например, «Период», «Контрагент»).
+    *   Могут иметь доступные значения, типы и настройки редактирования.
+
 ### Важные особенности и приемы
 
 1.  **Несколько наборов данных:** Можно связывать в схеме. В настройках в одной группировке можно использовать поля только из связанных наборов (кроме ресурсов).
@@ -50,6 +66,99 @@ title: СКД
     *   `{ГДЕ Поле1, Поле2}` — По каким полям можно делать отбор.
     *   Параметры виртуальных таблиц `{&ДатаНачала, &ДатаКонца}` также становятся доступны для отбора.
 
+## Назначение ролей для полей
+
+Роли полей в СКД — это **ключевая настройка для корректного расчета итогов**, особенно для работы с регистрами накопления, бухгалтерии и при использовании группировок по периодам. Роли сообщают системе, как обрабатывать поля при построении запросов и расчете агрегатов.
+
+**Типы ролей и их настройки:**
+
+#### 1. **Роль «Период»**
+**Назначение:** Для полей, содержащих даты/временные периоды. Используется при работе с виртуальными таблицами регистров, где задана периодичность.
+
+**Важные настройки:**
+- **Номер строки:** Определяет иерархию периодов. Нумерация должна быть строго последовательной:
+  - 1 — самый младший период (например, День)
+  - 2 — старший (например, Месяц)
+  - 3 — еще старший (например, Квартал)
+- **Дополнительный (флаг):**
+  - ✅ **Установлен** — в итоговый запрос включаются только явно указанные периоды
+  - ❌ **Снят** — в запрос автоматически включаются все родительские периоды (для корректного расчета остатков)
+
+**Особенности:**
+- Поля с ролью «Период» **нельзя использовать в одной группировке** с другими полями
+- При периодичности «Регистратор» обязательно нужно поле «Период»
+- При периодичности «Авто» обязательно нужно поле «ПериодСекунда»
+- **Проблема:** Группировка по неделям совместно с месяцами может давать задвоение данных
+
+#### 2. **Роль «Измерение»**
+**Назначение:** Для полей, по которым будут рассчитываться итоги (обычно измерения регистров).
+
+**Настройки:**
+- **Родительское поле:** Если используется не само измерение, а его реквизит, здесь указывается родительское поле
+- **Реквизит:** Указывается конкретный реквизит измерения
+
+**Важно:**
+- Родительское поле тоже должно иметь роль «Измерение»
+- Если в настройках выбрано подчиненное поле измерения, а само измерение не выбрано — оно будет добавлено в запрос **неявно** (для корректных итогов)
+
+#### 3. **Роль «Счет»**
+**Назначение:** Для полей, содержащих бухгалтерские счета (работа с регистром бухгалтерии).
+
+**Настройки:**
+- **Вид счета:** Обязательно указывается тип счета:
+  - Активный
+  - Пассивный
+  - Активно-пассивный
+- **Если не указан:** Система считает счет активно-пассивным, но может некорректно обрабатывать отрицательные остатки
+
+#### 4. **Роль «Остаток»**
+**Назначение:** Для полей начальных и конечных остатков регистров.
+
+**Настройки:**
+- **Имя:** Группировочное имя для пары «Начальный-Конечный остаток». Должно быть одинаковым для обоих полев
+- **Тип:** Выбирается:
+  - Начальный остаток
+  - Конечный остаток
+- **Бух. тип:** Для регистра бухгалтерии указывается:
+  - Дебет
+  - Кредит
+- **Поле счета:** Связь с полем, имеющим роль «Счет»
+
+**Критически важно:**
+- В схеме **обязательно должны присутствовать оба поля** (и начальный, и конечный остаток)
+- Если пользователь выбрал только один остаток — в запрос все равно включаются **оба** для корректных расчетов
+
+#### Дополнительные настройки ролей (общие для всех)**
+
+1. **«Игнорировать значение NULL»**
+- ✅ **Установлен:** Из итоговой выборки исключаются записи, где это поле имеет значение NULL
+- ❌ **Снят:** NULL-значения участвуют в расчетах и отображении
+
+2. **«Обязательное»**
+- ✅ **Установлен:** Поле **всегда** включается в итоговый запрос, даже если не выбрано в настройках
+- **Пример использования:**
+  - Принудительный расчет итогов по всем измерениям регистра
+  - Развернутое сальдо по всем субконто в бухгалтерии
+  - Обязательные поля для корректной работы расширений
+
+#### **Типичные ошибки и решения**
+
+-   **Ошибка 1: Неправильная нумерация периодов**
+    *   **Симптом:** Некорректный расчет остатков на начало периода
+    *   **Решение:** Проверить последовательность нумерации (1, 2, 3...)
+
+-   **Ошибка 2: Отсутствие пары «начальный-конечный» остаток**
+    *   **Симптом:** Итоги не рассчитываются или считаются неправильно
+    *   **Решение:** Добавить оба поля с одинаковым «Именем» в роли «Остаток»
+
+-   **Ошибка 3: Роль «Счет» без указания вида**
+    *   **Симптом:** Некорректное отображение отрицательных остатков
+    *   **Решение:** Указать правильный вид счета
+
+-   **Ошибка 4: Использование подчиненных реквизитов без родителя**
+    *   **Симптом:** Ошибки при построении запроса
+    *   **Решение:** Указать родительское поле в роли «Измерение»
+
 ## Наборы данных
 
 #### 1. **Типы наборов данных в СКД**
@@ -257,7 +366,7 @@ title: СКД
 
 #### 18. **Для чего в конструкторе СКД, на вкладке "Наборы данных", нужно поле "Роль"?**
 
-Роли (`Измерение`, `Ресурс`, `Остаток`, `Период` и т.д.) необходимы **внутреннему механизму СКД** для правильного расчета агрегатов (особенно остатков, оборотов, иерархии), независимо от того, как пользователь настроит отчет.
+Роль (`Измерение`, `Счет`, `Остатки`, `Период` и т.д.) необходимы **внутреннему механизму СКД** для правильного расчета агрегатов (особенно остатков, оборотов, иерархии), независимо от того, как пользователь настроит отчет.
 
 #### 19. **При соблюдении каких условий доступно использование функций из общих модулей в полях выражений СКД?**