Описание библиотеки DBTAGLIB

Описание библиотеки DBTAGLIB

connection / Может содержать вложения

Организует соединение с базой

Все теги библиотеки должны быть вложены внутрь этого тега.

Атрибуты

dbURL dbUID dbPWD dbName driver propsFile - Название файла, в котором хранятся параметры коннекта к базе. Файл должен находиться в директории /WEB-INF isDebugMode poolName

simpleRS / Может содержать вложения

Обеспечивает выборку из базы через SELECT

Внутренность тега является шаблоном для отображения одной строки выборки

Функционал разбиения больших выборок на части (страницы) отсутствует (см. тег resultset)

Атрибуты

SQLQuery - Строка, содержащая SQL-запрос на SELECT maxRows - Максимально отображаемое кол-во строк в выборке; если этот атрибут не указан, то кол-во строк не ограничивается escapeText - Строка, которая отображается в случае, если выборка оказалась пустой exceptionText - Строка, которая отображается в случае возникновения ошибки SQL-сервера при выполнении запроса delimiter - Разделитель между строками выборки

hierarhy / Может содержать вложения

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

Внутренность тега является шаблоном для отображения одной строки выборки.

Атрибуты

SQLQuery - Строка, содержащая SQL-запрос на SELECT, должна содержать символ "?", которому рекурсивно придается значение идентификатора родительского документа idField - Имя поля, содержащего идентификатор записи в таблице. По умолчанию - id root - Значение идентификатора для корневого элемента иерархии escapeText - Строка, которая отображается в случае, если выборка оказалась пустой exceptionText blockPrefix - Строка, которая отображается перед каждым блоком в иерархии blockSuffix - Строка, которая отображается после каждого блока в иерархии

resultset / Может содержать вложения

Обеспечивает выборку из базы через SELECT

В отличие от simpleRS имеет множество доп. возможностей:

1. Есть функционал разбиения больших выборок на части (страницы)

2. Есть возможность контролировать вывод/пропуск кода, не находяжегося

непосредственно внутри строк выборки (например строка заголовков таблицы,

отображающей результаты выборки)

3. Есть возможность отображения количества строк в выборке

4. Есть возможность отображения результатов выборки в виде таблицы

с контролируемым количеством столбцов/колонок

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

Атрибуты

SQLQuery - Строка, содержащая SQL-запрос на SELECT escapeURL - URL, на который происходит редирект в случае пустого результата escapeText - Строка, которая отображается в случае пустого результата exceptionText - Строка, которая отображается в случае возникновения ошибки SQL-сервера при выполнении запроса defaultPortion - Кол-во строк выборки, отображаемых на одну страницу (т. е. размер разбиения выборки на части по количеству строк). Для отказа от разбиения необходимо указать defaultPortion="all". Если значение этого атрибута не указано, то его величина принимается равной 30. defaultCols - Кол-во колонок в таблице при выводе результатов выборки в виде многоколоночной таблицы maxSize - Максимальный размер выборки в байтах, отображаемых на одну страницу (т. е. размер разбиения выборки на части по количеству символов) Если этот атрибут не указан, то размер не анализируется и выборка не разбивается по этой логике. parNamePrefics - Префикс для передачи параметров через строку запроса (при переключении между частями разбитой выборки или сортировке) Если этот атрибут не указан, то префикс строится автоматически

rows / Может содержать вложения

Должен быть вложен в resultset

Является контейнером для шаблона вывода строк выборки

Атрибуты

maxRows - Максимально отображаемое кол-во строк в выборке; К разбиению выборки на части не имеет отношения - просто выбираются первые N строк; если этот атрибут не указан, то кол-во строк не ограничивается delimiter - Разделитель между строками выборки

cols / Может содержать вложения

Должен быть вложен в resultset

Также является контейнером для шаблона вывода строк выборки

В отличие от rows задает вывод в виде нескольких столбцов многоколоночной таблицы

Атрибуты

border bordercolor width cellpadding cellspacing style ordclass notordclass delimiterstyle

Count / Не содержит вложений

Должен быть вложен в resultset

Отображает полное кол-во строк в выборке

localCount / Не содержит вложений

Должен быть вложен в resultset

