WlmFileSystemInteractionManager Class Reference

This class encapsulates data structures and operations for managing data base interaction in the framework of the DICOM basic worklist management service. More...

List of all members.

Public Member Functions

 WlmFileSystemInteractionManager ()
 default constructor.
 ~WlmFileSystemInteractionManager ()
 destructor
void SetEnableRejectionOfIncompleteWlFiles (OFBool value)
 Set value in member variable.
OFCondition ConnectToFileSystem (const OFString &dfPathv)
 Connects to the worklist file system database.
OFCondition DisconnectFromFileSystem ()
 Disconnects from the worklist file system database.
OFBool IsCalledApplicationEntityTitleSupported (const OFString &calledApplicationEntityTitlev)
 Checks if the given called application entity title is supported.
unsigned long DetermineMatchingRecords (DcmDataset *searchMask)
 This function determines the records from the worklist files which match the given search mask and returns the number of matching records.
unsigned long GetNumberOfSequenceItemsForMatchingRecord (DcmTagKey sequenceTag, WlmSuperiorSequenceInfoType *superiorSequenceArray, unsigned long numOfSuperiorSequences, unsigned long idx)
 For the matching record that is identified through idx, this function returns the number of items that are contained in the sequence element that is referred to by sequenceTag.
void GetAttributeValueForMatchingRecord (DcmTagKey tag, WlmSuperiorSequenceInfoType *superiorSequenceArray, unsigned long numOfSuperiorSequences, unsigned long idx, char *&value)
 This function determines an attribute value of a matching record and returns this value in a newly created string to the caller.
void ClearMatchingRecords ()
 This function frees the memory which was occupied by matchingRecords.

Protected Member Functions

void DetermineWorklistFiles (OFOrderedSet< OFString > &worklistFiles)
 This function determines all worklist files in the directory specified by dfPath and calledApplicationEntityTitle, and returns the complete path and filename information in an array of strings.
OFBool IsWorklistFile (const char *fname)
 This function returns OFTrue if the given filename refers to a worklist file, i.e.
OFBool DatasetIsComplete (DcmDataset *dataset)
 This function checks if the given dataset (which represents the information from a worklist file) contains all necessary return type 1 information.
OFBool ReferencedStudyOrPatientSequenceIsAbsentOrExistentButNonEmptyAndIncomplete (DcmTagKey sequenceTagKey, DcmItem *dset)
 This function checks if the specified sequence attribute is absent or existent but non-empty and incomplete in the given dataset.
OFBool DescriptionAndCodeSequenceAttributesAreIncomplete (DcmTagKey descriptionTagKey, DcmTagKey codeSequenceTagKey, DcmItem *dset)
 This function checks if the specified description and code sequence attribute are both incomplete in the given dataset.
OFBool AttributeIsAbsentOrEmpty (DcmTagKey elemTagKey, DcmItem *dset)
 This function checks if the specified attribute is absent or contains an empty value in the given dataset.
OFBool DatasetMatchesSearchMask (DcmDataset *dataset, DcmDataset *searchMask)
 This function returns OFTrue, if the matching key attribute values in the dataset match the matching key attribute values in the search mask.
void DetermineMatchingKeyAttributeValues (DcmDataset *dataset, const char **&matchingKeyAttrValues)
 This function determines the values of the matching key attributes in the given dataset.
OFBool ScheduledStationAETitlesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute scheduled station AE title match; otherwise OFFalse will be returned.
OFBool ScheduledProcedureStepStartDateTimesMatch (const char *datasetDateValue, const char *datasetTimeValue, const char *searchMaskDateValue, const char *searchMaskTimeValue)
 This function returns OFTrue if the dataset's and the search mask's values in attributes scheduled procedure step start date and scheduled procedure step start time match; otherwise OFFalse will be returned.
