ВыгрузитьЖурналРегистрации

[1cwiki]

Раздел

Глобальный контекст

Подразделы

Процедуры и функции работы с журналом регистрации

Синтаксис:

ВыгрузитьЖурналРегистрации(<Приемник>, <Фильтр>, <Колонки>, <ИмяВходногоФайла>, <МаксимальноеКоличество>)
Параметры:

<Приемник> (обязательный)

Тип: Строка; ТаблицаЗначений.
Строка, содержащая имя выходного XML файла, либо таблица значений, в которую будут выгружены выбранные в соответствии с отбором записи журнала регистрации.
В случае выгрузки в таблицу значений, она содержит колонки, в соответствии с параметром <Колонки>:
Уровень (Level) - тип УровеньЖурналаРегистрации;
Дата (Date) - тип Дата;
Пользователь (User) - идентификатор пользователя, тип УникальныйИдентификатор;
Компьютер (Computer) - имя компьютера, тип Строка;
ИмяПриложения (ApplicationName) - имя приложения, тип Строка;
Событие (Event ) - имя события, тип Строка;
Комментарий (Comment) - комментарий, тип Строка;
Метаданные (Metadata) - имя объекта метаданных, тип Строка; для событий "Доступ. Доступ" и "Доступ. Отказ в доступе" в этой колонке может содержаться массив имен объектов метаданных, тип Массив;
Данные (Data) - данные, произвольного типа, в зависимости от события;
ПредставлениеДанных (DataPresentation) - представление данных, тип Строка;
ИмяПользователя (UserName) - имя пользователя, тип Строка;
ПредставлениеПриложения (ApplicationPresentation) - представление имени приложения, тип Строка;
ПредставлениеСобытия (EventPresentation) - представление события, тип Строка;
ПредставлениеМетаданных (MetadataPresentation) - представление объекта метаданных; тип Строка; для событий "Доступ. Доступ" и "Доступ. Отказ в доступе" в этой колонке может содержаться массив представлений объектов метаданных, тип Массив;
СтатусТранзакции (TransactionStatus) - статус транзакции, тип СтатусТранзакцииЗаписиЖурналаРегистрации;
Транзакция (TransactionID) - представление транзакции, тип Строка;
Сеанс (Session) - номер сеанса, тип Число;
Соединение (Connection) - номер соединения, тип Число;
РабочийСервер (ServerName) - имя рабочего сервера, тип Строка;
ОсновнойIPПорт (Port) - номер основного IP-порта, тип Число;
ВспомогательныйIPПорт (SyncPort) - номер вспомогательного IP-порта, тип Строка;
РазделениеДанныхСеанса (SessionDataSeparation) - Структура с элементами, имена которых соответствуют именам общих реквизитов, разделяющих данные, а значения - значениям этих общих реквизитов;
ПредставлениеРазделенияДанныхСеанса (SessionDataSeparationPresentation) - Массив строк вида: <представление общего реквизита>: <представление значения общего реквизита>.
<Фильтр> (необязательный)