Отображает кол-во строк выборки на текущей странице

rsParts / Может содержать вложения

Должен быть вложен в resultset

Отображает ссылки на части выборки, разбитой на страницы

Атрибуты

css - CSS-класс для отображения ссылки currentcss - CSS-класс для отображения текущей части в списке ссылок delimiter - Разделитель между ссылками на разные части выборки first - Тескт ссылки перехода на начало выборки last - Тескт ссылки перехода на последнюю часть выборки prev - Тескт ссылки перехода на предыдущую часть выборки next - Тескт ссылки перехода на следующую часть выборки format - Формат отображения ссылки currentformat - Формат отображения текущей части в списке ссылок prefix - Тескт, отображаемый перед списком ссылок на части выборки в случае, когда выборка разбивается на части (т. е. достаточно большая для этого); если разбиения не происходит, то префикс не отображается suffix - Тескт, отображаемый после списка ссылок на части выборки в случае, когда выборка разбивается на части (т. е. достаточно большая для этого); если разбиения не происходит, то суффикс не отображается

rsSort / Может содержать вложения

Должен быть вложен в resultset

Формирует ссылку с тектом для указания посетителем сайта сортировки выбрки

Атрибуты

field - Название поля в SELECT, по которому необходимо провести сортировку title - Текст ссылки direction - Направление сортировки: asc - по возрастанию, desc - по убыванию (по умолчанию asc) comment sortclass - CSS-класс для отображения ссылки currentclass - CSS-класс для отображения текста ссылки, если текущая сортировка совпадает с заданной

rsABC / Может содержать вложения

Атрибуты

minAmount isEng delimiter style currentStyle abcClass currentClass format currentFormat prefix suffix

field / Не содержит вложений

Должен быть вложен в simpleRS, hierarhy, rows или cols

Отображает значение поля выборки

Атрибуты

name - Название поля emptyValue URLEncode - Кодировать ли значение поля для формирования параметра запроса в ссылке: Y - да, N - нет (по умолчанию - нет) isHTML - Является ли значение поля кодом HTML (если нет, то автоматически происходит преобразование спец-символов и перевода строки в HTML-код) Y - да, N - нет (по умолчанию - нет) doPlainText - Отображать ли значение поля чистым текстом как есть (без преобразования в HTML) Y - да, N - нет (по умолчанию - нет) dateFormat - Формат отображения даты (если поле является датой) locale decimalFormat - Формат отображения числа (если поле является числом) regExp - Регулярное выражения преобразования значения поля при выводе maxChars - Ограничение на отображение значения поля (выводится первые N символов). Разбиение производится по целым словам.

if / Может содержать вложения

Должен быть вложен в simpleRS, hierarhy, rows или cols

Отображает свое содержимое при выполнении условия проверки

Атрибуты

name - Название поля из выборки, значение которого проверяется ifNull value - Строковая (или числовая) величина, с которой сравнивается значение поля dateValue - Величина типа Date, с которой сравнивается значение поля (для полей типа дата) name2 - Название поля из выборки, со значением которого сравнивается основное поле SQLValue - Величина получаемая через SELECT из базы, с которой сравнивается значение поля act - Действие сравнения; допустимые значения: =, !=, <, > re - Регулярное выражение, проверяющее на соответствие значения поля шаблону

rsCountTag / Не содержит вложений

Тег для отображения номера строки в выборке из БД

Вложен внутрь rows, cols, simpleRS, rsContents

rsIsLast / Может содержать вложения

Должен быть вложен в rows

Тег, отображающий свои внутренности,

если это последняя строка из resultset

rsContents / Может содержать вложения

Должен быть вложен в resultset

Тег для отображения содержания (оглавления)

Каждый элемент листинга
содержания является одним из двух:

1. относительной ссылкой на свой контент в листинге rows

2. ссылкой на другую страницу (если resultset разбивается на

несколько страниц)

rsContentLink / Может содержать вложения

Должен быть вложен в rsContents

Тег для отображения ссылки элемента содержания

Атрибуты

css style

rsContentLocal / Может содержать вложения

Должен быть вложен в rsContents

Тег, отображающий свое содержимое, если текущая ссылка

на элемент содержания идет локально на текущую страницу

