Позиция / Position

Доступ: только чтение.

Тип: Число.

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

Дата / Date

Доступ: только чтение.

Тип: Дата.

Описание: Дата записи журнала регистрации.

Время / Time

Доступ: только чтение.

Тип: Строка в формате "ЧЧ:ММ:СС".

Описание: Время записи журнала регистрации.

Пользователь / User

Доступ: только чтение.

Тип: Строка или пустое значение.

Описание: Пользователь, вызвавший определенное событие.

Режим / Mode

Доступ: только чтение.

Тип: Строка "E", "C", "M", или "D".

Описание: Режим работы 1С: Предприятия, в котором произошло определенное событие.

ТипСобытия / EventType

Доступ: только чтение.

Тип: Строка или ТипСобытияЖурналаРегистрации.

Описание: Тип события. Тип значения этого свойства зависит от того, присутствует данный тип события в коллекции типов событий поставщика данных (см. свойство ТипыСобытий).

Событие / Event

Доступ: только чтение.

Тип: Строка или СобытиеЖурналаРегистрации.

Описание: Событие. Тип значения этого свойства зависит от того, присутствует данное событие в коллекции событий (см. свойство События) одного из типов событий поставщика данных (см. свойство ТипыСобытий).

Категория / Category

Доступ: только чтение.

Тип: Число 0, 1, 2, 3, 4 или 5.

Описание: Категория события: 0 - сеанс, 1 - административное, 2 - изменение данных, 3 - информация, 4 - предупреждение, 5 - ошибка.

Комментарий / Comment

Доступ: только чтение.

Тип: Строка или пустое значение.

Описание: Комментарий к событию.

Объект / Object

Доступ: только чтение.

Тип: Агрегатный или пустое значение.

Описание: Объект.

ПредставлениеОбъекта / ObjectPresent

Доступ: только чтение.

Тип: Строка или пустое значение.

Описание: Представление объекта.

НачалоПериода / BeginOfPeriod

Доступ: только чтение.

Тип: Дата.

Описание: Дата начала периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.

ВремяНачалаПериода / PeriodBeginingTime

Доступ: только чтение.

Тип: Строка в формате "ЧЧ:ММ:СС".

Описание: Время начала периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.

КонецПериода / EndOfPeriod

Доступ: только чтение.

Тип: Дата.

Описание: Дата конца периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.

ВремяОкончанияПериода / PeriodEndingTime

Доступ: только чтение.

Тип: Строка в формате "ЧЧ:ММ:СС".

Описание: Время окончания периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.

ГлубинаПросмотра / ScanDeep

Доступ: только чтение.

Тип: Неотрицательное число.

Описание: Количество попыток поиска строки, удовлетворяющей отбору.

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

Примечание: По умолчанию равно 0.

ПоследняяПросмотреннаяДата / LastScanDate

Доступ: только чтение.

Тип: Дата.

Описание: Дата последней записи журнала регистрации, после которой поиск строк был прекращен.

Поиск мог быть прекращен из-за ограничения, наложенного свойством ГлубинаПросмотра, или при нажатии клавиши <ESC>. Имеет смысл только при установленном отборе.

ИспользованиеБуфера / UsingBuffer

Доступ: только чтение.

Тип: Число 0 или 1.

Описание: Определяет, используется или нет буфер при отборе записей.

ИмяФайла / FileName

Доступ: чтение и запись.

Тип: строка.

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

Примечание: По умолчанию используется журнал регистрации текущей информационной базы. В случае использования провайдера в качестве поставщика данных табличного поля|_1cpp_table_field_ при изменении данного свойства табличное поле сразу начинает отображать указанный журнал регистрации. Если провайдер используется как самостоятельный объект, то для доступа к указанному файлу журнала регистрации необходимо закрыть ранее используемый файл методом ЗакрытьФайл и открыть новый файл методом ОткрытьФайл. Если используется журнал регистрации не текущей информационной базы, то свойство Объект неопределено.

ПросмотрАрхивов / ArchivesView

Доступ: чтение и запись.

Тип: Число 0 или 1.

Описание: Определяет, будет или нет осуществляться просмотр архивов при установке периода просмотра методами УстановитьПериод или УстановитьПериодРасш. Поиск архивов осуществляется в том же каталоге, где находится журнал регистрации. Архивы должны быть получены путем выполнения архивирования журнала регистрации из Монитора. Извлечение данных из архива зависит от того, установлен отбор с использованием буфера или нет. Если отбор с использованием буфера не установлен, то данные извлекаются по мере необходимости.

