proje ismini parametre olarak alan API 'leri kullanabilirsiniz. inSCADA platformunda API' lerin birçoğu proje ismi (projectName) parametresini alabilmektedir.
inSCADA içerisinde tanımlı bir değişkenin önceki taramalardaki değerini okur. inSCADA değişkenlerin en son okunan 300 değerini hafızada tutar. Bu 250 değere index ile ulaşabilirsiniz.
variablename : String
Return Value : Variable nesnesi geri döndürür. Dönen değer "null" ise işlem başarısızdır. Variable okunamamıştır.
Syntax
var variable=ins.getVariableValue("UNI01_Active_Power");
if (variable===null) {return -1}
var prv_variable=ins.getVariableValue("UNIT01_Active_Power",1);
if (prv_variable===null) {return -1}
if (variable.value!==prv_variable.value) {
ins.notify("info","Unit 01","Power value is changed");
}
return variable.value;
Get Variables Values
Array[] ins.getVariableValues(variablenames[])
inSCADA içerisinde tanımlı, talep edilen değişken listesinin değerlerini okur.
variablenames[] : String array
Return Value : Talep edilen değişkenlerin nesnelerinden oluşan bir dizi döndürür.
Syntax
var TAGS=["UNCORRECTED_FLOW_RATE",
"MASS_FLOW_RATE",
"CORRECTED_FLOW_RATE",
"ENERGY_FLOW_RATE",
"INDICATED_UNCORRECTED_FLOW_RATE",
"UNCORRECTED_TOTAL",
"MASS_TOTAL",
"CORRECTED_TOTAL",
"ENERGY_TOTAL",
"INDICATED_UNCORRECTED_TOTAL",
"CONVERTION_FACTOR",
"CORRECTED_FACTOR",
"LINE_COMPRESIBILITY",
"BASE_COMPRESIBILITY",
"LINE_PRESSURE",
"LINE_TEMPERATURE",
"LINE_DENSITY",
"BASE_DENSITY"];
var VALUES=ins.getVariableValues(TAGS);
if (VALUES===null) {return -1;}
var mass_flow_rate_value=VALUES["MASS_FLOW_RATE"].value;
var mass_flow_rate_timestamp=VALUES["MASS_FLOW_RATE"].date;
// veya
var corrected_flow_rate_value=VALUES.CORRECTED_FLOW_RATE.value;
inSCADA içerisinde tanımlı değişkenlere, tek seferde değer yazar.
variables : Değişkenlerin ve yazılmak istenen değerlerin içinde bulunduğu bir JSON nesnesidir.
ins.setVariableValues, ins.setVariableValue ' dan farklı olarak tek seferde birden fazla değişkene değer yazılmasını sağlar. Bu işlemi yaparken, protokole uygun olarak yazma işlemini optimize eder ve aynı veri bloğunda bulunan değerleri tek seferde bağlı cihaza gönderir. Birden çok verinin aktarımı için kullanılabilecek bir fonksiyondur.
Syntax
var write_tags={};
write_tags.UNIT01_Active_Power_Set={value : 100};
// veya
write_tags["UNIT01_Active_Power_Set"]={value : 100};
// veya
var tag_list=["TagName1","TagName2","TagName3",...,"TagName30"]
for (var i=0;i<tag_list.length;i++) {
write_tags[tag_list[i]]={value:Math.random()*100};
}
ins.setVariableValues(write_tags);