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 4.1 to 3.1

From version 3.1

edited by admin
on 2026/06/07 17:48

Change comment: Clean Confluence migrated style markers

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)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.admin
++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;" %)
 . В левом блоке — текст скрипта автоматизации. Внесите в него изменения, для сохранения нажмите на кнопку «Сохранить» внизу.
@@ -277,7 +277,7 @@
  (% style="text-align: left;" %)
  Подключение прикладного Lua-модуля осуществляется функцией require. Рекомендуемая форма использования:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  {{/code}}
@@ -284,7 +284,7 @@
  (% style="text-align: left;" %)
  Вызвать функцию Lua-модуля в таком случае можно следующим образом, например:
--{{code language="java"}}
++{{code}}
  local logger = log.get_logger("MyLogger")
  {{/code}}
@@ -402,7 +402,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}}
@@ -419,7 +419,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}}
@@ -441,7 +441,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")
@@ -491,7 +491,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code language="java"}}
++{{code}}
  -- параметры запроса
  local http_request = {
    url = "http://93.184.216.34",
@@ -513,7 +513,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,
@@ -526,7 +526,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
@@ -597,7 +597,7 @@
  (% style="text-align: left;" %)
  Пример приведён ниже:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  local logger = log.get_logger("MyLogger")
@@ -633,6 +633,7 @@
  loninput.lua позволяет «подписаться» на изменения состояния входов. Для управления «подписчиками» в модуле доступны следующие функции:
++(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -671,6 +671,7 @@
  В функцию {{code language="none"}}on_loninput_input_state_changed{{/code}} передаются следующие параметры:
++(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -732,7 +732,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 = {
    "токен первой точки доступа" = {
      ...
@@ -744,12 +744,13 @@
  }
  {{/code}}
--Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
++(% style="color: rgb(51,51,51);" %)Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
  ===== {{id name="РуководствопоскриптамLua-Управлениеточкойдоступа"/}}Управление точкой доступа =====
  Для управления точками доступа на модулях расширения доступна функция {{code language="none"}}transmit_status(token, status){{/code}}, которая позволяет отправлять модулям команды управления. Функция принимает следующие параметры:
++(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -776,8 +776,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" %)
  |=(((
  Команда
  )))|=(((
@@ -844,6 +844,7 @@
  Модуль {{code language="none"}}lonpacs.lua{{/code}} позволяет «подписаться» на события изменения состояния точек доступа, мониторинга связи с точками доступа, изменения состояния прохода (фазы алгоритма прохода). Для управления «подписчиками» в модуле доступны следующие функции:
++(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -926,6 +926,7 @@
  Параметр {{code language="none"}}ap_status{{/code}} может принимать одно из следующих значений:
++(% class="wrapped" %)
  |=(((
  Состояние точки доступа
  )))|=(((
@@ -940,7 +940,7 @@
  )))|(((
  )))|(((
--Точка доступа в состоянии ожидания транзакции
++(% style="color: rgb(51,51,51);" %)Точка доступа в состоянии ожидания транзакции
  )))
  |(((
  {{code language="none"}}
@@ -958,7 +958,7 @@
  )))|(((
  )))|(((
--Старт транзакции прохода по кнопке выхода
++(% style="color: rgb(51,51,51);" %)Старт транзакции прохода по кнопке выхода
  )))
  |(((
  {{code language="none"}}
@@ -967,7 +967,7 @@
  )))|(((
  )))|(((
--Дверь удержана открытой (удержание двери)
++(% style="color: rgb(51,51,51);" %)Дверь удержана открытой (удержание двери)
  )))
  |(((
  {{code language="none"}}
@@ -992,7 +992,7 @@
  )))|(((
  )))|(((
--Дверь открыта при совершении прохода
++(% style="color: rgb(51,51,51);" %)Дверь открыта при совершении прохода
  )))
  |(((
  {{code language="none"}}
@@ -1078,7 +1078,7 @@
  )))|(((
  )))|(((
--Неисправное состояние замка (не является состоянием точки доступа)
++(% style="color: rgb(51,51,51);" %)Неисправное состояние замка (не является состоянием точки доступа)
  )))
  |(((
  {{code language="none"}}
@@ -1087,7 +1087,7 @@
  )))|(((
  )))|(((
--Удержание двери точки доступа в состоянии "закрыта и заблокирована"
++(% style="color: rgb(51,51,51);" %)Удержание двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1096,7 +1096,7 @@
  )))|(((
  )))|(((
--Взлом двери точки доступа в состоянии "закрыта и заблокирована"
++(% style="color: rgb(51,51,51);" %)Взлом двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1115,7 +1115,7 @@
  Текущая транзакция пользователя обрывается.
  )))
  |(((
--##ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
++##(% style="color: rgb(68,68,68);" %)ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
  )))|(((
  )))|(((
@@ -1127,7 +1127,7 @@
  Функция {{code language="none"}}parse_ap_status{{/code}} возвращает Lua-таблицу следующего вида:
--{{code language="java"}}
++{{code}}
  {
    door_state = ..
    lock_state = ..
@@ -1138,6 +1138,7 @@
  где значение полей таблицы следующее:
++(% class="wrapped" %)
  |=(((
  Поле
  )))|=(((
@@ -1206,6 +1206,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" %)
  |=(((
  Код (условный)
  )))|=(((
@@ -1296,7 +1296,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,
@@ -1312,7 +1312,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
@@ -1415,7 +1415,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"
@@ -1547,7 +1547,7 @@
  {{info title="ВНИМАНИЕ"}}
  В данном случае это должны быть именно «глобальные функции», определённые, например, следующим образом:
--{{code language="java"}}
++{{code}}
  function pacs_reader_input(token, data)
    -- тело функции
  end
@@ -1555,7 +1555,7 @@
  Локальные функции с таким же именем не будут вызваны:
--{{code language="java"}}
++{{code}}
  local pacs_reader_input = function(token, data)
    -- функция не будет вызвана
  end
@@ -1588,7 +1588,7 @@
  В первом аргументе {{code language="none"}}token{{/code}} передаётся токен точки доступа, на которой предъявлен идентификатор; во втором аргументе передаётся Lua-таблица с идентификаторами:
--{{code language="java"}}
++{{code}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1614,7 +1614,7 @@
  Второй аргумент {{code language="none"}}args{{/code}} — параметры разрешения доступа:
--{{code language="java"}}
++{{code}}
  {
    "use_extended_time" = true,
    "access_time_duration" = число (unix-timestamp),
@@ -1758,12 +1758,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")
  -- Логическое состояние элемента
@@ -1847,7 +1847,7 @@
  (((
  Первый аргумент — токен точки доступа. Второй аргумент — Lua-таблица с идентификаторами (такая же, какая получена в функции-обработчике {{code language="none"}}pacs_reader_input{{/code}}):
--{{code language="java"}}
++{{code}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1936,7 +1936,7 @@
  Второй аргумент — Lua-таблица со значением состояния по различным «осям»:
--{{code language="java"}}
++{{code}}
  {
    "lock" = Unlocked,
    "door" = Open,
@@ -1977,7 +1977,7 @@
  (% style="text-align: left;" %)
  Пример использования модуля приведён ниже:
--{{code language="java"}}
++{{code}}
  local storage = require("storage")
  local my_options = storage.get("my_key")
@@ -2013,7 +2013,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-функции спустя заданное количество миллисекунд.
@@ -2032,7 +2032,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code language="java"}}
++{{code}}
  local log = require("log")
  local logger = log.get_logger("script.lua")
@@ -2069,11 +2069,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}}.