Выражение привязки

Выражения привязок инструментальной панели очень похожи на выражения привязок сервера. Однако выражения привязок в виджетах могут включать несколько основных типов ссылок:

  • Специальные ссылки Web UI (использующие схему web/), которые запускают специфичные для Web UI операции

Ссылки на компоненты

Ссылка на компонент указывает на свойство компонента инструментальной панели (например, текст метки). Она имеет следующий формат:

form/component:property

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

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

property  - имя определенного свойства внутри компонента. Имена свойств можно найти в описании свойств каждого компонента инструментальной панели. Указывать свойство в ссылке на компонент необязательно. Если свойство не указано, ссылка ведет к свойству по умолчанию компонента.

Формат свойства, т.е. типа значения, возвращаемого ссылкой на свойство компонента, можно найти в описании этого свойства в справочнике компонентов.

Примеры ссылок на свойство компонента

{form/userNameField:}

{form/userNameField:text}

Обе ссылки разрешаются в текст, который содержится в userNameField (при условии, что это текстовое поле). Первая ссылка указывает на свойство по умолчанию компонента, то есть text, а вторая прямо называет его (:text).

Специальные ссылки web UI

Специальная ссылка инициирует выполнение операции, специфичной для Web UI. Ссылка имеет следующий формат:

web/operation(["parameter"])

Поддерживаются следующие операции:

  • web/logout() - прекращает текущую сессию Web UI и осуществляет выход пользователя
  • web/redirect("context" [, parameter1 [, parameter2...]]) - переадресует текущего пользователя на другую веб инструментальную панель согласно указанному пути контекста
  • web/executeAction("context:action!") - выполняет действие из контекста с указанным путем

Пример выражения привязки инструментальной панели

{form/numberField1:value} * 100

Это выражение разрешится в число, равное свойству value компонента Числовое поле, названного numberField1, умноженному на 100.