Show/Hide Toolbars

Руководство администратора

Сводная информация по работе с ДП

Ссылки Назад Вверх Вперед

Для проверки возможности доступа к ДП можно использовать функцию dbo.fn_ExtParamsInSubcatUserPermissions().

Тип ДП

В смартах

В SQL

В JS


Особенности работы с различными типами ДП

Обращение к различным типам ДП

Методы JS API

Число

Работа с числами

ExtParamValues

TaskID,

ExtParamID,

DecimalValue,

MoneyValue

var ep = new ExtParam(1234)

ep.get() — получить объект

ep.show() — показать

ep.hide() — скрыть

ep.val() — получить значение (кроме файла)

ep.val("text") — установить значение, вызвать событие change (кроме файла, выбора пользователей, таблицы и нумератора)

ep.getAvailableValues(handler) — получить значение Lookup/Multilookup

ep.change() — изменить

ep.change(handler) — подписать на изменение ДП

ep.change(null) — отписать от изменения

ep.save() — сохранить (кроме файла, таблицы и нумератора)

ep.update() — обновить (кроме файла, таблицы и нумератора)

ep.isHidden() — проверяет скрыт или нет

ep.freeze() — делает доступным тольео на чтение

Дата

Работа с датами

ExtParamValues

TaskID,

ExtParamID,

DateTimeValue

Строка

Работа со строками

ExtParamValues

TaskID,

ExtParamID,

ExtParamValue

 

Очистка строки от HTML-тегов:

dbo.fnStripTags(TaskText) — удаляет из текста все теги (все, что находится между символами < и >)

dbo.cm_StripHTML(TaskText) — удаляет из текста все теги (все, что находится между символами < и >)

dbo.cm_ReplaceHTML(TaskText) — заменяет служебные символы на обычные читаемые: ", <, >, неразрывный пробел (&nbsp;) и перенос строки (<br />)

dbo.cm_ReplaceEverything(TaskText) — заменяет служебные символы и HTML-теги на символы и теги, которые будут корректно отображаться в отчете (например, <strong> на <b>, символы '&lt;' на '<' и т.п.)

Флажок

Работа с логическими выражениями

ExtParamValues

TaskID,

ExtParamID,

ExtParamValue

Выбор пользователей

'{"Users":{"Deleted":[XX,...,XX],"Added":[XX,...,XX]},

"Groups":{"Deleted":[XX,...,XX],"Added":[XX,...,XX]},

"OrgUnits":{"Deleted":[XX,...,XX],"Added":[XX,...,XX]}}'

{"Users":[28], "Groups":[], "OrgUnits":[]}

Работа с ДП "Выбор пользователей"

ExtParamSelectUsersValues

TaskID,

ExtParamID,

UserID

Адресат email

'{"ValsToAdd":[{"UserID":XX},...,{"Email":XX}],

"ValsToDelete":[{"UserID":XX},...,{"Email":XX}]}'

Работа с ДП "Адресаты email"


Lookup

Работа с ДП Lookup

ExtParamValues

TaskID,

ExtParamID,

SelectedTaskID

Multilookup

Добавить одну задачу

ВСтроку(ID_задачи)

Добавить несколько задач — через ]||[]||[

ВСтроку(ID_задачи)+"]||[]||["+ВСтроку(ID_задачи)

Удалить одну задачу

'-'+ВСтроку(ID_задачи)

Обновить комментарий

'='+ВСтроку(ID_задачи)+"]||["+"текст_комментария"

Несколько операций в одной строке — через #

"111111#222222#-333333#-444444"

Работа с ДП "Выбор нескольких задач из категории"

ExtParamValueSelectedTasks

TaskID,

ExtParamID,

SelectedTaskID

Таблица

Ячейка

ID_колонки:{"First":ХХ,"Second":YY}

Строка

{"First":"ID_строки","Second":

{ID_колонки:{"First":ХХ,"Second":YY},

...,

ID_колонки:{"First":ХХ,"Second":YY}}}

* Ключ Second указывается только для колонок "Выпадающий список"

Добавление строки

'+[{ID_колонки:{"First":ХХ,"Second":YY},

...,

ID_колонки:{"First":ХХ,"Second":YY}}]'

Изменение строки

'= {"First":"ID_строки","Second":

{ID_колонки:{"First":ХХ},

...,

ID_колонки:{"First":ХХ}}}'

Удаление строки

'-ID_строки'

Одновременное изменение всех строк (ID_строки берется в кавычки, ID_колонки — нет)

# — если ID существующих строк известны

'#{"ID_строки":

{ID_колонки:{"First":ХХ},...,ID_колонки:{"First":ХХ}}},

...,

{"ID_строки":

{ID_колонки:{"First":ХХ},...,ID_колонки:{"First":ХХ}}}'

| — если ID существующих строк не известны (сначала все строки удаляются)

'|{"ID_строки":

{ID_колонки:{"First":ХХ},...,ID_колонки:{"First":ХХ}}},

...,

{"ID_строки":

{ID_колонки:{"First":ХХ},...,ID_колонки:{"First":ХХ}}}'

Нумерация строк таблицы начинается с 1, при удалении промежуточных строк нумерация не сдвигается и остаются пропуски.

Работа с ДП "Таблица"

ExtParamTableValues

TaskID,

ColumnID,

RowID,

Value (строка)

Файл

Свойство FileInfo

Версия: FileID.VersionID

Работа с ДП "Файл"

FileStorageFiles

FileId

LatestVersionId

Name

FileStorageFileToTaskLinks

FileId

TaskID

FileStorageFileToExtParamLinks

FileId

TaskID

ExtParamId