Визуальные компоненты: различия между версиями
Wiki (обсуждение | вклад) |
Wiki (обсуждение | вклад) |
||
Строка 2: | Строка 2: | ||
=== Контейнер объектов (container) === | === Контейнер объектов (container) === | ||
Предназначен для задания единого способа отображения визуальных компонентов. | Предназначен для задания единого способа отображения визуальных компонентов и позволяющий инкапсулировать в себе объекты других типов. | ||
[[Файл:Контейнер объектов.png|без|обрамить]] | [[Файл:Контейнер объектов.png|без|обрамить]] | ||
'''Свойства''' | '''Свойства''' | ||
Строка 53: | Строка 53: | ||
=== Вкладки (tabsheet) === | === Вкладки (tabsheet) === | ||
Вкладка — это визуальный элемент, который позволяет создавать множество вкладок, для размещения на них визуальных элементов.. | Вкладка — это визуальный элемент, который позволяет создавать множество вкладок, для размещения на них визуальных элементов. | ||
[[Файл:Вкладка.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | {| class="wikitable" | ||
|'''Название атрибута''' | |'''Название атрибута''' | ||
Строка 143: | Строка 130: | ||
|} | |} | ||
=== | === Панель кнопок (toolbar) === | ||
Панель кнопок - визуальный элемент, который позволяет разместить в себе группу кнопок. | |||
[[Файл:Панель кнопок.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступ из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |readonly | |||
| colspan="1" |строка | |||
| colspan="1" | | |||
| colspan="1" |<nowiki>0|false</nowiki> | |||
| colspan="1" |да | |||
| colspan="1" |да | |||
| colspan="1" |<nowiki>Значение данного свойства обратно значению свойства enabled. Присвоение значения свойству readonly не имеет действия. Возможные значения "1"|"true" или "0"|"false" (независимы от регистра).</nowiki> | |||
|} | |||
=== Кнопка (button) === | |||
Позволяет добавить на панель кнопку, которую в последствие можно привязать к какомулибо действию, созданному в правилах заполнения (к примеру Апп-функция). | |||
[[Файл:Кнопка.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступен из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |onclick | |||
| colspan="1" |действие | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Название действия (action/actiongroup), выполняемое при нажатии на кнопку | |||
|- | |||
| colspan="1" |iconname | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |да | |||
| colspan="1" |Наименование иконки из репозитория для отображения на кнопке | |||
|- | |||
| colspan="1" |hint | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |да | |||
| colspan="1" |Текст всплывающей подсказки при наведении на кнопку | |||
|} | |||
=== Текст/подпись (label) === | |||
[[Файл:Текст-Подпись .png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступен из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |onclick | |||
| colspan="1" |действие | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия (action/actiongroup), выполняемое при клике на тексте | |||
|} | |||
=== Таблица (grid) === | |||
Компонент для отображения табличных данных. | |||
[[Файл:Таблица.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступ из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |groupby | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Перечисление колонок курсора для их группировки через запятую (Только для Delphi) | |||
|- | |||
| colspan="1" |groupbox | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |true | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |При истинном значении отображается поле для ручной группировки данных пользователем (Только для Delphi) | |||
|- | |||
| colspan="1" |selectedRow | |||
| colspan="1" |строка курсора | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Позволяет получить данные из выделенной в гриде строке, дополнительно указав название колонки в курсоре. Например выражение: | |||
{| class="wikitable" | |||
|<code>${window.grid.selectedRow.rw_name}</code> | |||
|} | |||
возвращает из выделенной строки грида grid значение ячейки в колонке с именем rw_name | |||
|- | |||
| colspan="1" |selectedRows | |||
| colspan="1" |строка курсора | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Позволяет получить данные из выделенных в гриде строк, дополнительно указав название колонки в курсоре. Например выражение: | |||
{| class="wikitable" | |||
|<code>${window.grid.selectedRows.rw_name}</code> | |||
|} | |||
возвращает через запятую из выделенных строк грида значение ячеек в колонке с именем rw_name. В случае, когда выделена только одна строка в гриде, атрибут работает как selectedRow | |||
|- | |||
| colspan="1" |selectedCell | |||
| colspan="1" |любой тип | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Позволяет получить данные из выделенной ячейки грида. Например выражение: | |||
{| class="wikitable" | |||
|<code>${window.grid.selectedCell}</code> | |||
|} | |||
возвращает значение выделенной ячейки грида | |||
|- | |||
| colspan="1" |selectedSourceField | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Название колонки в курсоре данных, соответствующей выделенной колонки грида | |||
{| class="wikitable" | |||
|<code>${window.grid.selectedSourceField}</code> | |||
|} | |||
|- | |||
| colspan="1" |selectedGroup | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Информация о группировке. Формат: | |||
{| class="wikitable" | |||
|<code><group></code> | |||
<code> <!-- 0..N --></code> | |||
<code> <col_name>group_value</col_name></code> | |||
<code></group></code> | |||
|} | |||
Например, если данные в гриде сгруппированы по колонка A и B. Осуществляется попытка провалиться в итоги, где A="Значение A", B="Значение B", то результирующая строка будет | |||
{| class="wikitable" | |||
|<code><group></code> | |||
<code> <A>Значение A</A></code> | |||
<code> <nowiki><B>Значение B</B></nowiki></code> | |||
<code></group></code> | |||
|} | |||
Не поддерживается в XM | |||
|- | |||
| colspan="1" |selectioncolumn | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Имя колонки (поля), в котором пользователь сможет осуществлять выделение галочкой. | |||
<nowiki>!!! поле с таким именем должно присутствовать в датасете, а колонка с этим полем - в списке колонок грида!!!</nowiki> | |||
|- | |||
| colspan="1" |livecomplexheaders | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |false | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Признак того, что в случае сложных заголовков сохраняется возможность сортировать и фильтровать по столбцам грида. | |||
Если этот атрибут равен "true", то значение атрибута numerate игнорируется и считается равным "false". | |||
|- | |||
| colspan="1" |columnfiltereditemslist | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |false | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |При фильтрации в фильтрах колонок грида присутствуют только значения видимые в результате применения фильтров по другим колонкам(иначе фильтры колонок содержат все значения). | |||
|- | |||
| colspan="1" |groupHeaderLineCount | |||
| colspan="1" |число | |||
| colspan="1" |нет | |||
| colspan="1" |1 | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Количество строк в заголовке группы. | |||
|- | |||
| colspan="1" |cansort | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |true | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Дать возможность пользователю сортировать данные. | |||
|- | |||
| colspan="1" |expandGroups | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |false | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Развернуть группировки. | |||
|- | |||
| colspan="1" |checkedRows | |||
| colspan="1" |строка курсора | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Позволяет получить данные из строк в гриде, отмеченными галочками, дополнительно указав колонку название колонки в курсоре. Значения будут перечислены через запятую. | |||
Например выражение: | |||
{| class="wikitable" | |||
|<code>${window.grid.checkedRows.rw_id}</code> | |||
|} | |||
для отмеченных строк грида rw_id = 10 и rw_id=20 вернет "10,20" | |||
=== | Отмеченной строкой грида является та строка, у которой значение колонки из selectioncolumn равно истине | ||
|- | |||
| colspan="1" |rowstyle | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |"Стиль строки" - Название колонки, содержащей информацию о раскраске строки таблицы. Формат раскраски описан в статье (Выделение цветом строк в окне фильтра) - '''''TTTTTT$BBBBBB$SSSS''''' | |||
|- | |||
| colspan="1" |selectedRowStyle | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |"Стиль выделенной строки" - Название колонки, содержащей информацию о раскраске выделенной строки таблицы. Формат раскраски описан в статье (Выделение цветом строк в окне фильтра) - '''''TTTTTT$BBBBBB$SSSS''''' | |||
|- | |||
| colspan="1" |minRows | |||
| colspan="1" |число | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Минимальное число строк на странице | |||
|- | |||
| colspan="1" |maxRows | |||
| colspan="1" |число | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Максимальное число строк на странице | |||
|- | |||
| colspan="1" |selectedColumnName | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Название активной колонки (которое отображается в шапке грида) | |||
|- | |||
| colspan="1" |selectedColumnNameWithBands | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Для сложных шапок - последовательность названий колонок, в которые входит активная, начиная сверху, через запятую. | |||
=== | Пример: Верхний бенд, средний бенд, название колонки. | ||
|- | |||
| colspan="1" |selectedColumnBand(xx) | |||
| colspan="1" |строка | |||
| colspan="1" |''только чтение'' | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |да | |||
| colspan="1" |Возвращает функцию для расчета сложных шапок - названий бендов. Для получения последовательности бендов заданного уровня, необходима запись типа ${eval(windowName.gridName.selectedColumnBand,xx)}, где windowName - имя формы, gridName - имя грида, xx - номер уровня (считается от колонки вверх). | |||
|- | |||
| colspan="1" |exportCaption | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Текст в шапке листа Excel при экспорте. | |||
|} | |||
==== Описание ==== | === Обработчики событий === | ||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступ из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |ondrilldown | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия, выполняемое при двойном щелчке на строк. Если столбцу грида, в ячейке которого был выполнен двойной щелчток мышью также содержит атрибут ondrilldown, то выполняется действие, назначенное столбцу. | |||
|- | |||
| colspan="1" |onrowselect | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия, выполняемое при смене активной строки грида. | |||
==== | Действие также выполняется при инициализации грида, так как в этот момент его первая строка становится активной. | ||
|- | |||
| colspan="1" |onrowclick | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия, выполняемое при нажатии на строку грида. | |||
|} | |||
=== | === Группа колонок грида (colgroup) === | ||
Объединяет несколько пордяд идущих колонок в одну визуальную группу | |||
[[Файл:Группа колонок.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | {| class="wikitable" | ||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступ из скрипта''' | |||
|'''Описание''' | |||
|- | |||
|caption | |||
|строка | |||
|да | |||
| | | | ||
| colspan="1" |да | |||
| colspan="1" |нет | |||
|Название группы колонок | |||
|} | |} | ||
=== | === Колонка (column) === | ||
Описывает визуальное представление колонки грида и связывает колонку с курсором данных. | |||
[[Файл:Колонка.png|без|обрамить]] | |||
'''Свойства''' | |||
{| class="wikitable" | {| class="wikitable" | ||
|'''Название атрибута''' | |'''Название атрибута''' | ||
Строка 177: | Строка 522: | ||
|'''Описание''' | |'''Описание''' | ||
|- | |- | ||
| colspan="1" | | |caption | ||
|строка | |||
|да | |||
| | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
|Название колонки | |||
|- | |||
| colspan="1" |sourcefield | |||
| colspan="1" |строка | |||
| colspan="1" |да | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Название отображаемой колонки курсора | |||
|- | |||
| colspan="1" |displayformat | |||
| colspan="1" |перечислимый | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Формат отображения данных: | |||
* currency - отображение денег | |||
* number - отображение произвольного числа | |||
* date - дата | |||
* datetime -дата со временем | |||
* check - булеан в виде checkbox | |||
* string - строка (в разработке) | |||
* icon - иконка по идентификатору | |||
* checkicon - кликабельная иконка - при клике на нее значение поля меняется на +1 и иконка меняется на следующую из списка icons (если список исчерпан, то с начала списка и значение поля равно 0) | |||
|- | |||
| colspan="1" |summary | |||
| colspan="1" |строка | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Формула для расчета итогов и подытогов колонки. '''Формулы 1-го рода''' - агрегирующие функции: | |||
* sum() - просуммировать значения текущей колонки. Применяется для типов данных: число (деньги) | |||
* min() - минимальное значение текущей колонки. Применяется для типов данных: число (деньги), дата | |||
* max() - максимальное значение текущей колонки. Применяется для типов данных: число (деньги), дата | |||
* avg() - среднее значение значений текущей колонки. Применяется для типов данных: число (деньги) | |||
* count() - количество строк в текущей колонке. Применяется для всех типов данных | |||
* countdistinct() - количество строк с уникальными значениями в текущей колонке. Применяется для всех типов данных | |||
* countnotempty() - количество строк с не пустыми значениями в текущей колонке. Применяется для всех типов данных | |||
'''Формулы 2-го рода''' - агрегирующие функции по произвольным колонкам курсора: | |||
* sum(название колонки курсора) - просуммировать значения заданной колонки (суммирует значения только из заданных в гриде колонок) | |||
* min(название колонки курсора) - минимальное значение заданной колонки | |||
* max(название колонки курсора) - максимальное значение заданной колонки | |||
* avg(название колонки курсора) - среднее значение значений заданной колонки | |||
* count(название колонки курсора) - количество строк в заданной колонке | |||
* countdistinct(название колонки курсора) - количество строк с уникальными значениями в заданной колонке | |||
* countnotempty() - количество строк с не пустыми значениями в текущей колонке. Применяется для всех типов данных | |||
* group(название колонки курсора) - используется для условия подсчёта подытогов. Подытог рассчитывается только для данных, группируемых по колонке, указанной в group. | |||
'''Формулы 3-го рода''' - формулы первого и второго рода и операторы для $-выражений. Например: | |||
sum(название колонки курсора) + min() - сумма значений заданной колонки плюс минимальное значение в текущей колонке. | |||
'''XM-формула''' | |||
Есть возможность так же использовать xm-формулы, они обязательно должны быть обернуть в $ выражение - '''${Текст формулы}''' | |||
|- | |||
| colspan="1" |summaryformat | |||
| colspan="1" |строка | | colspan="1" |строка | ||
| colspan="1" | | | colspan="1" | | ||
| colspan="1" | | | colspan="1" | | ||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Формат отображения данных итогов и подытогов колонки: | |||
* currency - отображение денег | |||
* number - отображение произвольного числа | |||
'''Примечание''': если в summary колонки находится формула 2-го или 3-го рода (см. summary), то необходимо определить формат итога | |||
для значения формулы с помощью summaryformat. | |||
|- | |||
| colspan="1" |headerstyle | |||
| colspan="1" |стиль | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Стиль шапки колонки. Фактически используется только для задания ширины колонки. | |||
|- | |||
| colspan="1" |contentstyle | |||
| colspan="1" |стиль | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |да | | colspan="1" |да | ||
| colspan="1" |нет | |||
| colspan="1" |Стиль данных по колонке. Никак не влияет на внешний вид колонки. Добавлен на случай будущего расширения стилей дополнительными атрибутами. | |||
|- | |||
| colspan="1" |descriptionfunc | |||
| colspan="1" |строка | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Наименование апп-функции, для получения описания картинки | |||
|- | |||
| colspan="1" |visible | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" |<nowiki>1|true</nowiki> | |||
| colspan="1" |да | | colspan="1" |да | ||
| colspan="1" |<nowiki> | | colspan="1" |нет | ||
| colspan="1" |<nowiki>Видимость столбца. Возможные значения "1"|"true" или "0"|"false" (независимы от регистра).</nowiki> | |||
Примечание: если при обращении к этому атрибуту его значение в строковом виде равно "1" или "true", то оно принимается за true, в случае любых других значений включая пустую строку или NULL оно принимается за false. | |||
|- | |||
| colspan="1" |widthinchars | |||
| colspan="1" |число | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Начальная ширина колонки в размере равном указанному количеству латинских символов "a" | |||
|- | |||
| colspan="1" |icons | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" | | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Список идентификаторов системных иконок которые последовательно будут отображаться в поле типа checkicon при изменении значения поля. (Первая иконка списка отображается при значении поля 0, вторая 1 итд) | |||
|- | |||
| colspan="1" |cellstyle | |||
| colspan="1" |строка | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Название колонки, содержащей информацию о раскраске ячейки в колонке таблицы. | |||
Значением в поле колонки стиля должна быть строка, содержащая json с настройками стилизации ячейки в строке. | |||
Поддерживаются следующие параметры стилизации: | |||
bgcolor - цвет заливки ячейки | |||
textcolor - цвет текста ячейки | |||
textalign - кастомное выравнивание содержимого ячейки по горизонтали ( left, center, right ) | |||
fractionDigits - количество знаков после запятой для ячеек с типом "number" - (параметр числовой - то есть "fractionDigits": 2 , а не "2") | |||
bold (true/false) - жирный шрифт | |||
italic (true/false) - курсив | |||
underline (true/false) - подчеркивание | |||
strikethrough (true/false) - перечеркивание | |||
Например '{"bgcolor": "#00ff00", "textcolor": "#ffff00", "underline": true, "strikethrough": false}' | |||
Важно, чтобы значением свойств bold, italic, underline и strikethrough было именно булево значение true или false, а не строки "true" или "false" | |||
|- | |||
| colspan="1" |headerLineBreak | |||
| colspan="1" |булеан | |||
| colspan="1" | | |||
| colspan="1" |false | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Признак переноса строки в заголовке колонки. | |||
|- | |||
| colspan="1" |headerTextAlign | |||
| colspan="1" |строка | |||
| colspan="1" | | |||
| colspan="1" |left | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Выравнивание текста в заголовке колонки: | |||
* left - по левому краю; | |||
* center - по центру; | |||
* right - по правому краю; | |||
* justify - по ширине. | |||
|- | |||
| colspan="1" |withDischarges | |||
| colspan="1" |булеан | |||
| colspan="1" |нет | |||
| colspan="1" |false | |||
| colspan="1" |нет | |||
| colspan="1" |нет | |||
| colspan="1" |Разделение на разряды. Учитывается для колонок с форматом отображения число или деньги. | |||
|} | |} | ||
'''Обработчики событий''' | |||
{| class="wikitable" | |||
|'''Название атрибута''' | |||
|'''Тип данных''' | |||
|'''Обязательность''' | |||
|'''Значение по умолчанию''' | |||
| colspan="1" |'''Может содержать скрипт''' | |||
| colspan="1" |'''Доступ из скрипта''' | |||
|'''Описание''' | |||
|- | |||
| colspan="1" |ondrilldown | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия при проваливании в ячейку. Информацию о ячейке можно получить из атрибутов selectedCell, selectedSourceField, selectedRow | |||
|- | |||
| colspan="1" |ondrillsummary | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Название действия при проваливании в строку итогов. Информацию о группировки можно получить из атрибута selectedGroup | |||
|- | |||
| colspan="1" |onchangevalue | |||
| colspan="1" |действие (action/actiongroup) | |||
| colspan="1" | | |||
| colspan="1" | | |||
| colspan="1" |да | |||
| colspan="1" |нет | |||
| colspan="1" |Для displayformat "check" и "checkicon" - определяет действие которое будет вызываться при смене значения в ячейке (клике на чекбокс/иконку). | |||
Вызывается после установки нового значения в гриде. | |||
|} | |||
'''Форматирование данных''' | |||
{| class="wikitable" | |||
!Тип данных/displayformat | |||
! colspan="1" |Выравнивание | |||
!Способ форматирования | |||
|- | |||
|Число/number | |||
| colspan="1" |справа | |||
| | |||
* В целой части используются разделители тысячных в виде пробелов | |||
* Дробная часть отображается только при ее наличии, т.е. она не равна 0 | |||
* Дробная часть может иметь длину не более 6 знаков | |||
* Если дробная часть имеет больше 6 знаков, она округляется по правилам математики | |||
* Дробная часть не должная содержать в качестве последних символов нули | |||
|- | |||
| colspan="1" |Дата/date | |||
| colspan="1" |по центру | |||
| colspan="1" |Формат отображения: dd.mm.yyyy hh24:mi:ss. | |||
=== | Время отображается только, если оно не равно 00:00:00 | ||
|- | |||
| colspan="1" |/datetime | |||
| colspan="1" |по центру | |||
| colspan="1" |Формат отображения: dd.mm.yyyy hh24:mi:ss | |||
|- | |||
| colspan="1" |/currency | |||
| colspan="1" |справа | |||
| colspan="1" | | |||
* В целой части используются разделители тысячных в виде пробелов | |||
* Дробная часть всегда отображается и имеет два знача после запятой. Например, для целый чисел дробная часть равна "00" | |||
|- | |||
| colspan="1" |Строка/string (в разработке) | |||
| colspan="1" |слева | |||
| colspan="1" |Данные, отличные от строки, форматируются в строку согласно правилам "Способ форматирования" для каждого типа данных. Исключение для чисел, при форматировании в строку для них не используются разделители тысячных | |||
|} | |||
== Произвольный ввод == | == Произвольный ввод == |
Версия 13:28, 15 июля 2022
Визуальные компоненты
Контейнер объектов (container)
Предназначен для задания единого способа отображения визуальных компонентов и позволяющий инкапсулировать в себе объекты других типов.
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
direction | перечислимый | нет | vertical | нет | да | Определяет способ расположения дочерний элементов
|
cssstylecontent | строка | нет | нет | да | CSS Стиль блока с содержимым для контейнера | |
ratio | число | нет | 1 | нет | нет | Определяет пропорции ширины или высоты для контейнера |
readonly | строка | нет | 0|false | да | да | Значение данного свойства обратно значению свойства enabled. Присвоение значения свойству readonly не имеет действия. Возможные значения "1"|"true" или "0"|"false" (независимы от регистра).
Примечание: если при обращении к этому атрибуту его значение в строковом виде равно "1" или "true", то оно принимается за true, в случае любых других значений включая пустую строку или NULL оно принимается за false. |
Вкладки (tabsheet)
Вкладка — это визуальный элемент, который позволяет создавать множество вкладок, для размещения на них визуальных элементов.
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
activeTabCaption | строка | только для чтения | нет | да | Название активной вкладки. Если ни одна из вкладок не активна, то значение атрибута равно пустой строке. | |
activeTabPosition | число | только для чтения | нет | да | Позиция активной вкладки. Нумерация вкладок начинается с единицы. Если ни одна из вкладок не активна, то значение атрибута равно нулю. | |
activeTab | строка | да | да | Название активной вкладки. Если название задано, при загрузке режима вкладка с этим названием становится активной | ||
direction | строка | horizontal | нет | да | Направление отображения вкладок (vertical - вкладки слева, контент - справа | horizontal - вкладки сверху, контент снизу) | |
cssstylecaption | строка | нет | да | Имя CSS стиля вкладки | ||
cssstyleactive | строка | нет | да | Имя CSS стиля активной вкладки | ||
enableCollapse | булеан | false | нет | да | Возможность сворачивания (только для вкладок с направлением отображения "vertical") | |
collapsed | число | 0 | нет | да | Положение по умолчанию (свернуты - 1, развернуты - 0) |
Панель кнопок (toolbar)
Панель кнопок - визуальный элемент, который позволяет разместить в себе группу кнопок.
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
readonly | строка | 0|false | да | да | Значение данного свойства обратно значению свойства enabled. Присвоение значения свойству readonly не имеет действия. Возможные значения "1"|"true" или "0"|"false" (независимы от регистра). |
Кнопка (button)
Позволяет добавить на панель кнопку, которую в последствие можно привязать к какомулибо действию, созданному в правилах заполнения (к примеру Апп-функция).
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступен из скрипта | Описание |
onclick | действие | нет | нет | да | Название действия (action/actiongroup), выполняемое при нажатии на кнопку | |
iconname | строка | нет | да | да | Наименование иконки из репозитория для отображения на кнопке | |
hint | строка | нет | да | да | Текст всплывающей подсказки при наведении на кнопку |
Текст/подпись (label)
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступен из скрипта | Описание |
onclick | действие | нет | нет | нет | Название действия (action/actiongroup), выполняемое при клике на тексте |
Таблица (grid)
Компонент для отображения табличных данных.
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание | ||
groupby | строка | нет | да | нет | Перечисление колонок курсора для их группировки через запятую (Только для Delphi) | |||
groupbox | булеан | нет | true | нет | нет | При истинном значении отображается поле для ручной группировки данных пользователем (Только для Delphi) | ||
selectedRow | строка курсора | только чтение | нет | да | Позволяет получить данные из выделенной в гриде строке, дополнительно указав название колонки в курсоре. Например выражение:
возвращает из выделенной строки грида grid значение ячейки в колонке с именем rw_name | |||
selectedRows | строка курсора | только чтение | нет | да | Позволяет получить данные из выделенных в гриде строк, дополнительно указав название колонки в курсоре. Например выражение:
возвращает через запятую из выделенных строк грида значение ячеек в колонке с именем rw_name. В случае, когда выделена только одна строка в гриде, атрибут работает как selectedRow | |||
selectedCell | любой тип | только чтение | нет | да | Позволяет получить данные из выделенной ячейки грида. Например выражение:
возвращает значение выделенной ячейки грида | |||
selectedSourceField | строка | только чтение | нет | да | Название колонки в курсоре данных, соответствующей выделенной колонки грида
| |||
selectedGroup | строка | только чтение | нет | да | Информация о группировке. Формат:
Например, если данные в гриде сгруппированы по колонка A и B. Осуществляется попытка провалиться в итоги, где A="Значение A", B="Значение B", то результирующая строка будет
Не поддерживается в XM | |||
selectioncolumn | строка | только чтение | нет | нет | Имя колонки (поля), в котором пользователь сможет осуществлять выделение галочкой.
!!! поле с таким именем должно присутствовать в датасете, а колонка с этим полем - в списке колонок грида!!! | |||
livecomplexheaders | булеан | нет | false | нет | нет | Признак того, что в случае сложных заголовков сохраняется возможность сортировать и фильтровать по столбцам грида.
Если этот атрибут равен "true", то значение атрибута numerate игнорируется и считается равным "false". | ||
columnfiltereditemslist | булеан | нет | false | нет | нет | При фильтрации в фильтрах колонок грида присутствуют только значения видимые в результате применения фильтров по другим колонкам(иначе фильтры колонок содержат все значения). | ||
groupHeaderLineCount | число | нет | 1 | нет | нет | Количество строк в заголовке группы. | ||
cansort | булеан | нет | true | нет | нет | Дать возможность пользователю сортировать данные. | ||
expandGroups | булеан | нет | false | нет | нет | Развернуть группировки. | ||
checkedRows | строка курсора | только чтение | нет | да | Позволяет получить данные из строк в гриде, отмеченными галочками, дополнительно указав колонку название колонки в курсоре. Значения будут перечислены через запятую.
Например выражение:
для отмеченных строк грида rw_id = 10 и rw_id=20 вернет "10,20" Отмеченной строкой грида является та строка, у которой значение колонки из selectioncolumn равно истине | |||
rowstyle | строка | нет | нет | да | "Стиль строки" - Название колонки, содержащей информацию о раскраске строки таблицы. Формат раскраски описан в статье (Выделение цветом строк в окне фильтра) - TTTTTT$BBBBBB$SSSS | |||
selectedRowStyle | строка | нет | нет | да | "Стиль выделенной строки" - Название колонки, содержащей информацию о раскраске выделенной строки таблицы. Формат раскраски описан в статье (Выделение цветом строк в окне фильтра) - TTTTTT$BBBBBB$SSSS | |||
minRows | число | нет | нет | нет | Минимальное число строк на странице | |||
maxRows | число | нет | нет | нет | Максимальное число строк на странице | |||
selectedColumnName | строка | только чтение | нет | да | Название активной колонки (которое отображается в шапке грида) | |||
selectedColumnNameWithBands | строка | только чтение | нет | да | Для сложных шапок - последовательность названий колонок, в которые входит активная, начиная сверху, через запятую.
Пример: Верхний бенд, средний бенд, название колонки. | |||
selectedColumnBand(xx) | строка | только чтение | нет | да | Возвращает функцию для расчета сложных шапок - названий бендов. Для получения последовательности бендов заданного уровня, необходима запись типа ${eval(windowName.gridName.selectedColumnBand,xx)}, где windowName - имя формы, gridName - имя грида, xx - номер уровня (считается от колонки вверх). | |||
exportCaption | строка | нет | да | нет | Текст в шапке листа Excel при экспорте. |
Обработчики событий
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
ondrilldown | действие (action/actiongroup) | нет | да | нет | Название действия, выполняемое при двойном щелчке на строк. Если столбцу грида, в ячейке которого был выполнен двойной щелчток мышью также содержит атрибут ondrilldown, то выполняется действие, назначенное столбцу. | |
onrowselect | действие (action/actiongroup) | нет | да | нет | Название действия, выполняемое при смене активной строки грида.
Действие также выполняется при инициализации грида, так как в этот момент его первая строка становится активной. | |
onrowclick | действие (action/actiongroup) | нет | да | нет | Название действия, выполняемое при нажатии на строку грида. |
Группа колонок грида (colgroup)
Объединяет несколько пордяд идущих колонок в одну визуальную группу
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
caption | строка | да | да | нет | Название группы колонок |
Колонка (column)
Описывает визуальное представление колонки грида и связывает колонку с курсором данных.
Свойства
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
caption | строка | да | да | нет | Название колонки | |
sourcefield | строка | да | нет | нет | Название отображаемой колонки курсора | |
displayformat | перечислимый | нет | нет | Формат отображения данных:
| ||
summary | строка | нет | нет | Формула для расчета итогов и подытогов колонки. Формулы 1-го рода - агрегирующие функции:
Формулы 2-го рода - агрегирующие функции по произвольным колонкам курсора:
Формулы 3-го рода - формулы первого и второго рода и операторы для $-выражений. Например: sum(название колонки курсора) + min() - сумма значений заданной колонки плюс минимальное значение в текущей колонке. XM-формула Есть возможность так же использовать xm-формулы, они обязательно должны быть обернуть в $ выражение - ${Текст формулы} | ||
summaryformat | строка | нет | нет | Формат отображения данных итогов и подытогов колонки:
Примечание: если в summary колонки находится формула 2-го или 3-го рода (см. summary), то необходимо определить формат итога для значения формулы с помощью summaryformat. | ||
headerstyle | стиль | да | нет | Стиль шапки колонки. Фактически используется только для задания ширины колонки. | ||
contentstyle | стиль | да | нет | Стиль данных по колонке. Никак не влияет на внешний вид колонки. Добавлен на случай будущего расширения стилей дополнительными атрибутами. | ||
descriptionfunc | строка | нет | нет | Наименование апп-функции, для получения описания картинки | ||
visible | строка | нет | 1|true | да | нет | Видимость столбца. Возможные значения "1"|"true" или "0"|"false" (независимы от регистра).
Примечание: если при обращении к этому атрибуту его значение в строковом виде равно "1" или "true", то оно принимается за true, в случае любых других значений включая пустую строку или NULL оно принимается за false. |
widthinchars | число | нет | нет | нет | Начальная ширина колонки в размере равном указанному количеству латинских символов "a" | |
icons | строка | нет | нет | нет | Список идентификаторов системных иконок которые последовательно будут отображаться в поле типа checkicon при изменении значения поля. (Первая иконка списка отображается при значении поля 0, вторая 1 итд) | |
cellstyle | строка | нет | нет | нет | нет | Название колонки, содержащей информацию о раскраске ячейки в колонке таблицы.
Значением в поле колонки стиля должна быть строка, содержащая json с настройками стилизации ячейки в строке. Поддерживаются следующие параметры стилизации: bgcolor - цвет заливки ячейки textcolor - цвет текста ячейки textalign - кастомное выравнивание содержимого ячейки по горизонтали ( left, center, right ) fractionDigits - количество знаков после запятой для ячеек с типом "number" - (параметр числовой - то есть "fractionDigits": 2 , а не "2") bold (true/false) - жирный шрифт italic (true/false) - курсив underline (true/false) - подчеркивание strikethrough (true/false) - перечеркивание Например '{"bgcolor": "#00ff00", "textcolor": "#ffff00", "underline": true, "strikethrough": false}' Важно, чтобы значением свойств bold, italic, underline и strikethrough было именно булево значение true или false, а не строки "true" или "false" |
headerLineBreak | булеан | false | нет | нет | Признак переноса строки в заголовке колонки. | |
headerTextAlign | строка | left | нет | нет | Выравнивание текста в заголовке колонки:
| |
withDischarges | булеан | нет | false | нет | нет | Разделение на разряды. Учитывается для колонок с форматом отображения число или деньги. |
Обработчики событий
Название атрибута | Тип данных | Обязательность | Значение по умолчанию | Может содержать скрипт | Доступ из скрипта | Описание |
ondrilldown | действие (action/actiongroup) | да | нет | Название действия при проваливании в ячейку. Информацию о ячейке можно получить из атрибутов selectedCell, selectedSourceField, selectedRow | ||
ondrillsummary | действие (action/actiongroup) | да | нет | Название действия при проваливании в строку итогов. Информацию о группировки можно получить из атрибута selectedGroup | ||
onchangevalue | действие (action/actiongroup) | да | нет | Для displayformat "check" и "checkicon" - определяет действие которое будет вызываться при смене значения в ячейке (клике на чекбокс/иконку).
Вызывается после установки нового значения в гриде. |
Форматирование данных
Тип данных/displayformat | Выравнивание | Способ форматирования |
---|---|---|
Число/number | справа |
|
Дата/date | по центру | Формат отображения: dd.mm.yyyy hh24:mi:ss.
Время отображается только, если оно не равно 00:00:00 |
/datetime | по центру | Формат отображения: dd.mm.yyyy hh24:mi:ss |
/currency | справа |
|
Строка/string (в разработке) | слева | Данные, отличные от строки, форматируются в строку согласно правилам "Способ форматирования" для каждого типа данных. Исключение для чисел, при форматировании в строку для них не используются разделители тысячных |
Произвольный ввод
Произвольный ввод - это визуальное действие, которое позволяет пользователю заполнить поля документа произвольным значением.
Пример отображения компонента "Произвольный ввод"
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Параметр | Обязательно | Описание: атрибут предназначен для выбора из списка соответствующего параметра, заданного в структуре документа.
Допустимые значения: статичная строка Примечание: В списке содержатся только те параметры, которые соответствуют уровню блока в структуре документа. |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение | |
---|---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для скрытия связанного сдействием визуального элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Ложь.
| |
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на возможность изменять значение параметра при помощи визуального компонента. Выражение имеет логический тип.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина.
|
Зависимости визуального компонента от типа параметра
Тип | Описание |
---|---|
Строка | Позволяет ввести в компонент строку |
Число | Позволяет вводить в компонент только числовое значение |
Дата | Позволяет выбрать дату или ввести с клавиатуры |
Дата и время | Позволяет выбрать дату со временем |
Логический | Позволяет выбрать значение True или False |
Отображение значения
Отображение значения - это визуальное действие, которое позволяет пользователю отображать значение поля документа
Пример отображения компонента "Произвольный текст"
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Параметр | Обязательно | Описание: атрибут предназначен для выбора из списка соответствующего параметра, заданного в структуре документа.
Допустимые значения: статичная строка. В списке содержатся только те параметры, которые соответствуют уровню блока в структуре документа. |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия. |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение | |
---|---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Ложь.
| |
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина.
|
Зависимости визуального компонента от типа параметра
Тип | Описание |
---|---|
Строка | Позволяет отобразить в компонент строку |
Число | Позволяет отобразить в компонент числовое значение |
Дата | Позволяет отобразить в компонент дату |
Дата и время | Позволяет отобразить в компонент дату со временем |
Логический | Позволяет отобразить в компонент значение True или False(в чекбоксе) |
Выбор из списка
Выбор из списка - это визуальное действие, которое разрешает пользователю заполнить поле документа одним значением из списка допустимых значений.
Пример отображения компонента "Выбор из списка"
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Тип выбора | Обязательно | Описание: позволяет настроить выпадающий список для выбора значение из грида.
Допустимые значения:
По умолчанию установлено значение "Из апп-функции" |
Параметр | Обязательно | Описание: атрибут предназначен для указания параметра, в которых будет сохранен идентификатор из справочника
Допустимые значения: число |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Свойства для типа выбора - "из грида"
Данные свойства предназначены, когда требуется заполнить выпадающий список на основе колонок грида.
Свойство | Наличие значения | Назначение |
---|---|---|
Имя грида | Обязательно | Описание: атрибут предназначен для выбора грида из списка, который будет использоваться для "Выпадающего списка"
Допустимые значения: статичная строка |
Условия выбора строк | Не обязательно | Описание: атрибут предназначен для задания выражения, при котором будут отображаться строки в выпадающем списке.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Свойства для типа выбора - "из апп-функции"
Данные свойства предназначены, когда требуется заполнить выпадающий список с помощью апп-функции
Свойство | Наличие значения | Назначение |
---|---|---|
Апп-функция | Не обязательно | Описание: Атрибут предназначен для выбора апп-функции, по которой будет выбираться значение из списка. Апп-функция должны иметь тип 1, т.е. возвращать курсор.
Допустимые значения: статичная строка |
Начать поиск с | Не обязательно | Описание: атрибут предназначен для задания минимального количества символов, после ввода которых будет осуществляться поиск. Значение может принимать только числовой тип
Допустимые значения: число Примечание: если выражение не задано, то условие по умолчанию поиск осуществляется сразу |
Входной параметр | Обязательно для(Наименование\Идентификатор\Код) | Описание: предназначен для передачи входных параметров
Допустимые значения: статичная строка |
Значение | Обязательно для(Наименование\Идентификатор\Код) | Описание: предназначен для указания значения(выражения)
Допустимые значения: статичная строка |
Параметр документа | Обязательно(для Идентификатора и Наименования) | Описание: атрибут предназначен для указания выходных параметров при выборе значения я из списка
Допустимые значения: статичная строка |
Описание колонки | Не обязательно | Описание: атрибут задает название для колонки(в случае если используется multisublistchoise) В других случаях название не влияет на компонент
Допустимые значения: статичная строка |
Свойства для типа выбора - "из локального справочника"
Свойство | Наличие значения | Назначение |
---|---|---|
Справочник | Не обязательно | Описание: атрибут предназначен для выбора локального справочника
Допустимые значения: название справочника |
Параметр документа | Обязательно(для Идентификатора и Наименования) | Описание: атрибут предназначен для указания выходных параметров при выборе значения я из списка
Допустимые значения: статичная строка |
Описание колонки | Не обязательно | Описание: атрибут задает название для колонки(в случае если используется multisublistchoise) В других случаях название не влияет на компонент
Допустимые значения: статичная строка |
Свойства для типа выбора - "общего справочника"
Свойство | Наличие значения | Назначение |
---|---|---|
Справочник | Не обязательно | Описание: Атрибут предназначен для выбора общего справочника
Допустимые значения: статичная строка |
Параметр документа | Обязательно(для Идентификатора и Наименования) | Описание: Атрибут предназначен для указания выходных параметров при выборе значения я из списка
Допустимые значения: статичная строка |
Описание колонки | Не обязательно | Описание: Атрибут задает название для колонки(в случае если используется multisublistchoise) В других случаях название не влияет на компонент
Допустимые значения: статичная строка |
Апп-функция
Апп-функция - это действие, которое позволяет изменять поля документа через БД. Поля документа передаются в апп-функцию в качестве входных и выходных параметров.
Пример отображения компонента "Апп-функция"
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Апп-функция | Обязательно | Описание: позволяет выбрать имя апп-функции
Допустимые значения: статичная строка, для апп-функции с CALL_TYPE = 1 или 2 |
Выполняется | Обязательно | Описание: атрибут позволяет указать, каким образом будет выполняться апп-функция(автоматически или по нажатию на кнопку)
Допустимые значения:
По умолчанию всегда установлено значение "Автоматически" |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Изменить весь документ
Изменить весь документ - это действие, которое позволяет одной операцией изменить все поля документа включая вложенные таблицы.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Апп-функция | Обязательно | Описание: позволяет выбрать имя апп-функции, которая будет использоваться для изменения документа
Допустимые значения: статичная строка, для апп-функции с CALL_TYPE = 2 |
Выполняется | Обязательно | Описание: атрибут позволяет указать, каким образом будет выполняться апп-функция(автоматически или по нажатию на кнопку)
Допустимые значения:
По умолчанию всегда установлено значение "По желанию пользователя" |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Проверка
Проверка - это не визуальное действие, которое позволяет проверить правильность заполнения полей документа и при необходимости выдать сообщение об ошибке.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Параметр | Обязательно | Описание: Атрибут позволяет выбрать параметр, для которого будет осуществляться проверка
Допустимые значения():
Примечание: по умолчанию указано значение <Не выбран> |
Тип сообщения | Обязательно | Описание: Атрибут позволяет выбрать вид сообщения, который будет появляться в случае выполнения выражения
Допустимые значения:
По умолчанию всегда установлено значение "Ошибка" |
Выражение | Описание: Данный атрибут позволяет ввести выражение, при истинном значении которого, будет выдаваться сообщение
Допустимые значения: статичная строка | |
Сообщение | Обязательно | Описание: Данный атрибут позволяет задать сообщение, которое будет выдаваться в случае если выражение = Истина
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Проверка данных поддокумента (CheckRows)
Данное действие позволяет проверить корректность заполнения всех строк указанного поддокумента и вывести сообщение об ошибке в родительском (относительно поддокумента) окне.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Поддокумент | Обязательно | Описание: Атрибут позволяет выбрать таблицу, для строк которой будут последовательно осуществляться вложенные в неё действия
Допустимые значения:
|
Сообщение | Обязательно | Описание: Атрибут позволяет задать сообщение, которое будет отображаться в случае наличия ошибки в одной из строк проверяемой таблицы
Допустимые значения:
Примечание: после указанного текста ошибки будет отображён текст ошибки, возникшей в проверяемой строке вложенной таблицы |
Описание | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Присвоение
Присвоение - действие, которое позволяет одной операцией изменить все поля документа.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Параметр | Обязательно | Описание: атрибут предназначен для выбора параметра, для которого будет срабатывать присвоение
Допустимые значения: любой параметр из перечисленных типов(строка, число, дата, дата со временем, логический) |
Выражение | Обязательно | Описание: атрибут предназначен для задания вычислимого выражение к выбранному параметру
Допустимые значения: результат выражения должен соответствовать типу параметра |
Выполняется | Обязательно | Описание: атрибут позволяет указать каким образом будет выполняться присвоение значения (автоматически или по нажатию на кнопку)
По умолчанию всегда установлено значение "Автоматически" |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Открытие фильтра на редактирование (editFilter)
Открытие фильтра на редактирование - действие, которое позволяет получить фильтр документа, открыть окно редактирования и по нажатию кнопки "Сохранить" передать фильтр документа и его описание в параметры.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Параметр (param) | Необязательно | Описание: атрибут предназначен для выбора параметра, для которого будет срабатывать присвоение выходного значения фильтра.
Допустимые значения: параметр типа строка. |
Параметр описания ограничений фильтра (paramDescr) | Необязательно | Описание: атрибут предназначен для выбора параметра, для которого будет срабатывать присвоение выходного значения описания фильтра.
Допустимые значения: параметр типа строка. |
Наименование фильтра (caption) | Необязательно | Описание: атрибут позволяет задать заголовок (наименование) окна редактора фильтра.
Допустимые значения: формула, результат - строка или STRING_NULL. |
Тип юниверса (universeType) | Обязательно | Описание: Атрибут предназначен для выбора типа.
Допустимые значения:
По умолчанию задано значение DOCUNV |
ИД юниверса (universeId) | Обязательно | Описание: Атрибут позволяет ввести ИД юниверса (для типа ETRAN )
Допустимые значения: статичное число |
Ключевое слово (bo_unitype) | Обязательно | Описание: атрибут позволяет задать ключевое слово дополнительно к ИД юниверса
Допустимые значения: формула, результат - строка или STRING_NULL. |
Тип документа (docTypeId) | Обязательно | Описание: Атрибут позволяет выбрать тип документа (для типа DOCUNV)
Допустимые значения: статичное число |
Описание (description) | Обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Режим редактирования фильтра (editmode) | Необязательно | Описание: Задает режим редактирования фильтра (что можем менять)
Допустимые значения:
По умолчанию задано значение where |
Список полей (selstr) | Необязательно | Описание: атрибут предназначен для выбора параметра, для которого будет срабатывать для получения входного и присвоение выходного значения полей фильтра (для типа ETRAN ).
Допустимые значения: параметр типа строка. |
Список полей группировки (groupstr) | Необязательно | Описание: атрибут предназначен для выбора параметра, для которого будет срабатывать для получения входного и присвоение выходного значения полей группировки фильтра (для типа ETRAN ).
Допустимые значения: параметр типа строка. |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |
Внешнее действие
Внешнее действие - это действие позволяющее открыть другой документ/режим/печатную форму.
Основные свойства
Свойство | Наличие значения | Назначение |
---|---|---|
Тип | Обязательно | Описание: атрибут предназначен для выбора одного из 4х возможных внешних действии.
Допустимые значения:
По умолчанию тип не выбран |
Описание | Не обязательно | Описание: атрибут позволяет задать имя для визуального компонента. По умолчанию, если описание не задано, то элемент на форме будет отображаться без названия.
Допустимые значения: статичная строка |
Назначение | Не обязательно | Описание: атрибут предназначен для описания параметра в спецификации.
Допустимые значения: статичная строка |
Основные свойства для Печатной формы
Свойство | Наличие значения | Назначение |
---|---|---|
Формат данных | Обязательно | Описание: Атрибут предназначен для выбора формата данных.
Допустимые значения:
По умолчанию задано значение XLS |
Идентификатор отчета | Обязательно | Описание: Атрибут позволяет ввести идентификатор шаблона, который будет открываться(сохраняться) при нажатии на кнопку
Допустимые значения: статичная строка |
Свойства для Создания документа
Свойство | Наличие значения | Назначение |
---|---|---|
Тип документа | Обязательно | Описание: Атрибут позволяет выбрать тип документа
Допустимые значения: статичная строка |
Апп-функция получения экземпляра документа | Не обязательно | Описание: Атрибут позволяет выбрать апп-функция, в которой будет передаваться экземпляр для документа данного типа
Допустимые значения: статичная строка |
Дополнительно/Скрыть | Не обязательно | Описание: Атрибут позволяет указать название режима
Допустимые значения: статичная строка |
Свойства для Открытия документа
Свойство | Наличие значения | Назначение |
---|---|---|
Идентификатор документа | Обязательно | Описание: атрибут предназначен для указания выражения, которое будет содержать идентификатор открываемого документа
Допустимые значения: статичная строка По умолчанию тип не выбран |
Название режима | Не обязательно | Атрибут позволяет указать название режима |
Свойства для Открытия режима
Свойство | Наличие значения | Назначение |
---|---|---|
Идентификатор | Обязательно | Описание: атрибут предназначен для указания выражения, которое будет содержать идентификатор режима
Допустимые значения: статичная строка(Значение может задаваться явно, т.е. в числовом виде, либо через переменную документа. например XM_DOCUMENT.num, где XM_DOCUMENT - название документа, num - имя переменной ) По умолчанию тип не выбран |
Название режима | Не обязательно | Атрибут позволяет выбрать название из существующих режимов |
Свойства применимости
Свойство | Наличие значения | Назначение |
---|---|---|
Скрывать если | Не обязательно | Описание: атрибут предназначен для визуального скрытия элемента на форме.
Допустимые значения: формула, результат - логический тип. Если значение равно:
|
Выполнять если | Не обязательно | Описание: атрибут предназначен для задания условия, значение которого влияет на доступность к данному компоненту.
Допустимые значения: формула, результат - логический тип. Если значение равно:
Примечание: если выражение не задано, то условие по умолчанию принимает значение Истина. |