Как получить список всех документов конфигурации 1С: полное руководство

Работа с метаданными в платформе 1С:Предприятие часто требует от разработчика глубокого понимания структуры конфигурации. Одной из распространенных задач является необходимость получить полный перечень всех видов документов, зарегистрированных в базе данных. Это может потребоваться при создании динамических отчетов, построении универсальных обработок обмена данными или при проведении аудита наполненности системы.

Существует несколько подходов к решению этой задачи, каждый из которых имеет свои особенности и области применения. Вы можете использовать встроенные возможности платформы через объект Метаданные, обращаться к системным таблицам через Консоль запросов или применять специализированные методы для получения ссылок на конкретные объекты. Выбор конкретного метода зависит от того, нужна ли вам информация о структуре или фактическое наличие записей в базе.

В данной статье мы детально разберем наиболее эффективные способы получения списка документов. Мы рассмотрим работу с объектами конфигурации, особенности использования запросов к виртуальной таблице ВидыДокументов и нюансы обработки больших объемов данных. Понимание этих механизмов позволит вам писать более гибкий и производительный код.

Использование объекта Метаданные для анализа конфигурации

Самый прямой и программно-ориентированный способ получить информацию о структуре — это обращение к глобальному объекту Метаданные. Этот объект предоставляет доступ ко всем элементам конфигурации, включая документы, справочники, регистры и планы счетов. Для получения списка документов используется свойство Документы, которое возвращает коллекцию описаний метаданных.

Важно понимать, что перебор коллекции Метаданные.Документы дает нам доступ к описанию вида документа, а не к самим записям в базе данных. Это означает, что мы получаем список всех возможных типов документов, которые предусмотрены конфигурацией, независимо от того, создавались ли они пользователями. Такой подход идеален для задач, где нужно динамически построить интерфейс или сформировать список доступных для обработки типов.

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

💡

Для ускорения работы с большими конфигурациями кэшируйте полученный список документов в модуле формы или общем модуле, чтобы не обращаться к метаданным при каждом открытии окна.

Пример кода демонстрирует, как можно вывести наименования всех документов в журнал регистрации или консоль отладки. Обратите внимание на использование метода ПолучитьМетаданные() для перехода от имени к объекту описания.

Для каждого ОписаниеДокумента Из Метаданные.Документы Цикл Сообщить("Найдено: " + ОписаниеДокумента.Синоним);

КонецЦикла;

⚠️ Внимание: Объект Метаданные доступен только в толстом клиенте или в режиме предприятия с соответствующими правами. В тонком клиенте прямой доступ к некоторым свойствам метаданных может быть ограничен политиками безопасности.

Запрос к системной таблице ВидыДокументов

Если ваша задача требует получения списка документов непосредственно из базы данных с использованием языка запросов, то вам понадобится виртуальная таблица ИнформационнаяБаза.ВидыДокументов. Этот метод особенно полезен, когда необходимо отфильтровать документы по определенным признакам или соединить эту информацию с другими данными системы.

Запрос к этой таблице возвращает список всех видов документов, которые физически существуют в конфигурации базы данных. Результат запроса содержит такие поля, как Ссылка, Наименование, Синоним и Имя. Использование запросов позволяет легко интегрировать получение списка документов в сложные отчеты или обработки, написанные на языке запросов 1С.

Синтаксис запроса достаточно прост, но требует понимания структуры системных таблиц. Вы можете выбрать только необходимые поля, чтобы уменьшить объем передаваемых данных. Это особенно актуально в файловых базах или при работе через тонкий клиент с большим количеством пользователей.

ВЫБРАТЬ ВидыДокументов.Ссылка КАК Ссылка, ВидыДокументов.Наименование КАК Наименование, ВидыДокументов.Синоним КАК Синоним ИЗ

ИнформационнаяБаза.ВидыДокументов КАК ВидыДокументов

Результат такого запроса можно поместить в временную таблицу и далее использовать для формирования отчета или вывода на экран пользователя. Гибкость языка запросов позволяет сортировать список, фильтровать его по имени или синониму, а также объединять с другими данными.

Получение списка документов с записями в базе

Часто возникает ситуация, когда разработчику нужен не просто список видов документов, а перечень тех документов, по которым в базе уже есть хотя бы одна запись. Для решения этой задачи простого перебора метаданных недостаточно, так как он покажет и пустые виды документов.