ТипыСобытий / EventTypes

Доступ: чтение.

Тип: ТипыСобытийЖурналаРегистрации.

Описание: Фиксированная коллекция типов событий в журнале регистрации. Содержит как системные типы событий, так и пользовательские, определенные в файле 1cv7evt.txt. Поиск данного файла осуществляется в том же каталоге, где находится журнал регистрации.

Отбор / Filter

Доступ: чтение.

Тип: Отбор.

Описание: Коллекция содержит элементы отбора, соответствующие установленному отбору методами ИзменитьФильтр и УстановитьФильтр.

УстановитьПериод / SetPeriod

Синтаксис: УстановитьПериод([ДатаНачала],[ДатаКонца])

Параметры:

• ДатаНачала - тип: Дата. Определяет дату начала периода, с которой будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то началом периода считается начало журнала;
• ДатаКонца - тип: Дата. Определяет дату конца периода, по которую будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то концом периода считается конец журнала журнала.

Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.

Описание: Устанавливает период просмотра записей журнала регистрации.

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

Если до изменения периода были установлен отбор с сохранением позиций отобранных записей в буфере (см. метод УстановитьФильтр), то в случае увеличения периода происходит дополнительный отбор записей. При его прерывании клавишей <ESC> формируется исключение.

УстановитьПериодРасш / SetPeriodEx

Синтаксис: УстановитьПериодРасш([ДатаНачала],[ВремяНачала],[ДатаКонца],[ВремяКонца])

Параметры:

• ДатаНачала - тип: Дата. Определяет дату начала периода, с которой будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то началом периода считается начало журнала;
• ВремяНачала - тип: Строка в формате "ЧЧ:ММ:СС". Определяет время начала периода, с которого будут отображаться записи журнала регистрации. Необязателен, по умолчанию "00:00:00".
• ДатаКонца - тип: Дата. Определяет дату конца периода, по которую будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то концом периода считается конец журнала журнала.
• ВремяКонца - тип: Строка в формате "ЧЧ:ММ:СС". Определяет время окончания периода, по которое будут отображаться записи журнала регистрации. Необязателен, по умолчанию "23:59:59".

Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.

Описание: Устанавливает период просмотра записей журнала регистрации.

Метод служит для тех же целей, что и метод УстановитьПериод.

УстановитьГлубину / SetScanDeep

Синтаксис: УстановитьГлубину([Глубина],[ОбновитьТП])

Параметры:

• Глубина - тип: Число. Количество попыток поиска строки, удовлетворяющей отбору. Необязателен, по умолчанию 0;
• ОбновитьТП - тип: Число 0 или 1. Необходимость начать поиск строк сразу после изменения глубины просмотра. Необязателен, по умолчанию 1.

Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.

Описание: Устанавливает количество попыток поиска строки, удовлетворяющей отбору.

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

ИзменитьФильтр / ChangeFilter

Синтаксис: ИзменитьФильтр([ВариантОтбора],[ЗначениеОтбора])

Параметры:

• ВариантОтбора - тип: Число согласно таблице Варианты отборов и возможные значения|_log_data_provider_filter_types_. При этом если число положительное, то данный вариант отбора устанавливается, если отрицательное, то сбрасывается. При значении параметра равным нулю отбор полностью сбрасывается. Необязателен, по умолчанию 0;
• ЗначениеОтбора - тип: пустое значение, строка, объект агрегатного типа или список значений из них. Значение устанавливаемого отбора в зависимости от первого параметра. Необязателен, по умолчанию пустое значение.

Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.

Описание: Добавляет или удаляет элемент отбора для просмотра записей журнала регистрации.

Все значения типа строка являются регистронезависимыми за исключением значений отбора по пользователю.

Типом объекта могут быть:

• Перечисление;
• Справочник;
• Документ;
• Календарь;
• Вид расчета;
• Счет;
• Вид субконто;
• План счетов.

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

ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(2, "ЕM"); // добавить фильтр по режиму "Предприятие" и "Монитор"
ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(22);      // добавить фильтр по событию "Документ записан"
ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(-62);     // удалить фильтр по событию "Изменена точка актуальности"
ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр();        // сбросить все фильтры

УстановитьФильтр / SetFilter

Синтаксис: УстановитьФильтр([ИспользоватьБуфер])

