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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 8 промежуточных версий этого же участника)
Строка 21: Строка 21:
 
           }
 
           }
 
         ],
 
         ],
         "saveElementOnInitialize": true,
+
         "saveElementOnInitialize": false,
         "conditionExpressionId": 100
+
         "conditionExpressionId": null
 
       },
 
       },
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 40: Строка 40:
 
|  defaultValues.expressionId|| Идентификатор [[Платформа_3V/Формы/Выражения | '''выражения''']], с помощью которого будет вычисляться значение по умолчанию
 
|  defaultValues.expressionId|| Идентификатор [[Платформа_3V/Формы/Выражения | '''выражения''']], с помощью которого будет вычисляться значение по умолчанию
 
|-
 
|-
|  saveElementOnInitialize || Сохранять элемент при открытии формы
+
|  saveElementOnInitialize || Сохранять элемент [[Платформа_3V/Формы/Источники_данных/Справочник/Создание_нового_элемента_при_открытии_формы | '''при открытии формы''']]
 
|-
 
|-
 
|  conditionExpressionId|| Идентификатор [[Платформа_3V/Формы/Выражения | '''выражения''']] с условием, при выполнении которого необходимо создавать новый элемент
 
|  conditionExpressionId|| Идентификатор [[Платформа_3V/Формы/Выражения | '''выражения''']] с условием, при выполнении которого необходимо создавать новый элемент
Строка 47: Строка 47:
 
'''Важно!''' атрибуты, которым заданы значения по умолчанию, обязательно должны быть добавлены на форму, в ином случае значение по умолчанию проставлено не будет.  
 
'''Важно!''' атрибуты, которым заданы значения по умолчанию, обязательно должны быть добавлены на форму, в ином случае значение по умолчанию проставлено не будет.  
 
Если данные поля не должны отображаться на форме, их возможно скрыть с помощью флага "Отображать"
 
Если данные поля не должны отображаться на форме, их возможно скрыть с помощью флага "Отображать"
 +
 +
<div class="NavFrame collapsed" style="width:1200px; overflow:auto;">
 +
  <div class="NavHead">Пример</div>
 +
  <div class="NavContent">
 +
[https://study.3v-cloud.com/navigator/#/home?objectId=2689 Форма с установленными атрибутами по умолчанию]
 +
  </div>
 +
</div>
 +
<br>
  
 
== Особенности использования ==
 
== Особенности использования ==
Новому элементу можно сразу при создании присвоить дефолтые значения атрибутов. Эти значения могут быть константой либо вычислены в expression. Но есть одно ограничение: этот метод не сможет подставить значение из других справочников, т.к. он срабатывает ДО построения источников
+
При необходимости выставления значения из атрибутов на основании элемента справочника требуется использовать НЕ источник - справочник с фильтром в форме в качестве источника данных, а выражение [[Платформа_3V/Формы/Выражения/Параметры/На_справочнике_-_объекте_репозитория_(EntryExpressionByDictionaryRequest)| '''на справочнике - объекте репозитория''']] с требуемыми фильтрами.
 +
 
 +
Пример: в параметр формы приходит определенный элемент справочника, значения атрибутов которого требуется подставить в новый создаваемый элемент
  
 
<div class="NavFrame collapsed" style="width:1200px; overflow:auto;">
 
<div class="NavFrame collapsed" style="width:1200px; overflow:auto;">
 
   <div class="NavHead">Пример</div>
 
   <div class="NavHead">Пример</div>
 
   <div class="NavContent">
 
   <div class="NavContent">
[https://study.3v-cloud.com/navigator/#/home?objectId=2689 Форма с установленными атрибутами по умолчанию]
+
[https://study.3v-cloud.com/navigator/#/home?objectId=3391 Пример по выставлению атрибутов элемента справочника]
 
   </div>  
 
   </div>  
 
</div>
 
</div>
 
<br>
 
<br>
 +
 +
Для выставления значений по умолчанию в поле с типом "Раскрывающийся список" или “Выбор из списка” при наличии "Источника данных", т.е. при необходимости сохранять данные в связанный источник, используйте текущий описанный механизм. В случае отстутвия источника данных, например, при использовании списков в качестве фильтров в реестровых формах, возможно воспользоваться [[Платформа_3V/Формы/Источники_данных/Справочник/Выбор_элементов_по_умолчанию| '''следующим способом''']], однако он не будет работать в первом случае

Текущая версия на 05:27, 2 августа 2022

Описание

Для того чтобы при открытии формы у атрибутов справочника задавались значения по умолчанию, в источнике (DictionaryDataSource ) необходимо прописать defaultNewElementSettings и прописать условия заполнения атрибутов:

"entryDataSources": {}
 1  "defaultNewElementSettings": {
 2           "defaultValues": [
 3           {
 4             "attributeId": 2,
 5             "value": "Новый объект",
 6             "expressionId": null
 7           },    
 8           {
 9             "attributeId": 3,
10             "value": null,
11             "expressionId": 1001
12           }
13         ],
14         "saveElementOnInitialize": false,
15         "conditionExpressionId": null
16       },
Поле Описание
defaultValues Значения атрибутов, которые присваиваются новому элементу
defaultValues.attributeId Идентификатор атрибута, которому требуется задать значение по умолчанию
defaultValues.value Статичное значение атрибута
defaultValues.expressionId Идентификатор выражения, с помощью которого будет вычисляться значение по умолчанию
saveElementOnInitialize Сохранять элемент при открытии формы
conditionExpressionId Идентификатор выражения с условием, при выполнении которого необходимо создавать новый элемент

Важно! атрибуты, которым заданы значения по умолчанию, обязательно должны быть добавлены на форму, в ином случае значение по умолчанию проставлено не будет. Если данные поля не должны отображаться на форме, их возможно скрыть с помощью флага "Отображать"


Особенности использования

При необходимости выставления значения из атрибутов на основании элемента справочника требуется использовать НЕ источник - справочник с фильтром в форме в качестве источника данных, а выражение на справочнике - объекте репозитория с требуемыми фильтрами.

Пример: в параметр формы приходит определенный элемент справочника, значения атрибутов которого требуется подставить в новый создаваемый элемент


Для выставления значений по умолчанию в поле с типом "Раскрывающийся список" или “Выбор из списка” при наличии "Источника данных", т.е. при необходимости сохранять данные в связанный источник, используйте текущий описанный механизм. В случае отстутвия источника данных, например, при использовании списков в качестве фильтров в реестровых формах, возможно воспользоваться следующим способом, однако он не будет работать в первом случае