DB.DeletePhysically - Revision history

Admin: 1 revision imported

2023-06-08T10:10:22Z

1 revision imported

1>Admin at 06:14, 7 May 2023

2023-05-07T06:14:42Z

Admin: 1 revision imported

2021-02-07T06:43:17Z

1 revision imported

Admin: Created page with "{{infobox function |name=DeletePhysically |object=Объект базы данных |caption=Удаление объектов из базы данных |type=1 |status=..."

2019-09-25T12:28:22Z

Created page with "{{infobox function |name=DeletePhysically |object=Объект базы данных |caption=Удаление объектов из базы данных |type=1 |status=..."

New page

{{infobox function
|name=DeletePhysically
|object=[[Объект базы данных]]
|caption=Удаление объектов из базы данных
|type=1
|status=2
|db=2
|exception=Невозможно превратить в число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция производит физическое удаление элемента справочника или документа из базы данных, удаляя также подчиненные объекты, если это необходимо. Перед физическим удалением объектов, необходимо убедиться, что эти объекты не используются в реквизитах других объектов, иначе можно получить ситуацию, когда реквизиты содержат объект, который невозможно загрузить, такая ситуация для нормальной работы системы нежелательна. Для проверки, используется ли данный объект в других реквизитах каких-либо объектов, можно использовать функцию [[CollectObjectsLinks]].

== Синтаксис ==
<code>
{{Grey|DB.}}'''DeletePhysically'''({{Optional|<Режим удаления подчиненных элементов (INT)>,<Режим удаления папок (INT)>}}):<Результат (INT)>
</code>

==== Аргументы ====
* <code>''<Режим удаления подчиненных элементов (INT)>''</code> - {{Optional}} Задает режим удаления элементов справочников, подчиненных данному. По умолчанию этот аргумент равен 1 (удалять подчиненные элементы). Если подчиненные элементы не будут удалены, они не будут подчинены никакому другому элементу и может стать недоступны для визуального редактирования.
* <code>''<Режим удаления папок (INT)>''</code> - {{Optional}} Для папок справочников, задает режим удаления подпапок и элементов справочников, находящихся в данной папке справочника. По умолчанию этот аргумент равен 0 (не удалять подпапки и элементы внутри текущей папки). Если подпапки и элементы внутри удаляемой папки не будут удалены, они будут перемещены внутрь папки, в которой находится удаляемая.

==== Возвращаемое значение ====
Возвращается 1, если удаление прошло успешно, иначе возвращает 0 (были обнаружены блокировки удаляемых объектов и пр.).

== Примеры ==
<pre>
//Пример производит удаление элементов из списка, проверяя, не были ли они уже удалены ранее
Уд:=0;
For i:=1 To СпЭлУд.Size() Do
б:=СпЭлУд.Get(i).Copy();
If б.Loadable() Then
б.DeletePhysically();
Уд:=Уд+1;
If Уд%10=0 Then
Form.StatusText("Удалено элементов: "+Уд);
EndIf;
EndIf;
EndDo;
Message("Удалены элементы: "+Str(Уд),"I");
</pre>

← Older revision	Revision as of 10:10, 8 June 2023
(No difference)

@@ Line 21: / Line 21: @@
 ==== Аргументы ====
-* <code>''<Режим удаления подчиненных элементов (INT)>''</code> - {{Optional}} Задает режим удаления элементов справочников, подчиненных данному. По умолчанию этот аргумент равен 1 (удалять подчиненные элементы). Если подчиненные элементы не будут удалены, они не будут подчинены никакому другому элементу и может стать недоступны для визуального редактирования.
+* <code>''<Режим удаления подчиненных элементов (INT)>''</code> - {{Optional}} Задает режим удаления элементов справочников, подчиненных данному. По умолчанию этот аргумент равен 1 (удалять подчиненные элементы). Если подчиненные элементы не будут удалены, они не будут подчинены никакому другому элементу и могут стать недоступными для визуального редактирования.
 * <code>''<Режим удаления папок (INT)>''</code> - {{Optional}} Для папок справочников, задает режим удаления подпапок и элементов справочников, находящихся в данной папке справочника. По умолчанию этот аргумент равен 0 (не удалять подпапки и элементы внутри текущей папки). Если подпапки и элементы внутри удаляемой папки не будут удалены, они будут перемещены внутрь папки, в которой находится удаляемая.

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)