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

• при замене основных объектов будет выполнен поиск замен подчиненных объектов;
• если ВыполнятьАвтоматическийПоискЗамен = Истина, то будет выполнена попытка поиска замен для подчиненных объектов по значениям полей связи. В случае, если объект не существует, будет выполнена процедура ПриПоискеЗаменыСсылок;
• если МетодПоиска в описании связей задан, то если автоматический поиск не нашел замен или не выполнялся, будет вызван МетодПоиска для подбора замен.

Синтаксис

Функция ЗаменитьСсылки(Знач ПарыЗамен, Знач ПараметрыЗамены = Неопределено) Экспорт

Параметры

• ПарыЗамен — Соответствие из КлючИЗначение:
  • Ключ - ЛюбаяСсылка - что ищем (дубль).
  • Значение - ЛюбаяСсылка - на что заменяем (оригинал). Ссылки сами на себя и пустые ссылки для поиска будут проигнорированы.
• ПараметрыЗамены — см. ОбщегоНазначения.ПараметрыЗаменыСсылок

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

ТаблицаЗначений - неуспешные замены (ошибки):

• Ссылка - ЛюбаяСсылка - ссылка, которую заменяли.
• ОбъектОшибки - Произвольный - объект-причина ошибки.
• ПредставлениеОбъектаОшибки - Строка - строковое представление объекта ошибки.
• ТипОшибки - Строка - тип ошибки: "ОшибкаБлокировки" - при обработке ссылки некоторые объекты были заблокированы. "ДанныеИзменены" - в процессе обработки данные были изменены другим пользователем. "ОшибкаЗаписи" - не смогли записать объект, или метод ВозможностьЗаменыЭлементов вернул отказ. "ОшибкаУдаления" - не смогли удалить объект. "НеизвестныеДанные" - при обработке были найдены данные, которые не планировались к замене.
• ТекстОшибки - Строка - подробное описание ошибки.

Пример вызова

Результат = ОбщегоНазначения.ЗаменитьСсылки(ПарыЗамен, ПараметрыЗамены)

Доступность

Сервер, Толстый клиент, Внешнее соединение