Параметры:

• ИспользоватьБуфер - тип: Число. 0 - буфер не используется (осуществляется динамический отбор), 1 - позиции отобранных записей сохраняются в буфере. Необязателен, по умолчанию 0.

Возвращает: тип: Число. 1 - изменения отбора корректны и начат отбор записей, 0 - в противном случае.

Описание: Проверяет на корректность изменения отбора методом ИзменитьФильтр и начинает отбор записей. Если используется буфер, то при прерывании отбора клавишей <ESC> формируется исключение. Если провайдер является поставщиком данных табличного поля, то выполнение процесса отбора в процентах отображается в строке состояния.

ОткрытьФайл / OpenFile

Синтаксис: ОткрытьФайл()

Возвращает: тип: Число. 1 - файл журнала регистрации открыт, 0 - в противном случае.

Описание: Открывает файл журнала регистрации для последующей выборки записей методом ВыбратьСтроки.

ЗакрытьФайл / CloseFile

Синтаксис: ЗакрытьФайл()

Описание: Закрывает открытый файл журнала регистрации.

ВыбратьСтроки / SelectLines

Синтаксис: ВыбратьСтроки([Смещение])

Параметры:

• Смещение - тип: Число. Определяет, с какого смещения в байтах от начала журнала регистрации производить выборку записей журнала регистрации. Необязателен, по умолчанию 0. Для выборки записей с начала временного файла параметр должен быть равен -1.

Возвращает: тип: Число. 1 - выборка начата, 0 - в противном случае.

Описание: Метод определяет, на какую запись указывает переданное смещение, и устанавливает выборку с этой записи.

ПолучитьСтроку / GetLine

Синтаксис: ПолучитьСтроку()

Возвращает: тип: Число. 1 - строка получена, 0 - в противном случае.

Описание: Выполняет позиционирование на очередную запись из выборки. Если перед получением строки установлен период и (или) отбор, то получение записи осуществляется с учетом периода и отбора. При прерывании данной операции клавишей <ESC> формируется исключение.

<ТипСобытия>

Доступ: только чтение.

Тип: ТипСобытияЖурналаРегистрации.

Описание: Набор свойств содержит идентификаторы типов событий журнала регистрации. Доступ к значению осуществляется по идентификатору типа события.

Количество / Count

Синтаксис: Количество()

Возвращает: тип: Число, количество типов событий.

Описание: Получить количество типов событий.

Получить / Get

Синтаксис: Получить(ТипСобытия)

Параметры:

• ТипСобытия - тип: Число, Строка. Индекс или идентификатор типа события.

Возвращает: тип: ТипСобытияЖурналаРегистрации.

Описание: Получить тип события журнала регистрации.

Индекс / IndexOf

Синтаксис: Индекс(ТипСобытия)

Параметры:

• ТипСобытия - тип: ТипСобытияЖурналаРегистрации. Тип события, индекс которого требуется получить.

Возвращает: тип: Число - индекс типа события, или -1, если тип события не принадлежит коллекции.

Описание: Получить индекс типа события.

Индекс / Index

Доступ: только чтение.

Тип: Число.

Описание: Значение данного свойства соответствует варианту отбора, используемому в методе ИзменитьФильтр (см. Варианты отборов и возможные значения|_log_data_provider_filter_types_).

Идентификатор / Identifier

Доступ: только чтение.

Тип: Строка.

Описание: Идентификатор типа события.

Описание / Description

Доступ: только чтение.

Тип: Строка.

Описание: Описание типа события.

Системный / IsSystem

Доступ: только чтение.

Тип: Число: 0 или 1.

Описание: Является данный тип события системным или пользовательским.

События / Events

Доступ: только чтение.

Тип: Фиксированная коллекция СобытияЖурналаРегистрации.

Описание: Содержит события, принадлежащие данному типу.

<Событие>

Доступ: только чтение.

Тип: СобытиеЖурналаРегистрации.

Описание: Набор свойств содержит идентификаторы событий журнала регистрации. Доступ к значению осуществляется по идентификатору события.

Количество / Count

Синтаксис: Количество()

Возвращает: тип: Число, количество событий.

Описание: Получить количество событий.

Получить / Get

Синтаксис: Получить(Событие)

Параметры:

• Событие - тип: Число, Строка. Индекс или идентификатор события.

Возвращает: тип: СобытиеЖурналаРегистрации.

Описание: Получить событие журнала регистрации.

