Записать сообщение в журнал регистрации
Обновлено: 18.05.2024
Это пример формирования записи в журнале регистрации, которая появляется при формировании записи в регистре сведений ЗначениеСуммовыхПоказателейМероприятияПоГодам:
ЗаписьЖурналаРегистрации("Создание записи в регистре сведений",
УровеньЖурналаРегистрации.Информация,
Метаданные.РегистрыСведений.ЗначениеСуммовыхПоказателейМероприятияПоГодам,
Регистратор,
"Запись журнала сформирована программно",
РежимТранзакцииЗаписиЖурналаРегистрации.Транзакционная);
А вот что нам говорит синтакс-помощник:
Тип: Строка. Событие указывается строкой. Может содержать точки для обозначение иерархии событий.
Запрещена запись событий использующих сочетания символов "_$" и "$_", зарезервированные для системных событий. Например: _$МоеСобытие$_ или _$МояГруппаСобытий$_.МоеСобытие.
Тип: УровеньЖурналаРегистрации. Уровень важности события.
Значение по умолчанию: Примечание
Тип: Произвольный. Данные, с которыми связано событие.
Рекомендуется указывать ссылки на объекты данных (элементы справочников, документы, к которым относится событие).
Тип: Строка. Произвольная строка комментария к событию.
Значение по умолчанию: Пустая строка
Тип: РежимТранзакцииЗаписиЖурналаРегистрации. Указывает отношение записи к текущей транзакции.
Значение по умолчанию: Независимая
Записывает событие в журнал регистрации.
Предназначен для записи дополнительных событий, которые не записываются системой.
Средствами встроенного языка не могут записываться системные события, записываемые при записи объектов, удалении и т.д.
1С 8.3 Программно добавить запись в журнал регистрации
&НаСервере
Процедура ДобавитьЗаписьВЖурналРегистрации ()
//Индексы хранятся в каталоге 1Cv8Log в файлах с расширением .lgx
ЗаписьЖурналаРегистрации ( "Обновление1С" , УровеньЖурналаРегистрации . Информация .
"Выполнено" , РежимТранзакцииЗаписиЖурналаРегистрации . Транзакционная );
//ЗаписьЖурналаРегистрации( , , , , , )
//Обработчик.
&НаСервере
Процедура ДобавитьЗаписьВЖурналРегистрацииЧерезСтруктуру ()
СписокЗаписейЖурнала = Новый СписокЗначений ();
ЗаписьЖурналаНачало = Новый Структура ( "ИмяСобытия, ПредставлениеУровня, Комментарий,ДатаСобытия" );
ЗаписьЖурналаНачало . ИмяСобытия = "НачалоОбновления1С" ;
ЗаписьЖурналаНачало . ПредставлениеУровня = "Информация" ; //"Предупреждение", "Ошибка", "Предупреждение", "Примечание".
ЗаписьЖурналаНачало . Комментарий = "Начато обновление конфигурации до версии 3.7.41" ;
ЗаписьЖурналаНачало . ДатаСобытия = ТекущаяДата ();
СписокЗаписейЖурнала . Добавить ( ЗаписьЖурналаНачало );
//. здесь по аналогии журналируем поэтапно сам процесс
ЗаписьЖурналаКонец = Новый Структура ( "ИмяСобытия, ПредставлениеУровня, Комментарий,ДатаСобытия" );
ЗаписьЖурналаКонец . ИмяСобытия = "ОкончаниеОбновления1С" ;
ЗаписьЖурналаКонец . ПредставлениеУровня = "Информация" ; //"Предупреждение", "Ошибка", "Предупреждение", "Примечание".
ЗаписьЖурналаКонец . Комментарий = "Завершено обновление конфигурации до версии 3.7.41" ;
ЗаписьЖурналаКонец . ДатаСобытия = ТекущаяДата ();
СписокЗаписейЖурнала . Добавить ( ЗаписьЖурналаКонец );
ЖурналРегистрации . ЗаписатьСобытияВЖурналРегистрации ( СписокЗаписейЖурнала );
В данной статье я предлагаю рассмотреть практические примеры возможностей актуальной библиотеки стандартных подсистем (БСП) в области функционала работы с "Журналом регистрации конфигурации". На момент написания статьи - я использую БСП версии 3.1.5.208. Все практические примеры статьи были реализованы на указанной версии БСП, использую платформу 1с 8.3.19.1264.
Публикация будет полезна всем разработчикам- программистам и администраторам баз данных, ну а так же любым пользователям, желающим познакомиться с основным функционалом журнал регистрации и методами записи и получения информации из него в типовых современных конфигурациях (работающих на БСП).
Примеры статьи актуальны для серверных и файловых баз.
Материал статьи я разделил на две части - в первой части описаны методы записи в журнал, а во второй - получение данных из журнала посредством методов библиотеки стандартных подсистем.
Итак, перейдем к первой части - методам записи в журнал регистрации:
Часть 1. Методы записи в журнал регистрации.
Самый простой метод регистрации в журнале возможен при выполнении такой процедуры
код исполнения выглядит вот так:
Результат исполнения процедуры записи выглядит вот так:
Рассмотрим еще один способ пакетной записи в журнал регистрации через структуру с помощью процедуры ЗаписатьСобытияВЖурналРегистрации(СобытияДляЖурналаРегистрации) Экспорт.
код исполнения выглядит вот так:
Убедимся, что работает. Результат исполнения данной процедуры аналогичен предыдущей - запись появилась.
Рис.2. Данная запись создана процедурой ЗаписатьСобытияВЖурналРегистрации.
С методами записи в журнал считаю, что достаточно. Предлагаю перейти ко второй части статью - методам получения информации из журнала регистрации.
Часть 2. Методы получения информации из журнала регистрации.
Для начала рассмотрим самый простой способ получения информации по отбору в форме самого журнала. Для этого воспользуемся процедурой ОткрытьЖурналРегистрации(Знач Отбор = Неопределено, Владелец = Неопределено) Экспорт
Код с отбором выглядит вот так:
Результат выполнения кода вот такой:
Рис.3. Программное открытие формы журнала регистрации с заданным отбором.
Здесь все просто - программно открывается форма журнала и мы видим все события по заданному отбору. Далее, давайте рассмотрим более сложный метод получения информации из технологического журнала - в структуру.
Для этого воспользуемся стандартной процедурой БСП ПрочитатьСобытияЖурналаРегистрации, которая вернет нам структуру записей журнала. Да-Да, именно вернет.
Данная типовая процедура помещает результат выполнения (в данном случае - это структура записей журнала регистрации) в хранилище. Код этой типовой процедуры выглядит вот так:
Чтобы получить результат, воспользуемся возможностями БСП - ДлительныеОперации. Общий код получения выглядит вот так:
Результат, который мы получим (вернули структуру с записями журнала):
Рис.4. Структура записей событий журнала.
В данной части мы рассмотрели два способа получения информации из журнала регистрации - по форме отбора и через структуру по средству функционала ДлительнойОперации. Теперь, перейдем заключению и выводам.
Заключение и выводы
В данной статье я рассмотрел основные возможности методов работы библиотеки стандартных подсистем с журналом регистрации в конфигурации. Примеры методов вы можете использовать в любой стандартной конфигурации 1С, основой которой является БСП.
Так же в статье затронута еще одна подсистема конфигурации - ДлительныеОперации. О ДлительныхОперациях вы можете прочитать мои статьи. Список полезных статей приведен в конце статьи.
Все эксперименты для написания этой статьи проводились на платформе 1С - 8.3.19.1264 и "чистой конфигурации" БСП 3.1.5.208.
Спасибо за прочтение данного материала. Если статья вам понравилась - прошу поддержать ее.
Другие мои материалы по подсистемам БСП
Также прошу ознакомиться с другими моими статьями по функционалу библиотеки стандартных подсистем и типовым конфигурациям по разделам:
Если с программой 1С работает большое число людей, то периодически приходится отслеживать операции, совершенные сотрудниками. Благо вышеуказанная утилита позволяет выполнять подобные операции. Ведь ее разработчики создали особый инструмент, который записывает изменения, появляющиеся при редактировании документов. Он называется журнал регистрации. Что дает возможность посмотреть, кем делались правки, какие недочеты исправлены.
Где находится журнал регистрации ошибок в 1С?
Как открыть журнал регистраций в 1С?
Чтобы отслеживать действия сотрудников недостаточно найти вышеупомянутый журнал, его нужно открыть. Сделать подобное несложно, но иногда он оказывается внушительных размеров. Из-за чего 1С показывает не все записи, а несколько последних. Понятно, что при таком подходе ничего проверить не удастся. Поэтому данную проблему следует незамедлительно устранить, выставив правильные фильтры.
Кстати, сверху устанавливается интервал (период), за который необходимо просмотреть информацию. Слева отмечаются события, имеющие особую важность (представляющие повышенный интерес). А справа можно выбрать следующие данные:
• Список событий;
• Перечень пользователей;
• Приложения;
• Компьютеры;
• Завершенные сеансы.
Как выключить журнал регистраций?
Ведение журнала требует много системных ресурсов. Поэтому некоторые организации стараются его отключить. Конечно, это не совсем верное решение. Поскольку тогда невозможно отслеживать правки, ошибки, сбои. Но если сервер не обладает достаточной мощностью, приходится поступать именно так. Благо выключить опцию несложно.
Как выгрузить журнал регистраций
Данная функция будет полезна в тех случаях, когда сервер недостаточно мощный. Поскольку она меньше нагружает компьютер. Именно поэтому администраторы некоторых организаций предпочитают работать в таком формате. Ведь чтобы выполнить выгрузку журнала необходимо сформировать отчет и нажать соответствующую кнопку в интерфейсе 1С.
Также проверять полученные данные можно при помощи специальной консоли. Обычно она находится на установочном диске. Если у администратора нет доступа к нему, разумно воспользоваться интернетом, посетив официальный сайт разработчика программы.
Как восстановить журнал регистраций
Если оборудование, программное обеспечение или сам журнал работает некорректно, приходится выполнять восстановление данных. В большинстве случае помогает простой перенос содержимого папки 1Cv8Log в другой каталог ИБ. Иначе нужно обращаться к логам и искать причину возникших проблем.
Как правило, они образуются после неквалифицированного вмешательства в работу 1С, попыток оптимизировать размер журнала, неправильных настроек. Поэтому желательно регулярно делать копию ИБ, да и все восстановительные мероприятия должен проводить опытный специалист.
Как сократить журнал регистраций?
Даже располагая мощным сервером и запасом места на диске, необходимо оптимизировать объем журнала. Иначе уже через пару лет он разрастется до внушительных размеров. Но делать это нужно аккуратно и через конфигуратор.
Затем необходимо выполнить приведенную ниже инструкцию:
Как выполнить очистку журнала регистраций?
Опытные пользователи могут открыть папку 1Cv8Log, найти нужные файлы, удалить их вручную. Однако тут надо быть аккуратным. Иначе нарушится работа 1С. Поэтому перед очисткой рекомендуется выполнить архивирование журнала.
Как добавить программно запись в журнал?
После ввода определенных комбинаций, программа начнет записывать десятки фоновых задач, работу коллег, собственные ошибки (сбои). Поэтому администратору больше не придется неотрывно сидеть за монитором. Достаточно периодически проверять журнал регистрации.
Как вернуть старый формат журнала регистраций?
Необходимость возврата к старой версии журнала может появиться, если сервер слабый. Ведь пользователи со временем обязательно начнут замечать, что обновленная программа 1С работает медленнее. А все из-за наличия файла lgd в каталоге 1Cv8Log, но огорчаться не стоит.
Вернуть старый формат не проблема. Достаточно выполнить следующие действия:
1. Отыскать, открыть 1Cv8Log;
2. Удалить скопившиеся файлы;
3. Создать файл типа 1Cv8.lgf.
Кстати, вышеупомянутую инструкцию необходимо проделывать для каждой имеющейся базы отдельно.
Как перенести журнал регистраций в отдельную базу?
Такая необходимость возникает, например, при переносе информационной базы с одного компьютера на другой. Если вместе с ней не переместить журнал регистраций, то в дальнейшем записанные данные будет невозможно проверить. Придется полностью очищать журнал. А это означает, что сведения удалятся безвозвратно.
Конечно, перенос 1Cv9Log тоже имеет нюансы. Например, при файловом варианте достаточно скопировать вышеуказанный объект и добавить его в соответствующую директорию на новом сервере. Это самый простой способ.
В случае если используется клиент-серверная база, придется немного повозиться. Сначала необходимо отыскать на сервере 1Cv8Reg, затем открыть этот файл. В нем следует вписать правильный идентификатор ИБ (с указанием ID), сохранить изменения. Только после выполнения данных действий папку 1Cv8Log можно перетаскивать в новую директорию.
Хотя если сделать что-то не получается, лучше обратиться к специалистам 1С, заказав соответствующую услугу. Это позволит оперативно устранить неисправность, сбой, проблему. А также сэкономит нервы и деньги. Ведь доработка 1С стоит недорого.
Хотите получать подобные статьи по четвергам?
Быть в курсе изменений в законодательстве?
Подпишитесь на рассылку
Читайте также: