Чтение информации о версиях объектов 1с документооборот. V8: История изменения реквизитов
Ключевые слова: Регистрация, история, изменение.
Эта статья является описанием озвученного в третьего алгоритма.
Речь о том, чтобы хранить в базе историю изменения реквизитов объектов.
Объекты в данном случае - это справочники, документы, планы обмена, планы видов характеристик и т. д., в общем то, что вводится пользователем вручную, для чего требуется хранить историю изменения реквизитов и на что можно сделать ссылку.
Состав объектов произвольный и определяется программистом, то есть можно, к примеру, настроить механизм только для всех справочников и выборочных документов.
Общая идею проста, как четыре рубля одной монетой.
А вот при ближайшем рассмотрении выяснилось пара нюансов.
А при превращении мыслей в статью и вовсе все поменялось.
Начнем по-порядку.
Для начала, делаем периодический регистр сведений "История реквизитов" без привязки к регистратору.
Затем, очень хочется иметь в этом регистре сведений измерение "Объект" типа "Любая ссылка", но этого делать нельзя.
Причина та, что тогда мы теряем возможность удалять помеченные на удаление объекты, поскольку на них будут ссылки в регистре.
Если же это измерение делать ведущим, то при удалении мы потеряем всю историю по этому объекту, которая удалится вместе с самим объектом.
А с другой стороны и без этого реквизита совсем уж никуда, ни отчета сформировать, ни просто даже объект найти.
Поэтому, в каждый объект, для которого требуется регистрация изменений реквизитов, добавляем реквизит "GUID" типа "Строка (32)".
Кроме того, в регистр сведений "История реквизитов" добавляем измерение "GUID объекта" типа "Строка (32)".
Так я хотел написать сначала.
А потом хорошо подумал.
Во-первых, очень плохо делать разные соединения с таблицами объектов в запросах, чтобы получить нужный объект по реквизиту "GUID".
Во-вторых, журнал регистрации фирмой 1С реализован таким образом, что в нем в реквизите "Данные" хранится именно ссылка на объект, а никакой не GUID.
Просто при удалении объектов журнал регистрации не участвует в проверке ссылочной целостности и после удаления объекта в нем в реквизите "Данные" показывается знакомая многим надпись "<Объект не найден> ...".
В-третьих, GUID вместо ссылок придется тогда вставлять и в остальных полях, то есть в пользователе, старом значении и новом значении.
В-четвертых, дешевле сделать свой алгоритм удаления помеченных объектов, нежели так изголяться.
Тем паче, что типовой алгоритм крайне скуден.
Правда, в рамках данной статьи описывать альтернативный алгоритм удаления помеченных объектов я не буду, ограничусь лишь тем, что скажу, что этот алгоритм должен при удалении помеченных объектов в регистре сведений "История реквизитов" все ссылки на удаляемые объекты заменять пустыми ссылками.
Почему пустыми?
Да все просто, чтобы ссылочная целостность базы не нарушалась.
Поэтому добавляем измерение "Объект" типа "Любая ссылка".
Вместо типа "Любая ссылка" можно проставить галочки у конкретных объектов, без разницы.
Продолжаем.
Помимо объекта нужно иметь информацию о реквизите, который меняется.
Поэтому добавляем измерение "Реквизит" типа "Строка (25)" или "Справочник.РеквизитыОбъектов", кому как больше нравится.
Я для примера сделал строкой.
Затем добавляем информацию о пользователе, сделавшем изменения.
Для этого добавляем ресурс "Пользователь" типа "Справочник.Пользователи".
Кроме того, добавляем ресурс "Имя компьютера" типа "Строка (25)".
Кому 25 символов мало, может изменить на нужное количество.
Для того, чтобы знать, в какой распределенной базе меняли реквизит, в случае использования распределенных баз, нужно добавить ресурс "Распределенная база" типа план обмена "Распределенные базы".
И, наконец, добаляем два ресурса, "СтароеЗначение" и "НовоеЗначение" составного типа.
В составе типов "Число", "Строка", "Булево", "Дата" и "Любая ссылка".
Размерность типов "Число" и "Строка" проставляется максимальная из возможных, чтобы в нее уместилось содержимое любого реквизита.
Здесь есть досадный момент, в состав типов нельзя включить строку неограниченной длины.
Поэтому механизм нельзя будет применять для строк неограниченной длины, содержимое которых длиннее максимального размера строки в составе нашего типа.
Теперь по поводу настроек в объектах.
Во всех объектах, для которых будет регистрироваться история, требуется прописать следующий код.
Переменная "НаборЗаписейИсторияОбъектов" вынесена в переменные модуля по той причине, что для нового объекта проверку реквизитов нужно делать в процедуре "ПередЗаписью", а заполнять реквизит "Объект" значением "Ссылка" в процедуре "ПриЗаписи", поскольку в процедуре "ПередЗаписью" еще нет ссылки для нового объекта.
Перем НаборЗаписейИсторияОбъектов;
Процедура ПередЗаписью(Отказ)
НаборЗаписейИсторияОбъектов = РегистрыСведений.ИсторияОбъектов.СоздатьНаборЗаписей();
ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Код
");
ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Наименование
");
ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Родитель
");
ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Владелец
");
Для А = 0
По ЭтотОбъект.Метаданные().Реквизиты.Количество() - 1
Цикл
ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, ЭтотОбъект.Метаданные().Реквизиты[А].Имя);
КонецЦикла;
КонецПроцедуры
Процедура ПриЗаписи(Отказ)
Если НаборЗаписейИсторияОбъектов.Количество() <> 0
Тогда
Для Каждого Запись Из НаборЗаписейИсторияОбъектов Цикл
Запись.Объект = Ссылка;
КонецЦикла;
НаборЗаписейИсторияОбъектов.Записать(Ложь);
КонецЕсли;
КонецПроцедуры
Процедура ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, ИмяРеквизита)
Если ЭтотОбъект[ИмяРеквизита] <> Ссылка[ИмяРеквизита] Тогда
НоваяЗапись = НаборЗаписейИсторияОбъектов.Добавить();
НоваяЗапись.Период = ТекущаяДата();
НоваяЗапись.Реквизит = ИмяРеквизита;
НоваяЗапись.ИмяКомпьютера = ИмяКомпьютера();
НоваяЗапись.Пользователь = ПараметрыСеанса.ТекущийПользователь;
НоваяЗапись.РаспределеннаяБаза = ПараметрыСеанса.ТекущаяРаспределеннаяБаза;
НоваяЗапись.СтароеЗначение = Ссылка[ИмяРеквизита];
НоваяЗапись.НовоеЗначение = ЭтотОбъект[ИмяРеквизита];
КонецЕсли;
КонецПроцедуры
Пример приведен для иерархического подчиненного справочника.
Если брать другой объект, например, документ, то состав служебных реквизитов будет другой, не "Код", "Наименование", "Родитель" и "Владелец", а "Дата" и "Номер".
В следующих статьях будут рассмотрены примеры использования механизма, описанного в данной статье.
Замаялся.
От Гения 1С : Смотрите
Стандартный механизм, реализованный в программных продуктах, поставляемых фирмой 1С, позволяет решить задачу отслеживания изменений в базах данных двумя способами:
- С помощью журнала регистрации (очевидная возможность, автоматически включенная в большинстве типовых конфигураций);
- С помощью механизма версионирования объектов (мене очевидный, но значительно более мощный функционал, который необходимо включать самостоятельно).
Сразу следует сделать небольшое замечание. В базах со значительным документооборотом и большими объемами вносимой информации версионирование объектов 1С может приводить к существенному увеличению объемов хранилища.
Что это за механизм и для чего он нужен
Журнал регистрации позволяет отследить историю изменения объекта, однако, у него есть один существенный недостаток – он не позволяет увидеть, какие именно изменения вносились в существующие данные.
Версионирование объектов позволяет:
- Увидеть, что и когда изменялось в конкретном объекте;
- Определить, кто именно внес те или иные изменения;
- Просмотреть предыдущую версию объекта;
- Сравнить между собой две сохраненные версии;
- Произвести анализ, определив какая версия, была наиболее точной и правильной;
- Вернуть объект в необходимое состояние.
Как уже было сказано выше, включать этот механизм следует обдуманно, заранее определив набор объектов хранения.
Чаще всего версионирование объектов 1С задействуют на этапе внедрения того или иного программного продукта:
- Во-первых, в это время происходит самое большое количество ошибок;
- Во-вторых, объемы вводимой информации в это время существенно ниже, чем в то время, когда программа уже функционирует на полную мощность.
Таким образом, с помощью этого механизма администратор и разработчики получают реальную возможность для анализа возникающих нестандартных ситуаций, систематизации ошибок и принятия решений относительно путей и способов устранения возникающих проблем.
В функционирующих на полную мощность системах, объемы версионирования можно ограничить наиболее важными направлениями и областями деятельности.
Включение системы версионирования
Рассмотрим последовательность действий для включения механизма версионирования объектов на примере конфигурации «Зарплата и управление персоналом», редакция 3.1.
В первую очередь зайдем в систему «Администрирование» -> «Общие настройки» -> «История изменения»(Рис.1).
Если его нет, зайдем в подменю «Все функции…» в ветку «Константы»-> «Использовать версионирование…» (Рис.2) и активируем галочку на этой форме
Рис.2
После активации флажка появится еще один элемент меню: «Настройки хранения» (Рис.3)
Рис.5
Настройка истории изменений
Давайте рассмотрим вышеприведенную форму:
- Две верхние команды позволяют определить момент сохранения версий объектов и срок хранения;
- В табличной части можно выполнить те же самые настройки, которые выполняются командами;
- Список справочников и документов значительно меньше количества элементов метаданных в конфигураторе;
- Под табличной частью существует ссылка, позволяющая настроить расписание удаления старой версии.
Новые версии объектов могут сохраняться:
- При непосредственной записи документа в базу;
- При проведении (повторном проведении) документа;
- При старте, этот пункт меню включается только тогда, когда в список добавлен хотя бы один бизнес процесс, и его активация указывает на то, что новая версия объекта будет создана только после запуска процесса в работу.
Сроки хранения версий можно ограничить периодами от одной недели до одного года, если ничего не выбирать в этой колонке, варианты объекта будут бессрочно храниться в базе.
В случае, если к существующему списку справочников и документов нам потребуется добавить собственный объект, мы должны:
- Открыть программу в режиме конфигуратора;
- Открыть конфигурацию для изменения;
- Зайти в подменю «Общие»-> «Определяемые типы»-> «Версионируемые данные»;
- В свойствах элемента необходимо изменить набор элементов параметра «Тип» (Рис.6);
Рис.6
После сохранения и обновления конфигурации наш добавленный элемент появится в отрывающейся форме настройки.
После активации и настройки расписания удаления объектов в системе появится соответствующее регламентное задание.
Здесь следует отметить, что вся информация о версиях объектов хранится в регистре сведений «Версии объектов», соответственно все действия, характерные для непериодических регистров сведений доступны и для этого регистра, в частности, полную его очистку можно выполнить с помощью кода, представленного на Рис.7
Как с этим механизмом работать
После включения возможности хранения вариантов объекта для какого либо элемента метаданных, на форме элемента (справочника, документа, бизнес-процесса) появится команда «История изменений». Активация этой команды вызовет соответствующую форму, в которой можно будет увидеть:
- Автора новой версии (человека, который вносил изменения);
- Дату изменения;
- Добавить собственные комментарии к существующим вариантам объектов;
- Сравнить версии между собой;
- Вызвать отбор журнала регистрации по соответствующему событию;
- Просмотреть версию;
- Актуализировать предыдущую версию.
Еще раз обратим внимание на то, что этот мощный инструмент надо использовать обдумано и осмысленно, в противном случае он может значительно снизить эффективность работы с программой.
«Автоматизация бизнеса:История версий » – это комплекс дополнений к типовым конфигурациям на базе “1С:Предприятие 8”, предназначенный для хранения истории изменений справочников и документов, анализа изменений с точностью до значения реквизитов и возможностью для отката данных до выбранной версии объекта.
История предоставляет более детальную информацию, чем стандартный журнал регистрации, об изменениях документов и справочников. При этом список объектов (документов и справочников) требующих регистрации версий может быть настроен персонально.
История версий легко может быть интегрирована в любую конфигурацию на базе “1С:Предприятие 8.x”. При объединении не требуется вносить изменения в объекты исходной конфигурации.
Что дает система:
РУКОВОДИТЕЛЮ – ПОВЫШЕНИЕ КОНТРОЛЯ ЗА РАБОТОЙ ПОЛЬЗОВАТЕЛЕЙ:
простота и удобство мониторинга изменений вносимых в систему;
возможность просмотра, какие именно изменения были внесены в документы «задним числом»;
возможность отслеживать объем вносимой информации в систему каждым из пользователей;
ПОЛЬЗОВАТЕЛЯМ – ПОВЫШЕНИЕ УДОБСТВА РАБОТЫ С СИСТЕМОЙ:
возможность просмотра истории изменений по интересующему объекту;
возможность работы с предыдущими версиями объектов;
возможность восстановления («отката») объекта до выбранной версии;
Основные возможности:
хранение истории значений любого документа или справочника (реквизиты шапки, табличных частей, автор изменений, дата и время изменений);
наглядный просмотр изменений, каждой версии в графическом виде;
возможность отката до любой версии объекта;
возможность удаления ненужных версий объектов (ограничена правами доступа);
возможность просмотра изменений объектов с отборами: по автору, виду объекта, времени внесения изменений;
возможность настройки списка объектов требующих регистрации в системе без изменения конфигурации;
быстрый переход к просмотру истории изменений из любого объекта системы;
сервисные функции по работе с данными об изменениях: архивирование изменений за выбранный период и очистка изменений за выбранный период по указанным видам объектов;
Технические особенности:
возможность быстрой интеграции с любой конфигурацией на базе “1С:Предприятие 8.x” (до 8.3.6.x), без внесения изменений в объекты основной конфигурации; (интеграция занимает не более 5-ти минут)
при использовании «Автоматизация бизнеса:История версий» в базе данных хранится информация только об изменениях реквизитов объектов, что НЕ приводит к значительному росту базы данных и замедлению работы пользователей;
хранение изменений в системе производится в сжатом виде, что незначительно сказывается на времени формирования отчетов, но существенно сокращает требуемый объем памяти;
система поддерживает работу с распределенными базами данных;
Набор доступных отчетов и сервисных функций может быть ограничен на уровне прав доступа для каждого из пользователей системы. Программа может работать на управляемых формах.
«Автоматизация Бизнеса: История версий» является дополнением к любым типовым конфигурациям 8.x: «Управление торговлей ред. 10.3», «Управление торговлей ред. 11» и «Управление производственным предприятием ред. 1.3», и т.д. Данный продукт не содержит скрытых участков кода.
Системные требования:
Дополнительные сведения:
- Если программа не работает на вашем релизе типовой конфигарации, то мы ее доработаем для вас бесплатно.
- Для программы выпускаются регулярные бесплатные обновления.
- Код программы АБ:История версий открытый
- Модуль предоставляется под одну заявленную вами конфигурацию (платформу). Цена модуля от количества рабочих мест не зависит.
- При покупке программы предоставляется бесплатная техподдержка на 12 мес.
- Успановка программы производится либо самостоятельно пользователем, либо специалистами компании Автоматизация бизнеса за дополнительную плату. При покупке программы необходимо заполнить и отправить регистрационную анкету, которую пришлют с дистрибутивом программы.
Версионирование в 1С:Підприємство ➾ История изменений объектов ➾ Как настроить версионирование объектов в 1С:ПІдприємство? ➾ Что такое версионирование? Настройка вариантов, роли, механизм записи версий и др.
Представьте ситуацию: вы - менеджер по продажам. Вы сформировали заказ покупателя, по которому должны сделать отгрузку товара. Сформировали документ реализации и обнаружили, что данные в нем не совпадают с заказом покупателя. Чтобы узнать, кем, когда и какие изменения были внесены в документ, в конфигурациях "1С:ПІдприємство 8" существует механизм версионирования.
Версионирование - это хранение истории изменений объектов. В отличие от журнала регистрации, кроме хранения истории о том, кто, когда и какой объект изменил, механизм версионирования позволяет администратору системы увидеть конкретные изменения, которые внесли пользователи.
Система позволяет просматривать любую версию объекта или сравнивать любые версии объекта между собой. Для работы с историей изменений объектов необходимо выполнить предварительную настройку их версионирования. Настройку и просмотр истории версий выполняет администратор системы.
Как настроить версионирование объектов?
На данный момент механизм версионирования доступен во многих типовых, самых распространенных конфигурациях, например таких как:
Настройку версионирования выполняет Администратор системы с полными правами.
Откройте закладку "Версионирование" и поставьте галочку "Использовать версионирование объектов":
Нажмите на "Настройка версионирования объектов..."
При настройке версионирования для каждого типа документов и справочников можно указать:
- Не версионировать - значение установлено всем объектам по умолчанию;
- Версионировать - значение используется для настройки справочников и документов;
- Версионировать при проведении - значение используется только для документов.
Если выбран вариант Версионировать, то при каждом изменении объекта в его историю версий будет записываться очередная версия объекта.
Если у документа установлен режим Версионировать при проведении, то первая версия документа будет записана в историю только после первого проведения документа. Впоследствии версии документа будут записываться при каждой записи проведенного документа. Режим позволяет не создавать версии новых и не заполненных окончательно пользователем документов, чтобы не увеличивать размер ИБ. Рекомендуется применять эту настройку для всех документов.
Версионирование большого количества объектов может привести к росту информационной базы из-за хранения их версий. Поэтому рекомендуется использовать эту возможность избирательно.
Чтобы просмотреть историю изменений объектов, откройте Сервис/История изменений объектов. Команда доступна только администратору системы и только для тех объектов, у которых настроено версионирование. В открывшейся форме выберите объект (в примере это Заказ покупателя), выделите версии данного объекта, которые нужно сравнить, нажмите кнопку "Сравнить версии".
Эта команда сформирует Отчет по изменениям версий объекта (нажмите на изображение, чтобы увеличить):
Версионирование представляет собой опцию, с помощью которой пользователь может легко установить, кто и когда изменил находящийся в базе документ, а также какие именно изменения имели место. Платформа 1С:Предприятие 8 имеет сходную опцию – журнал регистрации, однако эта опция не позволяет выяснить характер изменений, журнал регистраций позволяет только узнать, когда был изменен документ и какой пользователь внес изменения.
Полезность инструмента «версионирование» можно проиллюстрировать на следующем примере. Менеджер сформировал заказ покупателя, на основании которого должна быть проведена отгрузка и поместил заказ в общую базу. При формировании документа реализации выясняется, что данные в новом документе отличаются от тех данных, которые были в заказе. В этом случае заказчик может получить не тот товар, которого ожидал или могут возникнуть другие неприятные ситуации, ответственность за которые ложится на данного менеджера. Для того чтобы выяснить – какие были сделаны изменения, кто и когда их сделал и предназначена опция версионирования, включенная в конфигурацию 1С:Предприятие 8.
Механизм версионирования позволяет хранить не только даты и автора изменений, но и историю изменений документа, опция позволяет просматривать различные версии состояния одного и того же документа. Чтобы использовать данную опцию, необходимо предварительно провести настройку версионирования объектов. Как настройку, так и просмотр всех состояний документа может проводить администратор системы.
Как настроить версионирование объектов?
Есть перечень типовых конфигураций платформы 1С:Предприятие, в которых реализована опция версионирования:
- 1С:Предприятие 8. Управление производственным предприятием
- 1С:Предприятие 8. Управление торговлей 10.3
Выполнение настройки версионирования проводится в учетной записи Администратора, в которой открыты все права.
1. Для настройки необходимо открыть программу, на панели навигации перейти к пункту Операции/Константы:
2. В закладках нужно выбрать «Версионирование», установить галочку перед надписью «Использовать версионирование объектов»:
В параметрах настройки есть возможность указать значение всех типов документов, справочников:
- Не версионировать - параметр установлен для всех типов объектов по умолчанию;
- Версионировать - параметр применяется для настройки справочников и документов;
- Версионировать при проведении -используется только для документов.
В том случае, если для какого-либо типа документа или справочника выбран параметр Версионировать, в историю версий этого объекта будет выполняться запись при каждом изменении этого объекта.
Режим «Версионировать при проведении» предполагает выполнение первой записи только после того,как документ впервые был проведен. Все последующие версии этого документа будут записываться после каждого изменения. Рекомендуется применить эту настройку для всех используемых объектов, поскольку данный режим не позволяет создавать пустых или неполных документов, за счет чего экономится свободное пространство информационной базы.
Если версионирование будет применяться ко всем без исключения объектам, это приведет к накоплению большого количества версий в базе, поэтому желательно органичивать количество объектов, к которым применяется эта функция.
4. Для просмотра истории версий необходимо в панели навигации перейти к пункту Сервис/История. Эта опция доступна исключительно для использования из-под учетной записи Администратора. Просматривать можно лишь те объекты, к которым была применена настройка версионирования. После того, как форма откроется, следует выбрать объект, изменения которого необходимо отследить, затем нужно выделить несколько версий для сравнения и нажать «Сравнить версии».
Если Вас заинтересовало версионирование (история изменений) объектов в 1С:Предприятие 8, напишите нам на почту: [email protected]