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 of0x0110
- 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 error0x0110
- Processing failure0x0112
- No such SOP Instance0x0117
- Invalid object Instance0x0118
- No such SOP Class0x0119
- Class-Instance conflict0x0124
- Not authorised0x0210
- Duplicate invocation0x0211
- Unrecognised operation0x0212
- Mistyped argument0x0213
- Resource limitation0xC112
- Applicable Machine Verification Instance not found0xC307
- Specified SOP Instance UID doesn’t exist or is not a UPS Instance managed by this SCP- Warning
0x0001
- Requested optional Attributes are not supported0x0107
- Attribute list error
Parameters: event (events.Event) – The event representing a service class receiving an N-GET request message.
Event
attributes are:assoc
: theassociation
that is running the service that received the N-GET request.context
: the presentation context the request was sent under as apresentation.PresentationContextTuple
.event
: the event that occurred asnamedtuple
.request
: the receivedN-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 attributeTags
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 aDataset
object containing (at a minimum) a (0000,0900) Status element. If returning aDataset
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