Экспорт Excel-отчета по собственному шаблону

Область применения:

1. Определение необходимого порядка и местоположения столбцов для результатов анализа
2. Добавление пустых столбцов для самостоятельного заполнения информацией.
3. Размещение столбцов с атрибутами и количеством по единицам измерения в произвольном порядке
4. Изменение стилизации блока заголовков (заливка, выравнивание, высота/шрифт/цвет текста и т.д.)
5. Отображение любого статического текста в блоке заголовка. Динамические значения атрибутов блока заголовка перед результатами анализа

Основные понятия:

1. Статический текст - текст, написанный без квадратных скобок ,который в итоговом excel будет отображаться в таком же виде, в котором был написан в шаблоне.
2. Значения атрибутов - динамические значения атрибутов, которые будут взяты из экспортируемого анализа.
3. Блок заголовка - данные, которые находятся над таблицей с результатами анализа.
4. Специальные атрибуты - атрибуты с особым поведением.
5. Атрибуты таблицы - атрибуты, которые используются в таблице с данными анализа. Для каждой строки(элемента или позиции) своё значение.
6. Атрибуты блока заголовка - атрибуты, которые имеют одно значение и располагаются над таблицей или в ней.

Загрузка шаблона и скачивание результата анализа

1. Зайти в глобальные настройки, нажав на значок шестеренки на панели инструментов:

2. Выбрать вкладку Шаблоны экспорта

3. Нажать на значок плюса "Создать шаблон экспорта"

4. Если шаблон прошел все проверки, то он будет загружен на платформу

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

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

Правила именования листов шаблона

1. Листы разделены по типу деревьев, для которых будет происходить экспорт
2. Element - имя листа для дерева элементов
3. Catalogs - имя листа для дерева справочников
4. Union_ИМЯ СХЕМЫ ПРИОРИТЕТА - имя листа для сводных деревьев. Например Union_Работы, Union_Работа и материалы
5. Имя схемы приоритета должно иметь такое же значение, как и в Value и использоваться в анализе, выбранном для экспорта. После слова Union должен быть написан разделитель в виде нижнего подчеркивания.
6. Лист с деревом элементов единственный и подчиняется шаблону листа с именем Element
7. Листов с деревом каталогов может быть несколько, но все они подчиняются листу с именем Catalogs
8. Листов сводных деревьев может быть несколько(по количеству используемых схем), каждый их них должен иметь свой лист в шаблоне с соответствующим именем

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

9. Для загрузки шаблона на платформу достаточно одного из листов с валидным именем

Пример именования листов

Причины, по которым шаблон может быть не загружен на платформу:

1. Шаблон имеет имя, которое уже используется
2. Имена используемых атрибутов таблицы/блока заголовка или специальных атрибутов не являются допустимыми(см. ниже)
3. Файл шаблона имеет лист, имя которого не является допустимым(см. выше)
4. Атрибуты таблицы находятся не на одной строке
5. Статический текст, атрибуты блока заголовка или специальные атрибуты находятся в ячейке ниже, чем атрибуты данных

Специальные атрибуты:

[RowForColumnNumbering] - с ячейки, где расположен этот атрибут будет начата нумерация столбцов таблицы, начиная со столбца, где он расположен и заканчивая последним столбцом. Вместо этого атрибута можно использовать свою нумерацию, если она является специфичной с использованием значений 1.1 или 2.3.1

В шаблоне специальным атрибутом заполнена строка 9 в колонке Е:

С неё будет автоматически начинаться нумерация в готовом файле:

Атрибуты, доступные на листе Element/Catalogs для дерева каталогов/элементов:

1. [Code] - Номер позиции
2. [Id] - Id элемента
3. [Name] -Наименование позиции или элемента
4. [Attribute_Имя атрибута] - Атрибут анализа. Если в выбранном анализе не будет найден атрибут с таким именем, то столбец будет пустым. Например [Attribute_H], [Attribute_Марка], [Attribute_Высота изделия]. При экспорте анализа с использованием шаблона экспорта окно с картинки ниже не будет появляться, все необходимые для выгрузки атрибуты должны быть прописаны в шаблоне, иначе они не будут выгружены.

Пример атрибутов анализа

