Глобальный контекст (Global context)

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

Доступен, начиная с версии 8.3.5.

Синтаксис:

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

Параметры:

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

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

• Объект метаданных – Общий реквизит, разделяющий данные.
• Строка – имя общего реквизита, разделяющего данные.

По умолчанию имеет значение Неопределено.
Допустимые значения:

• Неопределено - выбираются все объекты метаданных, если параметр <ВключитьОбъекты> также имеет значение Неопределено. Иначе равносильно передаче пустого массива.
• Массив с комбинациями разделителей, определяющий область поиска.

Примечание. Если комбинация разделителей содержит повторы, то вызывается исключение, т.к. в конфигурации не может быть объектов метаданных, дважды включенных в состав одного разделителя.
Значение по умолчанию: Неопределено.

<ВключитьОбъекты> (необязательный)

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

• Объект метаданных.
• Строка – полное имя объекта метаданных.

Допустимые значения:

• Неопределено,
• Пустой массив,
• Массив объектов метаданных.

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

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

Тип: Массив.
В качестве элементов массива могут выступать:

• Объект метаданных,
• Строка – полное имя объекта метаданных.

Свойство позволяет явно указать объекты метаданных, которые следует исключить из области поиска объектов, помеченных на удаление.
Допустимые значения:

• Неопределено
• Пустой массив (нет объектов, которые необходимо дополнительно включить в область поиска).
• Массив объектов метаданных.

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

Возвращаемое значение:

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

Описание:

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

Поиск выполняется среди доступных пользователю данных: у пользователя должно быть право на чтение объекта, данные выбираются только после проверки прав ограничения доступа.

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

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Вызов метода выполняет обращение к серверу.

Примечание:

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

Пример:

Использование в версии:

Доступен, начиная с версии 8.3.5.

     Методическая информация