wlds.h

/*
 *
 *  Copyright (C) 1996-2004, OFFIS
 *
 *  This software and supporting documentation were developed by
 *
 *    Kuratorium OFFIS e.V.
 *    Healthcare Information and Communication Systems
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *  THIS SOFTWARE IS MADE AVAILABLE,  AS IS,  AND OFFIS MAKES NO  WARRANTY
 *  REGARDING  THE  SOFTWARE,  ITS  PERFORMANCE,  ITS  MERCHANTABILITY  OR
 *  FITNESS FOR ANY PARTICULAR USE, FREEDOM FROM ANY COMPUTER DISEASES  OR
 *  ITS CONFORMITY TO ANY SPECIFICATION. THE ENTIRE RISK AS TO QUALITY AND
 *  PERFORMANCE OF THE SOFTWARE IS WITH THE USER.
 *
 *  Module:  dcmwlm
 *
 *  Author:  Thomas Wilkens
 *
 *  Purpose: (Partially) abstract class for connecting to an arbitrary data source.
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2004/04/06 18:19:28 $
 *  Source File:      $Source: /share/dicom/cvs-depot/dcmtk/dcmwlm/include/wlds.h,v $
 *  CVS/RCS Revision: $Revision: 1.20 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */

#ifndef WlmDataSource_h
#define WlmDataSource_h

#include "osconfig.h"

class DcmDataset;
class DcmList;
class DcmAttributeTag;
class DcmLongString;
class DcmTagKey;
class DcmElement;
class OFConsole;
class OFCondition;
class DcmSequenceOfItems;

class WlmDataSource
{
  protected:
    OFBool failOnInvalidQuery;
    char *calledApplicationEntityTitle;
    OFBool verbose;
    OFBool debug;
    DcmDataset *identifiers;
    DcmAttributeTag *errorElements;
    DcmAttributeTag *offendingElements;
    DcmLongString *errorComment;
    OFBool foundUnsupportedOptionalKey;
    OFBool readLockSetOnDataSource;
    OFConsole *logStream;
    OFBool noSequenceExpansion;
    WlmReturnedCharacterSetType returnedCharacterSet;
    DcmDataset **matchingDatasets;
    unsigned long numOfMatchingDatasets;
    OFString specificCharacterSet;
    WlmSuperiorSequenceInfoType *superiorSequenceArray;
    unsigned long numOfSuperiorSequences;

    OFBool CheckSearchMask( DcmDataset *searchMask );

    void CheckNonSequenceElementInSearchMask( DcmDataset *searchMask, int &invalidMatchingKeyAttributeCount, DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL );

    void CheckSequenceElementInSearchMask( DcmDataset *searchMask, int &invalidMatchingKeyAttributeCount, DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL );

    void ExpandEmptySequenceInSearchMask( DcmElement *&element );

    OFBool IsSupportedMatchingKeyAttribute( DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL );

    OFBool IsSupportedReturnKeyAttribute( DcmElement *element, DcmSequenceOfItems *supSequenceElement=NULL );

    void ClearDataset( DcmDataset *idents );

    void PutOffendingElements( DcmTagKey &tag );

    void PutErrorElements( DcmTagKey &tag );

    OFBool CheckMatchingKey( DcmElement *elem );

    OFBool ContainsOnlyValidCharacters( const char *s, const char *charset );

    OFBool IsValidDateOrDateRange( const char *value );

    OFBool IsValidDate( const char *value );

    OFBool IsValidTimeOrTimeRange( const char *value );

    OFBool IsValidTime( const char *value );

    char *GetStringValue( DcmElement *elem );

    void DumpMessage( const char *message );

    char *DeleteLeadingAndTrailingBlanks( const char *value );

    WlmDataSource( const WlmDataSource &Src );

    WlmDataSource &operator=( const WlmDataSource &Src );


  public:
    WlmDataSource();

    virtual ~WlmDataSource();

    virtual OFCondition ConnectToDataSource() = 0;

    virtual OFCondition DisconnectFromDataSource() = 0;

    void SetCalledApplicationEntityTitle( char *value );

    void SetFailOnInvalidQuery( OFBool value );

    void SetLogStream( OFConsole *value );

    void SetVerbose( OFBool value );

    void SetDebug( OFBool value );

    void SetNoSequenceExpansion( OFBool value );

    void SetReturnedCharacterSet( WlmReturnedCharacterSetType value );

    virtual OFBool IsCalledApplicationEntityTitleSupported() = 0;

    virtual WlmDataSourceStatusType StartFindRequest( DcmDataset &findRequestIdentifiers ) = 0;

    virtual DcmDataset *NextFindResponse( WlmDataSourceStatusType &rStatus ) = 0;

    WlmDataSourceStatusType CancelFindRequest();

    DcmAttributeTag *GetOffendingElements();

    DcmLongString *GetErrorComments();

