Различия

Показаны различия между двумя версиями страницы.

--- pm.addlog [2025/09/19 08:18]
root создано
+++ pm.addlog [2025/09/19 10:57] (текущий)
root
@@ Строка 1: / Строка 1: @@
 ====== async pm.addLog(data) ======
+**data** - объект с данными, описывающие добавляемое сообщение.\\
 <wrap ks>
-Документация в разработке...
+Данная функция позволяет добавить в системный журнал кастомное сообщение на более низком уровне, чем это делает функция [[log|log]].\\
+Объект **data** содержит поля:\\
+ - **stamp** - метка времени в миллисекундах (из нее формируется первая колонка журнала);\\
+ - **mark** - двухбуквенная метка приложения, выдающая сообщение (вторая колонка);\\
+ - **type** - тип сообщения, может принимать значения 'e' - ошибка (выводится красным цветом), 'i' - информация (зеленым цветом), 'd' - отладочные сообщения (белым цветом);\\
+ - **val** - текст сообщения.
 </wrap>
 <wrap ks>
-Пример:
+Приммер:
 </wrap>
 <code javascript>
-// в разработке...
+let logData = {
+    stamp: Date.now(),
+    mark: 'ZZ',
+    type: 'e',
+    val: 'my message'
+}
+await ds.rpcCall('pm.addLog', [ logData ]);
 </code>
+<wrap ks>
+Данный код добавит в системный журнал, в обход стандартной функции, сообщение **my message** с меткой **ZZ** и типом сообщения - ошибка.
+</wrap>
+{{ :ds_rpccall3.png?nolink |}}

DevelSCADA

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы