Специализированное администрирование > Анализ системной и коммерческой информация > Администрирование аудита > Сведения о файле configAudit.xml > Теги в configAudit.xml и их значение
  
Теги в configAudit.xml и их значение
Схема configAudit.xml содержит следующие элементы.
EventConfiguration
|
|— KeyEntry
|— ConfigEntry
|
|— KeyedEventEntry
|— EventEntry
Задайте для родительского элемента EventConfiguration значение true, чтобы включить аудит для всех событий в приложении.
<EventConfiguration enabled="true">
</EventConfiguration>
Чтобы аудит событий был выборочным, необходимо настроить его и указать события аудита, которые должны быть включены. По умолчанию для EventConfiguration задано значение false - аудит отключен.
Элемент
Подэлемент
Описание
Атрибуты
EventConfiguration
KeyEntry
Используйте этот элемент, чтобы добавить событие, для которого требуется аудит.
eventKey
multiObject
ConfigEntry
Используйте этот элемент для аудита события, специфичного для типа, или для аудита всех типов событий.
class
enabled
KeyEntry
KeyEntry содержит следующие подэлементы и их атрибуты:
Элемент
Атрибут
Описание
Тип данных
Значение
KeyEntry
eventKey
Используйте этот атрибут, чтобы добавить события, для которых требуется аудит.
Строка
Укажите событие, для которого требуется аудит. Для этого атрибута обязательно должно быть задано значение.
Например:
eventKey="*/wt.team.TeamServiceEvent/REMOVE_ROLE"
multiObject
Используйте этот атрибут, чтобы указать, является ли событие однообъектным или многообъектным.
Логический
Значение по умолчанию составляет false.
Если задано значение true, событие считается многообъектным.
Если не указать это значение, используется значение по умолчанию false и событие считается однообъектным.
Ниже приведен пример использования фрагмента кода KeyEntry, предназначенного для регистрации события "Удаление роли из коллектива контекста":
<EventConfiguration enabled="false">
<KeyEntry eventKey="*/wt.team.TeamServiceEvent/REMOVE_ROLE" multiObject="true"/>
</EventConfiguration>
. Дополнительные сведения о событиях и связанном с ними значении eventKey см. в разделе #InTheConfigurationFileEventsAreEith-BBF9C944.
ConfigEntry
Задайте для ConfigEntry значение true, чтобы включить аудит, специфичный для типа. Если класс для ConfigEntry не указан, записываются все события, независимо от типа. Если класс указан, выполняется аудит событий, соответствующих указанному типу. Пример класса wt.org.WTGroup или wt.team.RolePrincipalMap. ConfigEntry содержит следующие подэлементы и их атрибуты:
Элемент
Подэлемент
Описание
Атрибуты
ConfigEntry
KeyedEventEntry
Используйте этот элемент, чтобы включить аудит базового типа событий. Например, событий, аналогичных событиям "Архивирование" и "Связывание".
eventType
enabled
handler
EventEntry
Используйте этот элемент для включения аудита небазового типа событий, таких как "Откат итерации" и "Изменение состояния рабочего процесса".
При определении события необходимо использовать следующий формат: <наименование_события>EventEntry. Пример: AccessControlEventEntry.
eventType
enabled
handler
KeyedEventEntry
KeyedEventEntry содержит следующие атрибуты:
Элемент
Атрибут
Описание
Тип данных
Значение
KeyedEventEntry
eventType
илиeventKey
Используйте этот атрибут, чтобы определить базовый тип события, для которого требуется аудит. Определите события как eventType или eventKey, в зависимости от их исполнения в установке Windchill.
Строка
Для этого атрибута обязательно должно быть задано значение. Значение может быть следующим:
KeyedEventEntry eventKey="*/wt.sandbox.SandboxServiceCheckoutEvent/POST_SB_CHECKOUT_EVENT"
Enabled
Используйте этот атрибут, чтобы включить аудит события.
Логический
Для этого атрибута обязательно должно быть задано значение. Чтобы включить аудит, значение должно быть равно true.
Handler
Используйте этот атрибут, чтобы указать класс помощника, содержащего метод регистрации конкретного события.
Строка
Для этого атрибута обязательно должно быть задано значение. Значение может быть следующим:
handler="wt.audit.configaudit.TeamAuditMapEventRecorder"
EventEntry
EventEntry содержит следующие атрибуты:
Элемент
Атрибут
Описание
Тип данных
Значение
EventEntry
eventType
Используйте этот атрибут, чтобы указать небазовый тип события, для которого требуется аудит. Примеры небазовых событий: STATUS_CHANGE или NOT_AUTHORIZED. Дополнительные сведения о небазовых событиях и соответствующих EventEntry см. в разделе Список небазовых событий и типов событий
Строка
Для этого атрибута обязательно должно быть задано значение. Чтобы указать событие, для которого требуется аудит, используйте формат <наименование_события>EventEntry.
Например,
AccessControlEventEntry eventType="NOT_AUTHORIZED"
.
Enabled
Используйте этот атрибут, чтобы включить аудит события.
Логический
Для этого атрибута обязательно должно быть задано значение. Для включения аудита это значение должно быть равно true.
Handler
Используйте этот атрибут, чтобы указать класс помощника, содержащего метод регистрации конкретного события.
Строка
Для этого атрибута обязательно должно быть задано значение. Укажите класс помощника, содержащего метод регистрации конкретного события.
Например,
handler="wt.audit.configaudit.TeamAuditMapEventRecorder"
.
Фрагмент использование кода ConfigEntry
<EventConfiguration enabled="false">
<KeyEntry eventKey="*/wt.team.TeamServiceEvent/REMOVE_ROLE" multiObject="true"/>
<ConfigEntry class="" enabled="true">
<KeyedEventEntry eventKey="*/wt.sandbox.SandboxServiceCheckoutEvent/POST_SB_CHECKOUT_EVENT" enabled="true" handler="wt.audit.configaudit.PDMCheckoutEventRecorder"/>
</ConfigEntry>
<ConfigEntry class="wt.team.RolePrincipalMap" enabled="true">
<KeyedEventEntry eventKey="*/wt.team.TeamServiceEvent/ADD_ROLE" enabled="true" handler="wt.audit.configaudit.TeamAuditMapEventRecorder"/>
<KeyedEventEntry eventKey="*/wt.team.TeamServiceEvent/REMOVE_ROLE" enabled="true" handler="wt.audit.configaudit.TeamAuditMapEventRecorder"/>
</ConfigEntry>
<ConfigEntry class="" enabled="true">
<AccessControlEventEntry eventType="NOT_AUTHORIZED" enabled="true" handler="wt.audit.configaudit.NotAuthorizedEventRecorder"/>
<VCEventEntry eventType="POST_ROLLBACK" enabled="true" handler="wt.audit.configaudit.DefaultAuditEventRecorder"/>
<ConfigEntry>
</EventConfiguration>