***************************************************************
* eHealth Business Connector General Practioner RELEASE NOTES *
***************************************************************
3.14.2 release (february 2017)
    . see    release.notes.business-intrahubv3.txt

3.14.2-beta-1 release (november 2017)

3.14.2-beta-0 internal release (november 2017)

3.14.1 release (octobre 2017)

3.14.0 release (octobre 2017)
   
3.14.0-beta-0 release (september 2017)
   . adding    new business service intrahub v3
   . adding    new business service mediprima
   
3.13.1 release (juli 2017)
   . adding    new business service MyCarenet eAttest

3.13.0 internal release (july 2017)

3.12.1 release (juin 2017)  
   . adding    new business service Civics V2
   . adding    new business service Dics V3
   . deleting  business service Civics V1
   . deleting  business service Dics V2

3.12.0 internal release (mai 2017)

3.11.1 release
  .  bugfix for dll incompatability in utilities-addressbook

3.11.0 internal release (october 2016)
  .  adding    new business services dics v2
  .  removing  business service civics ( old version of dics and dicsv2) removed , we only support 2 versions at a time
  
3.10.4 release (september 2016)
  . using latest version of technical connector 3.10.4
  . using latest version of business connector 3.10.4
  
3.10.3 release
   . internal release
   
3.10.2 release (july 2016)
  . using latest version of technical connector 3.10.2
  . using latest version of business connector 3.10.2 
  
3.10.1 release
   . internal release

3.10.0 release (june 2016)
   . improvement      uniformisation of all connector versions
   
3.4.11 (may 2016)
  . internal partner release (not published on ehealth portal only distributed to Recipe, Reseau Santé Wallon and Vitalink)
  . change    uniformisation of release numbering 
  . adding    new business service addressbook
  . adding    bootstrap configurations for all business modules
  . change	  config properties splitted between sender and careprovider properties ( makes mandate configurations easier)
  . upgrade   technical connector version 3.4.11
  . upgrade   business connector 3.4.11
  
3.8.0-beta-2
  . upgrade   technical connector version 3.4.0_beta-9
  . upgrade   business connector 3.4.0-beta-9 
  
3.6.0-beta-4
  . upgrade   technical connector version 3.4.0_beta-4
  . upgrade   business connector version 3.4.0_beta-4
  . adding    added projects mycarenet tarification and configuration for mycarenet facturation

3.6.0-beta-3
  . upgrade   technical connector version 3.4.0_beta-3
  . upgrade   business connector version 3.4.0_beta-3

3.6.0 beta-0
  . change    technical connector version 3.4.0_beta-2
  . adding    added projects mycarenet registration

3.5.0 beta-0
  . change    technical connector version 3.4.0_beta-0
  . adding    added projects dmg and genAsync 
            
 
3.4.0 release 
  . change    added projects dmg and genAsync 
  . change    technical connector version 3.3.0_beta-3
  . change    Some property names have changed : 
                  chapterIV.package.license.username => chapterIV.package.licence.username
                  genins.user.username => genins.package.licence.username
                  genins.user.password => genins.package.licence.password
  . change    Some properties are required now for therlink : the properties kmehr.single.hcparty.template.careprovider.in.therapeuticlink.*

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
  
