Type 1 Profile Architecture

Now a code snippet below of how you work with the message (A full example script in Example #4)

          public void Execute(COREHL7Script parent)

           {

              //This Execute method in your Script class is your MAIN method. It MUST be present to run!

               globals = parent;

              try

               {

                  /* Your Executable code goes in here below this line */

                   globals.TraceLog("Hello from the script I am Running!");

                  if (string.IsNullOrEmpty(globals.InitialHL7Message))

                   {

                       globals.SetException("No action required.No initial message", "Script()", 321342);

                       globals.Completed = true;

                      return;

                   }

                   MyMessage = globals.CreateInitialMessage();

                  if (globals.HasException)

                   {

                      //I tried to create the message object but an error

                      //occurred. Call move to error and exit

                       globals.MoveInitialMessageToError();

                       globals.Completed = true;

                      return;

                   }

                  //Now MyMessage is a valid CHS_Message object

                  //...Code...

                  //...Code...

                  //...Code...

                  //I have finished my task with the message

                  //Tell the Script Hosting Application that I

                  //am done. This will cause the message file to be consumed

                   globals.Completed = true;

                  return;

By setting globals.Completed to true your script tells the Script Engine software that you have completed your task to the point where there is nothing more to be done. This means that the Script Engine software will CONSUME (IE Delete) the source HL7 data file. If your script were to set the globals.Completed to false, this tells the Script Engine software that something went wrong. It will NOT consume the data file, it will back out, reset itself, wait 30 seconds and then run your script again passing the same HL7 message into it.

If your script completes it's task(s) it can exit gracefully returning control back to the Script Engine software, or you may have a script that runs in a perpetual loop until the Script Engine tells it to stop. You exit a script gracefully by setting globals.Completed to true. In the instance below and using the settings in the screenshot above the Script Engine software would run the script again in 10 seconds.

Example Code:

          public void Execute(COREHL7Script parent)

           {

              globals = parent;

              try

               {

                  if (!globals.OpenHours.IsOpenNow())

                   {

                       globals.TraceLog("Exiting - cannot run until " + globals.OpenHours.StartingTime.ToShortTimeString());

                       globals.Completed = true;

                      return;

                   }

                  //code

                  //code

In your script an error may occur which makes it impossible to continue. In this case it can still exit gracefully by setting globals.Completed to false, and perhaps also setting an exception so that there will be some context logged into the Logs folder. In the instance below and using the settings in the screenshot above the Script Engine software would run the script again in 5 Minutes.

Example Code:

          public void Execute(COREHL7Script parent)

           {

              globals = parent;

              try

               {

                  if (globals.MSSQLProfile == null)

                   {

                       globals.SetException("Invalid MSSQL Server Connector", "Script", 212092);

                       globals.Completed = false;

                      return;

                   }

                  if (globals.MSSQLProfile.OpenConnection())

                   {

                       globals.SetException("Cannot connect to SQL Server", "Script", 212093);

                       globals.Completed = false;

                      return;

                   }

                   globals.Trace("Connected to the database!");

                  //code

                  //code

          public void Execute(COREHL7Script parent)

           {

              globals = parent;

              try

               {

                  if (!globals.OpenHours.IsOpenNow())

                   {

                       globals.TraceLog("Exiting - cannot run until " + globals.OpenHours.StartingTime.ToShortTimeString());

                       globals.Completed = true;

                      return;

                   }

                  if (globals.MSSQLProfile == null)

                   {

                       globals.SetException("Invalid MSSQL Server Connector", "Script", 212092);

                       globals.Completed = false;

                      return;

                   }

                  if (globals.MSSQLProfile.OpenConnection())

                   {

                       globals.SetException("Cannot connect to SQL Server", "Script", 212093);

                       globals.Completed = false;

                      return;

                   }

                   globals.Trace("Connected to the database!");

                  string sSQL = "Select Top 1000 * from MyTable Order By LastModified";

                  DataTable dt = globals.MSSQLProfile.OpenSQLDataTable(sSQL,"MyTable");

                  if (dt.Rows.Count > 0)

                   {

                      for (int i = 0; i < dt.Rows.Count; i++)

                       {

                          //code

                          //code

                          if (globals.StopAllProcessing)

                           {

                              break;

                           }

                       }

                   }

                   globals.MSSQLProfile.CloseConnection();

                   globals.Completed = true;

                  return;