Translations:Documents/User API/30/ru

Функции объекта архива (SYS.Archive["va_Archive"]):

• ElTp cfg( string nm ) — получает значение конфигурационного поля nm объекта.
• bool cfgSet( string nm, ElTp val ) [доступ к соответствующей подсистеме] — устанавливает конфигурационное поля nm объекта в значение val.
• bool status( ) — статус архиватора "Исполнение".
• int end( string arch = "" ) — время конца данных архива для архиватора arch, в микросекундах.
• int begin( string arch = "" ) — время начала данных архива для архиватора arch, в микросекундах.
• int period( string arch = "" ) — период данных архива для архиватора arch, в микросекундах.
• TArrayObj archivatorList( ) — список архиваторов, использующих данный архив как источник.
• VarType getVal( int tm, bool up_ord = false, string arch = "" ) — получает значение из архива на время tm, подтяжкой к верху up_ord и архиватора arch:
  • tm — время запрашиваемого значения, в микросекундах, установить в 0 для "end()"; этот атрибут также является выходом, соответственно реальное время полученного значения помещается сюда, если это переменная;
  • up_ord — подтягивать время запрашиваемого значения к верху сетки;
  • arch — архиватор запроса, установить в пустую строку для проверки всех архиваторов, установить в "<buffer>" для обработки только буфера.
• bool setVal( int tm, VarType vl, string arch = "" ) [доступ к подсистеме Архивы-История] — устанавливает значение vl в архив на время tm и архиватор arch:
  • tm — время устанавливаемого значения, в микросекундах;
  • vl — значение;
  • arch — архиватор установки, установить в пустую строку для всех архиваторов, установить в "<buffer>" для обработки только буфера.
• Array getVals( int begTm, int endTm, int period, string arch = "" ) — получает архив/историю значений от begTm и по endTm для архиватора arch:
  • begTm — время начала запрошенного диапазона данных, в микросекундах, будет изменено в реальное начало данных;
  • endTm — время окончания запрошенного диапазона данных, в микросекундах;
  • period — период данных, в микросекундах, должно быть обязательно определено и будет использовано максимальное значение для этого архива, будет изменено в периодичность реальных данных;
  • arch — архиватор запроса, установить в пустую строку для проверки всех архиваторов, установить в "<buffer>" для обработки только буфера.
• bool setVals( Array buf, int tm, int period, string arch = "" ) [доступ к подсистеме Архивы-История] — устанавливает значение архиву/истории buf в архив от времени начала tm, для периода значений period и архиватора arch.
  • buf — массив значений к установке;
  • tm — время начала устанавливаемого диапазона данных, в микросекундах;
  • period — период устанавливаемых данных, в микросекундах, должно быть обязательно определено и будет использовано максимальное значение для этого архива, будет изменено в периодичность реальных данных;
  • arch — архиватор запроса, установить в пустую строку для проверки всех архиваторов, установить в "<buffer>" для обработки только буфера.