Платформа 3V/Формы/Источники данных/Справочник/Выбор элементов по умолчанию

Материал из 3v-wiki
Перейти к навигации Перейти к поиску

Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у источника формы (блок 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.

1 выбор элементов.png



Поэтому в 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": []
    }

В результате при открытии карточки мы получим:

2 результат параметра по умолчанию.png