5. [UnitsOfMeasure] - Единица измерения. Значение будет только для конечных дочерних позиций в каждом справочнике. Например, для строки 225 нет значения, так как эта позиция не конечная в своем справочнике.

Пример выгрузки столбца UnitOfMeasure(Ед.изм. столбец J)

6. [Quantity_Имя единицы измерения] - в этом столбце будет выводиться количество для конкретной единицы измерения, если она используется для текущей позиции или элемента. **** Берется из столбца "Единицы" таблицы единицы измерения в меню глобальных настроек**.** Например [Quantity_м3], [Quantity_шт]. Если в выбранном анализе не будет найдена заданная единица измерения, то столбец будет пустым.

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

Пример единиц измерения в компании (см. столбец Единицы)

7. [Quantity] - количество. В этом столбце(на картинке столбец O) отображается значение только для конечных позиций в каждом справочнике из схемы. У промежуточных позиций, у которых есть дочерние позиции, значения в этом столбце не будет, но его можно увидеть в столбце для конкретной единицы измерения(например, столбец K и L для строки 11394(т.к. позиции имеют дочерние позиции в этом справочнике)).

Пример выгрузки столбца Quantity(столбец O), PricePerUnit(столбец P), Стоимость(столбец Q)

8. [PricePerUnit] - цена за единицу. Значение будет показано только для позиций, которые являются конечными в цепочке вложенности в каждом справочнике. Для строки 225 или 8314 нет значения, так как она не конечная в своем справочнике. Если позиция одновременно конечная и начальная(4 строка), то цена всё равно выводится. То, что позиция конечная является более важным, чем то, что она начальная.
9. [Cost] - стоимость. На отображение влияет настройка "Суммарные стоимости родительских позиций". Если она включена, то стоимость отображается для всех позиций, независимо от того родительские они или дочерние. Если настройка выключена, то стоимость отображается только для конечных позиций.
10. [Project] - имя проекта
11. [Model] - имя модели
12. [VersionAndDate] - версия анализа и дата проведения анализа
13. [TreeName] - имя дерева
14. [ApprovedVersion] - утвержденная версия

Дополнительные атрибуты, доступные только на листах сводных деревьев - Union_Имя схемы для сводного дерева:

Атрибуты, перечисленные выше, доступны как для дерева элементов или каталогов, так и для дерева сводного анализа. Помимо них доступны следующие атрибуты:

1. [PricePerUnit_1 level] , [PricePerUnit_2 level] … [PricePerUnit_n level] - цена за единицу по уровням для схемы приоритетов из имени текущего листа, где n - уровень для схемы.

Например, у схемы ниже три уровня: первый - арматура по диаметрам, второй - арматура по основам и третий - арматура.

Трехуровневая схема

• После выгрузки таблица будет выглядеть вот так:

2. [Cost_1 level] , [Cost_2 level] … [Cost_n level] - стоимость по уровням для схемы из имени текущего листа, где n - уровень для схемы.

3. [FullCost] - полная стоимость. Это стоимость текущей позиции, суммированная со всеми стоимостями её дочерних позиций (как дочерних позиций этого же справочника, так и позиций из соподчиненных справочников). Заполняется для всех позиций. Не зависит от выбранных настроек в интерфейсе или столбцов в шаблоне.
4. [Catalog] - имя каталога, к которому относится позиция.
5. [ApprovedNumber] - утверждённый номер.

Атрибуты для блока заголовка:

1. [ProjectHeader] - имя проекта
2. [ModelHeader] - имя модели
3. [VersionAndDateHeader] - версия анализа и дата проведения анализа
4. [TreeNameHeader] - имя дерева
5. [ApprovedVersionHeader] - утвержденная версия

Примеры листов шаблона и результаты анализа по ним

Лист схема. Шаблон/итоговый файл:

Лист catalogs одного из справочников. Шаблон/итоговый файл:

Возможные проблемы в экспортированном анализе:

1. Проблема - столбец, где должно быть значение какого-либо атрибута, не имеет значения. Например, для таких атрибутов как [Attribute_Марка]/ [Attribute_Высота изделия]/ [UnitOfMeasure_м3] или [UnitOfMeasure_шт].

• Возможное решение - проверить имя атрибута/единицы измерения после нижнего подчеркивания. Оно должно точно соответствовать имени атрибута/единице измерения в Value. Обращать особое внимание на буквы с/c, o/о, х/x и подобные, у которых написание на латинице похоже на кириллическое.