rsContentPrev / Может содержать вложения

Должен быть вложен в rsContents

Тег, отображающий свое содержимое, если текущая ссылка

на элемент содержания идет на одну из предыдущих страниц

rsContentNext / Может содержать вложения

Должен быть вложен в rsContents

Тег, отображающий свое содержимое, если текущая ссылка

на элемент содержания идет на одну из следующих страниц

rsBreakParts / Может содержать вложения

Вложен в resultset

Отображает вложение в случае, если происходит разбиение выборки

на части по максимальному размеру текста на странице

rsBreakPartsBegin / Может содержать вложения

Вложен в rsBreakParts

Отображает ссылку на первую часть разбиения в случае, если происходит разбиение выборки

на части по максимальному размеру текста на странице.

Тесктом ссылки является содержание тега.

Атрибуты

css style currentCss currentStyle

rsBreakPartsPrev / Может содержать вложения

Вложен в rsBreakParts

Отображает ссылку на предыдущую часть разбиения в случае, если происходит разбиение выборки

на части по максимальному размеру текста на странице.

Тесктом ссылки является содержание тега.

Атрибуты

css style currentCss currentStyle

rsBreakPartsNext / Может содержать вложения

Вложен в rsBreakParts

Отображает ссылку на следующую часть разбиения в случае, если происходит разбиение выборки

на части по максимальному размеру текста на странице.

Тесктом ссылки является содержание тега.

Атрибуты

css style currentCss currentStyle

treeHeader / Не содержит вложений

Атрибуты

table idField nameField parentIdField parentIdValueField delimiter rootId rootName URL

treeTitle / Не содержит вложений

Тег для отображения дерева заголовков без ссылок

(в основном для использования в теге title)

Атрибуты

table idField nameField parentIdField parentIdValueField delimiter rootId isBeginFromIdField

ordField / Не содержит вложений

Атрибуты

name table idField up down delimiter URL ordUpParam ordDownParam

boolField / Не содержит вложений

Атрибуты

name isChange table idField yes no URL boolTrueParam boolFalseParam

delItem / Не содержит вложений

Атрибуты

table idField label

update / Может содержать вложения

Организует внесение изменений в базу (UPDATE и INSERT) через web-форму

Атрибуты

table - Название основной таблицы, изменения в которой происходят name - Атрибут name HTML-тега form (если не задан, то в качестве имени тега используется имя таблицы) idField - Ключевое поле основной таблицы (по умолчанию - id) onSubmit - Код javascript, выполняемый перед отправкой данных формы на сервер tmpDir - Путь к временной директории от корня сайта, в которой хранятся временные файлы в процессе внесения данных (например картинки или прицепленные файлы) По умолчанию - /tmp dir - Путь к директории от корня сайта, в которой хранятся файлы, связанные с данными таблицы (например картинки или прицепленные файлы) По умолчанию - /docImages charSet - Кодировка, принятая по умолчанию на сервере (если не указана, то windows-1251) Существует для обхода особенности апача при работе на *nux-серверах - даже, если кодировка файлов апачу указана как windows-1251 и отключена автоматическая перекодировка для русского апача, принимаемые multypart-form данные он видит как koi8-r auxImgTable auxImgField auxImgNameField auxImgParentIDField auxImgParentTableField auxImgParentRtfField isOnlyForInsert - Если значение Y, то форма не позволяет делать UPDATE существующих записей в базе isOnlyForUpdate - Если значение Y, то форма не позволяет делать добавлять новые записи в базу toMail - Адрес e-mail (адреса e-mail через ;), являющийся основным адресатом сообщения (поле TO), отсылаемого при успешном сохраниении данных bccMail - Адрес e-mail (адреса e-mail через ;), являющийся адресатом сообщения (поле BCC), отсылаемого при успешном сохраниении данных ccMail - Адрес e-mail (адреса e-mail через ;), являющийся адресатом сообщения (поле CC), отсылаемого при успешном сохраниении данных fromMail - Адрес e-mail, от лица которого отправляется сообщение при успешном сохраниении данных smtpServer - SMTP-сервер (DNS-имя или IP-адрес), который используется для отправки сообщение при успешном сохраниении данных mailSubj - Тема письма, которое отправляется при успешном сохраниении данных mailBody - Тело письма (точнее его начало), которое отправляется при успешном сохраниении данных isWrapMail - Разбивать ли строки отправляемого письма по 76 символов По умолчанию - Y (да) mailCharset - Кодировка отправляемого письма (по умолчанию - koi8-r) errorStr - Строка сообщения об ошибке (точнее ее начало) отображаемая в случае, когда сохранить данные не удалось по причине того, что они не удовлетворили набор, предъявляемых к ним условий errorStrStyle - CSS-стиль строки сообщения об ошибке отображаемой в случае, когда сохранить данные не удалось по причине того, что они не удовлетворили набор, предъявляемых к ним условий messageStr - Строка сообщения об успешном сохранении данных isShowOnSuccess - Отображать ли содержимое тега update (т. е. сохраненные данные) в случае успешного сохранения данных. По умолчанию Y (да) successInsertURL - Адрес URL, на который происходит редирект клиента в случае успешного добавления новой строки данных successUpdateURL - Адрес URL, на который происходит редирект клиента в случае успешного изменения существующей строки данных