OFBool ModalitiesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute modality match; otherwise OFFalse will be returned.
OFBool ScheduledPerformingPhysicianNamesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute scheduled performing physician's names match; otherwise OFFalse will be returned.
OFBool PatientsNamesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute patient's names match; otherwise OFFalse will be returned.
OFBool PatientsIDsMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute patient id match; otherwise OFFalse will be returned.
OFBool AccessionNumbersMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute accession number match; otherwise OFFalse will be returned.
OFBool RequestedProcedureIdsMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute requested procedure id match; otherwise OFFalse will be returned.
OFBool ReferringPhysicianNamesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute referring physician's name match; otherwise OFFalse will be returned.
OFBool PatientsSexesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute patient sex match; otherwise OFFalse will be returned.
OFBool RequestingPhysiciansMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute requesting physician match; otherwise OFFalse will be returned.
OFBool AdmissionIdsMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute admission id match; otherwise OFFalse will be returned.
OFBool RequestedProcedurePrioritiesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute requested procedure priorities match; otherwise OFFalse will be returned.
OFBool PatientsBirthDatesMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values in attribute patient's birth date match; otherwise OFFalse will be returned.
OFBool DateTimeRangeMatch (const char *datasetDateValue, const char *datasetTimeValue, const char *searchMaskDateValue, const char *searchMaskTimeValue)
 This function performs a date time range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool DateRangeMatch (const char *datasetDateValue, const char *searchMaskDateValue)
 This function performs a date range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool TimeRangeMatch (const char *datasetTimeValue, const char *searchMaskTimeValue)
 This function performs a time range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool DateTimeSingleValueMatch (const char *datasetDateValue, const char *datasetTimeValue, const char *searchMaskDateValue, const char *searchMaskTimeValue)
 This function performs a date time single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool DateSingleValueMatch (const char *datasetDateValue, const char *searchMaskDateValue)
 This function performs a date single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool TimeSingleValueMatch (const char *datasetTimeValue, const char *searchMaskTimeValue)
 This function performs a time single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.
OFBool CaseSensitiveSingleValueMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values match while performing a case sensitive single value match; otherwise OFFalse will be returned.
OFBool WildcardMatch (const char *datasetValue, const char *searchMaskValue)
 This function returns OFTrue if the dataset's and the search mask's values match while performing a wildcard match; otherwise OFFalse will be returned.
OFBool MatchStarSymbol (const char *dv, const char *sv)
 This function is called, if the search pattern contains a star symbol.
void ExtractValuesFromRange (const char *range, char *&lower, char *&upper)
 This function extracts the actual lower and upper date or time values from a given date or time range.

Protected Attributes

OFString dfPath
 path to database files
OFBool enableRejectionOfIncompleteWlFiles
 indicates if wl-files which are lacking return type 1 attributes or information in such attributes shall be rejected or not
OFString calledApplicationEntityTitle
 called AE title
DcmDataset ** matchingRecords
 array of matching records
unsigned long numOfMatchingRecords
 number of array fields

Private Member Functions

 WlmFileSystemInteractionManager (const WlmFileSystemInteractionManager &old)
 Privately defined copy constructor.
WlmFileSystemInteractionManageroperator= (const WlmFileSystemInteractionManager &obj)
 Privately defined assignment operator.


Detailed Description

This class encapsulates data structures and operations for managing data base interaction in the framework of the DICOM basic worklist management service.

Definition at line 48 of file wlfsim.h.


Constructor & Destructor Documentation

WlmFileSystemInteractionManager::WlmFileSystemInteractionManager ( const WlmFileSystemInteractionManager old  )  [private]

Privately defined copy constructor.

Parameters:
old Object which shall be copied.


Member Function Documentation

WlmFileSystemInteractionManager& WlmFileSystemInteractionManager::operator= ( const WlmFileSystemInteractionManager obj  )  [private]

Privately defined assignment operator.

Parameters:
obj Object which shall be copied.

void WlmFileSystemInteractionManager::DetermineWorklistFiles ( OFOrderedSet< OFString > &  worklistFiles  )  [protected]

This function determines all worklist files in the directory specified by dfPath and calledApplicationEntityTitle, and returns the complete path and filename information in an array of strings.

Parameters:
worklistFiles Set of strings, each specifying path and filename to one worklist file.

OFBool WlmFileSystemInteractionManager::IsWorklistFile ( const char *  fname  )  [protected]

This function returns OFTrue if the given filename refers to a worklist file, i.e.

has an extension of ".wl".

Parameters:
fname The name of the file.
Returns:
OFTrue in case the given filename refers to a worklist file, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DatasetIsComplete ( DcmDataset dataset  )  [protected]

