Источник данных на справочнике (DictionaryDataSource)

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 1     {
 2       "id": 1,
 3       "name": "Источник на справочнике",
 4       "dictionaryId": 14040,
 5       "hierarchyId": null,
 6       "filter": [
 7         {
 8           "id": 1,
 9           "expressionId": 1,
10           "value": 33
11         }
12       ],
13       "sortingOptions": null,
14       "groupingOptions": null,
15       "dictionaryAttributes": null,
16       "defaultValue": null,
17       "defaultValueExpressionId": null,
18       "parameterId": null,
19       "dictionarySourceSelectionMode": "None",
20       "dataSourceAttributesAdditionsSettings": null,
21       "externalFileStorageUrl": null,
22       "filePrefix": null,
23       "defaultNewElementSettings": null
24       "discriminator": "DictionaryDataSource"
25     }
Свойство Описание
id Идентификатор источника данных
name Наименование источника данных
isReadOnly Признак, что источник данных доступен только для чтения
dataEditRuleIds Коллекция идентификаторов правил BinaryConditionRule, которые определяют доступность редактирования источника
beforeSaveDataActions Коллекция идентификаторов действий Action, которые выполняются перед сохранением источника данных
afterSaveDataActions Коллекция идентификаторов действий Action, которые выполняются после сохранения источника данных
discriminator "DictionaryDataSource"
dictionaryId Идентификатор справочника (объект репозитория)
hierarchyId Идентификатор альтернативной иерархии справочника
filter Фильтр справочника
sortingOptions Настройки сортировки элементов справочника
groupingOptions Настройки группировки справочника
dictionaryAttributes Коллекция загружаемых атрибутов
dictionarySourceSelectionMode Режим выставления отметки справочника при первом его открытии
defaultValueExpressionId Идентификатор выражения, результат которого будет использоваться как значение по умолчанию при соответствующем значении DictionarySourceSelectionMode (DefaultValueByExpression , DefaultValueByExpressionOrSelectFirst )
parameterId Идентификатор параметра, значения которого будут использоваться как значение по умолчанию при соответствующем значении DictionarySourceSelectionMode (ParameterValue, ParameterValueOrSelectFirst)
defaultValue Коллекция идентификаторов элементов справочника, которые будут использоваться как значение по умолчанию при соответствующем значении DictionarySourceSelectionMode (DefaultValue, DefaultValueByExpressionOrSelectFirst)
dataSourceAttributesAdditionsSettings Коллекция дополнительных настроек для атрибутов справочника DataSourceAttributesAdditionsSettings
externalFileStorageUrl Ссылка на внешнее хранилище файлов. Хранилище должно иметь апи на загрузку файлов через put "upload/fileName" и на получение через get "get/fileName".
filePrefix Префикс для файлов, загружаемых в externalFileStorageUrl. Может использоваться для задания пути файла, например префикс "folder/" будет означать, что файлы будут складываться в папку "folder".
defaultNewElementSettings Создание нового элемента при открытии справочника с пустой отметкой defaultNewElementSettings

Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode)

Значение Описание
None -
SelectFirst Будет выбран первый элемент справочника
SelectAll Будут выбраны все элементы справочника
DefaultValue Будут выбраны элементы по умолчанию, которые указаны в свойстве "defaultValue"
ParameterValue Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId"
SelectAllEver Будут выбраны все элементы справочника, в отличии от SelectAll, при любом перестроении источника отметка сбрасывается всегда до полной, позволяет решить вопрос, когда при нескольких перестроений зависимых источников некоторые из элементов оказываются не выбраны
DefaultValueByExpression Будут выбраны элементы по результату вычисления выражения, идентификатор которого указан в свойстве "defaultValueExpressionId"
DefaultValueOrSelectFirst Будут выбраны элементы по умолчанию из свойства "defaultValue" или, если DefaultValue придет пустым, первый элемент
ParameterValueOrSelectFirst Будут выбраны элементы по значению параметра из свойства "parameterId" или, если указанный параметр придет пустым, первый элемент
DefaultValueByExpressionOrSelectFirst Будут выбраны элементы по результату вычисления выражения из свойства "defaultValueExpressionId" или, если указанное выражение придет пустым, первый элемент