pynetdicom._handlers.doc_handle_n_get

pynetdicom._handlers.doc_handle_n_get(event)

Documentation for handlers bound to evt.EVT_N_GET.

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

Event

evt.EVT_N_GET

Supported Service Classes

  • Display System Management Service Class
  • Modality Performed Procedure Step Management

Status

Success
0x0000 - Success
Failure
0x0107 - Attribute list error
0x0110 - Processing failure
0x0112 - No such SOP Instance
0x0117 - Invalid object Instance
0x0118 - No such SOP Class
0x0119 - Class-Instance conflict
0x0124 - Not authorised
0x0210 - Duplicate invocation
0x0211 - Unrecognised operation
0x0212 - Mistyped argument
0x0213 - Resource limitation
0xC112 - Applicable Machine Verification Instance not found
0xC307 - Specified SOP Instance UID doesn’t exist or is not a UPS Instance managed by this SCP
Warning
0x0001 - Requested optional Attributes are not supported
0x0107 - Attribute list error
Parameters:event (events.Event) –

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

  • assoc : the association that is running the service that received the N-GET request.
  • context : the presentation context the request was sent under as a presentation.PresentationContextTuple.
  • event : the event that occurred as namedtuple.
  • request : the received N-GET request
  • timestamp : the date and time that the N-GET request was processed by the service.

Event properties are:

  • attribute_identifiers : a list of attribute Tags contained within the N-GET request’s Attribute Identifier List parameter.
Returns:
  • status (pydicom.dataset.Dataset or int) – The status returned to the peer AE in the N-GET response. Must be a valid N-GET 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 matching the request’s Attribute List conformant to the specifications in the corresponding Service Class.

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

References