Flexberry ORM 4.0.0
Интерфейс ICSSoft.STORMNET.Business.Audit.IAuditService

Интерфейс для сервиса аудита (отвечает за API и настройки). Подробнее...

Граф наследования:ICSSoft.STORMNET.Business.Audit.IAuditService:
ICSSoft.STORMNET.Business.Audit.AuditService

Открытые члены

bool IsTypeAuditable (Type curType)
 Является ли класс аудируемым (проверяются настройки по аудиту приложения + настройки класса) Подробнее...
 
bool EnableAudit (bool throwExceptions)
 Включить ведение аудита в приложении (предварительно должны быть проинициализированы AppSetting и Audit) Подробнее...
 
void DisableAudit ()
 Отключить ведение аудита в приложении Подробнее...
 
Guid WriteCommonAuditOperation (DataObject operationedObject, IDataService dataService, bool throwExceptions=true, IDbTransaction transaction=null)
 Сообщаем о совершении потенциально аудируемого действа. Подробнее...
 
bool RatifyAuditOperation (tExecutionVariant executionVariant, List< Guid > auditOperationIdList, bool throwExceptions)
 Подтверждение созданных ранее операций аудита (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию) Подробнее...
 
bool RatifyAuditOperation (tExecutionVariant executionVariant, List< Guid > auditOperationIdList, string dataServiceConnectionString, Type dataServiceType, bool throwExceptions)
 Подтверждение созданных ранее операций аудита (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию) Подробнее...
 
bool RatifyAuditOperation (tExecutionVariant executionVariant, List< Guid > auditOperationIdList, IDataService dataService, bool throwExceptions)
 Подтверждение созданных ранее операций аудита (выполнение зависит от выбранного режима записи данных аудита) (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных) Подробнее...
 
Guid WriteCustomAuditOperation (CustomAuditParameters customAuditParameters, bool throwExceptions)
 Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию) Подробнее...
 
Guid WriteCustomAuditOperation (CustomAuditParameters customAuditParameters, IDataService dataService, bool throwExceptions)
 Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных) Подробнее...
 
Guid WriteCustomAuditOperation (CustomAuditParameters customAuditParameters, string dataServiceConnectionString, Type dataServiceType, bool throwExceptions)
 Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных) Подробнее...
 
void AddCreateAuditInformation (DataObject operationedObject)
 Добавление информации о том, кто и когда создал объект, если он это поддерживает Подробнее...
 
void AddEditAuditInformation (DataObject operationedObject)
 Добавление информации о том, кто и когда отредактировал объект, если он это поддерживает Подробнее...
 
View GetViewByAuditRecord (IAuditRecord auditRecord)
 Получение представления, по которому вероятнее всего вёлся аудит объекта, по операции над которым есть запись. Данное представление будет использоваться для получения кэпшенов полей. Подробнее...
 
View GetAuditViewByType (Type type, tTypeOfAuditOperation operationType)
 Получение представления для аудита у определенного типа. Подробнее...
 
AuditAdditionalInfo WriteCommonAuditOperationWithAutoFields (DataObject operationedObject, IDataService dataService, bool throwExceptions=true, IDbTransaction transaction=null)
 Сообщаем о совершении потенциально аудируемого действа. Подробнее...
 
bool RatifyAuditOperationWithAutoFields (tExecutionVariant executionVariant, List< AuditAdditionalInfo > auditOperationInfoList, IDataService dataService, bool throwExceptions)
 Подтверждение созданных ранее операций аудита (выполнение зависит от выбранного режима записи данных аудита) (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных) Подробнее...
 

Свойства

bool IsAuditEnabled [get]
 Включён ли аудит для приложения Подробнее...
 
bool IsAuditRemote [get]
 Выполняется ли аудит удалённо (то есть через вызов AuditWinService) Подробнее...
 
string AuditConnectionStringName [get]
 Получение имени строки соединения с БД аудита (используется для загрузки данных из БД). Если используется запись аудита через windows-сервис, то будет возвращено null Подробнее...
 
bool ShowPrimaryKey [get, set]
 Следует ли отображать записи с изменением первичного ключа на формах. Подробнее...
 
AuditAppSetting AppSetting [get, set]
 Настройки аудита в приложении Подробнее...
 
IAudit Audit [get, set]
 Элемент, реализующий логику аудита Подробнее...
 
AppMode ApplicationMode [get, set]
 Режим, в котором работает приложение: win или web Подробнее...
 

Подробное описание

Интерфейс для сервиса аудита (отвечает за API и настройки).

Методы