В этом случае необходимо использовать запрос к таблице Документы.ВсеВидыДокументов или выполнять выборку с группировкой по виду документа из общей таблицы документов. Такой подход позволяет отсеять виды документов, которые были добавлены в конфигурацию разработчиком, но еще ни разу не использовались пользователями в работе.

Использование таблицы Документы.ВсеВидыДокументов является наиболее оптимальным способом, так как эта виртуальная таблица специально предназначена для анализа наполненности базы по типам документов. Она возвращает только те виды, где счетчик записей больше нуля.

Метод	Возвращает пустые виды	Скорость работы	Сложность реализации
Метаданные.Документы	Да	Высокая	Низкая
ВидыДокументов (запрос)	Да	Средняя	Низкая
Документы.ВсеВидыДокументов	Нет	Высокая	Низкая
Группировка по Документ-Ссылка	Нет	Низкая	Высокая

При выборе метода важно учитывать объем базы данных. Если в системе хранятся миллионы документов, то прямая выборка всех записей с последующей группировкой может привести к значительному падению производительности. Виртуальные таблицы в этом плане намного эффективнее.

☑️ Проверка перед запуском обработки

Определить цель получения спискаПроверить права доступа пользователяВыбрать метод (Метаданные или Запрос)Протестировать на копии базы

Выполнено: 0 / 4

Работа с консолью запросов для быстрого анализа

Для администраторов баз данных и разработчиков, которым нужно быстро получить информацию без написания полноценного кода в конфигураторе, незаменимым инструментом является Консоль запросов. Этот инструмент позволяет выполнять произвольные SQL-подобные запросы к базе данных 1С в интерактивном режиме.

Чтобы получить список документов через консоль, достаточно ввести запрос к таблице ИнформационнаяБаза.ВидыДокументов. Результат отобразится в виде таблицы прямо в окне консоли, откуда его можно скопировать в Excel или текстовый файл для дальнейшего анализа. Это значительно ускоряет процесс аудита конфигурации.

Кроме того, консоль запросов позволяет проверять гипотезы о структуре данных «на лету». Вы можете быстро добавить условие ГДЕ, чтобы найти документы с определенным словом в названии, или отсортировать результат по алфавиту. Это делает инструмент мощным средством для экспресс-диагностики.

⚠️ Внимание: Будьте осторожны при использовании консоли запросов в продуктивной базе. Хотя чтение данных безопасно, случайное выполнение запросов с тяжелыми соединениями может замедлить работу системы для других пользователей.

Интерфейс консоли также поддерживает сохранение часто используемых запросов в файлы, что позволяет создать библиотеку полезных скриптов для администрирования. Например, вы можете сохранить запрос на получение списка всех регистров или справочников рядом с документами.

Как запустить консоль запросов?

Для запуска используйте внешнюю обработку "Консоль запросов", доступную в типовых конфигурациях, или подключите её как внешнюю отчету через меню "Файл" -> "Открыть". В некоторых версиях платформы она доступна через меню "Администрирование".

Фильтрация и сортировка списка документов

Получив полный список документов, вы почти наверняка захотите его упорядочить или отфильтровать. Платформа 1С предоставляет широкие возможности для манипуляции коллекциями данных. Если вы работаете с объектом Метаданные, вы можете использовать стандартные методы коллекций или создать временный массив для сортировки.

При использовании запросов сортировка и фильтрация выполняются на стороне СУБД, что является наиболее производительным вариантом. Вы можете использовать конструкции УПОРЯДОЧИТЬ ПО и ГДЕ для точной настройки вывода. Например, часто требуется исключить служебные документы или документы, помеченные на удаление (хотя для видов документов пометка удаления обычно не применима в том же смысле, что и для самих записей).

Фильтрация по префиксу или наличию определенных символов в имени документа может быть полезна при анализе больших конфигураций, собранных из множества подсистем. Это позволяет быстро выделить документы, относящиеся к конкретному блоку учета, например, к блоку "Зарплата" или "Торговля".

ВЫБРАТЬ ВидыДокументов.Наименование ИЗ ИнформационнаяБаза.ВидыДокументов КАК ВидыДокументов ГДЕ ВидыДокументов.Наименование ПОДОБНО "%Заказ%" УПОРЯДОЧИТЬ ПО

ВидыДокументов.Наименование

💡