    virtual void SetDbDsn( const char * /*value*/ ) {}

    virtual void SetDbUserName( const char * /*value*/ ) {}

    virtual void SetDbUserPassword( const char * /*value*/ ) {}

    virtual void SetCfgFileMatchRecords( const char * /*value*/ ) {}

    virtual void SetCfgFileSelectValues( const char * /*value*/ ) {}

    virtual void SetDatabaseType( WlmDatabaseType /*value*/ ) {}

    virtual void SetSerialNumber( const int /*value*/ ) {}

    virtual void SetInstitutionId( const unsigned int /*value*/ ) {}

    virtual void SetDfPath( const char * /*value*/ ) {}

    virtual void SetCreateNullvalues( OFBool /*value*/ ) {}

    virtual void SetPfFileName( const char * /*value*/ ) {}

    virtual void SetModalityToReturn( const char * /*value*/ ) {}

    virtual void SetCommaSeparatePatientName( OFBool /*value*/ ) {}

    virtual void SetReturnPatientUidInAccessionNumber( OFBool /*value*/ ) {}
};

#endif

/*
** CVS Log
** $Log: wlds.h,v $
** Revision 1.20  2004/04/06 18:19:28  joergr
** Updated data dictionary, UIDs and transfer syntaxes for the latest Final Text
** Supplements (42 and 47) and Correction Proposals (CP 25).
**
** Revision 1.19  2004/01/15 12:01:24  wilkens
** Added function to Worklist Management Data Source Base Class. This function
** is needed in the private part of this toolkit.
**
** Revision 1.18  2004/01/07 09:52:18  wilkens
** Fixed typo in comment.
**
** Revision 1.17  2004/01/07 08:32:28  wilkens
** Added new sequence type return key attributes to wlmscpfs. Fixed bug that for
** equally named attributes in sequences always the same value will be returned.
** Added functionality that also more than one item will be returned in sequence
** type return key attributes.
**
** Revision 1.16  2004/01/02 13:56:14  wilkens
** Integrated new return key attributes into wlmscpfs and updated function that
** checks integrity of matching key attribute values (added support for new VR).
**
** Revision 1.15  2003/12/23 13:04:36  wilkens
** Integrated new matching key attributes into wlmscpfs.
**
** Revision 1.14  2003/12/11 10:45:33  wilkens
** Added function to Worklist Management Data Source Base Class. This function
** is needed in the private part of this toolkit.
**
** Revision 1.13  2003/08/21 13:38:23  wilkens
** Moved declaration and initialization of member variables matchingDatasets and
** numOfMatchingDatasets to base class.
** Got rid of superfluous member variable objlist and of superfluous function
** ClearObjList().
**
** Revision 1.12  2003/07/02 09:17:55  wilkens
** Updated documentation to get rid of doxygen warnings.
**
** Revision 1.11  2003/02/17 12:02:03  wilkens
** Made some minor modifications to be able to modify a special variant of the
** worklist SCP implementation (wlmscpki).
**
** Revision 1.10  2002/12/16 11:08:33  wilkens
** Added missing #include "osconfig.h" to certain files.
**
** Revision 1.9  2002/08/12 10:56:07  wilkens
** Made some modifications in in order to be able to create a new application
** which contains both wlmscpdb and ppsscpdb and another application which
** contains both wlmscpfs and ppsscpfs.
**
** Revision 1.8  2002/07/17 13:10:36  wilkens
** Corrected some minor logical errors in the wlmscpdb sources and completely
** updated the wlmscpfs so that it does not use the original wlistctn sources
** any more but standard wlm sources which are now used by all three variants
** of wlmscps.
**
** Revision 1.7  2002/07/01 14:13:56  wilkens
** Some more corrections to get rid of msvc6's warnings.
**
** Revision 1.6  2002/06/10 11:25:05  wilkens
** Made some corrections to keep gcc 2.95.3 quiet.
**
** Revision 1.5  2002/05/08 13:20:51  wilkens
** Added new command line option -nse to wlmscpki and wlmscpdb.
**
** Revision 1.4  2002/04/18 14:20:08  wilkens
** Modified Makefiles. Updated latest changes again. These are the latest
** sources. Added configure file.
**
** Revision 1.3  2002/01/08 17:45:34  joergr
** Reformatted source files (replaced Windows newlines by Unix ones, replaced
** tabulator characters by spaces, etc.)
**
** Revision 1.2  2002/01/08 16:50:12  joergr
** Added preliminary database support using OTL interface library (modified by
** MC/JR on 2001-12-21).
**
** Revision 1.1  2002/01/08 16:30:59  joergr
** Added new module "dcmwlm" developed by Thomas Wilkens (initial release for
** Windows, dated 2001-12-20).
**
**
*/

---

Generated on 8 Dec 2004 for OFFIS DCMTK Version 3.5.3 by Doxygen 1.3.9.1