void ICSSoft.STORMNET.Business.Audit.IAuditService.AddCreateAuditInformation ( DataObject  operationedObject)

Добавление информации о том, кто и когда создал объект, если он это поддерживает

Аргументы
operationedObjectОбъект, куда добавляется информация

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

void ICSSoft.STORMNET.Business.Audit.IAuditService.AddEditAuditInformation ( DataObject  operationedObject)

Добавление информации о том, кто и когда отредактировал объект, если он это поддерживает

Аргументы
operationedObjectОбъект, куда добавляется информация

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

void ICSSoft.STORMNET.Business.Audit.IAuditService.DisableAudit ( )

Отключить ведение аудита в приложении

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.EnableAudit ( bool  throwExceptions)

Включить ведение аудита в приложении (предварительно должны быть проинициализированы AppSetting и Audit)

Аргументы
throwExceptionsСледует ли вызывать исключения в ошибочной ситуации
Возвращает
Удалось ли включить аудит

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

View ICSSoft.STORMNET.Business.Audit.IAuditService.GetAuditViewByType ( Type  type,
tTypeOfAuditOperation  operationType 
)

Получение представления для аудита у определенного типа.

Аргументы
typeТип, у которого нужно получить представление для аудита.
operationTypeТип аудируемой операции, для которой нужно получить представление. (Select, Insert, Update или Delete)
Возвращает
Представление для аудита.

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

View ICSSoft.STORMNET.Business.Audit.IAuditService.GetViewByAuditRecord ( IAuditRecord  auditRecord)

Получение представления, по которому вероятнее всего вёлся аудит объекта, по операции над которым есть запись. Данное представление будет использоваться для получения кэпшенов полей.

Аргументы
auditRecordЗапись из аудита, по которой необходимо определить представление.
Возвращает
Найденное представление (если что-то не удалось, то выдастся null; исключения не должно быть в любом случае).

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.IsTypeAuditable ( Type  curType)

Является ли класс аудируемым (проверяются настройки по аудиту приложения + настройки класса)

Аргументы
curTypeИсследуемый тип
Возвращает
True, если является и нужно вести аудит

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.RatifyAuditOperation ( tExecutionVariant  executionVariant,
List< Guid >  auditOperationIdList,
bool  throwExceptions 
)

Подтверждение созданных ранее операций аудита (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию)

Аргументы
executionVariantКакой статус будет присвоен операции
auditOperationIdListСписок айдишников записей аудита
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
True, если всё закончилось без ошибок

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.RatifyAuditOperation ( tExecutionVariant  executionVariant,
List< Guid >  auditOperationIdList,
string  dataServiceConnectionString,
Type  dataServiceType,
bool  throwExceptions 
)

Подтверждение созданных ранее операций аудита (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию)

Аргументы
executionVariantКакой статус будет присвоен операции
auditOperationIdListСписок айдишников записей аудита
dataServiceConnectionStringСтрока соединения сервиса данных, который выполняет запись в БД приложения
dataServiceTypeТип сервиса данных, который выполняет запись в БД приложения
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
True, если всё закончилось без ошибок

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.RatifyAuditOperation ( tExecutionVariant  executionVariant,
List< Guid >  auditOperationIdList,
IDataService  dataService,
bool  throwExceptions 
)

Подтверждение созданных ранее операций аудита (выполнение зависит от выбранного режима записи данных аудита) (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных)

Аргументы
executionVariantКакой статус будет присвоен операции
auditOperationIdListСписок айдишников записей аудита
dataServiceСервис данных, по параметрам которого (строка соединения и тип) осуществляется поиск в AuditService.Current.AppSetting.AuditDSSettings
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
True, если всё закончилось без ошибок

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

bool ICSSoft.STORMNET.Business.Audit.IAuditService.RatifyAuditOperationWithAutoFields ( tExecutionVariant  executionVariant,
List< AuditAdditionalInfo auditOperationInfoList,
IDataService  dataService,
bool  throwExceptions 
)

Подтверждение созданных ранее операций аудита (выполнение зависит от выбранного режима записи данных аудита) (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных)

Аргументы
executionVariantКакой статус будет присвоен операции
auditOperationInfoListДополнительная информация, которую необходимо передать в аудит.
dataServiceСервис данных, по параметрам которого (строка соединения и тип) осуществляется поиск в AuditService.Current.AppSetting.AuditDSSettings
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
True, если всё закончилось без ошибок

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

