qie.postDICOMRequest¶
Signature: qie.postDICOMRequest(request, connection*, channel*, callingAET*)
Returns: Integer responseToken - the response token to use when calling getResponseToDICOMRequest(...)
Posts a DICOM request to the original message sender OR DICOM connection.
Note
This method can only be called from a channel that uses a DICOM listener OR it must specify another channel that uses a DICOM Listener.
Note
The request message object will be updated with the Message ID (0000,0110) and Command Data Set Type (0000,0800) values that are actually used.
Note
See this KB article for additional information about posting DICOM Requests.
Note
connection is optional. When not specified, {original sender} sends the request back over the association the current message arrived on, instead of opening a new one.
Note
channel is optional. When not specified, {current channel} sends the request, so the channel running this script needs a DICOM listener.
Note
callingAET is optional. When not specified, {channel AET} is the AE title of the DICOM listener that sends the request.
Parameters¶
| Type | Name | Description | Default |
|---|---|---|---|
| DICOM Message | request | the DICOM request message object to send | |
| String | connection* | (optional) the DICOM Connection name to send the request to | {original sender} |
| String | channel* | (optional) the name of the channel that should send the request | {current channel} |
| String | callingAET* | (optional) override the callingAET to use in this request | {channel AET} |
Example¶
// Create a DICOM C-FIND request
var cFindRequest = qie.createCFindRQCommand(
"1.2.840.10008.5.1.4.1.2.2.1", // Study Root Query/Retrieve Information Model – FIND
0 // priority (0 = medium)
);
cFindRequest.setNode("/0008,0052", "STUDY");
cFindRequest.setNode("/0010,0010", "Robert*");
// Post the request to a configured DICOM connection
var token = qie.postDICOMRequest(
cFindRequest,
"PACS Archive" // DICOM connection name
); // response token