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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
(Новая страница: «Страница в разработке»)
 
Строка 1: Строка 1:
−
Страница в разработке
+
При необходимости выставления отметки по умолчанию в справочник необходимо у источника формы задать свойство '''dictionarySourceSelectionMode''' одним из следующих вариантов:
 +
 
 +
=== Режимы выставления отметки справочника при открытии справочника (DictionarySourceSelectionMode) ===
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Значение !! Описание
 +
|-
 +
| None || -
 +
|-
 +
| SelectFirst || Будет выбран первый элемент справочника
 +
|-
 +
| SelectAll || Будут выбраны все элементы справочника
 +
|-
 +
| [[Платформа_3V/Формы/Источники_данных/Справочник/DefaultValue|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>

Версия 14:53, 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=5971