childUpdate / Может содержать вложения

Атрибуты

table parentIdField isOnlyForInsert isOnlyForUpdate isAllowNull nullErrorStr css style buttCss buttStyle delLabel addLabel

submit / Не содержит вложений

Вложен в update

Отображает кнопку Submit в HTML-форме

Атрибуты

name - Атрибут name HTML-тега input (кнопки) - для возможности обращения к нему из javascript insertLabel - Тескт на кнопке для вставки новых данных в базу updateLabel - Тескт на кнопке для изменения существующих данных в базе changeLabel - Тескт на кнопке для возврата к изменению указанных данных после их отправки на сервер inpclass - CSS-класс отображения кнопки style - CSS-стиль отображения кнопки

input / Может содержать вложения

Вложен в update или childUpdate

Обеспечивает функционал ввода данных (и их проверок)

в конкретное поле основной таблицы для сохранения в базе

Атрибуты

name - Название поля основной таблицы (этим же именем называется и HTML-тег поля ввода) type - Тип HTML-поля ввода. Возможные варианты: text, textarea, password, checkbox. По умолчанию - text. Если тип password, то отображаются два поля ввода и указываемые в них данные должны совпадать. Если тип checkbox, то содержимое тега используется как HTML-label для данного checkbox'а. isUnique - Является ли поле уникальным. Если да, то при получении данных формы проводится соответствующая проверка полученных данных на уникальность. По умолчанию - N (нет) defaultVal - Значение поля по умолчанию (работает только при добавлении новой записи в базу) checkedVal - Если поле является checkbox'ом, - его значение, сохраняемое в базе, если оно помечено, как выбранное. По умолчанию - 1. uncheckedVal - Если поле является checkbox'ом, - его значение, сохраняемое в базе, если оно не помечено, как выбранное. По умолчанию - 0. defaultSQLVal - Значение поля по умолчанию определяемое через SELECT из базы (работает только при добавлении новой записи в базу) isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) maxlength - Максимально допустимая длина текстового поля minlength - Минимально допустимая длина текстового поля (т. е. данные, короче, чем указано не принимаются к сохранению в базе) max - Максимально допустимое числовое значение (для числовых полей) min - Минимально допустимое числовое значение (для числовых полей) isMail - Если значение атрибута Y (да), то это поле проверяется на соответствие формату адреса e-mail и на него происходит отправка сообщения при успешном сохранеии данных формы isMailAddr - Если значение атрибута Y (да), то это поле проверяется на соответствие формату адреса e-mail (отправка сообщения на этот адрес не производится) isToMail - Если значение атрибута Y (да), то это поле проверяется на соответствие формату адреса e-mail и на него происходит отправка сообщения при успешном сохранеии данных формы isCcMail - Если значение атрибута Y (да), то это поле проверяется на соответствие формату адреса e-mail и на него происходит отправка сообщения при успешном сохранеии данных формы (адресат типа CC) isBccMail - Если значение атрибута Y (да), то это поле проверяется на соответствие формату адреса e-mail и на него происходит отправка сообщения при успешном сохранеии данных формы (адресат типа BCC) cols - Соответствующий атрибут cols HTML-тега textarea rows - Соответствующий атрибут rows HTML-тега textarea size - Соответствующий атрибут size HTML-тега input css - CSS-класс отображения HTML-тега формы style - CSS-стиль (атрибут style) отображения HTML-тега формы onChange - Соответствующий атрибут onChange HTML-тега формы onFocus - Соответствующий атрибут onFocus HTML-тега формы onBlur - Соответствующий атрибут onBlur HTML-тега формы onClick - Соответствующий атрибут onClick HTML-тега формы checkRE - Регулярное выражение, проверяющее соответствие указанных данных шаблону modifyRE - Регулярное выражение, модифицирующее полученные данные перед сохранениием их в базе doTrim - Если значение атрибута Y (да), то возможные обрамляющие пробелы из полученных данных удаляются. По умолчанию - N (нет) isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr - nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные maxLenErrorStr - Строка сообщения об ошибке, отображаемая если длина указанных данных превысила значение атрибута maxlength minLenErrorStr - Строка сообщения об ошибке, отображаемая если длина указанных данных не достигла значения атрибута minlength maxErrorStr - Строка сообщения об ошибке, отображаемая если величина указанных числовых данных превысила значение атрибута max minErrorStr - Строка сообщения об ошибке, отображаемая если величина указанных числовых данных не достигла значения атрибута min reErrorStr - Строка сообщения об ошибке, отображаемая если указанные данные не соответствуют шаблону регулярного выражения в атрибуте checkRE или если поле является числовым, а указанные данные не являются числом или если поле должно иметь формат адреса e-mail, но указанные данные не являются адресом e-mail pwdErrorStr - Строка сообщения об ошибке, отображаемая если указанные данные при вводе пароля в два поля не совпали uniqueErrorStr - Строка сообщения об ошибке, отображаемая если указанные данные для уникального поля не являются уникальными