This function checks if the given dataset (which represents the information from a worklist file) contains all necessary return type 1 information.

According to the DICOM standard part 4 annex K, the following attributes are type 1 attributes in C-Find RSP messages: Attribute Tag Return Key Type SpecificCharacterSet (0008,0005) 1C (will be checked in WlmDataSourceFileSystem::StartFindRequest(...); this attribute does not have to be checked here) ScheduledProcedureStepSequence (0040,0100) 1 > ScheduledStationAETitle (0040,0001) 1 > ScheduledProcedureStepStartDate (0040,0002) 1 > ScheduledProcedureStepStartTime (0040,0003) 1 > Modality (0008,0060) 1 > ScheduledProcedureStepDescription (0040,0007) 1C (The ScheduledProcedureStepDescription (0040,0007) or the ScheduledProtocolCodeSequence (0040,0008) or both shall be supported by the SCP; we actually support both, so we have to check if at least one of the two attributes contains valid information.) > ScheduledProtocolCodeSequence (0040,0008) 1C (see abobve) > > CodeValue (0008,0100) 1 > > CodingSchemeDesignator (0008,0102) 1 > ScheduledProcedureStepID (0040,0009) 1 RequestedProcedureID (0040,1001) 1 RequestedProcedureDescription (0032,1060) 1C (The RequestedProcedureDescription (0032,1060) or the RequestedProcedureCodeSequence (0032,1064) or both shall be supported by the SCP; we actually support both, so we have to check if at least one of the two attributes contains valid information.) RequestedProcedureCodeSequence (0032,1064) 1C (see abobve) > > CodeValue (0008,0100) 1 > > CodingSchemeDesignator (0008,0102) 1 StudyInstanceUID (0020,000D) 1 ReferencedStudySequence (0008,1110) 2 > ReferencedSOPClassUID (0008,1150) 1C (Required if a sequence item is present) > ReferencedSOPInstanceUID (0008,1155) 1C (Required if a sequence item is present) ReferencedPatientSequence (0008,1120) 2 > ReferencedSOPClassUID (0008,1150) 1C (Required if a sequence item is present) > ReferencedSOPInstanceUID (0008,1155) 1C (Required if a sequence item is present) PatientName (0010,0010) 1 PatientID (0010,0020) 1

Parameters:
dataset - [in] The dataset of the worklist file which is currently examined.
Returns:
OFTrue in case the given dataset contains all necessary return type 1 information, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::ReferencedStudyOrPatientSequenceIsAbsentOrExistentButNonEmptyAndIncomplete ( DcmTagKey  sequenceTagKey,
DcmItem dset 
) [protected]

This function checks if the specified sequence attribute is absent or existent but non-empty and incomplete in the given dataset.

Parameters:
sequenceTagKey The sequence attribute which shall be checked.
dset The dataset in which the attribute is contained.
Returns:
OFTrue in case the sequence attribute is absent (and cannot be added to the dataset) or existent but non-empty and incomplete, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DescriptionAndCodeSequenceAttributesAreIncomplete ( DcmTagKey  descriptionTagKey,
DcmTagKey  codeSequenceTagKey,
DcmItem dset 
) [protected]

This function checks if the specified description and code sequence attribute are both incomplete in the given dataset.

Parameters:
descriptionTagKey The description attribute which shall be checked.
codeSequenceTagKey The codeSequence attribute which shall be checked.
dset The dataset in which the attributes are contained.
Returns:
OFTrue in case both attributes are incomplete, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::AttributeIsAbsentOrEmpty ( DcmTagKey  elemTagKey,
DcmItem dset 
) [protected]

This function checks if the specified attribute is absent or contains an empty value in the given dataset.

Parameters:
elemTagKey The attribute which shall be checked.
dset The dataset in which the attribute is contained.
Returns:
OFTrue in case the attribute is absent or contains an empty value, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DatasetMatchesSearchMask ( DcmDataset dataset,
DcmDataset searchMask 
) [protected]

This function returns OFTrue, if the matching key attribute values in the dataset match the matching key attribute values in the search mask.

Parameters:
dataset The dataset which shall be checked.
searchMask The search mask.
Returns:
OFTrue in case the dataset matches the search mask in the matching key attribute values, OFFalse otherwise.

