Changes for page Руководство по скриптам Lua

Last modified by superadmin on 2026/06/15 21:57

Manage
- Copy
Actions
- Export
- Print Preview
Viewers
- Source
- Children
- Content
- Comments
- Attachments (4)
- History
- Information
- Likes

From version 4.2

edited by superadmin
on 2026/06/15 21:57

Change comment: Short URL code assigned

To version 1.1

edited by pugachevskaya_elena
on 2026/01/16 16:17

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Objects (0 modified, 0 added, 1 removed)
- XWiki.ShortUrlClass[0]

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.superadmin
++XWiki.pugachevskaya_elena

Content

@@ -40,7 +40,7 @@
  == {{id name="РуководствопоскриптамLua-Какредактироватьскрипт"/}}Как редактировать скрипт ==
  (% style="text-align: left;" %)
--Для удобство редактирования и отладки скрипта автоматизации предназначен текстовый online-редактор, доступный в наших продуктах по адресу {{code language="none"}}http://[ip-address]/lua-editor/{{/code}} или ##http:~/~/[ip-address]/internal/(%%)lua-editor/##.
++Для удобство редактирования и отладки скрипта автоматизации предназначен текстовый online-редактор, доступный в наших продуктах по адресу {{code language="none"}}http://[ip-address]/lua-editor/{{/code}} или ##http:~/~/[ip-address]/(% style="color: rgb(51,51,51);" %)internal/(%%)lua-editor/##.
  (% style="text-align: left;" %)
 . В левом блоке — текст скрипта автоматизации. Внесите в него изменения, для сохранения нажмите на кнопку «Сохранить» внизу.