inputImg / Не содержит вложений

Вложен в update или childUpdate

Обеспечивает функционал сохранения изображения в конкретном поле основной таблицы

Если поле имеет тип LONGBINARY, то изображение сохраняется непосредственно в базе

в виде бинарника.

Если поле имеет тип VARCHAR, то изображение сохраняется как отдельный файл,

а в базе сохраняется строка пути к этому файлу от корня сайта.

Атрибуты

name - Название поля основной таблицы (этим же именем называется и HTML-тег file) isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) deleteLabel - Текст checkbox'а помечаемого для удаления изображения css - CSS-класс отображения HTML-тега file style - CSS-стиль (атрибут style) отображения HTML-тега file isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные reErrorStr - Строка сообщения об ошибке, отображаемая если выбранный файл имеет расширение, отличное от .gif, .jpg, .jpeg, .png dir - Путь к директории от корня сайта, в которой будут сохраняться изображения в виде отдельных файлов. Если значение атрибута не указано, то его значение берется из аналогичного атрибута update width - Если значение атрибута задано, то все поступающие изображения автоматически изменяют свой размер так, чтобы их ширина стала равной указанной (сохраняя при этом пропорции) height - Если значение атрибута задано, то все поступающие изображения автоматически изменяют свой размер так, чтобы их высота стала равной указанной (сохраняя при этом пропорции). Если задаются оба парамтра - width и height, то пропорции изображения сохраняются, а соотношение сторон достигается путем обрезания краев изображения. maxWidth - Если значение атрибута задано, то все поступающие изображения чей размер превышает указанную ширину автоматически изменяют свой размер так, чтобы их ширина стала равной указанной (сохраняя при этом пропорции) maxHeight - Если значение атрибута задано, то все поступающие изображения чей размер превышает указанную высоту автоматически изменяют свой размер так, чтобы их высота стала равной указанной (сохраняя при этом пропорции) thumbField - Название поля в базе, в котором предполагается хранение уменьшенной копии изображения. Если атрибут не задан, то сохранение уменьшенных копий не предполагается. thumbWidth - Ширина уменьшенной копии (при уменьшении пропорции сохраняются) thumbHeight - Высота уменьшенной копии (при уменьшении пропорции сохраняются) maxThumbWidth - Максимально допустимая ширина уменьшенной копии. Имеет значение, если задан атрибут thumbHeight maxThumbHeight - Максимально допустимая высота уменьшенной копии. Имеет значение, если задан атрибут thumbWidth

