Значение

Компонент «Значение» располагается в Дереве структуры формуляра непосредственно под Компонентом «Паттерн».

«Значение» позволяет перенести содержимое из исходного поля контекста в целевую ячейку (или её часть) Excel-шаблона. При этом целевая ячейка должна находиться в пределах (внутри границ) вышестоящего «Паттерна».

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

Пункт «Область в шаблоне»

Данный пункт необходим для передачи значения из контекста в целевую ячейку (или её часть) Excel-шаблона. При этом, есть два способа:

  • Сопоставление значения с целевой ячейкой в Excel-шаблоне.

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

  • в Excel-шаблоне установите курсор на требуемую ячейку;

  • нажмите на кнопку в пункте «Область в шаблоне»:

  • Сопоставление значения с текстовой меткой в Excel-шаблоне.

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

  • в Excel-шаблоне вставьте текстовую метку в требуемую ячейку, или часть ячейки (например, [ADDRESS] ) , находящуюся в пределах вышестоящего Паттерна :

  • нажмите на кнопку

в пункте «Область в шаблоне» . На открывшемся popup-экране укажите метку [ADDRESS] :

Пункт «Значение»

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

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

Имеется возможность связи не только с элементарным полем контекста, но и с вложенной таблицей. При этом дополнительно потребуется ввести Поле таблицы и Номер строки, из которой необходимо взять значение.

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

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

  • Опция

включает процедуру преобразования (если таковая имеется) выводимого значения во внешний формат (например, конвертация даты из '20140101' в '01.01.2014').

Пункт «Опции вывода»

  • Значение

Если данная опция включена, то Значение будет вставлено в ячейку обычным образом.

  • Формула

Если данная опция включена, Значение будет интерпретировано как формула ( См.подробнее здесь ).

Примечание:
 необходимо использовать англоязычный синтаксис формул (т.е. вместо СУММ требуется SUM; вместо ДЛСТР требуется LEN и т.д.).

  • Матрица (каждая буква в отдельной ячейке)

Если включена данная опция, то каждая буква Значения будет помещена в отдельную ячейку заданной области (см.серые ячейки в примере ниже):

При этом, в пункте «Область в шаблоне» необходимо сопоставить«Значение» с диапазоном ячеек (прямоугольной областью, состоящей из нескольких ячеек), по которому требуется побуквенно распределить текст «Значения»:

С помощью опции «Интервал» можно регулировать расстояние между заполняемыми ячейками.

Например, на рисунке ниже, интервал равен 1:

Пункт «Проверка данных»

По-умолчанию, опция Проверка данных для ячейки (если Проверка данных задана) будет скопирована "как есть" из шаблона в результирующий файл .

Если необходимо динамически переопределять какие-либо параметры Проверки данных, используйте следующие подпункты:

  • Атрибуты (из шаблона)

По-умолчанию, все атрибуты будут скопированы "как есть" из шаблона в результирующий файл .

Если необходимо динамически переопределять какие-либо атрибуты, укажите вложенную таблицу контекста, которая имеет два поля: первое поле для наименования атрибута и второе поле - для его значения. Внимание: оба поля должны иметь тип String или Char. Например, можно использовать стандартный табличный тип CKF_FIELD_VALUE_TABLE (если он доступен в вашей системе), или его аналог.

Список атрибутов, доступных для динамической замены:

allowBlank

error

errorStyle

errorTitle

imeMode

operator

prompt

promptTitle

showDropDown

showErrorMessage

showInputMessage

type

Внимание: Полное описание атрибутов см.здесь .

Все атрибуты соответствуют полям на popup-

экране Проверка данных:

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

  • (1) Значение (Формула)

Первая формула (значение) в опции Проверка данных. Она используется как нижняя граница для операторов сравнения 'between' и 'notBetween', а также, в качестве сравниваемой величины для других операторов сравнения (equal, notEqual, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual), либо она содержит ссылку на диапазон ячеек для типа проверки "Список". Содержимое может быть представлено как excel-формулой, так и константой, а так же константой-списком (последовательностью значений, разделенных точкой с запятой).

По-умолчанию, первая формула будет скопирована "как есть" из шаблона в результирующий файл .

Для динамической подмены, можно использовать два пути:

    • Определить поле контекста, которое содержит значение формулы.

    • Выбрать компонент Грид из списка присутствующих в форме, и его Столбец, который должен использоваться в качестве набора данных (для типа проверки "Список").


  • (2) Значение (Формула)

Вторая формула (значение) в опции Проверка данных. Она используется только как верхняя граница для операторов сравнения 'between' и 'notBetween'.

По-умолчанию, вторая формула будет скопирована "как есть" из шаблона в результирующий файл .

Для динамической подмены, следует определить поле контекста, которое содержит значение формулы.

Массовое создание Значений через выбор полей из контекста

Для удобства, доступен ещё один способ создания «Значений»: массовое создание через выбор полей из контекста. Чтобы им воспользоваться, при создании Значения, необходимо дважды щелкнуть на пиктограмме

в правой части соответствующей строки POPUP-экрана выбора компонента:

В результате откроется новый POPUP-экран, содержащий список полей контекста, релевантных для создаваемых «Значений». В представленном списке, необходимо отметить одно или несколько полей (посредством дабл-клика мыши). Отмеченные поля будут обозначены пиктограммой

После нажатия кнопки

в формуляр будут добавлены «Значения», соответствующие выбранным полям и уже имеющие с ними связь:

Для добавленных «Значений» остается только добавить связь с областью в шаблоне.