@@ -250,6 +250,7 @@
  )))|(% style="text-align: left;" %)(((
  Все продукты
  )))|(% style="text-align: left;" %)(((
++(% class="content-wrapper" %)
  (((
  Асинхронное выполнение отложенных по времени или периодических действий.
@@ -276,7 +276,7 @@
  (% style="text-align: left;" %)
  Подключение прикладного Lua-модуля осуществляется функцией require. Рекомендуемая форма использования:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  {{/code}}
@@ -283,7 +283,7 @@
  (% style="text-align: left;" %)
  Вызвать функцию Lua-модуля в таком случае можно следующим образом, например:
--{{code language="java"}}
++{{code}}
  local logger = log.get_logger("MyLogger")
  {{/code}}
@@ -401,7 +401,7 @@
  (% style="text-align: left;" %)
  В перечислении {{code language="none"}}fec.TYPE{{/code}} описаны различные типы периферии. Для управления пригодны типы {{code language="none"}}fec.TYPE.RELE{{/code}} (выход на плате контроллера) и {{code language="none"}}fec.TYPE.SART_RELE{{/code}} (выход на модуле расширения). Для управления выходами следует использовать функцию set_value(тип периферии, ID элемента, состояние), где в первый параметр необходимо передать одно из значений перечисления {{code language="none"}}fec.TYPE{{/code}}, во второй параметр — идентификатор (адрес) элемента для управления, в третий параметр — требуемое состояние (для выходов это 0 = Выключено, 1 = Включено). Например:
--{{code language="java"}}
++{{code}}
  local fec = require("fec")
  fec.set_value(fec.TYPE.RELE, 1, 1)
  {{/code}}
@@ -418,7 +418,7 @@
  (% style="text-align: left;" %)
  Поскольку управление светодиодной / звуковой индикацией на считывателях осуществляется в рамках алгоритмов доступа и состояние красного, зелёного светодиодов и звука взаимосвязано (если красный светодиод горит, то зелёный погашен и др.) — для удобства управления всей индикацией реализована функция-обёртка {{code language="none"}}fec.set_reader(ID считывателя, зелёный светодиод, красный светодиод, звук){{/code}}. Пример использования функции приведён ниже:
--{{code language="java"}}
++{{code}}
  local fec = require("fec")
  fec.set_reader(1, fec.DIOD.MODE_OFF, fec.DIOD.MODE_025_025, fec.BEEPER.MODE_OFF)
  {{/code}}
@@ -440,7 +440,7 @@
  (% style="text-align: left;" %)
  Ниже приведён пример использования модуля HTTP для отправки GET-запроса на IP-адрес веб-сайта (% class="nolink" %)http:~/~/example.com.
--{{code language="java"}}
++{{code}}
  local log = require("log")
  local http = require("http")
  local logger = log.get_logger("script.lua")
@@ -490,7 +490,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code language="java"}}
++{{code}}
  -- параметры запроса
  local http_request = {
    url = "http://93.184.216.34",
@@ -512,7 +512,7 @@
  (% style="text-align: left;" %)
  Для передачи запроса с телом в форме текста достаточно присвоить параметру запроса body соответствующее строковое значение. Например:
--{{code language="java"}}
++{{code}}
  local http_request = {
    url = "http://10.1.30.3:8080/myservice",
    method = http.METHOD.POST,
@@ -525,7 +525,7 @@
  (% style="text-align: left;" %)
  Модуль также позволяет передавать запрос с телом в форме JSON-документа, который автоматически формируется из Lua-таблицы. Например:
--{{code language="java"}}
++{{code}}
  local http_request = {
    url = "http://10.1.30.3:8080/myservice",
    method = http.METHOD.POST
@@ -596,7 +596,7 @@
  (% style="text-align: left;" %)
  Пример приведён ниже:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  local logger = log.get_logger("MyLogger")
@@ -632,6 +632,7 @@
  loninput.lua позволяет «подписаться» на изменения состояния входов. Для управления «подписчиками» в модуле доступны следующие функции:
++(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -670,6 +670,7 @@
  В функцию {{code language="none"}}on_loninput_input_state_changed{{/code}} передаются следующие параметры:
++(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -731,7 +731,7 @@
  Получить список точек доступа с их идентификаторами можно через поле {{code language="none"}}lonpacs.ap_instance{{/code}}, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле {{code language="none"}}lonpacs.ap_instance{{/code}} содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:
--{{code language="java"}}
++{{code}}
  lonpacs.ap = {
    "токен первой точки доступа" = {
      ...
@@ -743,12 +743,13 @@
  }
  {{/code}}
--Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
++(% style="color: rgb(51,51,51);" %)Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
  ===== {{id name="РуководствопоскриптамLua-Управлениеточкойдоступа"/}}Управление точкой доступа =====
  Для управления точками доступа на модулях расширения доступна функция {{code language="none"}}transmit_status(token, status){{/code}}, которая позволяет отправлять модулям команды управления. Функция принимает следующие параметры:
++(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -775,8 +775,9 @@
  Команда управления (требуемый статус точки доступа); значение из перечисления {{code language="none"}}lonpacs.AP_COMMAND{{/code}} (см. ниже)
  )))
--Для управления точкам доступа доступны следующие команды (значения параметра {{code language="none"}}status{{/code}}):
++(% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Для управления точкам доступа доступны следующие команды (значения параметра {{code language="none"}}status{{/code}}):
++(% class="wrapped" %)
  |=(((
  Команда
  )))|=(((
@@ -843,6 +843,7 @@
  Модуль {{code language="none"}}lonpacs.lua{{/code}} позволяет «подписаться» на события изменения состояния точек доступа, мониторинга связи с точками доступа, изменения состояния прохода (фазы алгоритма прохода). Для управления «подписчиками» в модуле доступны следующие функции:
++(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -925,6 +925,7 @@
  Параметр {{code language="none"}}ap_status{{/code}} может принимать одно из следующих значений:
++(% class="wrapped" %)
  |=(((
  Состояние точки доступа
  )))|=(((
@@ -939,7 +939,7 @@
  )))|(((
  )))|(((
--Точка доступа в состоянии ожидания транзакции
++(% style="color: rgb(51,51,51);" %)Точка доступа в состоянии ожидания транзакции
  )))
  |(((
  {{code language="none"}}
@@ -957,7 +957,7 @@
  )))|(((
  )))|(((
--Старт транзакции прохода по кнопке выхода
++(% style="color: rgb(51,51,51);" %)Старт транзакции прохода по кнопке выхода
  )))
  |(((
  {{code language="none"}}
@@ -966,7 +966,7 @@
  )))|(((
  )))|(((
--Дверь удержана открытой (удержание двери)
++(% style="color: rgb(51,51,51);" %)Дверь удержана открытой (удержание двери)
  )))
  |(((
  {{code language="none"}}
@@ -991,7 +991,7 @@
  )))|(((
  )))|(((
--Дверь открыта при совершении прохода
++(% style="color: rgb(51,51,51);" %)Дверь открыта при совершении прохода
  )))
  |(((
  {{code language="none"}}
@@ -1077,7 +1077,7 @@
  )))|(((
  )))|(((
--Неисправное состояние замка (не является состоянием точки доступа)
++(% style="color: rgb(51,51,51);" %)Неисправное состояние замка (не является состоянием точки доступа)
  )))
  |(((
  {{code language="none"}}
@@ -1086,7 +1086,7 @@
  )))|(((
  )))|(((
--Удержание двери точки доступа в состоянии "закрыта и заблокирована"
++(% style="color: rgb(51,51,51);" %)Удержание двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1095,7 +1095,7 @@
  )))|(((
  )))|(((
--Взлом двери точки доступа в состоянии "закрыта и заблокирована"
++(% style="color: rgb(51,51,51);" %)Взлом двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1114,7 +1114,7 @@
  Текущая транзакция пользователя обрывается.
  )))
  |(((
--##ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
++##(% style="color: rgb(68,68,68);" %)ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
  )))|(((
  )))|(((
@@ -1126,7 +1126,7 @@
  Функция {{code language="none"}}parse_ap_status{{/code}} возвращает Lua-таблицу следующего вида:
--{{code language="java"}}
++{{code}}
  {
    door_state = ..
    lock_state = ..
@@ -1137,6 +1137,7 @@
  где значение полей таблицы следующее:
++(% class="wrapped" %)
  |=(((
  Поле
  )))|=(((
@@ -1205,6 +1205,7 @@
  (% style="text-align: left;" %)
  Значение кода состояния алгоритма прохода (фазы прохода) {{code language="none"}}status, {{/code}}полученного в функции {{code language="none"}}lonpacs_on_pass_status_changed(token, status, notify_key),{{/code}} может принимать одно из следующих значений:
++(% class="wrapped" %)
  |=(((
  Код (условный)
  )))|=(((
@@ -1295,7 +1295,7 @@
  (% style="text-align: left;" %)
  Получить список точек доступа с их идентификаторами можно через поле {{code language="none"}}pacs.ap{{/code}}, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле {{code language="none"}}pacs.ap{{/code}} содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:
--{{code language="java"}}
++{{code}}
  pacs.ap = {
    "токен первой точки доступа" = {
      "#" = 0,
@@ -1311,7 +1311,7 @@
  (% style="text-align: left;" %)
  Соответственно, для перебора точек доступа (например, чтобы для каждой точки доступа проинциализировать свой алгоритм) удобно использовать следующий код:
--{{code language="java"}}
++{{code}}
  for key,item in pairs(pacs.ap) do
    if item["#"] == 0 or item["#"] == 1 then
      -- код обработки точки доступа с токеном = key
@@ -1414,7 +1414,7 @@
  (% style="text-align: left;" %)
  В режиме доступа «Пользовательский» для реализации алгоритма может потребоваться задать из Lua-скрипта для каждой точки доступа системные параметры. Для указания параметров из Lua-скрипта предназначена функция {{code language="none"}}pacs.set_configuration(token, {...}){{/code}}, в первом аргументе необходимо передать токен точки доступа, во втором аргументе — Lua-таблицу с параметрами. Например:
--{{code language="java"}}
++{{code}}
  for key,item in pairs(pacs.ap) do
    local configuration = {}
    configuration["input.mode"] = "card"
@@ -1546,7 +1546,7 @@
  {{info title="ВНИМАНИЕ"}}
  В данном случае это должны быть именно «глобальные функции», определённые, например, следующим образом:
--{{code language="java"}}
++{{code}}
  function pacs_reader_input(token, data)
    -- тело функции
  end
@@ -1554,7 +1554,7 @@
  Локальные функции с таким же именем не будут вызваны:
--{{code language="java"}}
++{{code}}
  local pacs_reader_input = function(token, data)
    -- функция не будет вызвана
  end
@@ -1579,6 +1579,7 @@
  )))|(% style="text-align: left;" %)(((
  К считывателю предъявлен идентификатор
  )))|(% style="text-align: left;" %)(((
++(% class="content-wrapper" %)
  (((
  Вызывается тогда, когда к считывателю контроллера предъявлен идентификатор.
@@ -1586,7 +1586,7 @@
  В первом аргументе {{code language="none"}}token{{/code}} передаётся токен точки доступа, на которой предъявлен идентификатор; во втором аргументе передаётся Lua-таблица с идентификаторами:
--{{code language="java"}}
++{{code}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1606,12 +1606,13 @@
  )))|(% style="text-align: left;" %)(((
  Получена внешняя команда на инициацию транзакции доступа.
  )))|(% style="text-align: left;" %)(((
++(% class="content-wrapper" %)
  (((
  Первый аргумент {{code language="none"}}token{{/code}} — токен точки доступа.
  Второй аргумент {{code language="none"}}args{{/code}} — параметры разрешения доступа:
--{{code language="java"}}
++{{code}}
  {
    "use_extended_time" = true,
    "access_time_duration" = число (unix-timestamp),
@@ -1755,12 +1755,12 @@
  {{/info}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-Изменениесостоянияпериферии"/}}Изменение состояния периферии(%%) =====
++===== {{id name="РуководствопоскриптамLua-Изменениесостоянияпериферии"/}}(% style="color: rgb(112,112,112);" %)Изменение состояния периферии(%%) =====
  (% style="text-align: left;" %)
  При изменении состояния какого-либо элемента периферии (обычно, это различные входы) вызывается функция-обработчик {{code language="none"}}pacs_input{{/code}}. Ниже приведён Lua-код, который позволит в зависимости от типа элемента периферии получить его логическое состояние.
--{{code language="java"}}
++{{code}}
  local fec = require("fec")
  -- Логическое состояние элемента
@@ -1840,10 +1840,11 @@
  )))|(% style="text-align: left;" %)(((
  Выполнить проверку переданных идентификаторов и начать транзакцию доступа
  )))|(% style="text-align: left;" %)(((
++(% class="content-wrapper" %)
  (((
  Первый аргумент — токен точки доступа. Второй аргумент — Lua-таблица с идентификаторами (такая же, какая получена в функции-обработчике {{code language="none"}}pacs_reader_input{{/code}}):
--{{code language="java"}}
++{{code}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1926,12 +1926,13 @@
  )))|(% style="text-align: left;" %)(((
  Изменить состояние точки доступа
  )))|(% style="text-align: left;" %)(((
++(% class="content-wrapper" %)
  (((
  Первый аргумент — токен точки доступа.
  Второй аргумент — Lua-таблица со значением состояния по различным «осям»:
--{{code language="java"}}
++{{code}}
  {
    "lock" = Unlocked,
    "door" = Open,
@@ -1972,7 +1972,7 @@
  (% style="text-align: left;" %)
  Пример использования модуля приведён ниже:
--{{code language="java"}}
++{{code}}
  local storage = require("storage")
  local my_options = storage.get("my_key")
@@ -2008,7 +2008,7 @@
  {{/info}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-set_timeout"/}}set_timeout(%%) =====
++===== {{id name="РуководствопоскриптамLua-set_timeout"/}}(% style="color: rgb(112,112,112);" %)set_timeout(%%) =====
  (% style="text-align: left;" %)
  Запланировать вызов указанной Lua-функции спустя заданное количество миллисекунд.
@@ -2027,7 +2027,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  local logger = log.get_logger("script.lua")
@@ -2064,11 +2064,11 @@
  * ключ — строка, ключ, по которому можно будет понять в Lua-функции, кто и когда запланировал её отложенный вызов.
  {{error title="ВНИМАНИЕ"}}
--Также [[как и в JavaScript>>url:https://learn.javascript.ru/settimeout-setinterval#%D1%80%D0%B5%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B2%D0%BD%D1%8B%D0%B9-settimeout||style="" shape="rect"]], рекомендуется избегать использования set_interval, сделав выбор в пользу рекурсивного set_timeout.
++Также [[как и в JavaScript>>url:https://learn.javascript.ru/settimeout-setinterval#%D1%80%D0%B5%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B2%D0%BD%D1%8B%D0%B9-settimeout||style="text-decoration: none;" shape="rect"]], рекомендуется избегать использования set_interval, сделав выбор в пользу рекурсивного set_timeout.
  {{/error}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-clear_interval"/}}clear_interval(%%) =====
++===== {{id name="РуководствопоскриптамLua-clear_interval"/}}(% style="color: rgb(112,112,112);" %)clear_interval(%%) =====
  (% style="text-align: left;" %)
  Аналогично clear_timeout функция позволяет отменить запланированное ранее периодическое задание: {{code language="none"}}clear_interval(ID задания){{/code}}, где {{code language="none"}}ID задания{{/code}} — результат выполнения функции {{code language="none"}}set_interval{{/code}}.

XWiki.ShortUrlClass[0]

Short URL code

...	...	@@ -1,1 +1,0 @@
1		-05486

Last known target (debug)

...	...	@@ -1,1 +1,0 @@
1		-ui.Руководство по скриптам Lua.WebHome