Платформа 3V/Формы/Источники данных/Справочник: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 81: Строка 81:
 
! Значение !! Описание
 
! Значение !! Описание
 
|-
 
|-
| None (0) || -
+
| None || -
 
|-
 
|-
| SelectFirst (1) || Будет выбран первый элемент справочника
+
| SelectFirst || Будет выбран первый элемент справочника
 
|-
 
|-
| SelectAll (2) || Будут выбраны все элементы справочника
+
| SelectAll || Будут выбраны все элементы справочника
 
|-
 
|-
| DefaultValue (3) || Будут выбраны элементы по умолчанию
+
| DefaultValue || Будут выбраны элементы по умолчанию, которые указаны в свойстве "defaultValue"
 
|-
 
|-
| ParameterValue (4) || Будут выбраны элементы по значению параметра
+
| ParameterValue || Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId"
 
|-
 
|-
| SelectAllEver (5) || Будут выбраны все элементы справочника, в отличии от SelectAll, при обновлении источника отметка сбрасывается всегда до полной, позволяет решить вопрос, когда при нескольких перестроений зависимых источников некоторые из элементов оказываются не выбраны
+
| SelectAllEver || Будут выбраны все элементы справочника, в отличии от SelectAll, при любом перестроении источника отметка сбрасывается всегда до полной, позволяет решить вопрос, когда при нескольких перестроений зависимых источников некоторые из элементов оказываются не выбраны
 
|-
 
|-
| DefaultValueByExpression (6) || Будут выбраны элементы по результату вычисления выражения
+
| DefaultValueByExpression || Будут выбраны элементы по результату вычисления выражения, идентификатор которого указан в свойстве "defaultValueExpressionId"
 
|-
 
|-
| DefaultValueOrSelectFirst (103) || Будут выбраны элементы по умолчанию или первый элемент
+
| DefaultValueOrSelectFirst || Будут выбраны элементы по умолчанию из свойства "defaultValue" или, если DefaultValue придет пустым, первый элемент
 
|-
 
|-
| ParameterValueOrSelectFirst(104) || Будут выбраны элементы по значению параметра или первый элемент
+
| ParameterValueOrSelectFirst || Будут выбраны элементы по значению параметра из свойства "parameterId" или, если указанный параметр придет пустым, первый элемент
 
|-
 
|-
| DefaultValueByExpressionOrSelectFirst (106) || Будут выбраны элементы по результату вычисления выражения или первый элемент
+
| DefaultValueByExpressionOrSelectFirst || Будут выбраны элементы по результату вычисления выражения из свойства "defaultValueExpressionId" или, если указанное выражение придет пустым, первый элемент
 
|}
 
|}

Версия 13:32, 4 мая 2021

 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 Идентификатор альтернативной иерархии справочника DictionaryHierarchyDto
filter Фильтр справочника DictionaryFilterDto
sortingOptions Настройки сортировки элементов справочника
groupingOptions Настройки группировки справочника
attribute Коллекция загружаемых атрибутов
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" или, если указанное выражение придет пустым, первый элемент