inputFile / Не содержит вложений

Вложен в update или childUpdate

Обеспечивает функционал сохранения файла в конкретном поле основной таблицы

Если поле имеет тип LONGBINARY, то файл сохраняется непосредственно в базе

в виде бинарника.

Если поле имеет тип VARCHAR, то файл сохраняется отдельно,

а в базе сохраняется строка пути к этому файлу от корня сайта.

Атрибуты

name - Название поля основной таблицы (этим же именем называется и HTML-тег file) isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) deleteLabel - Текст checkbox'а помечаемого для удаления файла css - CSS-класс отображения HTML-тега file style - CSS-стиль (атрибут style) отображения HTML-тега file isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные dir - Путь к директории от корня сайта, в которой будут сохраняться файлы. Если значение атрибута не указано, то его значение берется из аналогичного атрибута update

inputRichText / Не содержит вложений

Вложен в update

Обеспечивает функционал редактирования и сохранения в базе форматированного

контента через интерфейс WYSIWYG

Атрибуты

name - Название поля основной таблицы isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) css style cols rows isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные isWysiwyg - Включить ли визуальное редактирование - по умолчанию - ДА tblBorderColor tblCellPadding tblCellSpacing nomalFontSize - Список размеров шрифта в пойнтах, которые считаются "нормальными" и не требуют прямого указания в коде - используется при выключенной галке "полная чистка кода" Список должен быть представлен в виде чисел, разделенных символом "|" Значение по-умолчанию: 9|10|11|12 tblCss thCss tdCss maxImgWidth - максимально допустимая ширина изображений, поступающих вместе с содержимым RTF-файла; если этот атрибут указан, то при его превышении картинка пропорционально уменьшается maxImgHeight - максимально допустимая высота изображений, поступающих вместе с содержимым RTF-файла; если этот атрибут указан, то при его превышении картинка пропорционально уменьшается cssFile - CSS-файл, используемый для отображения редактируемого контента и на базе которого формируется выбор допустимых для содержания CSS-классов

inputDate / Не содержит вложений

Вложен в update или childUpdate

Обеспечивает функционал редактирования и сохранения в базе полей типа дата

Атрибуты

name - Название поля основной таблицы isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) buttLabel isTime defaultVal - Значение поля по умолчанию (работает только при добавлении новой записи в базу) defaultSQLVal - Значение поля по умолчанию определяемое через SELECT из базы (работает только при добавлении новой записи в базу) inpclass - CSS-класс отображения HTML-тега input style - CSS-стиль (атрибут style) отображения HTML-тега input buttclass - CSS-класс отображения HTML-тега input для кнопки "изменить" buttstyle - CSS-стиль (атрибут style) отображения HTML-тега input для кнопки "изменить" errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные formatErrorStr - Строка сообщения об ошибке, отображаемая если указанные данные не соответствуют формату даты

inputHidden / Не содержит вложений

Вложен в update или childUpdate

Обеспечивает функционал сохранения в базе полей, значения которых

не редактируются напрямую, но задаются исходя из параметров запроса

или автоматически вычисляются.

Атрибуты

name - Название поля основной таблицы SQLValue - Значение поля, получаемое через SELECT из базы value - Значение поля, указываемое напрямую isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) isEditable - Разрешается ли редактирование значения поля через javascript. По умолчанию - N (нет)

select / Может содержать вложения

Вложен в update или childUpdate

Обеспечивает функционал сохранения в базе полей, значения которых

выбираются из выпадающего списка.

Фактически, это работа с полем, являющися внешним ключем.

Атрибуты

name - Название поля основной таблицы SQLQuery - SQL-запрос типа SELECT, который вынимает из базы последовательность пар значение+текст, отображаемых как HTML-теги option hierarhyRoot hierarhyView isOnlyEndPointsHierarhy defaultVal - Значение поля по умолчанию (работает только при добавлении новой записи в базу) defaultSQLVal - Значение поля по умолчанию определяемое через SELECT из базы (работает только при добавлении новой записи в базу) isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные css - CSS-класс тега select style - CSS-стиль (атрибут style) тега select selectedStyle - CSS-стиль (атрибут style) тега option, отображаемый для текущего значения поля onChange - Соответствующий атрибут onChange HTML-тега select onFocus - Соответствующий атрибут onFocus HTML-тега select onBlur - Соответствующий атрибут onBlur HTML-тега select onClick - Соответствующий атрибут onClick HTML-тега select

