Платформа 3V/Формы/Источники данных/Справочник/Выбор элементов по умолчанию: различия между версиями
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 1: | Строка 1: | ||
− | Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у источника формы | + | Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у [[Платформа_3V/Формы/Источники_данных/Справочник|источника формы - справочника]] задать свойство '''dictionarySourceSelectionMode''' одним из следующих вариантов: |
=== Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) === | === Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) === | ||
Строка 13: | Строка 13: | ||
| SelectAll || Будут выбраны все элементы справочника | | SelectAll || Будут выбраны все элементы справочника | ||
|- | |- | ||
− | | | + | | DefaultValue|| Будут выбраны элементы по умолчанию, которые указаны в свойстве "defaultValue" |
|- | |- | ||
| ParameterValue || Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId" | | ParameterValue || Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId" | ||
Строка 30: | Строка 30: | ||
==Пример использования: задание по умолчанию определенных элементов справочника== | ==Пример использования: задание по умолчанию определенных элементов справочника== | ||
− | Для того чтобы задать значение по умолчанию в выпадающем списке | + | Для того чтобы задать статичное значение по умолчанию в выпадающем списке используют свойство '''DictionarySourceSelectionMode''' со значением '''DefaultValue'''.<br> |
Например, при открытии карточки всегда в параметре должны быть выбраны: "Кузнецов", "Смирнов" и "Сидоров". <br> | Например, при открытии карточки всегда в параметре должны быть выбраны: "Кузнецов", "Смирнов" и "Сидоров". <br> |
Текущая версия на 15:03, 9 февраля 2022
Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у источника формы - справочника задать свойство dictionarySourceSelectionMode одним из следующих вариантов:
Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode)
Значение | Описание |
---|---|
None | Без элемента по умолчанию |
SelectFirst | Будет выбран первый элемент справочника |
SelectAll | Будут выбраны все элементы справочника |
DefaultValue | Будут выбраны элементы по умолчанию, которые указаны в свойстве "defaultValue" |
ParameterValue | Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId" |
SelectAllEver | Будут выбраны все элементы справочника, в отличии от SelectAll, при любом перестроении источника отметка сбрасывается всегда до полной, позволяет решить вопрос, когда при нескольких перестроений зависимых источников некоторые из элементов оказываются не выбраны |
DefaultValueByExpression | Будут выбраны элементы по результату вычисления выражения, идентификатор которого указан в свойстве "defaultValueExpressionId" |
DefaultValueOrSelectFirst | Будут выбраны элементы по умолчанию из свойства "defaultValue" или, если DefaultValue придет пустым, первый элемент |
ParameterValueOrSelectFirst | Будут выбраны элементы по значению параметра из свойства "parameterId" или, если указанный параметр придет пустым, первый элемент |
DefaultValueByExpressionOrSelectFirst | Будут выбраны элементы по результату вычисления выражения из свойства "defaultValueExpressionId" или, если указанное выражение придет пустым, первый элемент |
Пример использования: задание по умолчанию определенных элементов справочника
Для того чтобы задать статичное значение по умолчанию в выпадающем списке используют свойство DictionarySourceSelectionMode со значением DefaultValue.
Например, при открытии карточки всегда в параметре должны быть выбраны: "Кузнецов", "Смирнов" и "Сидоров".
Пример можно посмотреть здесь.
Источником в выпадающем списке является справочник 1555, "Кузнецов", "Смирнов" и "Сидоров" - элементы справочника с идентификаторами 5, 4, 3.
Поэтому в JSON источника в карточке мы указываем следующие настройки defaultValue [ 3, 4, 5] и в "dictionarySourceSelectionMode" указываем значение "DefaultValue".
Пример JSON описания:
{
"dictionaryId": 1555,
"hierarchyId": null,
"defaultValue": [
3,
4,
5
],
"defaultValueExpressionId": null,
"parameterId": null,
"dictionarySourceSelectionMode": "DefaultValue",
"dataSourceAttributesAdditionsSettings": [],
"externalFileStorageUrl": null,
"filePrefix": null,
"discriminator": "DictionaryDataSource",
"id": 3,
"name": "Справочник",
"isReadOnly": false,
"dataEditRuleIds": [],
"dataEditExpressionIds": [],
"beforeSaveDataActions": [],
"beforeSaveActions": [],
"afterSaveDataActions": [],
"afterSaveActions": []
}
В результате при открытии карточки мы получим: