Изменение версии документа в 1с. V8: История изменения реквизитов. Включение системы версионирования

Стандартный механизм, реализованный в программных продуктах, поставляемых фирмой 1С, позволяет решить задачу отслеживания изменений в базах данных двумя способами:

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

Сразу следует сделать небольшое замечание. В базах со значительным документооборотом и большими объемами вносимой информации версионирование объектов 1С может приводить к существенному увеличению объемов хранилища.

Что это за механизм и для чего он нужен

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

Версионирование объектов позволяет:

1. Увидеть, что и когда изменялось в конкретном объекте;
2. Определить, кто именно внес те или иные изменения;
3. Просмотреть предыдущую версию объекта;
4. Сравнить между собой две сохраненные версии;
5. Произвести анализ, определив какая версия, была наиболее точной и правильной;
6. Вернуть объект в необходимое состояние.

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

Чаще всего версионирование объектов 1С задействуют на этапе внедрения того или иного программного продукта:

• Во-первых, в это время происходит самое большое количество ошибок;
• Во-вторых, объемы вводимой информации в это время существенно ниже, чем в то время, когда программа уже функционирует на полную мощность.

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

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

Включение системы версионирования

Рассмотрим последовательность действий для включения механизма версионирования объектов на примере конфигурации «Зарплата и управление персоналом», редакция 3.1.

В первую очередь зайдем в систему «Администрирование» -> «Общие настройки» -> «История изменения»(Рис.1).

Если его нет, зайдем в подменю «Все функции…» в ветку «Константы»-> «Использовать версионирование…» (Рис.2) и активируем галочку на этой форме

Рис.2

После активации флажка появится еще один элемент меню: «Настройки хранения» (Рис.3)

Рис.5

Настройка истории изменений

Давайте рассмотрим вышеприведенную форму:

1. Две верхние команды позволяют определить момент сохранения версий объектов и срок хранения;
2. В табличной части можно выполнить те же самые настройки, которые выполняются командами;
3. Список справочников и документов значительно меньше количества элементов метаданных в конфигураторе;
4. Под табличной частью существует ссылка, позволяющая настроить расписание удаления старой версии.

Новые версии объектов могут сохраняться:

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

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

В случае, если к существующему списку справочников и документов нам потребуется добавить собственный объект, мы должны:

1. Открыть программу в режиме конфигуратора;
2. Открыть конфигурацию для изменения;
3. Зайти в подменю «Общие»-> «Определяемые типы»-> «Версионируемые данные»;
4. В свойствах элемента необходимо изменить набор элементов параметра «Тип» (Рис.6);

Рис.6

После сохранения и обновления конфигурации наш добавленный элемент появится в отрывающейся форме настройки.

После активации и настройки расписания удаления объектов в системе появится соответствующее регламентное задание.

Здесь следует отметить, что вся информация о версиях объектов хранится в регистре сведений «Версии объектов», соответственно все действия, характерные для непериодических регистров сведений доступны и для этого регистра, в частности, полную его очистку можно выполнить с помощью кода, представленного на Рис.7

Как с этим механизмом работать

После включения возможности хранения вариантов объекта для какого либо элемента метаданных, на форме элемента (справочника, документа, бизнес-процесса) появится команда «История изменений». Активация этой команды вызовет соответствующую форму, в которой можно будет увидеть:

1. Автора новой версии (человека, который вносил изменения);
2. Дату изменения;
3. Добавить собственные комментарии к существующим вариантам объектов;
4. Сравнить версии между собой;
5. Вызвать отбор журнала регистрации по соответствующему событию;
6. Просмотреть версию;
7. Актуализировать предыдущую версию.

Еще раз обратим внимание на то, что этот мощный инструмент надо использовать обдумано и осмысленно, в противном случае он может значительно снизить эффективность работы с программой.

В «1С:Бухгалтерии 8» (ред. 3.0), начиная с версии 3.0.35, реализован механизм версионирования объектов, с помощью которого можно отслеживать историю изменений документов и справочников.

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

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

Использование версионирования особенно актуально на начальном этапе внедрения программы, когда объемы информации небольшие, а исполнители совершают много ошибок (например, вводят лишнюю информацию или очищают наименование или значение какого-то реквизита внутри объекта).

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

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

Объекты версионирования

Возможность хранения версий поддерживаются для справочников и документов, относящихся к следующим разделам учетной системы:

• Банк и касса;
• Продажи;
• Покупки;
• Склад;
• Производство;
• ОС и НМА;
• Зарплата и кадры.

Если для выбранного справочника или документа версионирование включено, в его форме будет доступна команда История изменений (рис. 1).

Рис. 1. Команда История изменений в форме элемента справочника.

По этой команде открывается список версий объекта (рис. 2).

Рис. 2. История изменений объекта.

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

• Кто изменил объект?
• Когда произошли изменения?
• Что было изменено в объекте?

В списке выводится следующая информация:

• № - порядковый номер версии, версии перечисляются по убыванию; номеров, самая первая версия находится внизу списка;
• Автор изменений - пользователь, который редактировал объект;
• Дата - дата и время редактирования;
• Комментарий - в этом поле можно ввести подробную информацию по поводу конкретной версии. Программа автоматически заполняет это поле, например, при переходе на другую версию.

С помощью отбора Изменения в реквизитах можно отражать изменения только определенных реквизитов. Для этого в форме отбора необходимо отметить флагами реквизиты, изменения по которым необходимо отражать в списке версий, и нажать на кнопку Выбрать.

Используя соответствующие кнопки, в форме списка доступны следующие действия:

• Открыть версию - просмотр отчета о состоянии объекта на интересующий момент времени;
• Сравнить версии - просмотр отчета по изменению состояния двух или более предварительно выделенных версий в списке (отчет покажет, какие именно реквизиты отличаются);
• Перейти на версию - возврат к одной из предыдущих версий объекта, которую необходимо предварительно выделить (изменения, внесенные после сохранения этой версии, будут отменены).

Обращаем ваше внимание, что при удалении объекта его история также удаляется, поэтому в этой ситуации версионирование не поможет.

Настройки хранения версий

Для ведения истории изменений объектов необходимо выбрать команду Поддержка и обслуживание из раздела Администрирование и удостовериться в том, что флаг Версионирование объектов включен (рис. 3).

Рис. 3. Механизм версионирования объектов в составе раздела Администрирование .

Рис. 4. Настройки версионирования объектов.

В форме Версионирование объектов выводится список из следующих реквизитов:

• Объект - список объектов программы в виде дерева с группировкой по типам объектов;
• Вариант версионирования - выбранный вариант версионирования;
• Срок хранения версий - выбранный срок хранения версий.

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

• Не версионировать - история версий объекта не ведется;
• Версионировать при записи - новая запись заносится в историю версий каждый раз при изменении (или создании нового) справочника или документа;
• - вариант применим только для документов, для которых разрешено проведение. Первая версия документа будет записана в историю только после первого проведения документа, впоследствии версии документа будут записываться при каждой записи проведенного документа. Эта настройка не позволяет создавать версии новых не заполненных окончательно документов, которые приводят к увеличению объема хранимой в программе информации;
• Версионировать при старте - этот вариант применим только для бизнес-процессов. Первая версия бизнес-процесса будет записана только после его старта. Режим позволяет не создавать лишние версии бизнес-процессов в то время, пока их подготавливают к запуску;
• По умолчанию - установить рекомендуемые настройки (для справочников - Не версионировать , для документов - Версионировать при проведении ).

Настройка версионирования возможна сразу для группы объектов программы, например, можно выбрать все документы или все справочники.

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

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

• За последнюю неделю;
• За последний месяц;
• За последние три месяца;
• За последние шесть месяцев;
• За последний год;
• Бессрочно.

Команды Установить вариант версионирования и Установить срок хранения версий также можно найти в меню Еще или в контекстном меню, вызываемом правой кнопкой мыши.

В поле Всего устаревших версий выдается информация о количестве и объеме устаревших версий в программе. Чтобы удалить устаревшие версии, необходимо нажать кнопку Очистить.

Для того, чтобы устаревшие версии удалялись автоматически, необходимо включить соответствующий флаг и перейти по гиперссылке Настроить расписание (рис. 5). Настроенное расписание будет выводиться в нижней части окна.

Рис. 5. Настройка регламентного задания по удалению устаревших версий.

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

В типовых конфигурациях 1С:Предприятие 8.3 появилась новая возможность - Версионирование объектов , которая во-первых, позволяет просмотреть все изменения, сделанные по выбранному объекту информационной базы (документ или справочник) и во-вторых, позволяет вернуться к любой из предыдущих версий данного объекта. Для этого система при изменении объектов записывает изменения не только в самом объекте, но и создает отдельную сущность - версия объекта информационной базы. В каждой версии есть информация кто ее создал и когда. Сравнив версию с предыдущей, получим перечень сделанных в версии изменений

Прежде всего необходимо включить в программе данную опцию и сделать нужные настройки:

В открывшемся списке устанавливаем признак использования опции и заходим в настройки хранения :

В открывшемся списке необходимо выбрать список объектов, которые мы хотим версионировать (т.е. записывать все варианты этих объектов при их изменении). Для примера установим версионирование справочника Номенклатура и документа Поступление товаров и услуг .

Для справочников новая версия документа сохраняется в момент записи элемента справочника, а вот для документов появляется возможность сохранения новых версий только при проведении:

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

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

Помимо номенклатуры, выберем версионирование документов поступления:

Теперь откроем любой элемент справочника Номенклатура и произвольно изменим реквизиты, к примеру Артикул, ставку НДС и комментарий:

в результате появились изменения:

Теперь открываем кнопку просмотра версий в верхней командной панели:

В открывшемся списке видим список всех сохраненных версий объекта. Любую версию можем открыть для просмотра, сравнить выборочно между собой или перейти на любую сохраненную версию (допустим если последние изменения справочника/документа не нужны).

Зажав клавищу Ctrl , выделим две версии справочника и нажмем Сравнить версии :

Сформировался отчет по изменениям версий, в котором можно увидеть все произведененные в справочнике изменения:

При необходимости можем точечно выбрать реквизиты для сравнения, отчет будет сравнивать только эти реквизиты в двух версиях:

Теперь проведем аналогичные манипуляции с документом поступления.

Для примера изменим сумму в табличной части и заполним номер и дату первичного документа

Нажав на кнопку просмотра версий, откроется соответствующее окно:

Здесь все также как и для справочников: можно посмотреть конкретную версию, сравнить две версии между собой или вернуть документ к какой-либо сохраненной версии. Выделим две строчки списка и нажмем Сравнить версии :

В других типовых конфигурациях 1С:Предприятие 8.3 настройка версионирования происходит аналогично.

Версионирование – это механизм, позволяющий быстро ответить на вопрос какой пользователь и какие изменения внес в конкретный документ, т.е. версионирование хранит историю изменений объектов информационной базы. Подобным функционалом обладает и «Журнал регистрации», но он только показывает когда пользователь начал и закончил работу с информационной базой, дату создания документа, редактирования, проведения. При возникновении же спорных моментов и если с объектом работали несколько пользователей по журналу регистрации невозможно выяснить, кто именно неверно заполнил, например, цену номенклатуры.

На данный момент механизм версионирования реализован в основных прикладных решениях:

1С:Бухгалтерия предприятия ред. 3.0

1С:Управление торговлей ред. 11.2

1С:Управление небольшой фирмой ред. 1.6

1С:Зарплата и управление персоналом 3.0

Внимание! Настройку версионирования выполняет Администратор системы с полными правами.

Настройка версионирования производится в разделе «Администрирование»-«Поддержка и обслуживание»

После включения механизма появится возможность настройки хранения версий объектов.

Для каждого вида документоа и справочник можно выбрать вариант версионирования:

• Не версионировать -изначально устанавливается всем объектам по умолчанию
• Версионировать при записи - возможно использование со справочниками и документами. Новая версия будет создаваться при нажатии на кнопку «Записать».
• Версионировать при проведении - возможно использование только для документов. Соответственно, версия будет создаваться при проведении документа.

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

После активации данного механизма в формах выбранных объектов появляется значок «Перейти к отчету по версиям объекта».

В нашем примере мы видим, что номенклатура «Папка-конверт на кнопке А» имеет 4 версии, те после создания объект был изменен 3 раза.

Для того, чтобы понять, что менялось от версии к версии мы можем выделить несколько версий и открыть отчет о сравнении нажатием кнопки «Сравнить версии».

В приведенном примере мы видим, что в версии 2 номенклатуре присвоено новое полное наименование, в версии 3 добавлена статья затрат и в версии 4 она изменена с «Доставки» на «Услуги аренды».

Причем в любой момент вы можете вернуться к выбранной версии объекта по нажатию на кнопку «Перейти на версию». Информация о данном действии также отразится в перечне версий объекта.

Ключевые слова: Регистрация, история, изменение.

Эта статья является описанием озвученного в третьего алгоритма.

Речь о том, чтобы хранить в базе историю изменения реквизитов объектов.

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

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

Общая идею проста, как четыре рубля одной монетой.
А вот при ближайшем рассмотрении выяснилось пара нюансов.
А при превращении мыслей в статью и вовсе все поменялось.

Начнем по-порядку.

Для начала, делаем периодический регистр сведений "История реквизитов" без привязки к регистратору.

Затем, очень хочется иметь в этом регистре сведений измерение "Объект" типа "Любая ссылка", но этого делать нельзя.
Причина та, что тогда мы теряем возможность удалять помеченные на удаление объекты, поскольку на них будут ссылки в регистре.
Если же это измерение делать ведущим, то при удалении мы потеряем всю историю по этому объекту, которая удалится вместе с самим объектом.
А с другой стороны и без этого реквизита совсем уж никуда, ни отчета сформировать, ни просто даже объект найти.
Поэтому, в каждый объект, для которого требуется регистрация изменений реквизитов, добавляем реквизит "GUID" типа "Строка (32)".
Кроме того, в регистр сведений "История реквизитов" добавляем измерение "GUID объекта" типа "Строка (32)".