Guid ICSSoft.STORMNET.Business.Audit.IAuditService.WriteCommonAuditOperation ( DataObject  operationedObject,
IDataService  dataService,
bool  throwExceptions = true,
IDbTransaction  transaction = null 
)

Сообщаем о совершении потенциально аудируемого действа.

Аргументы
operationedObjectОбъект, над которым выполняется операция.
dataServiceСервис данных, который выполянет операцию.
throwExceptionsСледует ли пробрасывать дальше возникшее исключение (по умолчанию - true).
transactionТранзакция, через которую необходимо проводить выполнение зачиток из БД приложения аудиту (при работе AuditService иногда необходимо дочитать объект или получить сохранённую копию, а выполнение данного действия без транзакции может привести к взаимоблокировке). По умолчанию - null.
Возвращает
Ответ о том, можно ли выполнять операцию (если null, то значит, что что-то пошло не так).

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

AuditAdditionalInfo ICSSoft.STORMNET.Business.Audit.IAuditService.WriteCommonAuditOperationWithAutoFields ( DataObject  operationedObject,
IDataService  dataService,
bool  throwExceptions = true,
IDbTransaction  transaction = null 
)

Сообщаем о совершении потенциально аудируемого действа.

Аргументы
operationedObjectОбъект, над которым выполняется операция.
dataServiceСервис данных, который выполянет операцию.
throwExceptionsСледует ли пробрасывать дальше возникшее исключение (по умолчанию - true).
transactionТранзакция, через которую необходимо проводить выполнение зачиток из БД приложения аудиту (при работе AuditService иногда необходимо дочитать объект или получить сохранённую копию, а выполнение данного действия без транзакции может привести к взаимоблокировке). По умолчанию - null.
Возвращает
Ответ о том, можно ли выполнять операцию (если null, то значит, что что-то пошло не так).

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

Guid ICSSoft.STORMNET.Business.Audit.IAuditService.WriteCustomAuditOperation ( CustomAuditParameters  customAuditParameters,
bool  throwExceptions 
)

Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет использован сервис данных по умолчанию)

Аргументы
customAuditParametersПараметры аудита
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
Id записи аудита

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

Guid ICSSoft.STORMNET.Business.Audit.IAuditService.WriteCustomAuditOperation ( CustomAuditParameters  customAuditParameters,
IDataService  dataService,
bool  throwExceptions 
)

Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных)

Аргументы
customAuditParametersПараметры аудита
dataServiceСервис данных, по параметрам которого (строка соединения и тип) осуществляется поиск в AuditService.Current.AppSetting.AuditDSSettings
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
Id записи аудита

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

Guid ICSSoft.STORMNET.Business.Audit.IAuditService.WriteCustomAuditOperation ( CustomAuditParameters  customAuditParameters,
string  dataServiceConnectionString,
Type  dataServiceType,
bool  throwExceptions 
)

Сделать запись в аудит (если аудит идёт в одну БД с приложением, то будет в сервис аудита передаваться имя строки соединения, найденное в AuditService.Current.AppSetting.AuditDSSettings по параметрам переданного сервиса данных)

Аргументы
customAuditParametersПараметры аудита
dataServiceConnectionStringСтрока соединения сервиса данных, который выполняет запись в БД приложения
dataServiceTypeТип сервиса данных, который выполняет запись в БД приложения
throwExceptionsСледует ли пробрасывать дальше возникшее исключение
Возвращает
Id записи аудита

Замещается в ICSSoft.STORMNET.Business.Audit.AuditService.

Полный список свойств

AppMode ICSSoft.STORMNET.Business.Audit.IAuditService.ApplicationMode
getset

Режим, в котором работает приложение: win или web

AuditAppSetting ICSSoft.STORMNET.Business.Audit.IAuditService.AppSetting
getset

Настройки аудита в приложении

IAudit ICSSoft.STORMNET.Business.Audit.IAuditService.Audit
getset

Элемент, реализующий логику аудита

string ICSSoft.STORMNET.Business.Audit.IAuditService.AuditConnectionStringName
get

Получение имени строки соединения с БД аудита (используется для загрузки данных из БД). Если используется запись аудита через windows-сервис, то будет возвращено null

bool ICSSoft.STORMNET.Business.Audit.IAuditService.IsAuditEnabled
get

Включён ли аудит для приложения

bool ICSSoft.STORMNET.Business.Audit.IAuditService.IsAuditRemote
get

Выполняется ли аудит удалённо (то есть через вызов AuditWinService)

bool ICSSoft.STORMNET.Business.Audit.IAuditService.ShowPrimaryKey
getset

Следует ли отображать записи с изменением первичного ключа на формах.