/// <summary>
/// Generates a "Dicom Instances Accessed" update event in the audit log (with ActionCode of Delete), according to DICOM Supplement 95.
/// </summary>
/// <remarks>
/// This method automatically separates different patients into separately logged events, as required by DICOM.
///
/// We chose to impleemnt the DicomInstancesAccessed audit log, as opposed to the DicomStudyDeleted audit message because the whole
/// study isn't being deleted, just a series.
/// </remarks>
/// <param name="aeTitles">The application entities from which the instances were accessed.</param>
/// <param name="instances">The studies that the series belong that are being deleted.</param>
/// <param name="eventSource">The source user or application entity which invoked the operation.</param>
/// <param name="eventResult">The result of the operation.</param>
public static void LogDeleteSeries(IEnumerable <string> aeTitles, AuditedInstances instances, EventSource eventSource, EventResult eventResult)
{
if (!AuditingEnabled)
{
return;
}
try
{
var aeTitlesArray = ToArray(aeTitles);
foreach (var patient in instances.EnumeratePatients())
{
var auditHelper = new DicomInstancesAccessedAuditHelper(eventSource, eventResult, EventIdentificationContentsEventActionCode.D);
auditHelper.AddUser(eventSource);
if (aeTitlesArray.Length > 0)
{
auditHelper.AddUser(new AuditProcessActiveParticipant(aeTitlesArray));
}
auditHelper.AddPatientParticipantObject(patient);
foreach (var study in instances.EnumerateStudies(patient))
{
auditHelper.AddStudyParticipantObject(study);
}
Log(auditHelper);
}
}
catch (Exception ex)
{
Platform.Log(LogLevel.Warn, ex, _messageAuditFailed);
}
}
/// <summary>
/// Generates a "Dicom Study Deleted" event in the audit log, according to DICOM Supplement 95.
/// </summary>
/// <remarks>
/// This method automatically separates different patients into separately logged events, as required by DICOM.
/// </remarks>
/// <param name="aeTitle">The application entity from which the instances were deleted.</param>
/// <param name="instances">The studies that were deleted.</param>
/// <param name="eventSource">The source user or application entity which invoked the operation.</param>
/// <param name="eventResult">The result of the operation.</param>
public static void LogDeleteStudies(string aeTitle, AuditedInstances instances, EventSource eventSource, EventResult eventResult)
{
if (!AuditingEnabled)
{
return;
}
try
{
foreach (var patient in instances.EnumeratePatients())
{
var auditHelper = new DicomStudyDeletedAuditHelper(eventSource, eventResult);
auditHelper.AddUserParticipant(eventSource);
auditHelper.AddUserParticipant(new AuditProcessActiveParticipant(aeTitle));
auditHelper.AddPatientParticipantObject(patient);
foreach (var study in instances.EnumerateStudies(patient))
{
auditHelper.AddStudyParticipantObject(study);
}
Log(auditHelper);
}
}
catch (Exception ex)
{
Platform.Log(LogLevel.Warn, ex, _messageAuditFailed);
}
}
/// <summary>
/// Generates a "Data Import" event in the audit log, according to DICOM Supplement 95.
/// </summary>
/// <remarks>
/// One audit event is generated for each file system volume from which data is imported.
/// If the audited instances are not on a file system, a single event is generated with an empty media identifier.
/// </remarks>
/// <param name="instances">The files that were imported.</param>
/// <param name="eventSource">The source user or application entity which invoked the operation.</param>
/// <param name="currentAE">The current DICOM AE performing the operation.</param>
/// <param name="eventResult">The result of the operation.</param>
public static void LogImportStudies(AuditedInstances instances, EventSource eventSource, EventSource currentAE, EventResult eventResult)
{
if (!AuditingEnabled)
return;
try
{
var fileVolumes = new List<string>(instances.EnumerateFileVolumes());
if (fileVolumes.Count == 0)
fileVolumes.Add(string.Empty);
foreach (var volume in fileVolumes)
{
var auditHelper = new DataImportAuditHelper(eventSource, eventResult, volume);
auditHelper.AddImporter(eventSource);
if (eventSource != currentAE)
auditHelper.AddImporter(currentAE);
foreach (var patient in instances.EnumeratePatients())
auditHelper.AddPatientParticipantObject(patient);
foreach (var study in instances.EnumerateStudies())
auditHelper.AddStudyParticipantObject(study);
Log(auditHelper);
}
}
catch (Exception ex)
{
Platform.Log(LogLevel.Warn, ex, _messageAuditFailed);
}
}
public void AuditFailure(DicomProcessingResult result)
{
// This primarily happens with DICOMDIR files
if (string.IsNullOrEmpty(result.StudyInstanceUid))
return;
if (!_context.FailedStudyAudits.ContainsKey(result.StudyInstanceUid))
{
var auditedInstances = new AuditedInstances();
auditedInstances.AddInstance(result.PatientId, result.PatientsName,
result.StudyInstanceUid);
AuditHelper.LogImportStudies(auditedInstances, _context.AuditSource, EventResult.MajorFailure);
_context.FailedStudyAudits.Add(result.StudyInstanceUid, result.StudyInstanceUid);
}
}
/// <summary>
/// Generates a "DICOM Instances Transferred" received event in the audit log, according to DICOM Supplement 95.
/// </summary>
/// <remarks>
/// This method automatically separates different patients into separately logged events, as required by DICOM.
/// </remarks>
/// <param name="localAETitle">The local application entity to which the transfer was completed.</param>
/// <param name="remoteAETitle">The application entity from which the transfer was completed.</param>
/// <param name="remoteHostName">The hostname of the application entity from which the transfer was completed.</param>
/// <param name="instances">The studies that were transferred.</param>
/// <param name="eventSource">The source user or application entity which invoked the operation.</param>
/// <param name="eventResult">The result of the operation.</param>
/// <param name="action">The action taken on the studies that were transferred.</param>
public static void LogReceivedInstances(string localAETitle, string remoteAETitle, string remoteHostName, AuditedInstances instances, EventSource eventSource, EventResult eventResult, EventReceiptAction action)
{
if (!AuditingEnabled)
{
return;
}
try
{
foreach (var patient in instances.EnumeratePatients())
{
var auditHelper = new DicomInstancesTransferredAuditHelper(eventSource, eventResult, action,
remoteAETitle ?? localAETitle, remoteHostName ?? LocalHostname, localAETitle, LocalHostname);
foreach (var study in instances.EnumerateStudies(patient))
{
auditHelper.AddStudyParticipantObject(study);
}
Log(auditHelper);
}
}
catch (Exception ex)
{
Platform.Log(LogLevel.Warn, ex, _messageAuditFailed);
}
}
public void AuditFailure(DicomProcessingResult result)
{
// This primarily happens with DICOMDIR files
if (string.IsNullOrEmpty(result.StudyInstanceUid))
return;
if (!_context.FailedStudyAudits.ContainsKey(result.StudyInstanceUid))
{
var auditedInstances = new AuditedInstances();
auditedInstances.AddInstance(result.PatientId, result.PatientsName,
result.StudyInstanceUid);
AuditHelper.LogImportStudies(auditedInstances, _context.AuditSource, EventResult.MajorFailure);
_context.FailedStudyAudits.Add(result.StudyInstanceUid, result.StudyInstanceUid);
}
}