void WlmFileSystemInteractionManager::DetermineMatchingKeyAttributeValues ( DcmDataset dataset,
const char **&  matchingKeyAttrValues 
) [protected]

This function determines the values of the matching key attributes in the given dataset.

Parameters:
dataset Dataset from which the values shall be extracted.
matchingKeyAttrValues Contains in the end the values of the matching key attributes in the search mask. Is an array of pointers.

OFBool WlmFileSystemInteractionManager::ScheduledStationAETitlesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute scheduled station AE title match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::ScheduledProcedureStepStartDateTimesMatch ( const char *  datasetDateValue,
const char *  datasetTimeValue,
const char *  searchMaskDateValue,
const char *  searchMaskTimeValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attributes scheduled procedure step start date and scheduled procedure step start time match; otherwise OFFalse will be returned.

Parameters:
datasetDateValue Value for the corresponding attribute in the dataset; might be NULL.
datasetTimeValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskDateValue Value for the corresponding attribute in the search mask; might be NULL.
searchMaskTimeValue Value for the corresponding attribute in the search mask; might be NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::ModalitiesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute modality match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::ScheduledPerformingPhysicianNamesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute scheduled performing physician's names match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::PatientsNamesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute patient's names match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::PatientsIDsMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute patient id match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::AccessionNumbersMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute accession number match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::RequestedProcedureIdsMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute requested procedure id match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::ReferringPhysicianNamesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute referring physician's name match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::PatientsSexesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute patient sex match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::RequestingPhysiciansMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute requesting physician match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::AdmissionIdsMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute admission id match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::RequestedProcedurePrioritiesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute requested procedure priorities match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::PatientsBirthDatesMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values in attribute patient's birth date match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DateTimeRangeMatch ( const char *  datasetDateValue,
const char *  datasetTimeValue,
const char *  searchMaskDateValue,
const char *  searchMaskTimeValue 
) [protected]

This function performs a date time range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetDateValue Value for the corresponding attribute in the dataset; might be NULL.
datasetTimeValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskDateValue Value for the corresponding attribute in the search mask; never NULL.
searchMaskTimeValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DateRangeMatch ( const char *  datasetDateValue,
const char *  searchMaskDateValue 
) [protected]

This function performs a date range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetDateValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskDateValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::TimeRangeMatch ( const char *  datasetTimeValue,
const char *  searchMaskTimeValue 
) [protected]

This function performs a time range match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetTimeValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskTimeValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DateTimeSingleValueMatch ( const char *  datasetDateValue,
const char *  datasetTimeValue,
const char *  searchMaskDateValue,
const char *  searchMaskTimeValue 
) [protected]

This function performs a date time single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetDateValue Value for the corresponding attribute in the dataset; might be NULL.
datasetTimeValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskDateValue Value for the corresponding attribute in the search mask; never NULL.
searchMaskTimeValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::DateSingleValueMatch ( const char *  datasetDateValue,
const char *  searchMaskDateValue 
) [protected]

This function performs a date single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetDateValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskDateValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::TimeSingleValueMatch ( const char *  datasetTimeValue,
const char *  searchMaskTimeValue 
) [protected]

This function performs a time single value match and returns OFTrue if the dataset's and the search mask's values in the corresponding attributes match; otherwise OFFalse will be returned.

Parameters:
datasetTimeValue Value for the corresponding attribute in the dataset; might be NULL.
searchMaskTimeValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::CaseSensitiveSingleValueMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values match while performing a case sensitive single value match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; never NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::WildcardMatch ( const char *  datasetValue,
const char *  searchMaskValue 
) [protected]

This function returns OFTrue if the dataset's and the search mask's values match while performing a wildcard match; otherwise OFFalse will be returned.

Parameters:
datasetValue Value for the corresponding attribute in the dataset; never NULL.
searchMaskValue Value for the corresponding attribute in the search mask; never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

OFBool WlmFileSystemInteractionManager::MatchStarSymbol ( const char *  dv,
const char *  sv 
) [protected]

This function is called, if the search pattern contains a star symbol.

It determines if dv (the dataset's value) still matches sv (the search mask's value). This function takes the star symbol in sv into account. (Note that the pattern value might contain more wild card symbols.) The function will return OFTrue if there is a match; if there is not a match it will return OFFalse.

Parameters:
dv Dataset's value; never NULL.
sv Search mask's value (may contain wild card symbols); never NULL.
Returns:
OFTrue if the values match, OFFalse otherwise.

void WlmFileSystemInteractionManager::ExtractValuesFromRange ( const char *  range,
char *&  lower,
char *&  upper 
) [protected]

This function extracts the actual lower and upper date or time values from a given date or time range.

Parameters:
range Date or time range from which lower and upper values shall be extracted.
lower Newly created string specifying the lower value from the date/time range; NULL if value is not specified in range.
upper Newly created string specifying the upper value from the date/time range; NULL if value is not specified in range.

void WlmFileSystemInteractionManager::SetEnableRejectionOfIncompleteWlFiles ( OFBool  value  ) 

Set value in member variable.

Parameters:
value The value to set.

OFCondition WlmFileSystemInteractionManager::ConnectToFileSystem ( const OFString dfPathv  ) 

Connects to the worklist file system database.

Parameters:
dfPathv Path to worklist file system database.
Returns:
Indicates if the connection could be established or not.

OFCondition WlmFileSystemInteractionManager::DisconnectFromFileSystem (  ) 

Disconnects from the worklist file system database.

Returns:
Indicates if the connection was disconnected successfully.

OFBool WlmFileSystemInteractionManager::IsCalledApplicationEntityTitleSupported ( const OFString calledApplicationEntityTitlev  ) 

Checks if the given called application entity title is supported.

If this is the case, OFTrue will be returned, else OFFalse.

Parameters:
calledApplicationEntityTitlev The application entity title which shall be checked for support. Valid pointer expected.
Returns:
OFTrue, if the called application entity title is supported, OFFalse, if the called application entity title is not supported or it is not given.

unsigned long WlmFileSystemInteractionManager::DetermineMatchingRecords ( DcmDataset searchMask  ) 

This function determines the records from the worklist files which match the given search mask and returns the number of matching records.

Also, this function will store the matching records in memory in the array member variable matchingRecords.

Parameters:
searchMask - [in] The search mask.
Returns:
Number of matching records.

unsigned long WlmFileSystemInteractionManager::GetNumberOfSequenceItemsForMatchingRecord ( DcmTagKey  sequenceTag,
WlmSuperiorSequenceInfoType superiorSequenceArray,
unsigned long  numOfSuperiorSequences,
unsigned long  idx 
)

For the matching record that is identified through idx, this function returns the number of items that are contained in the sequence element that is referred to by sequenceTag.

In case this sequence element is itself contained in a certain item of another superior sequence, superiorSequenceArray contains information about where to find the correct sequence element.

Parameters:
sequenceTag The tag of the sequence element for which the number of items shall be determined.
superiorSequenceArray Array which contains information about superior sequence elements the given sequence element is contained in.
numOfSuperiorSequences The number of elements in the above array.
idx Identifies the record from which the number of sequence items shall be determined.
Returns:
The number of items that are contained in the sequence element that is referred to by sequenceTag and that can be found in sequence items which are specified in superiorSequenceArray.

void WlmFileSystemInteractionManager::GetAttributeValueForMatchingRecord ( DcmTagKey  tag,
WlmSuperiorSequenceInfoType superiorSequenceArray,
unsigned long  numOfSuperiorSequences,
unsigned long  idx,
char *&  value 
)

This function determines an attribute value of a matching record and returns this value in a newly created string to the caller.

Parameters:
tag Attribute tag. Specifies which attribute's value shall be returned.
superiorSequenceArray Array which contains information about superior sequence elements the given element is contained in.
numOfSuperiorSequences The number of elements in the above array.
idx Identifies the record from which the attribute value shall be retrieved.
value Pointer to a newly created string that contains the requested value. If value was not found an emtpy string will be returned.

void WlmFileSystemInteractionManager::ClearMatchingRecords (  ) 

This function frees the memory which was occupied by matchingRecords.

It shall be called when the matching records are no longer needed.


The documentation for this class was generated from the following file:


Generated on 6 Jan 2011 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.5.1