Платформа 3V/Формы/Источники данных/Справочник/Выбор элементов по умолчанию
Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у источника формы (блок entryDataSources) задать свойство 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": []
}
В результате при открытии карточки мы получим: