http://sfsys.ru/index.php?action=history&feed=atom&title=DB.MassSetValueDB.MassSetValue - Revision history2026-04-04T15:27:42ZRevision history for this page on the wikiMediaWiki 1.31.1http://sfsys.ru/index.php?title=DB.MassSetValue&diff=4064&oldid=prevAdmin: 1 revision imported2021-11-20T17:03:53Z<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">Revision as of 17:03, 20 November 2021</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttp://sfsys.ru/index.php?title=DB.MassSetValue&diff=4063&oldid=prev1>Admin at 16:09, 2 October 20212021-10-02T16:09:33Z<p></p>
<p><b>New page</b></p><div>{{infobox function<br />
|name=SetValue<br />
|object=[[Объект базы данных]]<br />
|caption=Установка значений множества реквизитов<br />
|type=1<br />
|status=2<br />
|db=2<br />
|exception=Невозможно превратить в строку, дату, неверный реквизит, стр. часть, и пр.<br />
|visual=0}}<br />
{{HeadLinks|<br />
* [[Main_Page|Начальная страница]]<br />
* [[Общее_описание_языка|Общее описание]]<br />
* [[Объекты]]<br />
* [[Объект базы данных]]}}<br />
Функция устанавливает значения реквизитов множества объектов, заданных в выборке с помощью стандратных фильтров. Реквизит может находиться как в заголовке объекта, так и в его строчной части. '''Функция не проверяет наличие блокировки на объектах до выполнения изменения! Внимание:''' в реальной работе необходимо либо заблокировать изменяемые объекты до вызова функции, либо использовать функцию [[LockDBPath]], иначе изменения в объектах, выполненные таким образом, могут быть утеряны, если какой-либо объект открыт в данный момент на редактирование пользователем (или программно) и будет записан.<br />
<br />
Установка значений периодических реквизитов пока не поддерживается {{Planned}}. Изменение реквизитов, имеющих записи в таблице подчиненности документов (см. [[DB.LoadLinkedDocuments|LoadLinkedDocuments]]), не поддерживается, функция вызовет исключения при попытке изменить такие реквизиты. Функция корректно изменяет триггеры объектов, если они имеются. '''Важно''': для установки реквизитов журналов или реквизитов объектов, имеющих соответствующий реквизит в журнале, '''необходимо''' заблокировать объекты, на которые ссылаются объекты журнала, иначе (в редких случаях) можно получить состояние несогласованности объекта базы данных с его ссылкой в журнале (если изменение происходило в момент записи объекта другим пользователем, и объект был записан, а его ссылка в журнале еще не была обновлена). <br />
<br />
== Синтаксис ==<br />
<code><br />
{{Grey|DB.}}'''MassSetValue'''(''<Указание на реквизит и строчную часть, если необходимо (STRING)>'',''<Значение реквизита>''{{Optional|,<Дата начала записи периодического реквизита (DATE)>,<Дата окончания записи периодического реквизита (DATE)>,<Стандарные фильтры>...}})<br />
</code><br />
<br />
==== Аргументы ====<br />
* <code>''<Указание на реквизит и строчную часть, если необходимо (STRING)>''</code> - Задает наименование реквизита, значение которого необходимо установить, если реквизит находится в строчной части, указывает также на наименование строчной части. Общий формат аргумента: <code>[<Наименование строчной части>.]<Наименование реквизита></code>.<br />
* <code>''<Значение реквизита>''</code> - Устанавливаемое значение реквизита. Если тип значения не соответствует типу значения реквизита, тип будет приведен (т.е., если реквизит имеет тип число, а аргумент имеет строчный тип, строка будет превращена в число до установки значение). <br />
* <code>''<Дата начала записи периодического реквизита (DATE)>''</code> - {{Optional}} Задает дату начала периода сохранения периодического реквизита объекта. Если реквизит не периодический, этот аргумент игнорируется. {{Planned}}<br />
* <code>''<Дата окончания записи периодического реквизита (DATE)>''</code> - {{Optional}} Задает дату окончания периода сохранения периодического реквизита объекта. Если реквизит не периодический, этот аргумент игнорируется. Если аргумент не задан, однако аргумент ''Дата начала записи периодического реквизита'' задан и не соответствует пустой дате, этот аргумент устанавливается равным предыдущему (запись производится на дату, а не на диапазон дат), если оба аргумента не заданы, используется диапазон записи, заданный функцией [[DB.UsePeriod|UsePeriod]]. {{Planned}}<br />
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры позиционирования описаны в статье [[Стандартные фильтры]].<br />
<br />
== Примеры ==<br />
<pre><br />
//Пример производит изменение реквизита ТоварнаяГруппа всех элементов справочника Номенклатура, родительская папка которых имеет реквизит Code равный "000000008636"<br />
bEl:=DB("Ref.ТоварнаяГруппа","Code","000000000055");<br />
aEl:=Ref.Номенклатура;<br />
aEl.MassSetValue("ТоварнаяГруппа",bEl,,,"~(@Folder.Code=""000000008636"")");<br />
</pre></div>1>Admin