Индекс / IndexOf

Синтаксис: Индекс(Событие)

Параметры:

• Событие - тип: СобытиеЖурналаРегистрации. Событие, индекс которого требуется получить.

Возвращает: тип: Число - индекс события, или -1, если событие не принадлежит коллекции.

Описание: Получить индекс события.

Индекс / Index

Доступ: только чтение.

Тип: Число.

Описание: Значение данного свойства соответствует варианту отбора, используемому в методе ИзменитьФильтр (см. Варианты отборов и возможные значения|_log_data_provider_filter_types_).

Идентификатор / Identifier

Доступ: только чтение.

Тип: Строка.

Описание: Идентификатор события.

Описание / Description

Доступ: только чтение.

Тип: Строка.

Описание: Описание события.

Системное / IsSystem

Доступ: только чтение.

Тип: Число: 0 или 1.

Описание: Является данное событие системным или пользовательским.

<ЭлементОтбора>

Доступ: только чтение.

Тип: ЭлементОтбора.

Описание: Набор свойств содержит элементы отбора. Доступ к значению осуществляется по имени элемента.

Количество / Count

Синтаксис: Количество()

Возвращает: тип: Число, количество элементов отбора.

Описание: Получить количество элементов отбора.

Получить / Get

Синтаксис: Получить(ЭлементОтбора)

Параметры:

• ЭлементОтбора - тип: Число, Строка. Индекс или имя элемента отбора.

Возвращает: тип: ЭлементОтбора.

Описание: Получить элемента отбора.

Индекс / IndexOf

Синтаксис: Индекс(ЭлементОтбора)

Параметры:

• ЭлементОтбора - тип: ЭлементОтбора. Элемент отбора, индекс которого требуется получить.

Возвращает: тип: Число - индекс элемента отбора, или -1, если элемент отбора не принадлежит коллекции.

Описание: Получить индекс элемента отбора.

Добавить / Add

Синтаксис: Добавить(Имя)

Параметры:

• Имя - тип: Строка. Имя добавляемого элемента отбора.

Возвращает: тип: ЭлементОтбора - созданный элемента отбора.

Описание: Добавляет новый элемент отбора в журнале регистрации, если элемента отбора с данным именем не существует, или возвращает существующий элемент отбора по имени.

Удалить / Remove

Синтаксис: Удалить(Индекс)

Параметры:

• Индекс - тип: Число. Индекс элемента отбора.

Описание: Удаляет элемент отбора в журнале регистрации.

Очистить / Clear

Синтаксис: Очистить()

Описание: Удаляет все элементы отбора в журнале регистрации.

Установить / Set

Синтаксис: Установить([ИспользоватьБуфер])

Параметры:

• ИспользоватьБуфер - тип: Число. 0 - буфер не используется (осуществляется динамический отбор), 1 - позиции отобранных записей сохраняются в буфере. Необязателен, по умолчанию 0.

Возвращает: тип: Число. 1 - изменения отбора корректны и начат отбор записей, 0 - в противном случае.

Описание: Выполняются действия аналогичные действиями при использовании метода УстановитьФильтр. Состав отбора определяется элементами коллекции.

Тип / Type

Доступ: только чтение.

Тип: Число.

Описание: Тип элемента отбора.

Типом элемента отбора могут быть:

• 0 - не определен;
• 3 - пользователь;
• 4 - режим;
• 5 - тип события;
• 6 - событие;
• 7 - категория;
• 8 - комментарий;
• 9 - объект;
• 10 - представление;
• 11 - вид объекта.

Значение / Value

Доступ: только чтение.

Тип: Зависит от типа отбора.

Описание: Значение элемента отбора.

Имя / Name

Доступ: только чтение.

Тип: Строка.

Описание: Имя элемента отбора. Может быть произвольным.

УстановитьТипИЗначение / SetTypeAndValue

Синтаксис: УстановитьТипИЗначение([ТипОтбора],[ЗначениеОтбора])

Параметры:

• ТипОтбора - тип: Число. См. описание свойства ТипОтбора. Необязателен, по умолчанию 0.
• ЗначениеОтбора - тип: зависит от типа отбора (см. Тип и значение элемента отбора|_log_data_provider_filter_items_) Необязателен, по умолчанию пустое значение.

Возвращает: тип: Число: 1 - тип и значение установлены, 0 - в противном случае.

Описание: Установить тип и значение для элемента отбора.