Лист

Понятие «Лист» в XLSX Workbench соответствует Листу в MS Excel.

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

Вкладка свойств:

Пункт «Связь с шаблоном»

Пункт «Связь с шаблоном» необходим для того, чтобы сопоставить компонент с листом Excel-шаблона. Для сопоставления следует нажать на кнопку

и из средства поиска выбрать нужный лист:

Здесь же можно определить, Видимым или Скрытым будет данный лист в Печатной форме во время выполнения:

Пункт «Наименование при выводе»

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

По умолчанию включен режим «Авто», который означает наименование по автоинкрементному принципу. Т.е. имя листа из формуляра переносится в XLSX-файл (если же лист с таким именем уже присутствует в файле, то к имени листа добавляется цифра - счетчик).

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

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

Здесь же можно указать, нажав кнопку:

следует ли использовать для наименования всё поле целиком или его фрагмент (допустим, первые 10 символов); а также, надо ли конвертировать значение во внешний формат (например, поле имеет тип даты).

Пункт «Появление при выводе»

По умолчанию, Лист будет всегда выводиться в Печатную форму (результирующий XLSX-файл) . Однако, есть возможность динамически задавать появление компонента в Печатной форме.

Данный пункт позволяет связать вывод компонента с наличием значения в каком-либо поле контекста (т.е. Лист появится в Печатной форме только в случае, если указанное поле контекста не пустое).

Необходимо нажать на кнопку и в средстве поиска выбрать требуемое поле контекста (т.н. индикатор появления):

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

и, на всплывающем экране, указать с какой позиции и сколько символов следует анализировать.

Пункт «Печать на каждой странице»

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

Необходимо нажать на кнопку

и выбрать тот паттерн, строки или столбцы которого следует повторить в начале каждой страницы.

Пункт «Защита листа»

В данном пункте реализованы расширенные опции защиты листа.

Из шаблона

Опции защиты листа в режиме "Run-time" будут полностью скопированы из соответствующего листа шаблона в "Design-time".

Из контекста

Анализируется выбранное поле контекста (имеющего тип CHAR длинной 15). Каждый символ (позиция) этого поля которого является флагом соответствующей опции защиты листа:

Статически

Требуется просто расставить чекбоксы напротив желаемых опций защиты листа:

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