Справочники и Данные · 11 мин
Словарь данных 1С 8.3: что это такое и как его применять
Что такое словарь данных в 1С 8.3, из чего он состоит, как его создать и вести. Практические приёмы описания объектов, реквизитов и регистров конфигурации.
Словарь данных в 1С 8.3 — это структурированное описание всех объектов информационной базы: справочников, документов, регистров, их реквизитов, типов, связей и правил заполнения. Он отвечает на вопросы «где хранится эта информация», «какой тип у этого поля», «с чем связан этот реквизит» — без необходимости каждый раз открывать конфигуратор и искать объект вручную.
Сам термин пришёл из классической теории баз данных: словарь данных (data dictionary) — централизованное хранилище метаданных, то есть «данных о данных». В платформе 1С часть этой роли выполняет сама конфигурация: дерево объектов метаданных в конфигураторе фактически и есть встроенный словарь данных. Однако на практике под словарём данных обычно понимают отдельный документ — таблицу, wiki-страницу или файл, который описывает структуру конкретной базы понятным языком для аналитиков, разработчиков и внедренцев.
Такой документ особенно востребован в трёх ситуациях: при передаче конфигурации новому разработчику, при интеграции 1С с внешними системами (сайт, CRM, WMS) и при разработке отчётов и обработок, где нужно точно знать, откуда брать данные. Без словаря каждая такая задача превращается в археологические раскопки по конфигуратору и запросам.
Что входит в словарь данных 1С
Полноценный словарь данных описывает каждый значимый объект конфигурации по единому шаблону. Минимальный набор сведений об объекте: имя объекта метаданных (как в конфигураторе), синоним (как видит пользователь), назначение в бизнес-процессе, состав реквизитов с типами и обязательностью, ключевые связи с другими объектами.
Для реквизитов фиксируют: имя, тип данных (строка с длиной, число с точностью, ссылка на конкретный объект, перечисление, дата), обязательность заполнения, значение по умолчанию, бизнес-смысл и источник заполнения (вручную, программно, из другого документа). Для регистров дополнительно указывают измерения, ресурсы, реквизиты и периодичность регистра накопления или сведений.
Хорошая практика — включать в словарь также перечисления с расшифровкой каждого значения, планы обмена (если есть интеграции) и типовые запросы к важнейшим регистрам. Это превращает словарь из справочника структуры в рабочий инструмент аналитика.
Где посмотреть встроенный словарь: конфигуратор и дерево метаданных
Основной «живой» словарь данных любой базы 1С 8.3 — конфигуратор. Откройте его через меню «Конфигурация → Открыть конфигурацию»: дерево в левой части окна показывает все объекты метаданных, сгруппированные по видам — справочники, документы, регистры сведений, регистры накопления и так далее. Двойной щелчок по объекту открывает палитру свойств и структуру реквизитов на закладке «Данные».
Для быстрого обзора состава конкретного объекта удобна закладка «Данные» в окне редактирования: там перечислены реквизиты, табличные части, измерения и ресурсы с типами. Тип реквизита виден в колонке «Тип» — например, «СправочникСсылка.Номенклатура» сразу показывает, что поле ссылается на справочник номенклатуры.
- 1Откройте конфигуратор и команду «Конфигурация → Открыть конфигурацию»
- 2Найдите нужный объект в дереве метаданных и откройте его двойным щелчком
- 3Перейдите на закладку «Данные» и изучите реквизиты, типы и табличные части
- 4На закладке «Движения» посмотрите, в какие регистры документ пишет данные
- 5Зафиксируйте найденное в вашем документе-словаре
Дополнительный источник — функция «Все функции» в режиме предприятия (вызывается через главное меню, если включена в параметрах). Она показывает список всех объектов конфигурации, доступных пользователю, и позволяет открыть любой из них без конфигуратора. Это удобно для аналитика без прав разработчика, но полную структуру реквизитов так не увидеть.
Как создать собственный словарь данных для внедрения
Для проектной документации словарь ведут отдельно от конфигуратора. Распространённые форматы: таблица Excel или Google Sheets, страница в корпоративной wiki (Confluence и аналоги), файл Markdown в репозитории проекта. Выбор формата зависит от команды: разработчикам удобнее текст рядом с кодом, аналитикам — таблица с фильтрами.
Начинайте не со всех объектов подряд, а с ядра процесса: для торговой базы это «Номенклатура», «Контрагенты», документы продажи и закупки, регистры остатков и взаиморасчётов. Опишите 10–15 ключевых объектов полностью, а остальные добавляйте по мере работы с ними. Попытка описать всю типовую конфигурацию сразу обычно заканчивается заброшенным документом.
Удобный шаблон строки словаря для реквизита: объект, имя реквизита, синоним, тип, обязательность, источник заполнения, комментарий. Для связей между объектами полезна отдельная таблица «кто на кого ссылается»: например, документ «РеализацияТоваровУслуг» ссылается на «Контрагенты», «ДоговорыКонтрагентов», «Склады» и делает движения по регистрам «ТоварыНаСкладах» и «Продажи».
Словарь данных для интеграций и обменов
При обмене 1С с внешними системами словарь данных становится контрактом между командами. Сторонний разработчик не имеет доступа к вашему конфигуратору, и единственный способ объяснить ему структуру — документ, где каждое поле выгрузки привязано к объекту и реквизиту 1С с указанием типа и формата.
В словаре для интеграции дополнительно фиксируют: формат передачи (XML, JSON, CSV, планы обмена), соответствие полей внешней системы реквизитам 1С, правила преобразования (например, дата в формате ISO, код единицы измерения по ОКЕИ), поведение при пустых значениях и ключи синхронизации — обычно это GUID объекта или код справочника.
Как выбрать формат словаря
Типичные ошибки при ведении словаря данных
Самая частая ошибка — описать структуру один раз в начале проекта и больше не обновлять. Через несколько доработок словарь начинает врать: реквизит переименован, тип изменён со строки на ссылку, регистр заменён. Доверие к документу теряется, и команда возвращается к изучению конфигуратора вручную.
Вторая ошибка — копирование технических имён без бизнес-смысла. Запись «Реквизит: ДопПоле1, тип: строка(100)» бесполезна без пояснения, что в этом поле хранится артикул поставщика и заполняется оно из заказа. Словарь данных ценен именно связью техники и смысла.
Третья ошибка — игнорирование табличных частей и виртуальных таблиц регистров. Многие данные в 1С хранятся не в шапке объекта, а в табличных частях («Товары» документа) и читаются через виртуальные таблицы регистров накопления («Остатки», «Обороты»). Если словарь описывает только шапки, разработчик отчётов не сможет по нему работать.
Как проверить актуальность и полноту словаря
Периодически сверяйте словарь с реальной конфигурацией. Простой способ — выборочная проверка: возьмите 5–10 объектов из словаря и сравните состав реквизитов с закладкой «Данные» в конфигураторе. Расхождения покажут, насколько документ отстал от разработки.
Для глубокой проверки полезен запрос к метаданным средствами встроенного языка: коллекция Метаданные позволяет программно перебрать объекты и их реквизиты. Обработка, выгружающая состав метаданных в таблицу, помогает автоматизировать сравнение, но такую обработку запускайте только на копии базы или с пониманием того, что делает код.
Как проверить словарь данных
Имена и типы в словаре совпадают с закладкой «Данные» в конфигураторе
В конфигурации есть реквизиты, которых нет в словаре, или типы различаются
Все ссылочные реквизиты указывают на существующие и верные объекты
Словарь ссылается на переименованный или удалённый объект
Указаны измерения, ресурсы, периодичность и документы-регистраторы
Описан только факт наличия регистра без структуры
Человек без доступа к конфигуратору может по словарю объяснить, где лежат данные
Без открытия конфигуратора смысл полей неясен
Ограничения и когда словарь не нужен
Словарь данных — не обязательный артефакт. Для небольшой базы на типовой конфигурации без доработок, где работает один специалист, достаточно встроенных средств: конфигуратора, синтакс-помощника и стандартной документации поставщика конфигурации. Ведение отдельного документа в этом случае — лишние трудозатраты.
Также словарь не заменяет ни пользовательскую инструкцию (он описывает структуру, а не порядок действий), ни описание бизнес-процессов. Это разные документы с разной аудиторией, и смешивать их в одном файле не стоит — словарь должен оставаться компактным справочником структуры.
Что важно запомнить
Словарь данных 1С 8.3 — описание объектов метаданных, реквизитов, типов и связей базы. Встроенный словарь — дерево метаданных в конфигураторе; для внедрений и интеграций ведут отдельный документ. Его ценность определяется актуальностью и связью технических имён с бизнес-смыслом.
Частые вопросы о словаре данных 1С 8.3
Есть ли в 1С 8.3 готовый встроенный отчёт «словарь данных»?
Отдельного типового отчёта с таким названием в платформе нет. Роль словаря выполняет дерево метаданных в конфигураторе. Состав объектов можно программно получить через коллекцию «Метаданные» и выгрузить в таблицу собственной обработкой.
Чем словарь данных отличается от схемы данных?
Схема показывает связи между объектами визуально (какие документы какие регистры двигают, кто на кого ссылается), а словарь — детальное текстовое описание каждого объекта и реквизита. На практике они дополняют друг друга: схема даёт обзор, словарь — детали.
Нужно ли описывать в словаре типовые объекты конфигурации?
Полностью переписывать документацию поставщика не нужно — достаточно ссылки на неё. Детально описывайте доработанные и добавленные объекты, а также типовые объекты, которые нестандартно используются в ваших процессах.
Кто должен вести словарь данных в проекте?
Обычно аналитик или ведущий разработчик, но обновлять его должны все, кто меняет структуру конфигурации. Работает правило: задача на доработку считается закрытой только после актуализации словаря.
Как описать в словаре регистр сведений?
Укажите имя и назначение, периодичность (периодический или нет), режим подчинения регистратору, все измерения и ресурсы с типами, а также кто и когда пишет в регистр — пользователь вручную или документы-регистраторы.
Можно ли автоматически сгенерировать словарь из конфигурации?
Да, средствами встроенного языка: обход коллекции «Метаданные» позволяет выгрузить объекты, реквизиты и типы в табличный документ или файл. Такая выгрузка даёт технический каркас, но бизнес-смысл полей придётся дописывать вручную.