Различия

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

--- lss-server-php:datasource-fields [2024/06/28 17:20] – создано - внешнее изменение 127.0.0.1
+++ lss-server-php:datasource-fields [2026/04/27 18:04] (текущий) – [Расширенный описатель info] madmin
@@ Строка 5: / Строка 5: @@
 ==== Общие описатели ====
   * **name** - имя поля, обязательный параметр
-  * **type** - тип поля в терминах LSS: string, password, status, memo, date, num, check, ref, list, icons, radio, multilist, html
+  * **type** - тип поля в терминах LSS: string, password, status, memo, date, datetime, num, check, ref, list, icons, radio, multilist, html
   * **caption** - название поля в понятном человеку виде
   * **len** - отображаемая ширина поля в символах
@@ Строка 12: / Строка 12: @@
   * **default** - значение поля по умолчанию, при добавлении новой строки
   * **notnull** - значение поля должно быть обязательно задано
+  * **log** - изменение значения поля необходимо логировать
 ==== Числа ====
   * **dec** - кол-во знаков после запятой
+  * **numsep** = 0|1 - при отображении отделять тысячи (по 3 знака) неразрывным пробелом
+  * **hidezero** = 0|1 - нулевые значения отображать как пробел (пусто)
+==== datetime ====
+  * **dec** - точность хранения времени
+    * 0: часы:минуты
+    * 1: часы:минуты:секунды
+    * 2: часы:минуты:секунды.мс
 ==== Справочники ====
 Параметры поля type="ref"
@@ Строка 64: / Строка 72: @@
   * **info** - дополнительная служебная информация в виде массива (ключ=значение). Используется для спецобработки на сервере.
-===== Параметры поля в экранной форме "структура БД" =====
+===== Параметры поля в экранной форме "LSS описание БД" =====
 В экранной форме "структура БД" описывается таблицы и поля базы данных. По этим описателям генерятся контроллеры источников данных - описатели полей, SQL запросы к таблицам.
@@ Строка 82: / Строка 90: @@
   * **ref_join** - подстраивает поведение связи при выполнении **join**. Стандартное поведение: подменять ссылки для **restrict** связей и удалять для **cascade**. Если параметр задан, то поведение зависит не от типа связи а от значения этого параметра. Значения 1, r, R означают подмену ссылок, все остальное означает удаление.
   * **ref_copy** - подстраивает поведение связи при выполнении **copy**. Стандартное поведение: копировать только для **cascade** связей. Если параметр задан, то поведение зависит не от типа связи а от значения этого параметра. Значения 1, c, C означают копирование.
+  * **ref_logparent** - при любом изменении в строке отписывать в лог родительской таблицы по этой ссылке. Если значение 1, то имя в логе совпадает с именем таблицы, иначе значение задает имя в логе
+  * **ref_readonlytest** - при правке у удалении строки проверять признак row.readonly строки связанного источника данных.
 ==== стандартные описатели ====
   * **change** - при изменении поля отсылать запрос change или выполнять очистку полей
@@ Строка 101: / Строка 111: @@
 </code>
   * **save** - 1|0 при изменении значения поля автоматически вызывать запрос save
-  * **default** - значение поля по умолчанию, используется при выполнении append и в фильтрах
   * **info** - произвольная информация вида cod=значение. Перенесется в описатель поля fld
-==== списки: list, radio, icons ====
-  * **list** - для типов **list**, **radio** и **icons** содержит список допустимых значений
-<code>
-code1=Значение 1;code2=Значение 2
-</code>
-<code>
-Значение 1;Значение 2
-</code>
-  * **basetype** - string|num
 ==== видимость и доступность ====
   * **readonly** - 1|0 можно объявить поле readonly
   * **js_readonly** - можно объявить поле readonly в зависимости от условия: get('mode_code')=='ОТКЛ'
-  * **visible** - 0|1 можно сделать поле невидимым
-  * **js_visible** - можно сделать поле невидимым в зависимости от условия: get('mode_code')!='ОТКЛ'
 ==== описатели полей MAIN при подключении их в справочник ====
@@ Строка 125: / Строка 123: @@
   * **refcaption** - 1|0 при подключении поля как справочник брать caption из поля ссылки (type=ref)
+==== Расширенный описатель info ====
+Описатель info позволяет пополнить описание поля массивом вида имя=значение. Имена могут быть произвольными. Однако, некоторые имена обрабатываются особым образом - подменяют описатели поля. Вот список таких имен:
+  * refid
+  * refname
+  * visible
+  * js_visible
+  * default
+  * hidden
+  * basetype
+  * hidezero
+  * numsep