***************************************************************
* eHealth Business Connector RELEASE NOTES *
***************************************************************
3.2.0 beta release
 . improvement    architecture changes                                    new IKVM version (7.4.4981 ehealth edition)
 . improvement                                                            generated DLL are stronged typed (needed for COM interface)
 . improvement                                                            no fat dll is generated but serveral dll easier for third parties to depends on the ehealth connector.
 . improvement                                                            refactoring generic sender in order to provide a more open and flexible implementation
 . upgrade                                                                new version of the technical connector (3.2.0_beta-1)
 . adding                                                                new business service ehbox v3
 . adding                                                                new business service therlink
 . adding                                                                new business service ws consent
 . bug-fix                                                                delete of some business checks
 . change                                                                 jaxb generation is done a bit different : some method names for lists have changed : now the name of the list property is plural : example getAdresses instead of getAdress
 . improvement                                                             removed Thread.currentThread().setContextClassLoader(getClass().getClassLoader()) : now this is done in a module configured in property file for .net implementations

3.1.0 beta release
 .improvement         kmehr version update to 1.5.1
 .improvement        added method deleteMessage to ehboxV2
 .improvement         business adaptations chapterIV :
                     .changed interface : reference parameters are now created with ChapterIVReference object 
                     .modification in genins : now works with the unified configuration file
 .bug-fix            fix for chapter IV: referenceParameters are now set to correct values 
 .bug-fix               fix for intrahub :invalid port for timestampAuthority 
 .improvement        business adaptations chapterIV:
                     . changed interface for builders and service : now extra parameter agreementStartDate is required , see javadoc 
                     . ResponseHandler is renamed to ResponseBuilder
                     . new return object : ChapterIVKmehrResponseWithTimeStampInfo : it contains the timestampResponse and the KmehrResponse , both as jaxb object and as byteArrays to be stored by the client
                     . added utility method FaultType retrieveReturnInfo(response) in ResponseBuilder : retrieves error after soa exception
                     . the methods to create the builderfactory have changed, see javadoc
 . added            Generic Insurability business connector: be.ehealth.businessconnector.genins
 . change            chapter IV: the FolderType is not changed anymore (no author info,... is put)
 . improvement        chapter IV validation for incoming XML is now optional
 . change            recipe: XSD validation for notifications is disabled
 . added            intrahub : new interface for WS calls IntrahubServiceComplete which will return the complete WS response object
 . improvement        ehboxv2: added possibility to specify Receipt elements from ContentSpecification part of sendMessageRequest through the builder
 
 3.0.0 beta release
 . improvement         architecture changes :
                    . business module business-gp is split in seperate modules for each business component
                    . removed specific property file for business connector
                    . new unified binding file that is used in every project
                    . using joda time (http://joda-time.sourceforge.net/) instead of java.util.Calendar to simplify date handling
 . added            chapterIV business module
 . improvement        be.ehealth.businessconnector.ehbox                                        migrating domain objects to separated package in order to better support new ehbox versions
 . improvement        be.eheealth.businessconnector.intrahub                                    service methods doesn't works with string as input and output but responds with an kmehr object. 
                                                                                              builders are provided to convert kmehr to string and string to kmehr in order to guarantee backwards compability.
 . improvement        integration new eHealth Technical connector (v3.0.0 beta)
                     . improvement    architecture changes                                    change object creation is now done with factories, and its possible to provide custom implementation ( which should implement the required interface )                                     .
                                                                                             remove XSD and WSDL as external dependency. 
                     . improvement     be.ehealth.technicalconnector.beid.*                    adding some helper classes to read the content of the eID (using Fedict commons-eid lib)
                    . improvement    be.ehealth.technicalconnector.config.*                    adding framework to validate if the required properties are present in the configuration file
                                                                                             adding the possibility to load on start up some configuration modules (see information in properties file for more info)
                     . improvement    be.ehealth.technicalconnector.exception.*                refactoring the way of creating exception (removed ExceptionFactory)
                     . adding        be.ehealth.technicalconnector.idgeneration.*            service that provides an unique id for the moment only an id based on DateTime is implemented.
                     . adding        be.ehealth.technicalconnector.service.sts.*                adding support for the STS SAML Sender-Vouches profile                 
                     . adding        be.ehealth.technicalconnector.service.sts.security.*    framework to work with eID based on the PKCS11 or PCSC technology (using Fedict commons-eid lib)                     
                     . adding        be.ehealth.technicalconnector.session.*                    framework for creating and maintaining a session
                     . adding         be.ehealth.technicalconnector.utils.DateUtils            Utility class to facilitate the use of joda time
                     . improvement    be.ehealth.technicalconnector.utils.IOUtils                  Utility class to facilitate the IO operations (some methods are added for the .NET support)
 
2.0.7 FINAL    release
 . bug-fix            be.ehealth.businessconnector.ehboxV2.builders.ConsultationBuilder        if unsealing of a message doesn't works: the exception in logged and thrown 
 . bug-fix
 . improvement        integration new eHealth Technical Connector (v2.0.7)
                     . bug-fix        be.ehealth.technicalconnector.security.EIDReader        remove nullpointer when no card is inserted
                    . bug-fix        be.ehealth.technicalconnector.utils.MarshallerHelper    adding property that default charset is UTF-8    
 
2.0.6 FINAL release
 . bug-fix            be.ehealth.businessconnector.ehboxV2.builders.ConsultationBuilder        changing the construction of the NewsMessage. Avoid null response for getTitle() and getContent()
 . improvement         be.ehealth.businessconnector.ehboxV2.builders.SendMessageBuilder         adding UTF-8 flag for every getBytes() and toString()
 . improvement        be.ehealth.businessconnector.ehboxV2.builders.ConsultationBuilder         adding UTF-8 flag for every getBytes() and toString()
 . KNOWN ISSUES/LIMITATIONS
     . SessionManagment.createSession only works on a 32-bit JVM (1.6.0 or higher). The 64-bit JVM doesn't contains sun.security.pkcs11.SunPKCS11 class.  

2.0.5 FINAL release
 . bug-fix          be.ehealth.businessconnector.ehboxV2.builders.SendMessageBuilder         remove nullpointer when no message doesn't contains freeText
 . bug-fix          be.ehealth.businessconnector.security.etk.EtkServiceImpl                adding support for searching an ETK based on the professional nihii number
 . improvement        be.ehealth.businessconnector.security.etk.ETKCacheManager                adding some debug logging
 . KNOWN ISSUES/LIMITATIONS
     . SessionManagment.createSession only works on a 32-bit JVM (1.6.0 or higher). The 64-bit JVM doesn't contains sun.security.pkcs11.SunPKCS11 class.
  
2.0.4 TEMP release
 . bug-fix             be.ehealth.businessconnector.ehboxV2.service.ServiceFactory                update configuration property to load ehboxv2 wsdl
 . KNOWN ISSUES/LIMITATIONS
     . SessionManagment.createSession only works on a 32-bit JVM (1.6.0 or higher). The 64-bit JVM doesn't contains sun.security.pkcs11.SunPKCS11 class.
 
2.0.3 TEMP release
 . bug-fix    HubReplyValidatorImpl    remove null pointer when AcknowledgeType doesn't have a description
 . bug-fix    AuthProviderFactory        update fully qualified name of AuthProviderAdaptor class
 
2.0.2 TEMP release
 . bug-fix  update configuration property to load ehboxv2 wsdl
 . bug-fix  remove reflection for error message translation (resolving ERROR - BUNDLE exception)
 . bug-fix     desactivating incoming message validation when message is encrypted
 . update     ehboxV2 wsdl/xsd in order to match Venetian Blind Design pattern (resolving JAXBContext security error)
 . update     SAM CIVICS WSDL/XSD to latest version
 . add        findCNK on CivicsService and SamCivicsService
 . add        runtime dependencies (XercesImpl and serializer)

2.0.1 FINAL release
 . bug-fix    remove policies from wsdl
 . bug-fix    remove unused imports in testclasses
      /!\  only the packaging is changed. The signed libraries are the same

2.0.0 FINAL release
 . adding outgoing message validation for business services (intrahub, ehbox v2, recipe and civics)
 . adding incoming message validation for business services (intrahub, ehbox v2, recipe and civics)
    The incoming message validation can be disabled by setting the corresponding property (validation.incoming.*.message) to false
    

2.0-beta3
 . adding proxy support through properties
 . adding logging support through properties
 . bug-fix generic sender (avoid NAMESPACE_ERR when root element contains namespace prefix)
 . bug-fix IntraHubTransactionService.getTransactionList(...)
     If the acknowledge doesn't contains any errors, an empty transactionlist may be recieved. In this case this method will return null.
 . bug-fix IntraHubTherapeuticLinkService.getTherapeuticLink(...)
     If the acknowledge doesn't contains any errors, an empty TherapeuticLink list may be recieved. In this case an empty list will be returned.
     

2.0-beta2
 . adding loadPersonalCertificate in the SessionManager in order to lead the personal certificate after session creation.

2.0-beta
 . Updated binding library
     /!\  It is not possible anymore to set a list directly by his direct setter. For example object.setList(List<?>)
          This is replaced by object.getList().addAll(List<?>)
 . Integrating the latest eHealth Technical Connector (v2.0-beta)
 . Integrating ehbox v2 (ehbox v1 is deprecated)
 . Removed the cache implementation in the ETKCachManager (see ETEE design specifications)
     For this reason ETKCacheManger.flushCache() and MultiKey are deprecated.  
 . ETKCacheManager.getEtk(KgssIdentifierType, Long, String) is deprecated;
     This is replaced by ETKCacheManager.getEtk(IdentifierType,Long, String)
 . ETKCacheManger.getKgssEtk() is deprecated. 
     This is replaces by EtkBusinessService.KGSS.getETK()
 . ETKCacheManger.getRecipeEtk() is deprecated. 
     This is replaces by EtkBusinessService.RECIPE.getETK()
 . IdentifierTypes is deprecated and replaced by IdentifierType.
 . Minor refactoring (cleaner code base) 
 
1.0.0 FINAL release
 . added Generic Service
 . externalisation of config file
 . improved error handeling
 . several performance fixes

1.0-beta2
 . bugfixing UTF-8 support 
 . several minor fixes for clear error messages 

1.0-beta
 . initial version