Сценарий "Каскадное удаление записи справочника"

Иногда возникает необходимость удалить из базы DIRECTUM какую-либо запись справочника. Но удалить ее не удастся в случае, если существуют записи в других справочниках, документы или константы, в реквизитах которых используется удаляемая запись. Эти записи в свою очередь могут использоваться в др. объектах и т.д. Т.е. для удаления исходной записи необходимо удалить все “дерево” – под этим и подразумевается каскадное удаление записи справочника.

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

Как работает сценарий.

1. Запрашивается тип справочника, запись справочника и вариант работы сценария (Удаление записи или Сбор информации).

2. При Удалении вызывается функция, в которую передается запись справочника. Она находит все объекты, использующие данную запись. Если запись не используется, то происходит ее удаление. В противном случае, просматриваются все объекты, и для записи справочника - функция рекурсивно вызывает сама себя, документы – удаляются (реквизит, в котором используется запись, обязательный) или предлагается выбрать Удалить документ/Очистить реквизит (реквизит необязательный), константы - очищаются. Если все объекты обработаны, значит, запись больше не используется, и она удаляется.
3. При Сборе информации выполняется также разработанный аналитический отчет «Каскадное использование записи справочника», который показывает ссылки на объекты, каскадно использующие запись справочника в качестве значения реквизита.

Рис. 1. Отчет.

Особенности работы сценария:

• если запись из одного из следующих справочников: Организации, Подразделения организаций, Контактные лица организаций, Абоненты систем обмена документами, является отражением записи из зеркального справочника - Наши организации, Подразделения, Работники, Наши абоненты систем обмена документами, удалить такую запись можно только через зеркальный справочник. Поэтому сначала происходит удаление исходной записи, а затем отражения;
• т.к. в базе может существовать циклическое использование записи справочника, например: в таких случаях выполнение сценария прерывается и выводится сообщение с указанием справочника и наименования записи, которую не удалось удалить. Следует вручную очистить значение соответствующего реквизита и запустить сценарий заново. Однако, для случая очистка реквизита “Руководитель” выполнятся автоматически.

Сценарий также может быть запущен из командной строки или другой компоненты . Дополнительные параметры для запуска сценария: “RefType” – имя типа справочника, “ID” – ИД записи, “UseType” – тип использования “Удаление/Отчет”:

SBLauncher.exe  S=SQLSERVER  D=DIRECTUM -CT=Script -F="CascadeDeleting"

-R="RefType=ОРГ|ID=101702|UseType=Отчет"

Работает в DIRECTUM 4.9.

******************01.02.2013******************

Добавлено:

1) после успешного завершения сценария выводится список удаленных или очищенных объектов;

2) в документах предлагается очистить необязательный реквизит.

CascadeDeleting.zip (19,28 Кб)