pynetdicom._handlers.doc_handle_event_report¶

pynetdicom._handlers.doc_handle_event_report(event)[source][source]¶

Documentation for handlers bound to evt.EVT_N_EVENT_REPORT.

User implementation of this event handler is required if one or more services that use N-EVENT-REPORT are to be supported. If a handler is not implemented and bound to evt.EVT_N_EVENT_REPORT then the N-EVENT-REPORT request will be responded to using a Status value of 0x0110 - Processing Failure.

Event

evt.EVT_N_EVENT_REPORT

Supported Service Classes

Modality Performed Procedure Step Management

Status

Success: 0x0000 Success
Failure: 0x0110 Processing failure

0x0112 No such SOP Instance

0x0113 No such event type

0x0114 No such argument

0x0115 Invalid argument value

0x0117 Invalid object Instance

0x0118 No such SOP Class

0x0119 Class-Instance conflict

0x0210 Duplicate invocation

0x0211 Unrecognised operation

0x0212 Mistyped argument

0x0213 Resource limitation

Parameters

event (events.Event) –

The event representing a service class receiving a N-EVENT-REPORT request message. Event attributes are:

assoc : the association that is running the service that received the N-EVENT-REPORT request.
context : the presentation context the request was sent under as a presentation.PresentationContextTuple.
description : a description of the event that occurred as str.
name : the name of the event that occurred as str.
request : the received N-EVENT-REPORT request
timestamp : the date and time that the N-EVENT-REPORT request was processed by the service.

Event properties are:

event_information : the decoded Dataset contained within the N-EVENT-REPORT request’s Event Information parameter. Because pydicom uses a deferred read when decoding data, if the decode fails the returned Dataset will only raise an exception at the time of use.

Returns

status (pydicom.dataset.Dataset or int) – The status returned to the peer AE in the N-EVENT-REPORT response. Must be a valid N-EVENT-REPORT status value for the applicable Service Class as either an int or a Dataset object containing (at a minimum) a (0000,0900) Status element. If returning a Dataset object then it may also contain optional elements related to the Status (as in DICOM Standard Part 7, Annex C).
dataset (pydicom.dataset.Dataset or None) – If the status category is ‘Success’ or ‘Warning’ then a Dataset containing elements of the response’s Event Reply conformant to the specifications in the corresponding Service Class.

If the status category is not ‘Success’ or ‘Warning’ then None.

Raises

NotImplementedError – If the handler has not been implemented and bound to evt.EVT_N_EVENT_REPORT by the user.