iTools® SqlArchiveStore driver

04.08.17

Mediante il driver iTools® SqlArchiveStore è possibile archiviare i valori letti mediante uno tra i tanti protocolli disponibili nel framework iTools® su un database SqlServer. Questo tipo di driver consente di creare un archivio contenente le informazioni storiche delle “Variable” iTools®.

Di seguito un esempio che mostra la configurazione di un driver in archiviazione mediante SqlServer:

using System;
using System.Collections.Generic;
using System.Text;
 
namespace TestSqlArchiveStore
{
   using IToolS.Components;
   using IToolS.Components.Communication;
   using IToolS.Components.IOServers;
   using IToolS.Data;
   using IToolS.Data.Base;
 
   class Program
   {
      static void Main(string[] args)
      {
         ComponentBase.RaiseEventsOnMainThread = false;
 
         IOServer ioserver1 = new IOServer() { Name = "Simulation" };
 
         IOServer ioserver2 = new IOServer() { Name = "SqlArchiveStore" };
         // Periodo di archivzione in millisecondi, -1 per utilizzare il trigger mediante variabile
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("TimerPeriod", ((long)(-1))));
         // Valore da assegnare alla veriabile di trigger alla ricezione dello stesso, null per non inserire un valore di reset
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("TriggerResetValue", "0"));
         // Nome del target a cui collegarsi per gestire il trigger
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("TriggerName", "TargetTrigger"));
         // Abilita o meno l'archiviazione della veriabile di trigger
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("ExcludeTriggerVariable", true));
         // Imposta la stringa di connessione al database
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("ConnectionString", 
            "data source=.\\SQLEXPRESS;initial catalog=ITOOLS;persist security info=True;Integrated Security=SSPI;"));
         // Nome della tabella di archiviazione
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("TableName", "SqlStoreServer"));
         // Schema da utilizzare
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("SchemaName", "dbo"));
         // Tempo di vita dell'archivio dell'archivio, i campioni piu' vecchi del tempo impostato vengono eliminati, 
         // null per non eliminare mai i campioni archiviati
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("ArchiveLifeTime", null));
         // Nome delle proprieta' di variabile aggiuntive da archiviare
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("Properties", new String[]{ "Address" }));
         // Prefisso da utilizzare per nominare la tabella di archiviazione
         ioserver2.AdvancedProperties.Add(new AdvancedProperty("TablePrefix", "Archive"));
 
         Group group = new Group() { IOServer = ioserver2, GroupName = "group1" };
         
         Variable variable = new Variable() { Address = "10", Area = "HR", VariableName = "variable1" };
         Variable triggetVariable = new Variable() { Address = "20", Area = "HR", VariableName = "triggerVariable" };
         triggetVariable.Targets.Add(new VariableTarget() { Name = "TargetTrigger", Category = "Trigger", LowerValue = "5000", UpperValue = "15000" });
 
         variable.Changed += delegate(Object sender, ChangedEventArgs e)
         {
            Console.WriteLine("Variable: {1} value: {0}", e.NewValue, ((Variable)sender).VariableName);
         };
 
         triggetVariable.Changed += delegate(Object sender, ChangedEventArgs e)
         {
            Console.WriteLine("Variable: {1} value: {0}", e.NewValue, ((Variable)sender).VariableName);
         };
 
         group.Add(variable);
         group.Add(triggetVariable);
 
         Client client = new Client() { Group = group, IOServer = ioserver1 };
 
         client.Start();
 
         group.StartIOServer();
 
         Console.WriteLine("Press ENTER to exit");
         Console.ReadLine();
 
      }
   }
}

using System;

using System.Collections.Generic;

using System.Text;

namespace TestSqlArchiveStore

