Выгрузка реквизитов в Excel

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

Обработка работает со следующими типами объектов метаданных:

• *Справочники* (включая иерархические и подчинённые);
  
• *Документы* (с табличными частями);
• *Регистры сведений* (периодические и непериодические);
• *Регистры накопления* (с регистраторами);
• *Регистры бухгалтерии* (с субконто и счетами)%
• *Планы видов характеристик* (с типом значения):

Описание функционала:

1. Выгрузка реквизитов объекта

Как это работает:

При выборе объекта обработка получает его метаданные и формирует табличный документ со следующей структурой:

• Секция "СТАНДАРТНЫЕ РЕКВИЗИТЫ"

Содержит реквизиты, определённые платформой для данного типа объекта:

- Для **документов**: Дата, Номер, Проведен, ПометкаУдаления

- Для **справочников**: Код, Наименование, Родитель, ЭтоГруппа, ПометкаУдаления, Предопределенный;

- Для **ПВХ**: дополнительно выводится реквизит ТипЗначения

Важно о стандартных реквизитах:

- Значения этих реквизитов берутся непосредственно из выбранного объекта (заполненные данные);

- Тип данных для каждого стандартного реквизита определяется через свойство "СтандартныеРеквизиты" метаданных объекта;

- Реквизит "Предопределенный" выводится только если он существует у объекта (обёрнут в Попытку-Исключение).

• Секция "РЕКВИЗИТЫ ОБЪЕКТА"

Содержит пользовательские реквизиты, созданные в Конфигураторе. Для каждого реквизита выводится:

• Представление - Синоним реквизита (как видит пользователь);
• Реквизит - Системное имя (как в Конфигураторе);
• Тип - Полное описание типа с длиной/точностью;
• Обяз. - Обязательность заполнения;
• Значение - Фактическое значение из выбранного объекта.

Важно о длине и точности:

- Длина/точность выводятся только если они заданы в Конфигураторе;

- Если квалификаторы отсутствуют — выводится просто "Число" или "Строка";

- Для строк с фиксированной длиной добавляется префикс "фикс."

Как определяется обязательность (функция `РеквизитОбязательный`);

Обязательность реквизита проверяется в следующем порядке:

1. Свойство "ОбязательноеЗаполнение" — основное свойство реквизита в Конфигураторе.

2. "Проверки заполнения" ("ПроверкиЗаполнения") — дополнительные правила проверки для объекта в целом.

3. Если ни одно из условий не выполнено — реквизит считается необязательным ("Нет").

Важно о проверках при проведении:

- Обработка проверяет только метаданные, но не может проверить логику проведения документа.

- Реквизиты, обязательные только при проведении (например, "Номенклатура" в ТЧ "Товары"), отмечены в колонке "Примечание" как "Обязателен при проведении";

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

Табличные части

Для каждой табличной части объекта:

- Если ТЧ пустая — выводится только структура (список реквизитов ТЧ с пустыми значениями);

- Если ТЧ с данными — выводятся строки с фактическими значениями;

- Для каждой строки ТЧ выводится её номер (`НомерСтроки`) и значения всех реквизитов.

ВЫПОЛНЕНА ДОРАБОТКА В ВЕРСИИ 1.1: Выгрузка MXL для сравнения в 1С

При выгрузке реквизитов в Excel теперь можно дополнительно сохранять файл во внутреннем формате 1С (.mxl):

- При включенной галочке создаются два файла: .xlsx (для просмотра в Excel) и .mxl (для сравнения в 1С).

- MXL файлы можно читать без установленного Excel на сервере;

- Сравнение в 1С работает значительно быстрее;

- Нет проблем с блокировкой файлов Excel.

2. Сравнение выгрузок

Как это работает:

Сравнение выполняется путём чтения двух Excel-файлов через COM-объект Excel и сопоставления реквизитов по именам в пределах одинаковых секций.

Алгоритм сравнения:

1. Читается первый файл — все реквизиты сохраняются с привязкой к секциям;

2. Читается второй файл — аналогично;

3. Сравнение идёт в порядке первого файла с сохранением структуры секций;

4. Для каждого реквизита ищется совпадение во втором файле;

5. Реквизиты, найденные только во втором файле, добавляются в конец:

Статусы сравнения:

- "Совпадает" — Тип и Обязательность одинаковы в обоих файлах;

- "Различается" — Тип или Обязательность отличаются;

- "Нет в файле 1" — реквизит присутствует только во втором файле;

- "Нет в файле 2" — реквизит присутствует только в первом файле;

Цветовое выделение:

- Цвета настраиваются пользователем на вкладке "Сравнение выгрузок";

- Доступные цвета: Зелёный, Розовый, Жёлтый, Оранжевый, Синий, Серый;

- При включении галочки "Без цвета" — выделение не применяется;

- Цвета хранятся как числовые коды и передаются в Excel через COM;

Важно о сравнении:

- Секции "СТАНДАРТНЫЕ РЕКВИЗИТЫ", "РЕКВИЗИТЫ ОБЪЕКТА", "ТАБЛИЧНАЯ ЧАСТЬ" сохраняются в результате;

- Легенда с пояснением цветов добавляется в начало файла (если цветовое выделение включено)

ВЫПОЛНЕНА ДОРАБОТКА В ВЕРСИИ 1.1: Комбинированный поиск при сравнении

