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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
(Новая страница: «Страница в разработке»)
 
 
(не показано 6 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
Страница в разработке
+
Для выставления отметки по умолчанию в поле со списком элементов из справочника необходимо у [[Платформа_3V/Формы/Источники_данных/Справочник|источника формы - справочника]] задать свойство '''dictionarySourceSelectionMode''' одним из следующих вариантов:
 +
 
 +
=== Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) ===
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Значение !! Описание
 +
|-
 +
| None || Без элемента по умолчанию
 +
|-
 +
| SelectFirst || Будет выбран первый элемент справочника
 +
|-
 +
| SelectAll || Будут выбраны все элементы справочника
 +
|-
 +
| DefaultValue|| Будут выбраны элементы по умолчанию, которые указаны в свойстве "defaultValue"
 +
|-
 +
| ParameterValue || Будут выбраны элементы по значению параметра, идентификатор которого указан в свойстве "parameterId"
 +
|-
 +
| SelectAllEver || Будут выбраны все элементы справочника, в отличии от SelectAll, при любом перестроении источника отметка сбрасывается всегда до полной, позволяет решить вопрос, когда при нескольких перестроений зависимых источников некоторые из элементов оказываются не выбраны
 +
|-
 +
| DefaultValueByExpression || Будут выбраны элементы по результату вычисления выражения, идентификатор которого указан в свойстве "defaultValueExpressionId"
 +
|-
 +
| DefaultValueOrSelectFirst || Будут выбраны элементы по умолчанию из свойства "defaultValue" или, если DefaultValue придет пустым, первый элемент
 +
|-
 +
| ParameterValueOrSelectFirst || Будут выбраны элементы по значению параметра из свойства "parameterId" или, если указанный параметр придет пустым, первый элемент
 +
|-
 +
| DefaultValueByExpressionOrSelectFirst || Будут выбраны элементы по результату вычисления выражения из свойства "defaultValueExpressionId" или, если указанное выражение придет пустым, первый элемент
 +
|}
 +
 
 +
 
 +
==Пример использования: задание по умолчанию определенных элементов справочника==
 +
Для того чтобы задать статичное значение по умолчанию в выпадающем списке используют свойство '''DictionarySourceSelectionMode''' со значением '''DefaultValue'''.<br>
 +
 
 +
Например, при открытии карточки всегда в параметре должны быть выбраны: "Кузнецов", "Смирнов" и "Сидоров". <br>
 +
Пример можно посмотреть [https://study.3v-cloud.com/navigator/#/home?objectId=1539 здесь.]<br>
 +
Источником в выпадающем списке является справочник 1555, "Кузнецов", "Смирнов" и "Сидоров" - элементы справочника с идентификаторами 5, 4, 3.
 +
[[Файл:1 выбор элементов.png|700px|слева]]<br clear="both" /><br>
 +
Поэтому в JSON источника в карточке мы указываем следующие настройки '''defaultValue''' [ 3, 4, 5] и в '''"dictionarySourceSelectionMode"''' указываем значение "DefaultValue".<br>
 +
Пример JSON описания:
 +
<syntaxhighlight lang="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": []
 +
    }
 +
</syntaxhighlight>
 +
В результате при открытии карточки мы получим:
 +
[[Файл:2 результат параметра по умолчанию.png|900px|слева]]<br clear="both" /><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.

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



Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Формы/Источники_данных/Справочник/Выбор_элементов_по_умолчанию&oldid=5982