2. Проблема - дерево сводного анализа не было экспортировано.

• Возможное решение - схема расчёта в имени листа для сводного анализа написана с опечаткой или не используется в выбранном анализе

Имя листа шаблона со сводным деревом для схемы справочников из п.3 ниже

3. Проблема - для атрибутов [PricePerUnit_5 level]/[Cost_3 level] и подобных не было экспортировано значение.

• Возможное решение - для выбранной схемы расчёта не существует данного уровня как например для такой схемы, у которой нет 3 и 5 уровней

Схема расчёта с 2 уровнями

Настройки экспорта, влияющие на экспорт с использованием шаблона

1. Стоимостные показатели - не оказывает влияния на экспорт по шаблону, так как пользователь сам решает, какой набор столбцов, отвечающих за стоимостные показатели будет включен в шаблон.
2. Вывод единиц измерения объемов построчно - не оказывает влияния на экспорт по шаблону, вместо этого пользователь может использовать атрибуты данных [Quantity], [UnitOfMeasure] и подобные [Quantity_м2].
3. Неназначенные объекты - оказывает влияние на экспорт по шаблону. Работает так же, как и при выгрузке без использования шаблона. Подробнее о выгрузке результата анализа без шаблона можно посмотреть здесь.
4. Суммарные стоимости родительских позиций - оказывает влияние на экспорт по шаблону. Показывает суммарные стоимости в столбце "Стоимость" для всех родительских позиций на листах справочников и на листах со сводными деревьями. При отключении показываются стоимости только для конечных позиций.
5. Какие деревья экспортируем? - все пункты оказывают влияние на экспорт по шаблону.

• Если в шаблоне есть лист Catalogs, но в интерфейсе не стоит галочка на экспорте Деревьев справочников, то деревья справочников не будут экспортированы.
• Если в шаблоне нет листа Catalogs, а в интерфейсе стоит галочка на экспорте Деревьев справочников, то будет произведен дефолтный экспорт листа со справочниками так, как будто это выполнялось без шаблона(только в рамках листа справочников).
• Если галочка стоит и в шаблоне есть лист с именем Catalogs, то будет произведен экспорт на основе этого листа.

6. Что экспортируем в дереве элементов? - все настройки из этого блока оказывают влияние на экспорт по шаблону. Работает так же, как и при выгрузке без использования шаблона.
7. Что экспортируем в деревьях справочников? - все настройки из этого блока оказывают влияние на экспорт по шаблону. Работает так же, как и при выгрузке без использования шаблона.
8. Что экспортируем в сводных деревьях? - все настройки из этого блока оказывают влияние на экспорт по шаблону. Работает также как и при выгрузке без использования шаблона.
9. Вывод цен справочников каждого уровня по отдельным столбцам - не оказывает влияние на экспорт по шаблону. При выгрузке без шаблона - если она включена, то 2 столбца "Цена за ед." и "Стоимость" раскрываются в несколько по количеству уровней в используемой для сводного анализа схеме приоритета справочников. Например, если в схеме 3 уровня, то будет 3 столбца "Цена за ед." и 3 столбца "Стоимость".
10. Если используется шаблон экспорта, то столбцы с такими атрибутами, как например, [PricePerUnit_1 level] или [Cost_2 level] будут заполнены, если они есть в шаблоне.
11. В столбце "Цена за ед. Арматура по диаметрам"(заголовок может быть задан в шаблоне, в данном случае столбец R) отображаются только цена за ед. для позиций (строка 4 и 449), которые относятся к справочникам на первом уровне схемы (для данного примера это единственный справочник с именем "Арматура по диаметрам"). Для позиций, которые не относятся к этому справочнику, будут показаны значения "-". Если в столбце "Цена за ед." отсутствуют значение, то для этих позиций в столбце "Цена за ед. Арматура по диаметрам" значение также будет отсутствовать.(строка 225).
12. В столбце "Стоимость Арматура по диаметрам"(столбец U) схема заполнения будет аналогична столбцу "Цена за ед. Арматура по диаметрам", но пустых ячеек не будет. Если позиция относится к справочникам с текущего первого уровня, то её стоимость будет написана, если же позиция не относится к справочникам этого уровня, то будет записан "-".