{

using IToolS.Components;

using IToolS.Components.Communication;

using IToolS.Components.IOServers;

using IToolS.Data;

using IToolS.Data.Base;

class Program

{

static void Main(string[] args)

{

ComponentBase.RaiseEventsOnMainThread = false;

IOServer ioserver1 = new IOServer() { Name = "Simulation" };

IOServer ioserver2 = new IOServer() { Name = "SqlArchiveStore" };

// Periodo di archivzione in millisecondi, -1 per utilizzare il trigger mediante variabile

ioserver2.AdvancedProperties.Add(new AdvancedProperty("TimerPeriod", ((long)(-1))));

// Valore da assegnare alla veriabile di trigger alla ricezione dello stesso, null per non inserire un valore di reset

ioserver2.AdvancedProperties.Add(new AdvancedProperty("TriggerResetValue", "0"));

// Nome del target a cui collegarsi per gestire il trigger

ioserver2.AdvancedProperties.Add(new AdvancedProperty("TriggerName", "TargetTrigger"));

// Abilita o meno l'archiviazione della veriabile di trigger

ioserver2.AdvancedProperties.Add(new AdvancedProperty("ExcludeTriggerVariable", true));

// Imposta la stringa di connessione al database

ioserver2.AdvancedProperties.Add(new AdvancedProperty("ConnectionString",

"data source=.\\SQLEXPRESS;initial catalog=ITOOLS;persist security info=True;Integrated Security=SSPI;"));

// Nome della tabella di archiviazione

ioserver2.AdvancedProperties.Add(new AdvancedProperty("TableName", "SqlStoreServer"));

// Schema da utilizzare

ioserver2.AdvancedProperties.Add(new AdvancedProperty("SchemaName", "dbo"));

// Tempo di vita dell'archivio dell'archivio, i campioni piu' vecchi del tempo impostato vengono eliminati,

// null per non eliminare mai i campioni archiviati

ioserver2.AdvancedProperties.Add(new AdvancedProperty("ArchiveLifeTime", null));

// Nome delle proprieta' di variabile aggiuntive da archiviare

ioserver2.AdvancedProperties.Add(new AdvancedProperty("Properties", new String[]{ "Address" }));

// Prefisso da utilizzare per nominare la tabella di archiviazione

ioserver2.AdvancedProperties.Add(new AdvancedProperty("TablePrefix", "Archive"));

Group group = new Group() { IOServer = ioserver2, GroupName = "group1" };

Variable variable = new Variable() { Address = "10", Area = "HR", VariableName = "variable1" };

Variable triggetVariable = new Variable() { Address = "20", Area = "HR", VariableName = "triggerVariable" };

triggetVariable.Targets.Add(new VariableTarget() { Name = "TargetTrigger", Category = "Trigger", LowerValue = "5000", UpperValue = "15000" });

variable.Changed += delegate(Object sender, ChangedEventArgs e)

{

Console.WriteLine("Variable: {1} value: {0}", e.NewValue, ((Variable)sender).VariableName);

};

triggetVariable.Changed += delegate(Object sender, ChangedEventArgs e)

{

Console.WriteLine("Variable: {1} value: {0}", e.NewValue, ((Variable)sender).VariableName);

};

group.Add(variable);

group.Add(triggetVariable);

Client client = new Client() { Group = group, IOServer = ioserver1 };

client.Start();

group.StartIOServer();

Console.WriteLine("Press ENTER to exit");

Console.ReadLine();

}

Come si vede da codice riportato sopra gli IOServer utilizzati sono due, uno in simulazione che rappresenta un ipotetico accesso ad un dispositivo di campo ed uno impostato sul driver Sql di archiviazione che utilizza una tabella per contenere le informazioni storiche di ciascuna variabile.

Tra le variabili avanzate presenti nel driver SqlArchiveStore troviamo:

ConnectionString: permette di impostare la stringa di connessione per accedere al database manager.
TableName: permette di impostare il nome della tabella da utilizzare (default: “SqlStore”).
SchemaName: permette di impostare il nome dello “schema” da utilizzare (default: “dbo”).
TablePrefix: definisce un prefisso da utilizzare per comporre il nome della tabella di archiviazione.
TimePeriod: Imposta il periodo di archiviazione espresso in millisecondi delle variabili, nel caso si voglia utilizzare l’archiviazione mediante variabile di trigger imposta a -1.
TriggerResetValue: Valore da assegnare alla variabile di trigger nel momento in cui si verifica il raggiungimento del valore obiettivo che fa scattare il trigger, impostare a null per non eseguire alcuna operazione di reset.
TriggerName: Nome del trigger da utilizzare per archiviare le variabili, è il nome da assegnare al target della variabile di trigger.
ExcludeTriggerVariable: Consente di abilitare o meno l’archiviazione della variabile di trigger.
ArchiveLifeTime: Consente di definire un tempo di vita dell’archivio, i campioni più vecchi del tempo definito vengono eliminati. Impostare a null per non eliminare mai i campioni archiviati.
Properties: Definisce la liste delle proprietà di variabile aggiuntive da sottoporre ad archiviazione.

Blog

iTools® SqlArchiveStore driver

Lascia un commento Annulla risposta