При сравнении двух Excel-файлов реквизиты теперь ищутся не только по имени, но и по системному имени и типу данных. Алгоритм поиска (по приоритету):

1. По системному имени — самый надёжный способ (например, "Валюта", а не "Валюты" или "ВалютаДокумента");

2. По синониму — если не найдено по системному имени (работает при включенной галочке "Комбинированный поиск");

3. По типу данных — если не найдено по синониму (работает при включенной галочке "Комбинированный поиск").

В статусе сравнения отображается способ поиска:

- "по системному имени";

- "по синониму";

- "по типу (единственный)";

- "по типу (первый из N)",где N — количество реквизитов с таким типом.

ВЫПОЛНЕНА ДОРАБОТКА В ВЕРСИИ 1.1: "Показывать результат в 1С (без Excel)"

При включении галочки "Показывать результат в 1С" результат сравнения отображается непосредственно в 1С в виде ТабличногоДокумента, без сохранения в Excel. Преимущества:

- Не требуется Microsoft Excel на сервере;

- Результат виден сразу, без открытия внешней программы;

- Цветовое выделение сохранено (как в Excel);

- Можно копировать данные из окна.

3. Поиск использования типов

Как это работает:

Поиск проходит по всем объектам метаданных конфигурации и находит реквизиты, тип которых совпадает с искомым.

Область поиска:

- Справочники — реквизиты шапки и табличных частей;

- Документы — реквизиты шапки и табличных частей;

- Регистры сведений — измерения, ресурсы, реквизиты;

- Регистры накопления — измерения, ресурсы, реквизиты;

- Регистры бухгалтерии— измерения, ресурсы, реквизиты;

- Документы-регистраторы— для регистров накопления и бухгалтерии;

Режимы поиска:

- Точное совпадение (галочка "Частичное совпадение" выключена):

  - Ищет точное совпадение типа или тип в начале составного типа

  - Пример: "Справочник.Номенклатура" найдёт только этот тип, но не "Справочник.НоменклатураКонтрагентов";

- Частичное совпадение (галочка включена):

  - Ищет вхождение искомой строки в любом месте типа

  - Пример: "Номенклатура" найдёт и "Справочник.Номенклатура", и "Справочник.НоменклатураКонтрагентов"

Исключения из поиска:

- Служебные табличные части пропускаются:

  - `ДополнительныеРеквизиты`

  - `ДополнительныеСведения`

  - `ДополнительныеРеквизитыОбъекта`

4. Структура конфигурации

Как это работает:

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

ВЫПОЛНЕНА ДОРАБОТКА В ВЕРСИИ 1.1: Унификация выгрузки структуры конфигурации

Выгрузка структуры конфигурации приведена к единому формату с основной выгрузкой:

- Добавлены измерения и ресурсы для регистров;

- Добавлен реквизит "НомерСтроки" для табличных частей;

- Добавлены примечания для полей (как в основной выгрузке);

- Вывод стандартных реквизитов (Код, Наименование, Дата, Номер и т.д.).

Выгрузка в Excel:

- Объекты группируются по типам на отдельных листах: "Справочники", "Документы", "Регистры сведений" и т.д;

- Для справочников и документов выводятся реквизиты и табличные части;

- Для регистров — измерения, ресурсы и реквизиты;

- Для ПВХ — реквизиты и табличные части (как у справочников);

- Для ПВХ без реквизитов — выводится пометка "(пустой ПВХ)";

Выгрузка в XML:

- Формируется структурированный XML-файл

- Каждый объект — отдельный элемент `<Объект>` с атрибутами Тип, Имя, Синоним

- Реквизиты, измерения, ресурсы — вложенные элементы

- Поддерживается для всех типов объектов

Поиск по дереву:

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

- Поиск по системному имени и синониму объекта

- Не найденные ветки скрываются

5. Технические особенности

ВЫПОЛНЕНА ДОРАБОТКА В ВЕРСИИ 1.1: Добавлена колонка "Сист. имя" в выгрузку Excel

- Системное имя всегда уникально и не зависит от синонима;

- Упрощается сравнение файлов (используется для комбинированного поиска);

- Позволяет точно идентифицировать реквизиты.

Новая структура Excel-файла:

Сохранение настроек:

- Последний выбранный тип объекта сохраняется через `ХранилищеОбщихНастроек`;

- Значения полей поиска сохраняются между сеансами;

- Настройки цветов сравнения сохраняются в реквизитах формы;

Работа с COM (Excel):

- Для выгрузки и сравнения используется COM-объект `Excel.Application`;

- При отсутствии Excel на компьютере — выгрузка в файл работает, но автоподбор ширины не выполняется;

- При ошибке COM — файл сохраняется без автоподбора, выводится сообщение.

Ограничения:

- Максимальное количество строк при чтении файлов сравнения: 500 (защита от зависания);

- Максимальное количество строк при выгрузке структуры: 1000;

- Цветовое выделение работает только при установленном Microsoft Excel.

Системные требования:

- Платформа: 1С:Предприятие 8.3.25 и выше;

- Режим: Управляемое приложение (тонкий/толстый клиент);

- Внешние компоненты: Microsoft Excel (для COM-автоматизации);

- Права: запись в файловую систему, чтение метаданных конфигурации.