Различия

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

--- request [2024/08/01 18:03] – [request name="panel"] 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 через ;
@@ Строка 190: / Строка 203: @@
 </code>
 ===== request name="log" =====
-Средство отладки. Отображает через console.log свои параметры. Запрос выполняется на клиенте, обращения к серверу не происходит.
+Средство отладки. Отображает через console.log свои параметры. Запрос выполняется на клиенте, обращения к серверу не происходит. mode="dialog" дополнительно отображает значение параметров в диалоге
 <code>
-<request name="log">
+<request name="log" mode="|dialog">
   <param name="" value=""/>
   ...
@@ Строка 200: / Строка 213: @@
 ===== request name="panel" =====
-  * mode=focus - позволяет передать фокус ввода на панель. Обязательный параметр id - id панели
+Обязательный параметр id - id панели
+  * mode=focus - позволяет передать фокус ввода на панель.
+  * mode=print - для панели webbrowser распечатать содержимое
+  * mode=refresh - для панели webbrowser принудительно перечитать
 <code>
 <request name="panel" mode="focus">
@@ Строка 226: / Строка 242: @@
 ===== request name="httpput" =====
-Вызывает загрузку из сервера на клиент файла по указанному адресу. Значения параметров подставляются в адрес
+Вызывает загрузку с клиента на сервер файла по указанному адресу. Значения параметров подставляются в адрес
 <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">
@@ Строка 238: / Строка 254: @@
 </code>
+===== request name="mark" =====
+===== request name="unmarkall" =====
+===== request name="set" =====
+Задать значения полей источника данных.
+<code>
+<request name="set" rowset="<имя источника данных>">
+  <param name="<имя поля>" value="<значение поля>"/>
+  <param name="<имя поля>" value="<значение поля>"/>
+  ...
+  <param name="<имя поля>" value="<значение поля>"/>
+</request>
+</code>