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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 1: Строка 1:
Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у источника формы (блок '''entryDataSources''') задать свойство '''dictionarySourceSelectionMode''' одним из следующих вариантов:
+
Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у [[Платформа_3V/Формы/Источники_данных/Справочник|источника формы - справочника] задать свойство '''dictionarySourceSelectionMode''' одним из следующих вариантов:
  
 
=== Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) ===
 
=== Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) ===

Версия 15:02, 9 февраля 2022

Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у [[Платформа_3V/Формы/Источники_данных/Справочник|источника формы - справочника] задать свойство 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