This class encapsulates data structures and operations for connecting to a file-based data source in the framework of the DICOM basic worklist management service.
More...
|
OFBool | SetReadlock () |
| This function sets a read lock on the LOCKFILE in the directory that is specified through dfPath and calledApplicationEntityTitle. More...
|
|
OFBool | ReleaseReadlock () |
| This function releases a read lock on the LOCKFILE in the given directory. More...
|
|
void | HandleNonSequenceElementInResultDataset (DcmElement *element, unsigned long idx) |
| This function takes care of handling a certain non-sequence element whithin the structure of a certain result dataset. More...
|
|
void | HandleSequenceElementInResultDataset (DcmElement *element, unsigned long idx) |
| This function takes care of handling a certain sequence element within the structure of a certain result dataset. More...
|
|
| WlmDataSourceFileSystem (const WlmDataSourceFileSystem &Src) |
| Protected undefined copy-constructor. More...
|
|
WlmDataSourceFileSystem & | operator= (const WlmDataSourceFileSystem &Src) |
| Protected undefined operator=. More...
|
|
OFBool | CheckSearchMask (DcmDataset *searchMask) |
| This function checks if the search mask has a correct format. More...
|
|
void | CheckNonSequenceElementInSearchMask (DcmDataset *searchMask, int &invalidMatchingKeyAttributeCount, DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL) |
| This function checks if a non-sequence element in the search mask has a correct format. More...
|
|
void | CheckSequenceElementInSearchMask (DcmDataset *searchMask, int &invalidMatchingKeyAttributeCount, DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL) |
| This function checks if a sequence element in the search mask has a correct format. More...
|
|
void | ExpandEmptySequenceInSearchMask (DcmElement *&element) |
| According to the 2001 DICOM standard (part 4, section C.2.2.2.6), if a search mask contains a sequence attribute which contains no item or a single empty item, all attributes from that particular sequence are in fact queried and shall be returned by the SCP. More...
|
|
OFBool | IsSupportedMatchingKeyAttribute (DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL) |
| This function checks if the given element refers to an attribute which is a supported matching key attribute. More...
|
|
OFBool | IsSupportedReturnKeyAttribute (DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL) |
| This function checks if the given element refers to an attribute which is a supported return key attribute. More...
|
|
void | ClearDataset (DcmDataset *idents) |
| This function removes all elements from the given DcmDataset object. More...
|
|
void | PutOffendingElements (const DcmTagKey &tag) |
| This function inserts the tag of an offending element into the corresponding member variable, unless this tag is already con- tained in this variable. More...
|
|
void | PutErrorElements (const DcmTagKey &tag) |
| This function inserts the tag of an error element into the corresponding member variable, without checking if it is already contained in this variable. More...
|
|
OFBool | CheckMatchingKey (const DcmElement *elem) |
| This function checks if the passed matching key's value only uses characters which are part of its data type's character repertoire. More...
|
|
OFBool | ContainsOnlyValidCharacters (const char *s, const char *charset) |
| This function returns OFTrue if all the characters of s can be found in the string charset. More...
|
|
OFBool | GetStringValue (const DcmElement *elem, OFString &resultVal) |
| This function returns the value of the given DICOM string element (attribute) in the parameter resultVal and returns OFTrue if successful. More...
|
|
OFString | DeleteLeadingAndTrailingBlanks (const OFString &value) |
| This function makes a copy of value without leading and trailing blanks. More...
|
|
| WlmDataSource (const WlmDataSource &Src) |
| Protected undefined copy-constructor. More...
|
|
WlmDataSource & | operator= (const WlmDataSource &Src) |
| Protected undefined operator=. More...
|
|
This class encapsulates data structures and operations for connecting to a file-based data source in the framework of the DICOM basic worklist management service.
void WlmDataSourceFileSystem::HandleExistentButEmptyDescriptionAndCodeSequenceAttributes |
( |
DcmItem * |
dataset, |
|
|
const DcmTagKey & |
descriptionTagKey, |
|
|
const DcmTagKey & |
codeSequenceTagKey |
|
) |
| |
This function performs a check on two attributes in the given dataset.
At two different places in the definition of the DICOM worklist management service, a description attribute and a code sequence attribute with a return type of 1C are mentioned, and the condition specifies that either the description attribute or the code sequence attribute or both shall be supported by an SCP. (I am talking about RequestedProcedureDescription vs. RequestedProcedureCodeSequence and ScheduledProcedureStepDescription vs. ScheduledProtocolCodeSequence.) In both cases, this implementation actually supports both, the description and the code sequence attributes. In cases where the description attribute is actually empty or the code sequence attribute is actually empty or contains exactly one item with an empty CodeValue and an empty CodingSchemeDesignator, we want to remove the empty attribute from the dataset. This is what this function does. (Please note, that this function will always only delete one of the two, and this function will start checking the sequence attribute.
- Parameters
-
dataset | Dataset in which the consistency of the two attributes shall be checked. |
descriptionTagKey | DcmTagKey of the description attribute which shall be checked. |
codeSequenceTagKey | DcmTagKey of the codeSequence attribute which shall be checked. |
void WlmDataSourceFileSystem::HandleExistentButEmptyReferencedStudyOrPatientSequenceAttributes |
( |
DcmDataset * |
dataset, |
|
|
const DcmTagKey & |
sequenceTagKey |
|
) |
| |
This function performs a check on a sequence attribute in the given dataset.
At two different places in the definition of the DICOM worklist management service, a sequence attribute with a return type of 2 is mentioned containing two 1C attributes in its item; the condition of the two 1C attributes specifies that in case a sequence item is present, then these two attributes must be existent and must contain a value. (I am talking about ReferencedStudySequence and ReferencedPatientSequence.) In cases where the sequence attribute contains exactly one item with an empty ReferencedSOPClass and an empty ReferencedSOPInstance, we want to remove the item from the sequence. This is what this function does.
- Parameters
-
dataset | Dataset in which the consistency of the sequence attribute shall be checked. |
sequenceTagKey | DcmTagKey of the sequence attribute which shall be checked. |
This function will return the next dataset that matches the given search mask, if there is one more resulting dataset to return.
In such a case, rstatus will be set to WLM_PENDING or WLM_PENDING_WARNING, depending on if an unsupported key attribute was encountered in the search mask or not. If there are no more datasets that match the search mask, this function will return an empty dataset and WLM_SUCCESS in rstatus.
- Parameters
-
rStatus | A value of type WlmDataSourceStatusType that can be used to decide if there are still elements that have to be returned. |
- Returns
- The next dataset that matches the given search mask, or an empty dataset if there are no more matching datasets in the worklist database files.
Implements WlmDataSource.
Based on the search mask which was passed, this function determines all the records in the worklist database files which match the values of matching key attributes in the search mask.
For each matching record, a DcmDataset structure is generated which will later be returned to the SCU as a result of query. The DcmDataset structures for all matching records will be stored in the protected member variable matchingDatasets.
- Parameters
-
findRequestIdentifiers | Contains the search mask. |
- Returns
- A WlmDataSourceStatusType value denoting the following: WLM_SUCCESS: No matching records found; WLM_PENDING: Matching records found, all return keys supported by this application; WLM_PENDING_WARNING: Matching records found, not all return keys supported by this application; WLM_FAILED_IDENTIFIER_DOES_NOT_MATCH_SOP_CLASS: Error in the search mask encountered.
Implements WlmDataSource.