Функция Внешний отчет позволяет экспортировать отчеты EPLAN Harness proD с помощью (самостоятельно созданной) программы обработки отчетов. При этом данные, содержащиеся в отчете, экспортируются во временный файл данных XML. Затем автоматически запускается программа обработки отчетов, которая создает из этих данных требуемый вывод. В разделе Сведения для разработчиков приведена дополнительная информация о создании такой программы.

Каталог установки EPLAN Harness proD содержит демонстрацию под именем HReportExternally.exe: эта программа использует шаблон файла .xlsx для вывода отчетов в таблицах Microsoft Excel. Каталог установки содержит шаблон для каждого вида отчета. Ключевые слова для каждого вида отчета можно найти здесь:

• Ключевые слова для отчетов о принадлежностях
• Ключевые слова для отчетов относительно узлов / устройств
• Ключевые слова для обобщенных перечней материалов
• Ключевые слова для построчных перечней материалов
• Ключевые слова для отчетов относительно кабелей
• Ключевые слова для отчетов кабельных сборок
• Ключевые слова для отчетов связующих объектов
• Ключевые слова для отчетов относительно специальных компонентов
• Ключевые слова для отчетов относительно защиты поверхности
• Ключевые слова для отчетов кабельных жгутов
• Ключевые слова для отчетов о перечнях проводов

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

Обязательная установка для функции "Внешний отчет"

Прежде чем использовать "Внешний отчет", необходимо выполнить два условия:

• На компьютере или в локальной сети должна быть доступна соответствующая программа .exe для обработки отчетов
• Путь к файлу и аргументы параметров должны быть добавлены в настройки Studio

На примере демонстрационной программы HReportExternally.exe это будет выглядеть так:

1. В Studio выберите Дополнительно > Настройки > Отчеты > Внешний отчет.
   
   Вы увидите список типов отчетов, каждый с двумя полями. Одно — для пути к файлу программы обработки отчетов, а другое — для аргументов параметров.
   
2. Для соответствующего типа отчета введите путь к внешней программе
   
   Выберите обобщенный отчет по спецификациям в качестве примера, а затем используйте демонстрационную программу <Каталог установки Harness proD>\HReportExternally.exe.
   
3. Щелкните в соседнем поле и, при необходимости, укажите дополнительные параметры для программы.
   
   В демонстрационной программе это путь к соответствующему шаблону отчета. Путь к шаблону следует вводить в следующем формате: -template "<Каталог установки Harness proD>\Demo\Demo_ReportExternally\<имя шаблона>.xlsx". Для обобщенных отчетов по перечням материалов можно использовать шаблон bom_aggregated_template.xlsx.
4. Щелкните по кнопке [OK].
   

Экспортировать отчет с помощью функции "Внешний отчет"

После настройки параметров для функции "Внешний отчет" в Studio вы можете использовать ее для экспорта отчетов:

1. Откройте отчет, который требуется экспортировать с помощью этой программы.
2. Выберите пункты меню Файл > Внешний отчет.
   
   Выберите каталог, в котором следует сохранить окончательный отчет, определите его имя и задайте соответствующее расширение файла. В демонстрационной программе расширение файла должно быть *.xlsx.
3. Нажмите [Сохранить].

Информация для разработчиков

Нескомпилированный исходный код для HReportExternally.exe сохранен по пути <Каталог установки Harness proD>\Demo\Demo_ReportExternally\Demo_ReportExternally.zip.

Если отчет сохраняется с помощью функции Внешний отчет, Harness proD выполняет следующие шаги:

• Harness proD создает файл *.xml с данными отчета.
• Harness proD вызывает программу со следующими параметрами:
  
  
  • -source "<путь к файлу данных XML>"
  • -output "<путь к выходному файлу, определенному пользователем>"
  • Дополнительные параметры, определенные пользователем, такие как -template "<Путь доступа к шаблону>" для демонстрационной программы HReportExternally.exe.

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

Специфические переменные шаблонов HReportExternally.exe

В шаблонах демонстрационной программы HReportExternally.exe используются разные переменные:

Ключевое слово	Описание
PROJECT_NAME	Имя проекта
DATE	Дата экспорта отчета
TIME	Время экспорта отчета
START	Необходимое указание, где находится первый столбец таблицы, в который требуется ввести данные
END	Необходимое указание, где находится последний столбец таблицы, в который требуется ввести данные