Многостраничный импорт/экспорт¶
Содержание
Настройки многостраничного импорта и экспорта в xlsx-файлы¶
Система поддерживает формирование многостраничных регламентированных отчетных форм путем экспорта нескольких отчетов и реестров на различные листы файла в формате MS Excel. Такой шаблон экспорта создается и привязывается к конкретному шаблону сбора данных, существующему в Системе. Соответственно, в шаблон экспорта можно выгружать только рекомендованные для его шаблона сбора реестры, отчеты и формы.
Для создания шаблона экспорта необходимо сформировать файл MS Excel соответствующей структуры. При настройке шаблона экспорта Система будет автоматически распознавать листы шаблона. Для каждого листа будет предоставлена возможность выбрать перечень отчетов и реестров, экспортируемых на данный лист.
Для того, чтобы у редактора шаблона была возможность настраивать импорт/экспорт в шаблоне сбора, необходимо пользователю добавить роль «Сложный импорт/экспорт: администратор».
Для настройки шаблона экспорта в Системе следует открыть паспорт шаблона сбора, к которому требуется привязать данный шаблон экспорта, нажать на кнопку «Редактировать», а затем нажать на кнопку «Импорт/экспорт».

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

Для создания нового шаблона экспорта необходимо нажать на синюю кнопку с плюсом в правом верхнем углу окна.

Далее в открывшемся окне необходимо выбрать предварительно настроенный файл MS Excel и нажать на кнопку «Открыть». После этого откроется страница настройки созданного шаблона экспорта.

Сверху написано текущее название шаблона (изначально оно совпадает с названием файла, который был выбран в качестве шаблона для экспортируемых данных). Далее - несколько полей для настройки шаблона. Если файл для шаблона экспорта был выбран неправильно или необходимо заменить файл в существующем шаблоне экспорта, то его можно заменить, нажав на кнопку со стрелочками в поле «Файл». Справа от названия поля будет указано название текущего файла для экспорта.

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

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

В появившейся строке настроек требуется выбрать в селекте, какой отчет/форма/реестр следует вставить на лист (выбор производится только из рекомендованных форм, отчетов, реестров для данного шаблона сбора), и указать верхнюю левую ячейку для данного отчета/формы/реестра.

Также можно указать, требуется ли сдвигать в файле футер.

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

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

На следующем шаге, если необходимо, следует добавить отчеты, формы или реестры на другие листы файла. После этого необходимо включить шаблон экспорта (поле «Статус шаблона»).

Чтобы сохранить настроенный шаблон сбора, следует нажать на кнопку «Сохранить» в правом нижнем углу окна, иначе – на кнопку «Сбросить», если необходимо сбросить настройки изменяемого шаблона экспорта к предыдущей конфигурации. Если необходимо удалить настроенный шаблон экспорта, то следует нажать на кнопку «Удалить».

По нажатию на кнопку «Удалить» на экране появится диаологовое окно для подтверждения удаления шаблона экспорта.

Если необходимо выйти из настроек конфигураций экспорта без сохранения, то для этого следует нажать на крестик в правом верхнем углу окна или на кнопку «Закрыть» в левом нижнем углу.

Для создания еще одного шаблона экспорта для данного шаблона сбора необходимо снова нажать на кнопку «+» в правом верхнем углу окна и выбрать интересующий файл для шаблона. В результате в окне настройки конфигурации импорта/экспорта откроется дополнительная вкладка с настройками нового шаблона.

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

В паспорте задания ранее созданного шаблона сбора, для которого был настроен шаблон экспорта, появятся разделы «Экспорт» и «Импорт». В данных разделах пользователи будут иметь возможность выбрать файл, в который необходимо выгрузить данные или из которого необходимо загрузить данные в Систему.

Функция импорта данных из шаблона обеспечивает возможность сбора данных в режиме off-line.
Настройки многостраничного импорта и экспорта в docx-файлы¶
Система также поддерживает возможность экспорта нескольких форм, отчетов и реестров в документ формата MS Word. Для этого необходимо подготовить файл, в котором заранее настраиваются заголовки строк и столбцов в таблице.
Возможны следующие варианты экспорта данных в документ MS Word:
- Экспорт данных отчета из Системы в определенном диапазоне. В коде используется условное обозначение «report-range-label». В файл-шаблон экспорта в ячейку, с которой будут начинаться данные вставляется код, в котором B3 – это метка ячейки, название которой должно совпадать с названием ячейки в Excel: {% report-range-label B3 1 1 5 2 %}.

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

В приведенном примере для отчета с условным названием-меткой B3, начиная с ячейки, в которой обнаружена запись {% report-range-label B3 1 1 5 2 %}, в таблицу вставляются выбранные данные, т.е. начиная с 1 строки 1 столбца по 5 строку 2 столбца включительно (нумерация соответствует нумерации строк и столбцов в Системе). Нумерация начинается с единицы. Обратите внимание, что размеры таблицы в файле MS Word не изменяются.
Пример, как выглядит форма в системе:

Пример экспортированного отчета:

При задании отрицательных значений, отсчет будет вестись с конца. В коде используется условное обозначение «report-range-label»:

Пример экспортированного отчета при задании отрицательных значений:

- Экспорт всех данных отчета из Системы (без задания диапазона). В коде используется условное обозначение «report-range-label». Если в коде не задавать диапазон строк и столбцов, например, {% report-range-label B3 %}, то экспортироваться будут все данные из Системы, начиная с 1 строки 1 столбца, до максимально заданных значений строк и столбцов в таблице файла-шаблона.

Пример как выглядит отчет в системе:

Пример экспортированного отчета:

- Экспорт одного числа из отчета Системы. Для вставки одного числа из отчета в текст в коде используется условное обозначение «report-label».
Допустим в файл-шаблон необходимо вставить значение из 6 строки 1 столбца: {% report-label B4 6 1 %}. Тогда текст файла-шаблона будет выглядеть следующим образом:

В результате экспорта отчет будет иметь следующий вид:

В приведенном примере для отчета с условным названием-меткой B4 будет найдено число из 6 строки, 1 столбца.
- Экспорт одного числа из отчета Системы при задании отрицательных значений. Для вставки одного числа из отчета в текст в коде используется условное обозначение «report-label».
Пример задания в коде отрицательного значения для вставки одного числа из отчета: {% report-label B4 -5 -2 %}.
В результате экспорта отчет будет иметь следующий вид:

В приведенном примере для отчета с условным названием-меткой B4 будет найдено число из 5 строки снизу, 2 столбца справа.
Если необходимо в файл экспортировать несколько отчетов/форм/реестров, то следует нажать на кнопку «+» в поле «(1) Документ Word». В результате появится новая строка, в которой необходимо выбрать интересующий отчет/форму/реестр.

В файле-шаблоне должны быть настроены таблицы аналогично описанию выше. Выбор отчетов/форм/реестров должен располагаться в том порядке, в котором они расположены в файле-шаблоне.
- Эскпорт файлов-изображений из системы в docx шаблон.
Если в отчете используется источник-файл, с приложенным файлом в форматах png, jpg, bmp, то его можно выгрузить в шаблон как картинку. для этого в соответствующей ячейке шаблона необходимо написать: {% report-label B2 1 1 parameters:50 70 %}, где в parameters передается размер изображения при вставке (50 на 70 пикселей в указанном примере).