radio / Может содержать вложения

Вложен в update или childUpdate

Обеспечивает функционал сохранения в базе полей, значения которых

выбираются из списка зависимых radio-кнопок.

Фактически, это работа с полем, являющися внешним ключем.

Функционал аналогичен тегу select

Атрибуты

name - Название поля основной таблицы SQLQuery - SQL-запрос типа SELECT, который вынимает из базы последовательность пар значение+текст, отображаемых как HTML-теги radio defaultVal - Значение поля по умолчанию (работает только при добавлении новой записи в базу) defaultSQLVal - Значение поля по умолчанию определяемое через SELECT из базы (работает только при добавлении новой записи в базу) isOnlyForInsert - Запретить редактирование этого поля для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого поля для добавляемых новых записей в базе. По умолчанию N (нет) isAllowNull - Допускать ли пустые значения поля. Если значение атрибута N (нет), то поле обязательно для заполнения. По умолчанию - Y (да) errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные delimiter - Разделитель между radio-кнопками onFocus - Соответствующий атрибут onFocus HTML-тега radio onBlur - Соответствующий атрибут onBlur HTML-тега radio onClick - Соответствующий атрибут onClick HTML-тега radio

selElem / Не содержит вложений

Вложен в radio или select

Определяет вариант выбора значения поля в дополнение (или вместо)

к списку, получаемому через запрос из атрибута SQLQuery родительского тега

Отображается перед списком, получаемым через запрос из

атрибута SQLQuery родительского тега

Атрибуты

value - Значение show - Текст

checkBoxes / Не содержит вложений

Вложен в update

Обеспечивает функционал редактирования связи "многие ко многим"

через список чекбоксов

Атрибуты

table - Название внешней таблицы, хранящей связи "многие ко многим" linkField - Название поля внешней таблицы, содержащее значение ключевого поля основной таблицы valField - Название поля внешней таблицы, содержащее значение ключевого поля третьей таблицы, с которой эта связь и организуется SQLQuery - SQL-запрос типа SELECT, который вынимает из базы последовательность пар значение+текст (значение - величина ключевого поля третьей таблицы) isOnlyForInsert - Запретить редактирование этого соответствия для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого соответствия для добавляемых новых записей в базе. По умолчанию N (нет) isAllowNull - Допускать ли пустые значения, т. е. отсутствие связи. По умолчанию - Y (да) delimiter - Разделитель между чекбоксами

multySelect / Не содержит вложений

Вложен в update

Обеспечивает функционал редактирования связи "многие ко многим"

через список (select) с множественным выбором

Атрибуты

table - Название внешней таблицы, хранящей связи "многие ко многим" linkField - Название поля внешней таблицы, содержащее значение ключевого поля основной таблицы valField - Название поля внешней таблицы, содержащее значение ключевого поля третьей таблицы, с которой эта связь и организуется SQLQuery - SQL-запрос типа SELECT, который вынимает из базы последовательность пар значение+текст (значение - величина ключевого поля третьей таблицы) isOnlyForInsert - Запретить редактирование этого соответствия для существующих записей в базе. По умолчанию N (нет) isOnlyForUpdate - Запретить редактирование этого соответствия для добавляемых новых записей в базе. По умолчанию N (нет) isAllowNull - Допускать ли пустые значения, т. е. отсутствие связи. По умолчанию - Y (да) hierarhyRoot hierarhyView isOnlyEndPointsHierarhy size - Соответствующий атрибут size HTML-тега select css - CSS-класс тега select style - CSS-стиль (атрибут style) тега select selectedStyle - CSS-стиль (атрибут style) тега option, отображаемый для текущего значения поля errorStr nullErrorStr - Строка сообщения об ошибке, отображаемая если в обязательном поле не были указаны данные

multyInput / Не содержит вложений

