pynetdicom._handlers.doc_handle_create#
- pynetdicom._handlers.doc_handle_create(event: Event, *args: Sequence[Any]) tuple[int | Dataset, Dataset | None] [source]#
Documentation for handlers bound to
evt.EVT_N_CREATE
.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_CREATE
then the N-CREATE request will be responded to using a Status value of0x0110
- Processing Failure.Management of the SOP Instances created in response to an N-CREATE request is the responsibility of the user.
Event
evt.EVT_N_CREATE
Supported Service Classes
Status
- Success
0x0000
- Success- Failure
0x0105
- No such attribute0x0106
- Invalid attribute value0x0107
- Attribute list error0x0110
- Processing failure0x0111
- Duplicate SOP Instance0x0116
- Attribute value out of range0x0117
- Invalid object instance0x0118
- No such SOP Class0x0120
- Missing attribute0x0121
- Missing attribute value0x0124
- Refused: not authorised0x0210
- Duplicate invocation0x0211
- Unrecognised operation0x0212
- Mistyped argument0x0213
- Resource limitation0xA510
- Failed: an initiate media creation action has already been received for this SOP Instance0xC221
- The Referenced Fraction Group Number does not exist in the referenced plan0xC222
- No beams exist within the referenced fraction group0xC223
- SCU already verifying and cannot currently process this request0xC227
- No such object instance - Referenced RT Plan not found0xC309
- 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- Warning
0xB300
- THE UPS was created with modifications0xB600
- Memory allocation not supported0xB605
- Requested Min Density or Max Density outside of printer’s operating range. The printer will use its respective minimum or maximum density value instead
- Parameters:
event (events.Event) –
The event representing a service class receiving a N-CREATE request message.
Event
attributes are:assoc
: theAssociation
that is running the service that received the N-CREATE request.context
: the presentation context the request was sent under as aPresentationContextTuple
.event
: the event that occurred asInterventionEvent
.request
: the receivedN-CREATE request
timestamp
: the date and time that the N-CREATE request was processed by the service asdatetime.datetime
.
Event
properties are:attribute_list
: the decodedDataset
contained within the N-CREATE request’s Attribute List parameter. Because pydicom uses a deferred read when decoding data, if the decode fails the returnedDataset
will only raise an exception at the time of use.message_id
: the N-CREATE request’s Message ID asint
.
args – If the handler was bound to the event using
bind(event, handler, args)
or by passingevt_handlers=[(event, handler, args), ...]
, where args is alist
then there will be one or more optional extra parameters matching the contents of args.
- Returns:
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
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 of the response’s Attribute List conformant to the specifications in the corresponding Service Class.If the N-CREATE-RQ doesn’t include a value for Affected SOP Instance UID and the status is 0x0000 (Success) then dataset should include an (0000,1000) Affected SOP Instance UID element (see Part 7, Section 10.1.5.1.4 of the DICOM Standard). The element value will be used to set the corresponding N-ACTION-RSP parameter value but will be removed from the Attribute List dataset prior to sending.
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_CREATE
by the user.
See also
send_n_create()
,N_CREATE
,InstanceAvailabilityNotificationServiceClass
,MediaCreationManagementServiceClass
,PrintManagementServiceClass
,ProcedureStepServiceClass
,RTMachineVerificationServiceClass
,UnifiedProcedureStepServiceClass
References