]>
|
|
|
|
|
ПоставщикДанныхЖурналРегистрации / 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> формируется исключение.