Значение

Компонент «Значение»  располагается в Дереве структуры формуляра непосредственно под Компонентом «Паттерн». 
«Значение» позволяет перенести содержимое из исходного поля контекста в целевую ячейку (или её часть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-экран, содержащий список полей контекста, релевантных для создаваемых «Значений». В представленном списке, необходимо отметить одно или несколько полей (посредством дабл-клика мыши). Отмеченные поля будут обозначены пиктограммой  :



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

              

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