DEMO licenses are fully functional and totally unrestricted with a few caveats.

1.Unlike the other commercial licenses, DEMO licenses have no "offline" activation methods and MUST be activated online using one of the static methods provided in the COREAPILicense class object.

2.They expire in 30 days and cannot be renewed.

3.They can only be activated ONCE per machine.

4.A COREAPIDEMOTCP license must be requested from customer service.

//Activating a COREAPIDEMO license over the internet

using System.IO;

using COREHL7FW;

//Only needed if you want to show dialogs or message boxes

using COREHL7FWDialogs;

      public void ActivateADemo()

       {

          try

           {

               COREExceptionEX ret;

              //Just need your HermeTech Account login and password. The login can

              //be EITHER the Account Number OR the Customer ID (Email).

               ret = CoreAPILicense.ActivateAPIDemoLicense("<login>", "<password>");

              if (ret.HasException())

               {

                  //Something went wrong! This could be any number of things, no internet

                  //blocked internet, invalid credentials, etc. There IS one exception we

                  //can do something about

                  if (ret.ExceptionNumber == 699134)

                   {

                      //This exception number means that there is ALREADY a DEMO license

                      //on our server for THIS computer. We might be able to retrieve it.

                       FormResults.InfoBox("See the example code for retrieving an API license!");

                      return;

                   }

                  else

                   {

                       FormResults.ErrorMsgBox(ret.ExtendedErrorMessage, "Activation Error");

                      return;

                   }

               }

              //Nothing went wrong. All we have do now is save the license.

              //I'm going to use the installation folder and the suggested

              //file title

               COREUtilities o = new COREUtilities();

              string fName = o.ApplicationPath() + CoreAPILicense.SuggestedDemoLicenseFileTitle;

              //My License will be in the StringValue property of the ret.Tag property

              string lValue = ret.Tag.StringValue;

               File.WriteAllText(fName, lValue);

              return;

           }

          catch (Exception ex)

           {

               FormResults.ErrorMsgBox(ex.Message);

              return;

           }

       }

Contact customer service and following their instructions and you will be emailed your DEMO COREAPIDEMOTCP license in a text file. You can then use that file for 30 days to activate a HL7Controller, HL7IPListenerController, or HL7IPSenderController object.

//Retrieving a previously activated COREAPIDEMO license over the internet

using System.IO;

using COREHL7FW;

//Only needed if you want to show dialogs or message boxes

using COREHL7FWDialogs;

      public void RetrieveDemoLicense()

       {

          try

           {

               COREExceptionEX ret;

              //Just need your HermeTech Account login and password. The login can

              //be EITHER the Account Number OR the Customer ID (Email).

               ret = CoreAPILicense.RetrieveAPIDemoLicense("<login>", "<password>", false);

              //NOTE: To retrieve a COREAPIDEMOTCP license set the 3rd parameter to true.

              if (ret.HasException())

               {

                  //Something went wrong! This could be any number of things, no internet

                  //blocked internet, invalid credentials, etc.

                  //There is an additional problem which you can see. There may be

                  //a valid DEMO license on our server for this computer BUT it was

                  //activated by another HermeTech account and thus you cannot retrieve it.

                   FormResults.ErrorMsgBox(ret.ExtendedErrorMessage, "Retrieval Error");

                  return;

               }

              //Nothing went wrong. All we have do now is save the retrieved license.

              //I'm going to use the installation folder and the suggested

              //file title.

               COREUtilities o = new COREUtilities();

              string fName = o.ApplicationPath() + CoreAPILicense.SuggestedDemoLicenseFileTitle;

              //My License will be in the StringValue property of the ret.Tag property

              string lValue = ret.Tag.StringValue;

               File.WriteAllText(fName, lValue);

              return;

           }

          catch (Exception ex)

           {

               FormResults.ErrorMsgBox(ex.Message);

              return;

           }

       }

In this snippet we also show an example of how you might use another of our objects, the COREException object in your own programming.

using System.IO;

using COREHL7FW;

private COREUtilities MyUtilities = new COREUtilities();

      public COREException IsMyLicenseValid()

       {

          try

           {

              //Here we will test a CORE API License.

              //For this example we assume that the license file is

              //in the installation folder and we are using a custom name

              string fName = MyUtilities.ApplicationPath() + "MyLicense.txt";

              if (!File.Exists(fName))

               {

                  //Well, that was quick. We'll return an exception. Note here that

                  //when we create the exception we are using just any int number that

                  //we want to in the 3rd parameter. You can then choose to respond to

                  //that number yourself.

                  return new COREException("File not found", "IsMyLicenseValid()", 31200);

               }

              //Now we will create a test HL7Controller object just to play with.

               HL7Controller tst = new HL7Controller(fName);

              //IF tst has an exception right off the bat after creation this is fatal and

              //we can just return a copy of this.

              if (tst.HasException)

               {

                  return tst.LastException.Copy();

               }

              //Now we can start checking the individual License properties that we care about

              if (!tst.LicenseIsValid)

               {

                  //the same as querying tst.License.IsValid

                  //If this is FALSE it means that the contents

                  //of my license file did not contain a CORE HL7 API License

                  //at all OR it's for a different computer. It might contain a recipe, or a laundry list.

                  return new COREException("License Not Valid", "IsMyLicenseValid()", 31201);

               }

              //At this point I know that the file contains a CORE API License. The next thing I

              //Care about is can I run the thing. Of course I COULD have just made the call below

              //First thing but we're trying to demonstrate multiple features here

              if (!tst.LicenseIsRunnable)

               {

                  //the same as querying tst.License.IsRunnable

                  //If this is FALSE it means that either the license is not valid (checked for above)

                  //OR the license is expired (IE a Demo License)

                  //OR the license is actually a SOFTWARE license for one of OUR commercial programs

                  return new COREException("License Not Runnable", "IsMyLicenseValid()", 31202);

               }

              //At this point I know it's a CORE API license. I know that it's runnable for BASIC

              //operations. What if I want to send or receive HL7 messages over TCP/IP

              if (!tst.LicenseIsRunnableForTCPIPInbound)

               {

                  //the same as querying tst.License.IsRunnableForTCPIPInbound

                  //If this is FALSE it means that this license cannot be used

                  //to instantiate a HL7IPListenerController object and create

                  //HL7Listener objects

                  return new COREException("License cannot receive TCP/IP Inbound", "IsMyLicenseValid()", 31203);

               }

              //But I want to send HL7 messages as well

              if (!tst.LicenseIsRunnableForTCPIPOutbound)

               {

                  //the same as querying tst.License.IsRunnableForTCPIPOutbound

                  //If this is FALSE it means that this license cannot be used

                  //to instantiate a HL7IPSenderController object and create

                  //HL7Sender objects

                  return new COREException("License cannot send messages over TCP/IP", "IsMyLicenseValid()", 31204);

               }

              //All is well just return a new, empty COREException

              return new COREException();

           }

          catch (Exception ex)

           {

              return new COREException("System Error: " +ex.Message, "IsMyLicenseValid()", 100011);

           }

       }