1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ТомаХраненияФайлов |
| Полный идентификатор | Справочник.ТомаХраненияФайлов (Catalogs.ТомаХраненияФайлов) |
| Синоним | Тома хранения файлов |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Иерархия | Отсутствует (плоский список) |
| Владельцы | Нет (независимый справочник) |
| Основное представление | По наименованию |
Назначение. Справочник управляет физическими местами хранения файлов и присоединённых документов в конфигурации. Он позволяет настроить несколько сетевых каталогов (томов) для распределённого хранения, указав пути отдельно для Windows- и Linux-серверов, задать порядок заполнения томов и лимиты их размера. Справочник заполняется администратором при первичной настройке файлового хранилища или при расширении дискового пространства и далее автоматически задействуется платформой при сохранении файлов пользователями (когда хранение файлов настроено «в томах на диске», а не в информационной базе).
Где найти в 1С: раздел «Администрирование» → «Тома хранения файлов».
Навигационная ссылка: e1cib/list/Справочник.ТомаХраненияФайлов
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Комментарий | Строка | Не обязателен | Произвольное текстовое описание тома для внутренних целей администрирования; доступен для группового редактирования |
| МаксимальныйРазмер | Число (десятичное) | Не обязателен | Предел размера тома в мегабайтах (МБ); используется системой для контроля заполнения и переключения на следующий том при превышении лимита. Значение 0 трактуется как «без ограничения» |
| ПолныйПутьLinux | Строка | Условно обязателен* | Полный путь к каталогу хранения файлов на Linux-сервере (например, /mnt/files/volume1) |
| ПолныйПутьWindows | Строка | Условно обязателен* | Полный путь к каталогу хранения файлов на Windows-сервере (например, \\server\files\volume1) |
| ПорядокЗаполнения | Число (десятичное) | Обязателен | Номер последовательности заполнения томов; система записывает файлы сначала в том с меньшим номером порядка; должен быть уникальным для каждого тома |
| ВремяПоследнейОчисткиФайлов | Дата и время | Не обязателен | Служебное поле; фиксирует дату и время последней операции очистки лишних файлов из тома; заполняется автоматически при выполнении регламентной операции удаления |
*Условная обязательность: должен быть заполнен хотя бы один из путей — Windows или Linux — в зависимости от операционной системы сервера, на котором работает кластер.
Стандартные реквизиты. Помимо реквизитов, определённых разработчиком, справочник содержит стандартные реквизиты: Код, Наименование, ПометкаУдаления, Ссылка, Предопределённый. Наименование используется как понятное человеку имя тома (например, «Том 1 — основной»).
2.2 Табличные части
Табличные части отсутствуют.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Основная форма редактирования элемента справочника: ввод путей Windows/Linux, максимального размера, порядка заполнения и комментария. Ключевая форма для пользователя-администратора |
| ФормаСписка | Форма списка томов; помимо навигации предоставляет функции массовой проверки целостности хранилища и переноса (перезаполнения) файлов между томами |
| УдалениеЛишнихФайловИзТома | Служебная форма для удаления «файлов-сирот» — файлов, физически присутствующих в каталоге тома, но отсутствующих в регистрах учёта файлов. Обновляет реквизит ВремяПоследнейОчисткиФайлов |
4. Ключевые процедуры модулей
В приложенном evidence тексты модулей (BSL) не переданы, поэтому ниже описаны типовые обработчики, характерные для служебного справочника томов хранения файлов в конфигурациях на БСП (Библиотека стандартных подсистем). Конкретные имена процедур и номера строк требуют сверки с модулями данной поставки.
Модуль формы элемента (ФормаЭлемента)
ПриСозданииНаСервере— установка видимости полей пути в зависимости от типа ОС сервера, блокировка редактирования при недостатке прав.ПередЗаписьюНаСервере/ обработчик проверки заполнения — контроль того, что заполнен хотя бы один из путей (Windows/Linux) и что путь синтаксически корректен.- Обработчики выбора каталога для полей
ПолныйПутьWindows/ПолныйПутьLinux.
Модуль объекта (ОбъектМодуль)
ОбработкаПроверкиЗаполнения— проверяет заполнение обязательногоПорядокЗаполненияи наличие хотя бы одного пути; при необходимости добавляет ошибки в массив проверяемых реквизитов.ПередЗаписью— контроль уникальностиПорядокЗаполнения, нормализация путей (удаление завершающего слэша), запрет удаления пути у тома, в котором уже хранятся файлы.
Модуль менеджера / общие модули работы с файлами (БСП)
- Функции поиска тома для записи очередного файла с учётом
ПорядокЗаполненияиМаксимальныйРазмер. - Процедуры проверки целостности хранилища и переноса файлов между томами (вызываются из
ФормаСписка). - Регламентная процедура очистки лишних файлов (вызывается из формы
УдалениеЛишнихФайловИзТома), обновляющаяВремяПоследнейОчисткиФайлов.
5. Проведение и движения
Справочник не является документом и не участвует в проведении — он не формирует бухгалтерских проводок и не создаёт движений по регистрам накопления/сведений бухгалтерского или налогового учёта. Соответственно, счета типового плана счетов РК (1210, 1030, 1330, 3310, 3130, 6010, 7010) и налоговые расчёты (НДС 16 %, ИПН, ОПВ, ОСМС/ВОСМС, СО, соцналог 6 %) к данному объекту не применяются.
Взаимодействие с учётной механикой — косвенное: справочник хранит адреса каталогов, в которые платформа физически сохраняет файлы, присоединённые к объектам учёта. Информация о том, в каком томе лежит конкретный файл, хранится не в этом справочнике, а в служебных регистрах сведений подсистемы работы с файлами (сведения о хранимых файлах и их привязке к тому). Таким образом, ТомаХраненияФайлов задаёт «место назначения», а учёт самих файлов ведётся отдельными служебными объектами конфигурации.
6. Связанные объекты и ввод на основании
- Присоединённые файлы / хранилища файлов — служебные объекты подсистемы работы с файлами БСП, которые ссылаются на элемент справочника как на место физического размещения. При выключенном режиме хранения «в томах» справочник не задействуется (файлы хранятся в ИБ).
- Регистры сведений подсистемы файлов — фиксируют соответствие «файл ↔ том».
- Регламентные задания — очистка неиспользуемых файлов и контроль заполнения томов используют данные справочника.
- Ввод на основании — не предусмотрен (для служебного справочника не применяется).
7. Точки расширения
- Расширение конфигурации (без снятия с поддержки): добавление собственных реквизитов (например, признак архивного тома, максимальный размер одного файла), добавление обработчиков
ПередЗаписью/ОбработкаПроверкиЗаполнениячерез расширение. - Дополнительные проверки — контроль доступности сетевого пути и прав записи перед сохранением тома (через подключаемый обработчик формы элемента).
- Дополнительные обработки и отчёты — сервисные обработки для миграции файлов между томами, инвентаризации занятого объёма, поиска «сирот» вне штатной формы
УдалениеЛишнихФайловИзТома. - Подписки на события — на запись элемента справочника для журналирования изменений путей/лимитов.
- Права ролей — ограничение доступа к справочнику ролью администратора; тонкая настройка через профили групп доступа.
Требует проверки для конкретной поставки 3.0.74.2: точные имена процедур модулей и номера строк, состав служебных регистров сведений подсистемы файлов, а также перечень командных функций формы списка (проверка целостности / перенос файлов) — сверять по конфигуратору, так как реализация подсистемы работы с файлами зависит от версии встроенной БСП.