Так я хотел написать сначала.

А потом хорошо подумал.

Во-первых, очень плохо делать разные соединения с таблицами объектов в запросах, чтобы получить нужный объект по реквизиту "GUID".

Во-вторых, журнал регистрации фирмой 1С реализован таким образом, что в нем в реквизите "Данные" хранится именно ссылка на объект, а никакой не GUID.
Просто при удалении объектов журнал регистрации не участвует в проверке ссылочной целостности и после удаления объекта в нем в реквизите "Данные" показывается знакомая многим надпись "<Объект не найден> ...".

В-третьих, GUID вместо ссылок придется тогда вставлять и в остальных полях, то есть в пользователе, старом значении и новом значении.

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

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

Поэтому добавляем измерение "Объект" типа "Любая ссылка".
Вместо типа "Любая ссылка" можно проставить галочки у конкретных объектов, без разницы.

Продолжаем.

Помимо объекта нужно иметь информацию о реквизите, который меняется.
Поэтому добавляем измерение "Реквизит" типа "Строка (25)" или "Справочник.РеквизитыОбъектов", кому как больше нравится.
Я для примера сделал строкой.

Затем добавляем информацию о пользователе, сделавшем изменения.
Для этого добавляем ресурс "Пользователь" типа "Справочник.Пользователи".
Кроме того, добавляем ресурс "Имя компьютера" типа "Строка (25)".
Кому 25 символов мало, может изменить на нужное количество.

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

И, наконец, добаляем два ресурса, "СтароеЗначение" и "НовоеЗначение" составного типа.
В составе типов "Число", "Строка", "Булево", "Дата" и "Любая ссылка".
Размерность типов "Число" и "Строка" проставляется максимальная из возможных, чтобы в нее уместилось содержимое любого реквизита.
Здесь есть досадный момент, в состав типов нельзя включить строку неограниченной длины.
Поэтому механизм нельзя будет применять для строк неограниченной длины, содержимое которых длиннее максимального размера строки в составе нашего типа.

Теперь по поводу настроек в объектах.
Во всех объектах, для которых будет регистрироваться история, требуется прописать следующий код.
Переменная "НаборЗаписейИсторияОбъектов" вынесена в переменные модуля по той причине, что для нового объекта проверку реквизитов нужно делать в процедуре "ПередЗаписью", а заполнять реквизит "Объект" значением "Ссылка" в процедуре "ПриЗаписи", поскольку в процедуре "ПередЗаписью" еще нет ссылки для нового объекта.
Перем НаборЗаписейИсторияОбъектов; Процедура ПередЗаписью(Отказ) НаборЗаписейИсторияОбъектов = РегистрыСведений.ИсторияОбъектов.СоздатьНаборЗаписей(); ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Код "); ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Наименование "); ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Родитель "); ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, "Владелец "); Для А = 0 По ЭтотОбъект.Метаданные().Реквизиты.Количество() - 1 Цикл ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, ЭтотОбъект.Метаданные().Реквизиты[А].Имя); КонецЦикла; КонецПроцедуры Процедура ПриЗаписи(Отказ) Если НаборЗаписейИсторияОбъектов.Количество() <> 0 Тогда Для Каждого Запись Из НаборЗаписейИсторияОбъектов Цикл Запись.Объект = Ссылка; КонецЦикла; НаборЗаписейИсторияОбъектов.Записать(Ложь); КонецЕсли; КонецПроцедуры Процедура ОбработатьИзменениеРеквизита(НаборЗаписейИсторияОбъектов, ИмяРеквизита) Если ЭтотОбъект[ИмяРеквизита] <> Ссылка[ИмяРеквизита] Тогда НоваяЗапись = НаборЗаписейИсторияОбъектов.Добавить(); НоваяЗапись.Период = ТекущаяДата(); НоваяЗапись.Реквизит = ИмяРеквизита; НоваяЗапись.ИмяКомпьютера = ИмяКомпьютера(); НоваяЗапись.Пользователь = ПараметрыСеанса.ТекущийПользователь; НоваяЗапись.РаспределеннаяБаза = ПараметрыСеанса.ТекущаяРаспределеннаяБаза; НоваяЗапись.СтароеЗначение = Ссылка[ИмяРеквизита]; НоваяЗапись.НовоеЗначение = ЭтотОбъект[ИмяРеквизита]; КонецЕсли; КонецПроцедуры

Пример приведен для иерархического подчиненного справочника.
Если брать другой объект, например, документ, то состав служебных реквизитов будет другой, не "Код", "Наименование", "Родитель" и "Владелец", а "Дата" и "Номер".

В следующих статьях будут рассмотрены примеры использования механизма, описанного в данной статье.

Замаялся.

От Гения 1С : Смотрите