From OpenSCADAWiki
Jump to: navigation, search
 
Line 4: Line 4:
 
<li>''ElTp cfg( string nm )'' — отримує значення конфігураційного поля ''nm'' об'єкту.</li>
 
<li>''ElTp cfg( string nm )'' — отримує значення конфігураційного поля ''nm'' об'єкту.</li>
 
<li>''bool cfgSet( string nm, ElTp val )'' [<span style='color:red'>доступ до відповідної підсистеми</span>] — встановлює конфігураційне поле ''nm'' об'єкту у значення ''val''.</li>
 
<li>''bool cfgSet( string nm, ElTp val )'' [<span style='color:red'>доступ до відповідної підсистеми</span>] — встановлює конфігураційне поле ''nm'' об'єкту у значення ''val''.</li>
<li>''Array SQLReq( string req, bool tr = EVAL );'' — здійснює SQL-запит ''req'' до БД, всередині (''tr''=true), назовні (''tr''=false) або байдуже (''tr''=EVAL) до транзакції. Повертає масив рядків таблиці результату з полями за індексами і за іменами стовпців. У випадку помилки її значення розташовується у властивості "err" результату.
+
<li>''Array SQLReq( string req, bool tr = '''EVAL''' );'' — здійснює SQL-запит ''req'' до БД, всередині (''tr''=true), назовні (''tr''=false) або байдуже (''tr''='''EVAL''') до транзакції. Повертає масив рядків таблиці результату з полями за індексами і за іменами стовпців. У випадку помилки її значення розташовується у властивості "err" результату.
 
<syntaxhighlight lang="JavaScript">
 
<syntaxhighlight lang="JavaScript">
 
DBTbl = SYS.BD.MySQL.GenDB.SQLReq("SELECT * from DB;");
 
DBTbl = SYS.BD.MySQL.GenDB.SQLReq("SELECT * from DB;");

Latest revision as of 18:22, 11 May 2025

Information about message (contribute)
This message has no documentation. If you know where or how this message is used, you can help other translators by adding documentation to this message.
Message definition (Documents/User API)
== {{Anch|SYS.BD|Subsystem "DB" (SYS.BD)}} ==
Functions of the database object (SYS.BD["TypeDB"]["DB"]):
<ul>
<li>''ElTp cfg( string nm )'' — gets the value of the configuration field ''nm'' of the object.</li>
<li>''bool cfgSet( string nm, ElTp val )'' [<span style='color:red'>access to the appropriate subsystem</span>] — sets the configuration field ''nm'' of the object to the value ''val''.</li>
<li>''Array SQLReq( string req, bool tr = '''EVAL''' );'' — performs the SQL-request ''req'' to the DB, inside (''tr''=true), outside (''tr''=false) or no matter (''tr''='''EVAL''') to the transaction. Returns an array of rows of the result table with the fields both per indexes and column names. At an error the result property "err" sets to the error value.
<syntaxhighlight lang="JavaScript">
DBTbl = SYS.BD.MySQL.GenDB.SQLReq("SELECT * from DB;");
if(DBTbl.err.length) SYS.messInfo("TEST DB","Error: "+DBTbl.err);
else for(var iRw = 0; iRw < DBTbl.length; iRw++) {
  var rec = "";
  for(var iFld = 0; iFld < DBTbl[iRw].length; iFld++) rec += DBTbl[iRw][iFld] + "\t";
  SYS.messInfo("TEST DB", "Row "+iRw+": "+rec);
  //Get column value by the name
  if(iRw) SYS.messInfo("TEST DB", "Row "+iRw+": 'NAME'"+DBTbl[iRw]["NAME"]);
} </syntaxhighlight></li>
</ul>
Translation== {{Anch|SYS.BD|Підсистема "БД" (SYS.BD)}} ==
Функції об'єкту бази даних (SYS.BD["TypeDB"]["DB"]):
<ul>
<li>''ElTp cfg( string nm )'' — отримує значення конфігураційного поля ''nm'' об'єкту.</li>
<li>''bool cfgSet( string nm, ElTp val )'' [<span style='color:red'>доступ до відповідної підсистеми</span>] — встановлює конфігураційне поле ''nm'' об'єкту у значення ''val''.</li>
<li>''Array SQLReq( string req, bool tr = '''EVAL''' );'' — здійснює SQL-запит ''req'' до БД, всередині (''tr''=true), назовні (''tr''=false) або байдуже (''tr''='''EVAL''') до транзакції. Повертає масив рядків таблиці результату з полями за індексами і за іменами стовпців. У випадку помилки її значення розташовується у властивості "err" результату.
<syntaxhighlight lang="JavaScript">
DBTbl = SYS.BD.MySQL.GenDB.SQLReq("SELECT * from DB;");
if(DBTbl.err.length) SYS.messInfo("TEST DB","Error: "+DBTbl.err);
else for(var iRw = 0; iRw < DBTbl.length; iRw++) {
  var rec = "";
  for(var iFld = 0; iFld < DBTbl[iRw].length; iFld++) rec += DBTbl[iRw][iFld] + "\t";
  SYS.messInfo("TEST DB", "Row "+iRw+": "+rec);
  //Get column value by the name
  if(iRw) SYS.messInfo("TEST DB", "Row "+iRw+": 'NAME'"+DBTbl[iRw]["NAME"]);
} </syntaxhighlight></li>
</ul>

Підсистема "БД" (SYS.BD)

Функції об'єкту бази даних (SYS.BD["TypeDB"]["DB"]):

  • ElTp cfg( string nm ) — отримує значення конфігураційного поля nm об'єкту.
  • bool cfgSet( string nm, ElTp val ) [доступ до відповідної підсистеми] — встановлює конфігураційне поле nm об'єкту у значення val.
  • Array SQLReq( string req, bool tr = EVAL ); — здійснює SQL-запит req до БД, всередині (tr=true), назовні (tr=false) або байдуже (tr=EVAL) до транзакції. Повертає масив рядків таблиці результату з полями за індексами і за іменами стовпців. У випадку помилки її значення розташовується у властивості "err" результату.
    DBTbl = SYS.BD.MySQL.GenDB.SQLReq("SELECT * from DB;");
    if(DBTbl.err.length) SYS.messInfo("TEST DB","Error: "+DBTbl.err);
    else for(var iRw = 0; iRw < DBTbl.length; iRw++) {
      var rec = "";
      for(var iFld = 0; iFld < DBTbl[iRw].length; iFld++) rec += DBTbl[iRw][iFld] + "\t";
      SYS.messInfo("TEST DB", "Row "+iRw+": "+rec);
      //Get column value by the name
      if(iRw) SYS.messInfo("TEST DB", "Row "+iRw+": 'NAME'"+DBTbl[iRw]["NAME"]);
    }