Аналог multySelect и multyLabel - представляет собой одно поле, в которое

вручную через разделители (например, через запятую) вводятся множественные

значения подчиненной таблицы

Атрибуты

table linkField valField split join type isOnlyForInsert isOnlyForUpdate isAllowNull size cols rows css style onChange onFocus onBlur onClick checkRE modifyRE maxlength minlength max min isMail isMailAddr isToMail isCcMail isBccMail errorStr nullErrorStr defaultSQLVal defaultVal maxLenErrorStr minLenErrorStr reErrorStr isUnique uniqueErrorStr

inputLabel / Не содержит вложений

Это связка хидден-поле + текст (текст получается по значению хидден-поля через SQLShow)

JavaScript функция задания нового значения и текста на клиенте - changeИМЯПОЛЯ(value, show)

Атрибуты

name SQLValue value SQLShow nullShow isUnique isAllowNull nullErrorStr uniqueErrorStr toChange delLabel changeLabel buttLabel buttCss buttStyle isOnlyForInsert isOnlyForUpdate onChange mailLabel width height

multyLabel / Не содержит вложений

Это гибрид inputLabel и multySelect

применяется (как и multySelect) для блоков редактирования связей многие ко многим

функционирует при сохранении данных на сервере аналогично multySelect,

на клиентской стороне функционирует аналогично inputLabel

представлен в виде набора пар

хидден-поле + текст (текст получается по значению хидден-поля через SQLShow)

JavaScript функция добавления нового значения в список пар на клиенте -

addИМЯТАБЛИЦЫ(value, show), где ИМЯТАБЛИЦЫ - это значение атрибута table тега multyLabel

(т. е. имя таблицы, хранящей связи многие ко многим)

Атрибуты

table linkField valField SQLShow toAdd nullShow isOnlyForInsert isOnlyForUpdate isAllowNull errorStr nullErrorStr buttLabel buttCss buttStyle onChange defaultSQLVal defaultVal

check / Может содержать вложения

Вложен в update

Делает дополнительные проверки введенных данных

Обрамляет совместно проверяемые поля

Атрибуты

SQLQuery errorStr isEmpty value dateValue act re

inputCheckHands / Не содержит вложений

Это "Защита от автоматов, заполняющих формы" -

коверканая картинка с номером и поле для ввода

Атрибуты

name isOnlyForInsert isOnlyForUpdate css style errorStr nullErrorStr size onChange onFocus onBlur onClick onKeyUp

rndStringImg / Не содержит вложений

Это "Защита от автоматов, заполняющих формы" -

используется в паре с inputCheckHands

генерит коверканую картинку с номером и поле для ввода

Номер берет из атрибута сессии, имя атрибута сессии

получает как параметр запроса name

mailCharSet / Может содержать вложения

mailBody / Может содержать вложения

toMail / Может содержать вложения

delete / Может содержать вложения

Атрибуты

table idField delParam confirmMess errorStr messageStr checkWhere

treeDelete / Может содержать вложения

Атрибуты

table idField parentIdField isOnlyEmpty notEmptyAlert delParam confirmMess errorStr messageStr

childDelete / Может содержать вложения

Атрибуты

table parentIdField SQLWhere - Дополнительная WHERE часть для идентификации (применяется в том случае, когда идентификация не определяется полностью значением поля parentIdField) idField

linkDelete / Не содержит вложений

Атрибуты

table parentIdField SQLWhere - Дополнительная WHERE часть для идентификации (применяется в том случае, когда идентификация не определяется полностью значением поля parentIdField)

fileDelete / Не содержит вложений

Атрибуты

fileField

chOrder / Не содержит вложений

Атрибуты

table ordField SQLWhere - Дополнительная WHERE часть для идентификации (применяется в том случае, когда изменение сортировки производится на подмножестве записей таблицы) idField ordUpParam ordDownParam errorStr messageStr

chBool / Не содержит вложений

Атрибуты

table boolField idField boolParam errorStr messageStr checkWhere

execute / Не содержит вложений

Атрибуты

SQLQuery errorStr messageStr

img / Не содержит вложений

Атрибуты

table imgField nameField escapeImg dbURL dbUID dbPWD dbName driver