pynetdicom._handlers.doc_handle_store

pynetdicom._handlers.doc_handle_store(event)[source][source]

Documentation for handlers bound to evt.EVT_C_STORE.

User implementation of this event handler is required if one or more services that use C-STORE are to be supported. If a handler is not implemented and bound to evt.EVT_C_STORE then the C-STORE request will be responded to using a Status value of 0xC211 - Failure.

If the user is storing the dataset in the DICOM File Format (as in the DICOM Standard Part 10, Section 7) then they are responsible for adding the DICOM File Meta Information.

Event

evt.EVT_C_STORE

Supported Service Classes

  • Storage Service Class

  • Non-Patient Object Storage Service Class

Status

Success
0x0000 - Success
Warning
0xB000 Coercion of data elements
0xB006 Elements discarded
0xB007 Dataset does not match SOP class
Failure
0x0117 Invalid SOP instance
0x0122 SOP class not supported
0x0124 Not authorised
0x0210 Duplicate invocation
0x0211 Unrecognised operation
0x0212 Mistyped argument
0xA700 to 0xA7FF Out of resources
0xA900 to 0xA9FF Dataset does not match SOP class
0xC000 to 0xCFFF Cannot understand
Parameters

event (events.Event) –

The event representing a service class receiving a C-STORE request message. Event attributes are:

  • assoc : the association that is running the service that received the C-STORE 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 C-STORE request

  • timestamp : the date and time that the C-STORE request was processed by the service.

Event properties are:

  • dataset : the decoded Dataset contained within the C-STORE request’s Data Set 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.

  • file_meta : a Dataset containing DICOM conformant File Meta Information that can be used with the decoded dataset when saving to file: event.dataset.file_meta = event.file_meta.

Returns

status – The status returned to the requesting AE in the C-STORE response. Must be a valid C-STORE 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 the DICOM Standard Part 7, Annex C).

Return type

pydicom.dataset.Dataset or int

Raises

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

See also

send_c_store() C_STORE StorageServiceClass NonPatientObjectStorageServiceClass

References