Различия

Показаны различия между двумя версиями страницы.

--- request [2025/07/11 14:59] – [request name="log"] madmin
+++ request [2026/06/11 14:37] (текущий) – [request name="httpput"] madmin
@@ Строка 81: / Строка 81: @@
 ==== request name="form" ====
-Запрос на получение [[form-definition|декларативного описания экранной формы]]. Имя запрашиваемой формы брать из параметра **form**. Возвращает [[form-definition]], по нему экранная форма будет построена и отображена.
+Запрос на получение [[form-definition|декларативного описания экранной формы]]. Имя запрашиваемой формы брать из параметра **form**. В ответ на запрос, сервер должен вернуть  [[form-definition]], по нему экранная форма будет построена и отображена.
 <code>
 <request
   request|name="form"
   mode|form="<имя формы>"
+  closable="1|0"
+  clearhistory="0|1"
   modal="0|1"
   width="<ширина модального окна>"
@@ Строка 99: / Строка 103: @@
 </code>
+Описание атрибутов:
+  * **form**: имя экранной формы, передается на сервер, по нему сервер определяет, описание какой экранной формы вернуть
+  * **closable**: обрабатывается клиентом, не передается на сервер. Значение closable="0" блокирует кнопку закрытия экранной формы
+  * **clearhistory**: обрабатывается клиентом, не передается на сервер. Значение clearhistory="1" закрывает все открытые экранные формы, кроме форм с признаком closable="0".
+  * **modal**: обрабатывается клиентом, не передается на сервер. Значение modal="1" открывает экранную форму в виде модального окна. Для модальных форм имеют смысл атрибуты **width** и **height**, они могут задавать размеры модальной экранной формы в пикселях или процентах от размера экрана. Если размеры не заданы, они рассчитываются автоматически, ориентируясь на размер экрана и размер последней открытой модальной формы, если она есть.
+Значения параметров из секции **params** передаются на сервер, и там могут быть использованы для корректировки возвращаемого описания экранной формы.
 ===== Запросы, адресованные уровню источника данных =====
 Уровень источника данных обычно ничего не знает о специфике использования запроса в конкретной форме. Тут расположен максимально абстрагированный от контекста использования код, поддерживающий работу конкретного источника данных.
@@ Строка 109: / Строка 120: @@
 ==== request name="refresh" ====
 Запрос на перечитку данных. При вызове дочерние узлы очищаются, выставляется статус - **loaded**, пока не придет ответ - новое содержимое строк.
+Специфически обрабатываемые параметры запроса:
   * параметр **row.focus.id** перечитывает с позиционированием на заданный id
   * параметр **row.focus.path** для дерева - перечитывает с позиционированием на заданный path - список id через ;
@@ Строка 231: / Строка 244: @@
 Вызывает загрузку с клиента на сервер файла по указанному адресу. Значения параметров подставляются в адрес
 <code>
-<request name="httpput" url="<адрес>" ext="jpg;png;xls;doc;pdf;zip" cancelcontinue="0|1" ignorecancel="0|1">
+<request name="httpput" url="<адрес>" ext="jpg;png;xls;doc;pdf;zip" ignorecancel="0|1" multiply="0|1">
   <param name="http.url" value="<адрес>">
   <param name="http.ext" value="jpg;png;gif;xls;doc;pdf;zip">
@@ Строка 246: / Строка 259: @@
+===== request name="set" =====
+Задать значения полей источника данных.
+<code>
+<request name="set" rowset="<имя источника данных>">
+  <param name="<имя поля>" value="<значение поля>"/>
+  <param name="<имя поля>" value="<значение поля>"/>
+  ...
+  <param name="<имя поля>" value="<значение поля>"/>
+</request>
+</code>