Скрипты Simple-Scada

Внутренние и внешние переменные в Simple-Scada являются объектами типа TM_Variable с множеством свойств и методов, которые подробно описаны по этой ссылке. Для того, чтобы из скрипта записать значение во внутреннюю/внешнюю переменную, необходимо использовать свойство Value, например:

begin
  MyVar.Value := 10;
end.

Для получения текущего значения внутренней/внешней переменной, необходимо привести значение переменной к нужному типу, используя свойства перечисленные по ссылке. Например, если в скрипте требуется сравнить значение переменной с целым числом, то можно использовать свойство AsInt (значение переменной переведенное в тип Integer):

begin
  if MyVar.AsInt = 1 then    // если значение переменной равно 1, то
    Field1.Color := clGreen  // изменить цвет поля на зеленый
  else                       // иначе
    Field1.Color := clRed;   // изменить цвет поля на красный 
end.

Локальная переменная доступна только в пределах скрипта, в котором она объявлена. Локальные переменные, объявленные в скрипте, не имеют свойств, поэтому записать значение в локальную переменную можно напрямую, например:

var
  myLocalVar: Integer;
begin
  myLocalVar := 125;
end;

Память для локальных переменных выделяется динамически при каждом выполнении скрипта. Это означает, что в момент запуска скрипта они могут иметь произвольное значение. Поэтому перед использованием локальных переменных их необходимо обязательно инициализировать. Например:

var
  a: Integer;  // локальная переменная "a"
begin
  // можно предположить, что в коде ниже переменная "a" увеличится на 1 и станет равна 1.
  // Но это не так. Являясь локальной, она изначально может иметь любое значение в пределах
  // integer и поэтому нельзя предугадать, какое значение она примет после прибавления единицы 
  a := a + 1;
end.

Корректный вариант скрипта:

var
  a: Integer;  // локальная переменная "a"
begin
  a := 0;      // перед использованием инициализируем локальную переменную "a" нулём
  a := a + 1;  // здесь "a" станет равна 1
end.

Таким образом, локальные переменные не подходят для организации таймеров или счетчиков. Если требуется увеличивать значение переменной на единицу при каждом выполнении скрипта, то нужно создать новую внутреннюю переменную через редактор переменных и использовать ее в скрипте, увеличивая на единицу, например:

begin
  // здесь переменная vrCounter будет корректно увеличиваться на 1 при каждом 
  // выполнении скрипта, т.к. она внутренняя и ее значение сохраняется при 
  // каждом выполнении скрипта 
  vrCounter.Value := vrCounter.Value + 1;  
end.

Важно! Использование глобальных переменных является плохим тоном. Вместо этого рекомендуется создавать внутренние переменные через редактор переменных. В частности, не рекомендуется объявлять в глобальных модулях переменные строковых типов из-за особенностей их хранения в памяти.

Глобальные переменные доступны из любого скрипта. Объявить глобальную переменную можно в глобальном модуле в секции interface, например:

interface
 
var
  // данная глобальная переменная будет доступна из всех скриптов
  myGlobalVar: Integer;  
 
implementation
 
end.

После этого можно использовать переменную в любом скрипте, например:

begin
  myGlobalVar := 5;       // запись значения в глобальную переменную
  if myGlobalVar = 3 then // использование глобальной переменной в условиях
  begin
 
  end;
end.

В большинстве случаев системные переменные можно использовать напрямую с объектами. Например, если требуется отображать текущую дату и время, то достаточно связать системную переменную "SysCurrentTime" с компонентом "Календарь". Если требуется показать номер версии Simple-Scada, то можно связать системную переменную "SysProjectVersionAsStr" с компонентом "Поле". Если требуется показать готовность основного сервера, то можно связать системную переменную "SysMasterState" с компонентом "Флажок" и т.д. При необходимости системные переменные можно использовать и в скриптах - работа с ними не отличается от работы с внутренними и внешними переменными.