Тип: Структура.
Структура фильтра журнала регистрации:
ДатаНачала (StartDate) - Дата; значение по умолчанию Неопределено;
ДатаОкончания (EndDate) - Дата; значение по умолчанию Неопределено;
Уровень (Level) - перечисление или массив перечислений; значение по умолчанию Неопределено;
ИмяПриложения (ApplicationName) - Строка или массив строк; значение по умолчанию Неопределено;
Пользователь (User) - ПользовательИнформационнойБазы или массив таких объектов, или Строка. Объект ПользовательИнформационнойБазы и массив таких объектов можно получить из объекта МенеджерПользователейИнформационнойБазы. Также можно задавать пользователя по имени (строкой). Причем, пользователей, которые были удалены из информацонной базы можно задавать только таким способом. Пустая строка означает "пользователя по умолчанию", который используется, когда в информационной базе нет ни одного пользователя (от имени такого пользователя работают также фоновые задания). Если в фильтре задается массив пользователей, то можно перемешивать в нем значения обоих типов - строка и ПользовательИнформационнойБазы. Значение по умолчанию Неопределено;
Компьютер (Computer) - Строка или массив строк; значение по умолчанию Неопределено;
Событие (Event) - Строка или массив строк; значение по умолчанию Неопределено. Допустимые системные имена событий:
_$Access$_.Access - Доступ. Доступ; Предназначено для регистрации фактов успешного доступа пользователей системы к тем или иным данным. Поле журнала регистрации Данные (Структура) в этом случае имеет следующий состав:
Данные (Data) - скомпонованный результат выборки, поля регистрации данных, к которым обращались. Таблица значений, в которой содержатся данные из результата исполнения запроса. Все вложенные таблицы развернуты. Одинаковые значения пишутся один раз.
_$Access$_.AccessDenied - Доступ. Отказ в доступе; Предназначено для регистрации фактов отказа в доступе к тем или иным данным пользователям системы. Поле журнала регистрации Данные (Структура). имеет следующий состав:
Для ошибки доступа к объекту (не ограничение доступа к данным):
Право (Right) - имя нарушенного права;
Для ошибки ограничения доступа к данным:
Действие (Action) - Действие, которое выполнялось с данными, для объектных таблиц: Чтение (Read), Добавление (Insert), Изменение (Update), Удаление (Delete); для не объектных таблиц, все что не Чтение, то Изменение;
Данные (Data) - скомпонованный результат выборки, поля регистрации данных, к которым обращались.Таблица значений, в которой содержатся данные из результата исполнения запроса. Все вложенные таблицы развернуты. Одинаковые значения пишутся один раз.
_$Data$_.Delete - Данные. Удаление;
_$Data$_.New - Данные. Добавление;
_$Data$_.Post - Данные. Проведение;
_$Data$_.TotalsMaxPeriodUpdate - Данные. Изменение максимального периода рассчитанных итогов;
_$Data$_.TotalsMinPeriodUpdate - Данные. Изменение минимального периода рассчитанных итогов;
_$Data$_.Unpost - Данные. Отмена проведения;
_$Data$_.Update - Данные. Изменение;
_$Data$_.SetStandardODataInterfaceContent - Данные. Изменение состава стандартного интерфейса OData;
_$InfoBase$_.ConfigUpdate - Информационная база. Изменение конфигурации;
_$InfoBase$_.DBConfigUpdate - Информационная база. Изменение конфигурации базы данных;
_$InfoBase$_.DBConfigBackgroundUpdateStart - Информационная база. Запуск фонового обновления;
_$InfoBase$_.DBConfigBackgroundUpdateFinish - Информационная база. Завершение фонового обновления;
_$InfoBase$_.DBConfigBackgroundUpdateCancel - Информационная база. Отмена фонового обновления;
_$InfoBase$_.DBConfigBackgroundUpdateSuspend - Информационная база. Приостановка (пауза) процесса фонового обновления;
_$InfoBase$_.DBConfigBackgroundUpdateResume - Информационная база. Продолжение (после приостановки) процесса фонового обновления;
_$InfoBase$_.EventLogSettingsUpdate - Информационная база. Изменение параметров журнала регистрации;
_$InfoBase$_.InfoBaseAdmParamsUpdate - Информационная база. Изменение параметров информационной базы;
_$InfoBase$_.MasterNodeUpdate - Информационная база. Изменение главного узла;
_$InfoBase$_.RegionalSettingsUpdate - Информационная база. Изменение региональных установок;
_$InfoBase$_.EraseData - Информационная база. Удаление данных информационной баз;
_$InfoBase$_.TARImportant - Тестирование и исправление. Ошибка;
_$InfoBase$_.TARInfo - Тестирование и исправление. Сообщение;
_$InfoBase$_.TARMess - Тестирование и исправление. Предупреждение;
_$Job$_.Cancel - Фоновое задание. Отмена;
_$Job$_.Fail - Фоновое задание. Ошибка выполнения;
_$Job$_.Start - Фоновое задание. Запуск;
_$Job$_.Succeed - Фоновое задание. Успешное завершение;
_$PerformError$_ - Ошибка выполнения;
_$Session$_.Authentication - Сеанс. Аутентификация; выполняется только при удачной аутентификации. Для события Аутентификация записываются поля Пользователь и ИмяПользователя. Поле Комментарий события не заполняется. В случае аутентификации 1С:Предприятия или аутентификации операционной системы поле Данные заполняется структурой со следующим составом свойств:
ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
Имя (Name) - Строка. Выбирается из Имя;
ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы.
В случае аутентификации при помощи OpenID поле Данные заполняется структурой со следующим составом свойств:
ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы;
URLПровайдераOpenID (OpenIDProviderURL) - URL использованного провайдера OpenID;
ИдентификаторПользователяПровайдераOpenID (OpenIDProviderUserID) - идентификатор пользователя на провайдере.
_$Session$_.AuthenticationError - Сеанс. Ошибка аутентификации; выполняется только при ошибке аутентификации. Поле Комментарий события не заполняется. В случае аутентификации 1С:Предприятия или аутентификации операционной системы поле Данные заполняется структурой со следующим составом свойств:
ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
Имя (Name) - Строка. Выбирается из Имя;
ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы.
В случае аутентификации при помощи OpenID поле данные заполняется структурой со следующим составом свойств:
ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы;
URLПровайдераOpenID (OpenIDProviderURL) - URL использованного провайдера OpenID
_$Session$_.Finish - Сеанс. Завершение;
_$Session$_.Start - Сеанс. Начало;
_$Transaction$_.Begin - Транзакция. Начало;
_$Transaction$_.Commit - Транзакция. Фиксация;
_$Transaction$_.Rollback - Транзакция. Отмена;
_$User$_.Delete - Пользователи. Удаление; записываются как при редактировании списка пользователей в Конфигураторе, так и при удалении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
Имя (Name) - Строка. Выбирается из Имя
_$User$_.New - Пользователи. Добавление; записываются как при создани пользователей в Конфигураторе, так и методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
АутентификацияОС (OSAuthentication) - Булево. Выбирается из АутентификацияОС;
АутентификацияСтандартная (StandardAuthentication) - Булево. Выбирается из АутентификацияСтандартная;
ЗапрещеноИзменятьПароль (CannotChangePassword) - Булево. Выбирается из ЗапрещеноИзменятьПароль;
Имя (Name) - Строка. Выбирается из Имя;
ОсновнойИнтерфейс (DefaultInterface) - ОсновнойИнтерфейс. Выбирается из имени интерфейса. Выводится, только если основной режим ОбычноеПриложение.
ПарольИзменен (PasswordChanged) - Булево. Указывает, изменен ли пароль.
ПарольУстановлен (PasswordIsSet) - Булево. Выбирается из ПарольУстановлен;
ПоказыватьВСпискеВыбора (ShowInList) - Булево. Выбирается из ПоказыватьВСпискеВыбора;
ПолноеИмя (FullName) - Строка. Выбирается из ПолноеИмя
ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
РежимЗапуска (RunMode) - РежимЗапускаКлиентскогоПриложения. Выбирается из РежимЗапуска;
Роли (Roles) - Массив полных имен объектов метаданных ОбъектМетаданных: Роль;
Язык (Language) - Язык.
_$User$_.Update - Пользователи. Изменение; записываются как при редактировании списка пользователей в Конфигураторе, так и при изменении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
АутентификацияОС (OSAuthentication) - Булево. Выбирается из АутентификацияОС;
АутентификацияСтандартная (StandardAuthentication) - Булево. Выбирается из АутентификацияСтандартная;
ЗапрещеноИзменятьПароль (CannotChangePassword) - Булево. Выбирается из ЗапрещеноИзменятьПароль;
Имя (Name) - Строка. Выбирается из Имя;
ОсновнойИнтерфейс (DefaultInterface) - ОсновнойИнтерфейс. Выбирается из имени интерфейса. Выводится, только если основной режим ОбычноеПриложение.
ПарольИзменен (PasswordChanged) - Булево. Указывает, изменен ли пароль.
ПарольУстановлен (PasswordIsSet) - Булево. Выбирается из ПарольУстановлен;
ПоказыватьВСпискеВыбора (ShowInList) - Булево. Выбирается из ПоказыватьВСпискеВыбора;
ПолноеИмя (FullName) - Строка. Выбирается из ПолноеИмя
ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
РежимЗапуска (RunMode) - РежимЗапускаКлиентскогоПриложения. Выбирается из РежимЗапуска;
Роли (Roles) - Массив полных имен объектов метаданных ОбъектМетаданных: Роль;
Язык (Language) - Язык;
_$OpenIDProvider$_.PositiveAssertion - Провайдер OpenID. Подтверждено; записывается базой, выступающей в роли провайдера OpenID, при отправке положительного ответа на запрос аутентификации. Поле Комментарий события не заполняется. Поле Данные заполняется структурой со следующим составом свойств:
Имя (Name) - Строка. Выбирается из Имя;
URLДоверяющейСтороны (RelyingPartyURL) - URL доверяющей стороны OpenID, запросившей аутентификацию;
_$OpenIDProvider$_.NegativeAssertion - Провайдер OpenID. Отклонено; записывается базой, выступающей в роли провайдера OpenID, при отправке отрицательного ответа на запрос аутентификации. Поле Комментарий события не заполняется. Поле Данные заполняется структурой со следующим составом свойств:
URLДоверяющейСтороны (RelyingPartyURL) - URL доверяющей стороны OpenID, запросившей аутентификацию.
Метаданные (Metadata - объект описания метаданного или их массив; значение по умолчанию Неопределено;
Данные (Data) - значение, тип значения – ссылка на объект (СправочикСсылка и т.д.); значение по умолчанию Неопределено;
ПредставлениеДанных (DataPresentation) - Строка;
Комментарий (Comment) - Строка;
СтатусТранзакции (TransactionStatus) - перечисление или массив перечислений; значение по умолчанию Неопределено;
Транзакция (TransactionID) - идентификатор транзакции; Строка;
Сеанс (Session) - номер сеанса пользователя. Число или массив чисел; значение по умолчанию Неопределено;
РабочийСервер (ServerName) - Строка или массив строк; значение по умолчанию Неопределено;
ОсновнойIPПорт (Port) - номер основного IP-порта рабочего процесса; Число или массив чисел; значение по умолчанию Неопределено;
ВспомогательныйIPПорт (SyncPort) - номер вспомогательного IP-порта рабочего процесса. Число или массив чисел; значение по умолчанию Неопределено.
РазделениеДанныхСеанса (SessionDataSeparation) - Структура, имена элементов которой соответствуют именам общих реквизитов. В процессе отбора элементы структуры РазделениеДанныхСеанса объединяются по И: запись журнала попадает в выборку, если в ней есть соответствия для всех общих реквизитов, заданных в фильтре. Значение по умолчанию Неопределено.
Значение элемента структуры, в свою очередь, может быть:
структурой, задающей единичное значение. Элементы структуры:
Значение (Value) - значение общего реквизита. Значение по умолчанию - Неопределено;
Использование (Use) - Булево. Значение по умолчанию - Истина. Задает использование общего реквизита, разделяющего данные. Если Ложь - элемент Значение игнорируется и может быть опущен. Таким образом, можно отбирать записи журнала, в которых данный общий реквизит не установлен.
массивом, который задает набор допустимых значений общего реквизита, разделяющего данные. Массив содержит структуры, каждая из которых задает единичное значение общего реквизита (как описано выше). Элементы массива учитываются по ИЛИ: запись журнала попадает в выборку, если значение общего реквизита в ней равно одному из заданных в массиве.
<Колонки> (необязательный)

Тип: Строка.
Для того чтобы выгрузить определенные колонки журнала регистрации необходимо перечислить их имена, при этом необходимо имя каждой колонки отделять запятой.
Доступны следующие колонки:
Уровень (Level);
Дата (Date);
Пользователь (User);
Компьютер (Computer);
ИмяПриложения (ApplicationName);
Событие (Event);
Комментарий (Comment);
Метаданные (Metadata);
Данные (Data);
ПредставлениеДанных (DataPresentation);
ИмяПользователя (UserName);
ПредставлениеПриложения (ApplicationPresentation);
ПредставлениеСобытия (EventPresentation);
ПредставлениеМетаданных (MetadataPresentation);
СтатусТранзакции (TransactionStatus);
Транзакция (TransactionID);
Сеанс (Session);
Соединение (Connection);
РабочийСервер (ServerName);
ОсновнойIPПорт (Port);
ВспомогательныйIPПорт (SyncPort);
РазделениеДанныхСеанса (SessionDataSeparation);
ПредставлениеРазделенияДанныхСеанса (SessionDataSeparationPresentation).
Если не задан, то будут выгружены значения всех колонок.
<ИмяВходногоФайла> (необязательный)

Тип: Строка.
Строка, содержащая имя входного файла.
<МаксимальноеКоличество> (необязательный)

Тип: Число.
Ограничивает число считываемых методом событий журнала.
Если параметр не указан или равен 0 - без ограничения.
Если указано конечное число, метод считывает последние в хронологическом порядке события с учетом установленного фильтра в количестве, не превышающем значения параметра.
Описание:

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

Доступность:

Сервер, толстый клиент, внешнее соединение.
Примечание:

При записи событий имена элементов структур и колонок таблиц значений записываются на языке, соответствующем варианту встроенного языка конфигурации.
Требует наличия у пользователя права ЖурналРегистрации (EventLog). Отсутствие права приводит к возникновению исключения.
Открывает файл журнала в режиме, разрешающем совместную запись.