НайтиПомеченныеНаУдаление

[1cwiki]

Раздел

Глобальный контекст

Подразделы

Процедуры и функции работы с данными информационной базы

Синтаксис:

НайтиПомеченныеНаУдаление(<ОбластьПоиска>, <ВключитьОбъекты>, <ИсключитьОбъекты>)
Параметры:

<ОбластьПоиска> (необязательный)

Тип: Массив.
Определяет область поиска объектов, помеченных на удаление. Область устанавливается комбинацией разделителей, в состав которых включены объекты метаданных, среди данных которых следует выполнять поиск.
Элемент массива имеет тип Массив.
Элемент вложенного массива имеет тип:
Объект метаданных – Общий реквизит, разделяющий данные.
Строка – имя общего реквизита, разделяющего данные.
По умолчанию имеет значение Неопределено.
Допустимые значения:
Неопределено,
Массив с комбинациями разделителей, определяющий область поиска,
Пустой массив - область поиска определяется параметрами метода ВключитьОбъекты и ИсключитьОбъекты.
Примечание. Если комбинация разделителей содержит повторы, то вызывается исключение, т.к. в конфигурации не может быть объектов метаданных, дважды включенных в состав одного разделителя.
Значение по умолчанию: Неопределено.
<ВключитьОбъекты> (необязательный)

Тип: Массив.
Позволяет явно указать объекты метаданных, которые должны присутствовать в области поиска ссылок помеченных на удаление объектов.
Элементом массива могут быть:
Объект метаданных.
Строка – полное имя объекта метаданных.
Допустимые значения:
Неопределено,
Пустой массив,
Массив объектов метаданных.

Значение по умолчанию: Неопределено.
<ИсключитьОбъекты> (необязательный)

Тип: Массив.
В качестве элементов массива могут выступать:
Объект метаданных,
Строка – полное имя объекта метаданных.
Свойство позволяет явно указать объекты метаданных, которые следует исключить из области поиска объектов, помеченных на удаление.
Допустимые значения:
Неопределено
Пустой массив (нет объектов, которые необходимо дополнительно включить в область поиска).
Массив объектов метаданных.

Значение по умолчанию: Неопределено.
Возвращаемое значение:

Тип: Массив.
Массив со списком ссылок помеченных на удаление объектов.
Описание:

Осуществляет поиск всех помеченных на удаление объектов, которые доступны пользователю в рамках текущего сеанса и которые попадают в область поиска, заданную параметрами ОбластьПоиска, ВключитьОбъекты и ИсключитьОбъекты.
Если параметр ОбластьПоиска неопределен или используется режим совместимости Версия8_3_4 и ниже, поиск осуществляется среди всех объектов, которые доступны в рамках текущего сеанса с учетом разделения (учитывается и условное разделение). При этом параметры ВключитьОбъекты и ИсключитьОбъекты не учитываются.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).
Примечание:

На мобильной платформе параметры ОбластьПоиска, ВключитьОбъекты, ИсключитьОбъекты игнорируются.
Пример:

Код Выделить Развернуть

ПомеченныеОбъекты = НайтиПомеченныеНаУдаление();
Для Каждого ПомеченныйЭлемент Из ПомеченныеОбъекты Цикл
    Сообщить("Помечен на удаление: " + ПомеченныйЭлемент);
КонецЦикла;