- pynetdicom._handlers.doc_handle_create(event: Event, *args: Sequence[Any]) Tuple[Union[pydicom.dataset.Dataset, int], Optional[pydicom.dataset.Dataset]] ¶
Documentation for handlers bound to
User implementation of this event handler is required if one or more services that use N-CREATE are to be supported. If a handler is not implemented and bound to
evt.EVT_N_CREATEthen the N-CREATE request will be responded to using a Status value of
0x0110- Processing Failure.
Management of the SOP Instances created in response to an N-CREATE request is the responsibility of the user.
Supported Service Classes
0x0105- No such attribute
0x0106- Invalid attribute value
0x0107- Attribute list error
0x0110- Processing failure
0x0111- Duplicate SOP Instance
0x0116- Attribute value out of range
0x0117- Invalid object instance
0x0118- No such SOP Class
0x0120- Missing attribute
0x0121- Missing attribute value
0x0124- Refused: not authorised
0x0210- Duplicate invocation
0x0211- Unrecognised operation
0x0212- Mistyped argument
0x0213- Resource limitation
0xA510- Failed: an initiate media creation action has already been received for this SOP Instance
0xC221- The Referenced Fraction Group Number does not exist in the referenced plan
0xC222- No beams exist within the referenced fraction group
0xC223- SCU already verifying and cannot currently process this request
0xC227- No such object instance - Referenced RT Plan not found
0xC309- The provided value of UPS State was not ‘SCHEDULED’
0xC616- There is an existing Film Box that has not been printed and N-ACTION at the Film Session level is not supported. A new Film Box will not be created when a previous Film Box has not been printed
0xB300- THE UPS was created with modifications
0xB600- Memory allocation not supported
0xB605- Requested Min Density or Max Density outside of printer’s operating range. The printer will use its respective minimum or maximum density value instead
event (events.Event) –
The event representing a service class receiving a N-CREATE request message.
context: the presentation context the request was sent under as a
request: the received
attribute_list: the decoded
Datasetcontained within the N-CREATE request’s Attribute List parameter. Because pydicom uses a deferred read when decoding data, if the decode fails the returned
Datasetwill only raise an exception at the time of use.
args – If the handler was bound to the event using
bind(event, handler, args)or by passing
evt_handlers=[(event, handler, args), ...], where args is a
listthen there will be one or more optional extra parameters matching the contents of args.
status (pydicom.dataset.Dataset or int) – The status returned to the peer AE in the N-CREATE response. Must be a valid N-CREATE status value for the applicable Service Class as either an
Datasetobject containing (at a minimum) a (0000,0900) Status element. If returning a
Datasetobject 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
Datasetcontaining elements of the response’s Attribute List conformant to the specifications in the corresponding Service Class.
If the status category is not ‘Success’ or ‘Warning’ then
NotImplementedError – If the handler has not been implemented and bound to
evt.EVT_N_CREATEby the user.