Использование оператора ПОДОБНО в запросах позволяет гибко фильтровать списки документов по маске имени, что удобно для поиска в больших конфигурациях.

Не забывайте о чувствительности к регистру при фильтрации в некоторых СУБД, хотя платформа 1С обычно нивелирует эти различия. Тем не менее, явное приведение к верхнему или нижнему регистру может потребоваться для кросс-платформенной совместимости кода.

Практические примеры использования списка документов

Зачем вообще может понадобиться программное получение списка всех документов? Рассмотрим несколько реальных сценариев из практики разработки и сопровождения систем 1С. Понимание этих сценариев поможет вам лучше ориентироваться в задачах, где требуется подобная функциональность.

Первый сценарий — это создание универсальной обработки обмена данными. Представьте, что вам нужно выгрузить все документы за период в XML или JSON. Вместо того чтобы вручную прописывать каждый вид документа в коде, вы можете динамически получить их список и в цикле выполнить выгрузку. Это делает обработку масштабируемой и независимой от изменений в конфигурации.

📊 Аудит базы данных: Проверка того, какие виды документов реально используются в компании, для оптимизации интерфейса и скрытия неиспользуемых функций.
🔄 Миграция данных: При переходе с одной версии конфигурации на другую необходимо сопоставить виды документов для корректного переноса исторических данных.
🛡️ Разграничение прав: Автоматическая настройка профилей групп доступа на основе списка документов, требующих особого контроля.

Второй сценарий — построение аналитических дашбордов. Руководству может быть интересно видеть количество созданных документов в разрезе всех видов за месяц. Динамическое получение списка позволяет автоматически добавлять новые виды документов в отчет без вмешательства программиста.

⚠️ Внимание: При автоматической обработке большого количества видов документов убедитесь, что у пользователя, от имени которого запускается код, есть права на чтение всех этих объектов. Отсутствие прав на один вид документа может прервать выполнение всего цикла.

Третий сценарий касается разработки внешних обработок и расширений. Если вы создаете расширение, которое должно работать в разных конфигурациях (например, и в УТ, и в КА), жесткая привязка к конкретным именам документов недопустима. Использование мета-поиска делает ваше решение универсальным.

💡

При разработке универсальных обработок всегда предусматривайте обработку исключений. Если какой-то вид документов не найден или структура изменилась, обработка не должна падать с ошибкой, а должна корректно пропустить этот элемент.

Можно ли получить список документов через COM-соединение из внешней программы?

Да, это возможно. При подключении к 1С через COM-объект (например, из C#, Python или VBScript) вы можете получить доступ к свойству Metadata и далее к коллекции Documents. Однако, этот метод работает только в режиме толстого клиента или при использовании специального режима запуска тонкого клиента, поддерживающего внешние соединения. Синтаксис будет аналогичен внутреннему языку 1С, но с учетом особенностей вызова методов COM.

В чем разница между таблицами ВидыДокументов и ВсеВидыДокументов?

Таблица ИнформационнаяБаза.ВидыДокументов содержит перечень всех видов документов, описанных в метаданных конфигурации, независимо от наличия записей. Таблица Документы.ВсеВидыДокументов (или выборка с группировкой) возвращает только те виды, для которых в базе данных существует хотя бы одна запись. Первая используется для анализа структуры, вторая — для анализа наполнения.

Как получить список документов, помеченных на удаление?

Сами виды документов не помечаются на удаление в контексте метаданных. Если вопрос касается записей документов, то необходимо делать выборку из каждого вида документа с условием ГДЕ ПометкаУдаления = ИСТИНА. Получить сводный список именно удаленных записей по всем видам одним простым запросом к таблице видов нельзя, требуется цикл или сложное объединение запросов.

Замедлит ли работу базы частый запрос к таблице ВидыДокументов?

Нет, запрос к этой виртуальной таблице является очень легковесным, так как она обращается к системному кэшу метаданных, а не сканирует таблицы с данными. Вы можете смело использовать этот запрос в циклах или при открытии форм без опасения за производительность системы.

Можно ли программно создать новый вид документа на лету?

Нет, в режиме Предприятия изменение структуры метаданных (создание новых видов документов) невозможно. Это делается только в режиме Конфигуратора. В режиме предприятия вы можете создавать только новые записи (экземпляры) существующих видов документов.

Получение списка всех документов конфигурации в 1С