УстановитьИспользованиеСобытияЖурналаРегистрации

[1cwiki]

Раздел

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

Подразделы

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

Синтаксис:

УстановитьИспользованиеСобытияЖурналаРегистрации(<ИмяСобытия>, <Использование>)
Параметры:

<ИмяСобытия> (обязательный)

Тип: Строка.
Имя регистрируемого события.
Допустимые системные имена событий:
_$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, запросившей аутентификацию.
<Использование> (обязательный)

Тип: ИспользованиеСобытияЖурналаРегистрации.
Задает использование и режим регистрации указанного в первом параметре события.
Режим регистрации управляется значением свойства ОписаниеИспользования, которое регламентировано для двух событий:
_$Access$_.Access – массив значений типа ОписаниеИспользованияСобытияДоступЖурналаРегистрации;
_$Access$_.AccessDenied – массив значений типа ОписаниеИспользованияСобытияОтказВДоступеЖурналаРегистрации.
Описание:

Управляет регистрацией событий в журнале регистрации.
Устанавливает для информационной базы режим регистрации события журнала регистрации.
По умолчанию все события используются.

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

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

Требует наличия у пользователя административных прав. Отсутствие права приводит к возникновению исключения.
События, связанные с транзакциями (_$Transaction$_.Begin, _$Transaction$_.Commit, _$Transaction$_.Rollback), не могут быть отключены с помощью данного метода.
Пример:

Код Выделить Развернуть

// Событие Доступ
ОписанияДоступ = Новый Массив;   

// РегистрНакопления.Начисления
ПоляРегистрации = Новый Массив;
ПоляРегистрации.Добавить("Сотрудник");

ПоляДоступа = Новый Массив;
ПоляДоступа.Добавить("Сумма");

Доступ = Новый ОписаниеИспользованияСобытияДоступЖурналаРегистрации;
Доступ.Объект = "РегистрНакопления.Начисления";
Доступ.ПоляРегистрации = ПоляРегистрации;
Доступ.ПоляДоступа = ПоляДоступа;
ОписанияДоступ.Добавить(Доступ);
   
// Справочник.Сотрудники
ПоляДоступа = Новый Массив;
ПоляРегистрации = Новый Массив;
ПоляРегистрации.Добавить("Ссылка");
   
Доступ = Новый ОписаниеИспользованияСобытияДоступЖурналаРегистрации;
Доступ.Объект = "Справочник.Сотрудники";
Доступ.ПоляРегистрации = ПоляРегистрации;
Доступ.ПоляДоступа = ПоляДоступа;
ОписанияДоступ.Добавить(Доступ);

ИспользованиеСобытия = Новый ИспользованиеСобытияЖурналаРегистрации;
ИспользованиеСобытия.Использование = Истина;
ИспользованиеСобытия.ОписаниеИспользования = ОписанияДоступ;

УстановитьИспользованиеСобытияЖурналаРегистрации(
                                            "_$Access$_.Access",
                                            ИспользованиеСобытия);

// Событие ОтказВДоступе
ОписанияОтказВДоступе = Новый Массив;

// Справочник.Сотрудники
ПоляРегистрации = Новый Массив;
ПоляРегистрации.Добавить("Ссылка");
ПоляАльтернатив = Новый Массив;
ПоляАльтернатив.Добавить("Фамилия");
ПоляАльтернатив.Добавить("ИНН");
ПоляРегистрации.Добавить(ПоляАльтернатив);

ОтказВДоступе =
Новый ОписаниеИспользованияСобытияОтказВДоступеЖурналаРегистрации;
ОтказВДоступе.Объект = "Справочник.Сотрудники";
ОтказВДоступе.ПоляРегистрации = ПоляРегистрации;
ОписанияОтказВДоступе.Добавить(ОтказВДоступе);

ИспользованиеСобытия = Новый ИспользованиеСобытияЖурналаРегистрации;
ИспользованиеСобытия.Использование = Истина;
ИспользованиеСобытия.ОписаниеИспользования = ОписанияОтказВДоступе;

УстановитьИспользованиеСобытияЖурналаРегистрации(
                                            "_$Access$_.AccessDenied",
                                            ИспользованиеСобытия);