]>
![]() |
|
|
ПоставщикДанныхЖурналРегистрации / LogProvider.
Используется для доступа к журналу регистрации 1С и может использоваться в двух режимах:
- в качестве поставщика данных для табличного поля|_1cpp_table_field_;
- как самостоятельный объект для работы с журналом регистрации.
Свойство ТекущаяСтрока|_table_field_current_row_ табличного поля имеет тип число и определяет:
- при чтении смещение в байтах от начала файла до начала текущей записи журнала регистрации;
- при записи производится установка на запись, содержащую указанное смещение, если фильтры не установлены, или установка на первую запись со смещением большим указанного, удовлетворяющей фильтрам, если фильтры установлены.
Доступ: только чтение.
Тип: Число.
Описание: Смещение в байтах от начала файла до начала текущей записи журнала регистрации.
Доступ: только чтение.
Тип: Дата.
Описание: Дата записи журнала регистрации.
Доступ: только чтение.
Тип: Строка в формате "ЧЧ:ММ:СС".
Описание: Время записи журнала регистрации.
Доступ: только чтение.
Тип: Строка или пустое значение.
Описание: Пользователь, вызвавший определенное событие.
Доступ: только чтение.
Тип: Строка "E", "C", "M", или "D".
Описание: Режим работы 1С: Предприятия, в котором произошло определенное событие.
Доступ: только чтение.
Тип: Строка.
Описание: Тип события.
Доступ: только чтение.
Тип: Строка.
Описание: События.
Доступ: только чтение.
Тип: Число 0, 1, 2, 3, 4 или 5.
Описание: Категория события: 0 - сеанс, 1 - административное, 2 - изменение данных, 3 - информация, 4 - предупреждение, 5 - ошибка.
Доступ: только чтение.
Тип: Строка или пустое значение.
Описание: Комментарий к событию.
Доступ: только чтение.
Тип: Агрегатный или пустое значение.
Описание: Объект.
Доступ: только чтение.
Тип: Строка или пустое значение.
Описание: Представление объекта.
Доступ: только чтение.
Тип: Дата.
Описание: Дата начала периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.
Доступ: только чтение.
Тип: Строка в формате "ЧЧ:ММ:СС".
Описание: Время начала периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.
Доступ: только чтение.
Тип: Дата.
Описание: Дата конца периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.
Доступ: только чтение.
Тип: Строка в формате "ЧЧ:ММ:СС".
Описание: Время окончания периода при установленном периоде просмотра методами УстановитьПериод или УстановитьПериодРасш.
Доступ: только чтение.
Тип: Неотрицательное число.
Описание: Количество попыток поиска строки, удовлетворяющей фильтрам.
Имеет действие только при установленном фильтре. Если 0, то количество попыток ограничено только размеров файла журнала регистрации, т.е. будет анализироваться весь файл.
Примечание: По умолчанию равно 0.
Доступ: только чтение.
Тип: Дата.
Описание: Дата последней записи журнала регистрации, после которой поиск строк был прекращен.
Поиск мог быть прекращен из-за ограничения, наложенного свойством ГлубинаПросмотра, или при нажатии клавиши <ESC>. Имеет смысл только при установленном фильтре.
Доступ: только чтение.
Тип: Число 0 или 1.
Описание: Определяет, используется буфер или нет при фильтрации записей.
Доступ: чтение и запись.
Тип: строка.
Описание: Содержит полное имя файла журнала регистрации, который провайдер использует в качестве источника данных.
Примечание: По умолчанию используется журнал регистрации текущей информационной базы. В случае использования провайдера в качестве поставщика данных табличного поля|_1cpp_table_field_ при изменении данного свойства табличное поле сразу начинает отображать указанный журнал регистрации. Если провайдер используется как самостоятельный объект, то для доступа к указанному файлу журнала регистрации необходимо закрыть ранее используемый файл методом ЗакрытьФайл и открыть новый файл методом ОткрытьФайл. Если используется журнал регистрации не текущей информационной базы, то свойство Объект неопределено.
Синтаксис: УстановитьПериод([ДатаНачала],[ДатаКонца])
Параметры:
- ДатаНачала - тип: Дата. Определяет дату начала периода, с которой будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то началом периода считается начало журнала;
- ДатаКонца - тип: Дата. Определяет дату конца периода, по которую будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то концом периода считается конец журнала журнала.
Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.
Описание: Устанавливает период просмотра записей журнала регистрации.
Если оба параметра не указаны, то отображается весь журнал. Алгоритм поиска границ предполагает, что записи в журнале расположены в порядке возрастания дат. Если это условие не выполняется, то данный метод может работать некорректно.
Если до изменения периода были установлены фильтры с сохранением позиций отобранных записей в буфере (см. метод УстановитьФильтр), то в случае увеличения периода происходит дополнительная фильтрация записей. При ее прерывании клавишей <ESC> формируется исключение.
Синтаксис: УстановитьПериодРасш([ДатаНачала],[ВремяНачала],[ДатаКонца],[ВремяКонца])
Параметры:
- ДатаНачала - тип: Дата. Определяет дату начала периода, с которой будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то началом периода считается начало журнала;
- ВремяНачала - тип: Строка в формате "ЧЧ:ММ:СС". Определяет время начала периода, с которого будут отображаться записи журнала регистрации. Необязателен, по умолчанию "00:00:00".
- ДатаКонца - тип: Дата. Определяет дату конца периода, по которую будут отображаться записи журнала регистрации. Необязателен, по умолчанию пустая дата. Если не указан, то концом периода считается конец журнала журнала.
- ВремяКонца - тип: Строка в формате "ЧЧ:ММ:СС". Определяет время окончания периода, по которое будут отображаться записи журнала регистрации. Необязателен, по умолчанию "23:59:59".
Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.
Описание: Устанавливает период просмотра записей журнала регистрации.
Метод служит для тех же целей, что и метод УстановитьПериод.
Синтаксис: УстановитьГлубину([Глубина],[ОбновитьТП])
Параметры:
- Глубина - тип: Число. Количество попыток поиска строки, удовлетворяющей фильтрам. Необязателен, по умолчанию 0;
- ОбновитьТП - тип: Число 0 или 1. Необходимость начать поиск строк сразу после изменения глубины просмотра. Необязателен, по умолчанию 1.
Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.
Описание: Устанавливает количество попыток поиска строки, удовлетворяющей фильтрам.
Данный метод рекомендуется использовать совместно с установленными фильтрами в случае поиска заведомо редких событий.
Синтаксис: ИзменитьФильтр([ТипФильтра],[ЗначениеФильтра])
Параметры:
- ТипФильтра - тип: Число. Тип изменяемого фильтра (см. Типы фильтров и возможные значения|_log_data_provider_filter_types_). При этом если число положительное, то данный тип фильтра устанавливается, если отрицательное, то сбрасывается. При значении параметра равным нулю сбрасываются все фильтры. Необязателен, по умолчанию 0;
- ЗначениеФильтра - тип: пустое значение, строка, объект агрегатного типа или список значений из них. Значение устанавливаемого фильтра в зависимости от первого параметра. Необязателен, по умолчанию пустое значение.
Возвращает: тип: Число. 1 - вызов метода закончился успешно, 0 - в противном случае.
Описание: Добавляет или удаляет фильтр для просмотра записей журнала регистрации.
Все значения типа строка являются регистронезависимыми за исключением значений для фильтра по пользователю.
Типом объекта могут быть:
- Перечисление;
- Справочник;
- Документ;
- Календарь;
- Вид расчета;
- Счет;
- Вид субконто;
- План счетов.
Примеры использования метода:
ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(2, "ЕM"); // добавить фильтр по режиму "Предприятие" и "Монитор" ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(22); // добавить фильтр по событию "Документ записан" ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(-62); // удалить фильтр по событию "Изменена точка актуальности" ТабличноеПоле.ПоставщикДанных.ИзменитьФильтр(); // сбросить все фильтры
Тип фильтра | Фильтруемое поле записи журнала | Значение поля | Режим | Категория | Описание | Возможное значение фильтра | |
---|---|---|---|---|---|---|---|
Добавление | Удаление | ||||||
1 | Пользователь | ECMD | 012345 | Строка с идентификатором пользователя или список значений из них. Для указания пустого пользователя использовать строку "<>". | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | ||
2 | Режим | ECMD | 012345 | Строка из символов 'E', 'C', 'M', 'D'. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | ||
3 | Категория | ECMD | 012345 | Строка из символов '0', '1', '2', '3', '4', '5'. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | ||
4 | Тип события | Sys | ECMD | 0 | Сеанс | ||
5 | Событие | OpenSession | ECMD | 0 | Подключение | ||
6 | CloseSession | ECMD | 0 | Отключение | |||
7 | Тип события | Consts | E | 2 | Константы | ||
8 | Событие | ConstWrite | E | 2 | Значение константы изменено | ||
9 | ConstDel | E | 2 | Значение константы удалено | |||
10 | Тип события | Refs | E | 2 | Справочники | ||
11 | Событие | RefNew | E | 2 | Записан новый элемент справочника | ||
12 | RefWrite | E | 2 | Элемент справочника записан | |||
13 | RefUnmarkDel | E | 2 | С элемента справочника снята пометка на удаление | |||
14 | RefDel | E | 2 | Элемент справочника удален | |||
15 | RefMarkDel | E | 2 | Элемент справочника помечен на удаление | |||
16 | RefGrpMove | E | 2 | Элемент справочника перенесен в другую группу | |||
17 | RefAttrWrite | E | 2 | Значение реквизита справочника изменено | |||
18 | RefAttrDel | E | 2 | Значение реквизита справочника удалено | |||
19 | Тип события | Docs | E | 23 | Документы | ||
20 | Событие | DocNew | E | 3 | Документ создан | ||
21 | DocOpen | E | 3 | Документ открыт | |||
22 | DocWrite | E | 2 | Документ записан | |||
23 | DocWriteNew | E | 2 | Записан новый документ | |||
24 | DocNotWrite | E | 3 | Документ не записан | |||
25 | DocPassed | E | 2 | Документ проведен | |||
26 | DocBackPassed | E | 2 | Документ проведен задним числом | |||
27 | DocNotPassed | E | 2 | Документ не проведен | |||
28 | DocMakeNotPassed | E | 2 | Документ сделан непроведенным | |||
29 | DocWriteAndRepassed | E | 2 | Документ записан и проведен | |||
30 | DocWriteAndPostBfAP | E | 2 | Документ записан и проведен задним числом | |||
31 | DocTimeChanged | E | 2 | Изменено время документа | |||
32 | DocOperWrite | E | 2 | Операция документа изменена | |||
33 | DocOperOn | E | 2 | Проводки включены | |||
34 | DocOperOff | E | 2 | Проводки выключены | |||
35 | DocMarkDel | E | 2 | Документ помечен на удаление | |||
36 | DocUnmarkDel | E | 2 | Пометка на удаление документа снята | |||
37 | DocDel | E | 2 | Документ удален | |||
38 | Тип события | CJ | E | 2 | Журнал расчетов | ||
39 | Событие | CJPerChng | E | 2 | Изменен текущий расчетный период в журнале расчетов | ||
40 | CJPerBackChng | E | 2 | Откат назад текущего расчетного периода в журнале расчетов | |||
41 | CJPerNotChng | E | 2 | Неудачная попытка изменения текущего расчетного периода в журнале расчетов | |||
42 | CJUneditRec | E | 2 | Отмена ручного редактирования результата расчета в журнале расчетов | |||
43 | CJEditRec | E | 2 | Отредактирован результат расчета в журнале расчетов | |||
44 | Тип события | Accs | E | 23 | Счета | ||
45 | Событие | AccNew | E | 3 | Записан новый счет | ||
46 | AccWrite | E | 2 | Счет записан | |||
47 | AccDel | E | 2 | Счет удален | |||
48 | AccMarkDel | E | 2 | Счет помечен на удаление | |||
49 | AccUnmarkDel | E | 2 | Со счета снята пометка на удаление | |||
50 | AccAttrWrite | E | 2 | Значение реквизита счета записано | |||
51 | AccAttrDel | E | 2 | Значение реквизита счета удалено | |||
52 | Тип события | CorrProvs | E | 2 | Корректные проводки | ||
53 | Событие | CorrProvNew | E | 2 | Записана новая корректная проводка | ||
54 | CorrProvEdit | E | 2 | Корректная проводка изменена | |||
55 | CorrProvDel | E | 2 | Корректная проводка удалена | |||
56 | Тип события | TmplOpers | E | 2 | Типовые операции | ||
57 | Событие | TmplOperNew | E | 2 | Записана новая типовая операция | ||
58 | TmplOperWrite | E | 2 | Типовая операция записана | |||
59 | TmplOperDel | E | 2 | Типовая операция удалена | |||
60 | TmplOperGrpMove | E | 2 | Типовая операция перенесена в другую группу | |||
61 | Тип события | Grbgs | EM | 125 | Общие события | ||
62 | Событие | GrbgTAChng | E | 2 | Изменена точка актуальности | ||
63 | GrbgSnapChng | E | 2 | Изменен период сохранения итогов | |||
64 | GrbgRclcDocs | E | 2 | Групповое проведение документов | |||
65 | GrbgNewPerBuhTot | E | 2 | Бухгалтерские итоги рассчитаны | |||
66 | GrbgRclcAllBuhTot | E | 2 | Полный пересчет бухгалтерских итогов | |||
67 | GrbgLogArch | M | 1 | Архивирование журнала регистрации | |||
68 | GrbgSyntaxErr | E | 5 | Синтаксическая ошибка | |||
69 | GrbgRuntimeErr | E | 5 | Ошибка времени выполнения | |||
70 | Тип события | Restruct | C | 1345 | Конфигурация | ||
71 | Событие | RestructSaveMD | C | 3 | Запись измененной конфигурации | ||
72 | RestructStart | C | 1 | Начало реструктуризации | |||
73 | RestructCopy | C | 1 | Начало копирования результатов реструктуризации | |||
74 | RestructAcptEnd | C | 1 | Реструктуризация завершена | |||
75 | RestructStatus | C | 3 | Статус реструктуризации | |||
76 | RestructAnalys | C | 3 | Анализ информации | |||
77 | RestructWarn | C | 4 | Предупреждение | |||
78 | RestructErr | C | 5 | Ошибка при реструктуризации | |||
79 | RestructCritErr | C | 5 | Критическая ошибка при реструктуризации | |||
80 | Тип события | Distr | C | 15 | Распределенная ИБ | ||
81 | Событие | DistBatchErr | C | 5 | Ошибка автообмена в пакетном режиме | ||
82 | DistDnldBeg | C | 1 | Начата выгрузка изменений данных | |||
83 | DistDnldSuc | C | 1 | Выгрузка изменений данных успешно завершена | |||
84 | DistDnldFail | C | 1 | Выгрузка изменений данных не выполнена | |||
85 | DistDnlErr | C | 5 | Ошибка выгрузки изменений данных | |||
86 | DistDnlStatus | C | 1 | Выгрузка изменений данных | |||
87 | DistUplBeg | C | 1 | Начата загрузка изменений данных | |||
88 | DistUplSuc | C | 1 | Загрузка изменений данных успешно завершена | |||
89 | DistUplFail | C | 1 | Загрузка изменений данных не выполнена | |||
90 | DistUplErr | C | 5 | Ошибка загрузки изменений данных | |||
91 | DistUplStatus | C | 1 | Загрузка изменений данных | |||
92 | DistDnldPrimBeg | C | 1 | Первичная выгрузка периферийной ИБ | |||
93 | DistDnldPrimSuc | C | 1 | Первичная выгрузка периферийной ИБ успешно завершена | |||
94 | DistDnldPrimFail | C | 1 | Первичная выгрузка периферийной ИБ не выполнена | |||
95 | DistDnldPrimErr | C | 5 | Ошибка первичной выгрузки периферийной ИБ | |||
96 | DistInit | C | 1 | Распределенная ИБ инициализирована | |||
97 | DistPIBCreat | C | 1 | Создана периферийная ИБ | |||
98 | DistPIBDel | C | 1 | Удалена периферийная ИБ | |||
99 | DistIBModi | C | 1 | Изменены параметры ИБ | |||
100 | DistAEParam | C | 1 | Изменены параметры автообмена | |||
101 | Тип события | UpDown | C | 15 | Выгрузка / загрузка данных | ||
103 | Событие | UpDownDnldToFile | C | 1 | Выгрузка ИБ | ||
104 | UpDownDnldSuc | C | 1 | Выгрузка ИБ успешно завершена | |||
105 | UpDownDnldFail | C | 1 | Выгрузка ИБ не выполнена | |||
106 | UpDownDnldErr | C | 5 | Ошибка выгрузки данных | |||
107 | UpDownUplFromFile | C | 1 | Загрузка ИБ | |||
108 | UpDownUplSuc | C | 1 | Загрузка ИБ успешно завершена | |||
109 | UpDownUplFail | C | 1 | Загрузка ИБ не выполнена | |||
110 | UpDownUplErr | C | 5 | Ошибка загрузки данных | |||
111 | Тип события | Archive | C | 15 | Сохранение / восстановление | ||
112 | Событие | ArchiveStart | C | 1 | Начало сохранения | ||
113 | ArchiveEnd | C | 1 | Завершение сохранения | |||
114 | DearchiveStart | C | 1 | Начало восстановления | |||
115 | DearchiveEnd | C | 1 | Завершение восстановления | |||
116 | ArchiveError | C | 5 | Ошибка при сохранении / восстановлении | |||
118 | Тип события | Batch | ECMD | 15 | Пакетный режим | ||
121 | Событие | BatchErr | ECMD | 5 | Ошибка при работе в пакетном режиме | ||
122 | Тип события | UsrDef | C | 1 | Пользователи | ||
123 | Тип события | Doctor | C | 15 | Тестирование и исправление ИБ | ||
124 | Событие | dctTRBeg | C | 1 | Начало тестирования и исправления | ||
125 | dctTBeg | C | 1 | Начало тестирования | |||
126 | dctPhInt | C | 1 | Контроль физической целостности | |||
127 | dctReind | C | 1 | Реиндексация таблиц ИБ | |||
128 | dctLgInt | C | 1 | Контроль логической целостности | |||
129 | dctRcST | C | 1 | Пересчет служебных данных | |||
130 | dctRcT | C | 1 | Пересчет итогов | |||
131 | dctTREnd | C | 1 | Окончание тестирования и исправления | |||
132 | dctTEnd | C | 1 | Окончание тестирования | |||
133 | dctErr | C | 5 | Ошибка ИБ | |||
134 | dctPck | C | 1 | Упаковка таблиц ИБ | |||
135 | Тип события | User | E | 012345 | Другие события | ||
136 | Событие | UserMsg | E | 012345 | Дополнительное событие | ||
137 | E | 012345 | Любое событие пользователя | Строка с идентификатором события или список значений из них. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | ||
138 | Тип события | E | 012345 | Любой тип события пользователя | Строка с идентификатором типа события или список значений из них. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | |
139 | Комментарий | ECMD | 012345 | Подстрока для поиска в комментарии | |||
140 | Объект | E | 012345 | Вид объекта | Строка с идентификатором вида объекта или список значений из них. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | |
141 | Объект | E | 012345 | Объект | Объект агрегатного типа или список значений из них. | Аналогично добавлению, или пустое значение, если полностью сбросить фильтр. | |
142 | Представление | E | 012345 | Подстрока для поиска в представлении |
Синтаксис: УстановитьФильтр([ИспользоватьБуфер])
Параметры:
- ИспользоватьБуфер - тип: Число. 0 - буфер не используется (осуществляется динамическая фильтрация), 1 - позиции отфильтрованных записей сохраняются в буфере. Необязателен, по умолчанию 0.
Возвращает: тип: Число. 1 - изменения фильтра корректны и начата фильтрация записей, 0 - в противном случае.
Описание: Проверяет на корректность изменения фильтра методом ИзменитьФильтр и начинает фильтрацию записей. Если используется буфер, то при прерывании фильтрации клавишей <ESC> формируется исключение. Если провайдер является поставщиком данных табличного поля, то выполнение процесса фильтрации в процентах отображается в строке состояния.
Синтаксис: ОткрытьФайл()
Возвращает: тип: Число. 1 - файл журнала регистрации открыт, 0 - в противном случае.
Описание: Открывает файл журнала регистрации для последующей выборки записей методом ВыбратьСтроки.
Синтаксис: ЗакрытьФайл()
Описание: Закрывает открытый файл журнала регистрации.
Синтаксис: ВыбратьСтроки([Смещение])
Параметры:
- Смещение - тип: Число. Определяет, с какого смещения в байтах от начала журнала регистрации производить выборку записей журнала регистрации. Необязателен, по умолчанию 0.
Возвращает: тип: Число. 1 - выборка начата, 0 - в противном случае.
Описание: Метод определяет, на какую запись указывает переданное смещение, и устанавливает выборку с этой записи.
Синтаксис: ПолучитьСтроку()
Возвращает: тип: Число. 1 - строка получена, 0 - в противном случае.
Описание: Выполняет позиционирование на очередную запись из выборки. Если перед получением строки установлен период и (или) фильтр, то получение записи осуществляется с учетом периода и фильтров. При прерывании данной операции клавишей <ESC> формируется исключение.