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 1.1 to 1.2 From 3.1 to 4.1

From version 1.2

edited by admin
on 2026/05/30 23:27

Change comment: Normalize links: remove text-decoration:none

To version 3.1

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

Change comment: Clean Confluence migrated style markers

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

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]/(% style="color: rgb(51,51,51);" %)internal/(%%)lua-editor/##.
++Для удобство редактирования и отладки скрипта автоматизации предназначен текстовый online-редактор, доступный в наших продуктах по адресу {{code language="none"}}http://[ip-address]/lua-editor/{{/code}} или ##http:~/~/[ip-address]/internal/(%%)lua-editor/##.
  (% style="text-align: left;" %)
 . В левом блоке — текст скрипта автоматизации. Внесите в него изменения, для сохранения нажмите на кнопку «Сохранить» внизу.
@@ -277,7 +277,7 @@
  (% style="text-align: left;" %)
  Подключение прикладного Lua-модуля осуществляется функцией require. Рекомендуемая форма использования:
--{{code}}
++{{code language="java"}}
  local log = require("log")
  {{/code}}
@@ -284,7 +284,7 @@
  (% style="text-align: left;" %)
  Вызвать функцию Lua-модуля в таком случае можно следующим образом, например:
--{{code}}
++{{code language="java"}}
  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}}
++{{code language="java"}}
  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}}
++{{code language="java"}}
  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}}
++{{code language="java"}}
  local log = require("log")
  local http = require("http")
  local logger = log.get_logger("script.lua")
@@ -491,7 +491,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code}}
++{{code language="java"}}
  -- параметры запроса
  local http_request = {
    url = "http://93.184.216.34",
@@ -513,7 +513,7 @@
  (% style="text-align: left;" %)
  Для передачи запроса с телом в форме текста достаточно присвоить параметру запроса body соответствующее строковое значение. Например:
--{{code}}
++{{code language="java"}}
  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}}
++{{code language="java"}}
  local http_request = {
    url = "http://10.1.30.3:8080/myservice",
    method = http.METHOD.POST
@@ -597,7 +597,7 @@
  (% style="text-align: left;" %)
  Пример приведён ниже:
--{{code}}
++{{code language="java"}}
  local log = require("log")
  local logger = log.get_logger("MyLogger")
@@ -633,7 +633,6 @@
  loninput.lua позволяет «подписаться» на изменения состояния входов. Для управления «подписчиками» в модуле доступны следующие функции:
--(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -672,7 +672,6 @@
  В функцию {{code language="none"}}on_loninput_input_state_changed{{/code}} передаются следующие параметры:
--(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -734,7 +734,7 @@
  Получить список точек доступа с их идентификаторами можно через поле {{code language="none"}}lonpacs.ap_instance{{/code}}, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле {{code language="none"}}lonpacs.ap_instance{{/code}} содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:
--{{code}}
++{{code language="java"}}
  lonpacs.ap = {
    "токен первой точки доступа" = {
      ...
@@ -746,13 +746,12 @@
  }
  {{/code}}
--(% style="color: rgb(51,51,51);" %)Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
++Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.
  ===== {{id name="РуководствопоскриптамLua-Управлениеточкойдоступа"/}}Управление точкой доступа =====
  Для управления точками доступа на модулях расширения доступна функция {{code language="none"}}transmit_status(token, status){{/code}}, которая позволяет отправлять модулям команды управления. Функция принимает следующие параметры:
--(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -779,9 +779,8 @@
  Команда управления (требуемый статус точки доступа); значение из перечисления {{code language="none"}}lonpacs.AP_COMMAND{{/code}} (см. ниже)
  )))
--(% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Для управления точкам доступа доступны следующие команды (значения параметра {{code language="none"}}status{{/code}}):
++Для управления точкам доступа доступны следующие команды (значения параметра {{code language="none"}}status{{/code}}):
--(% class="wrapped" %)
  |=(((
  Команда
  )))|=(((
@@ -848,7 +848,6 @@
  Модуль {{code language="none"}}lonpacs.lua{{/code}} позволяет «подписаться» на события изменения состояния точек доступа, мониторинга связи с точками доступа, изменения состояния прохода (фазы алгоритма прохода). Для управления «подписчиками» в модуле доступны следующие функции:
--(% class="wrapped" %)
  |=(((
  Функция
  )))|=(((
@@ -931,7 +931,6 @@
  Параметр {{code language="none"}}ap_status{{/code}} может принимать одно из следующих значений:
--(% class="wrapped" %)
  |=(((
  Состояние точки доступа
  )))|=(((
@@ -946,7 +946,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Точка доступа в состоянии ожидания транзакции
++Точка доступа в состоянии ожидания транзакции
  )))
  |(((
  {{code language="none"}}
@@ -964,7 +964,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Старт транзакции прохода по кнопке выхода
++Старт транзакции прохода по кнопке выхода
  )))
  |(((
  {{code language="none"}}
@@ -973,7 +973,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Дверь удержана открытой (удержание двери)
++Дверь удержана открытой (удержание двери)
  )))
  |(((
  {{code language="none"}}
@@ -998,7 +998,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Дверь открыта при совершении прохода
++Дверь открыта при совершении прохода
  )))
  |(((
  {{code language="none"}}
@@ -1084,7 +1084,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Неисправное состояние замка (не является состоянием точки доступа)
++Неисправное состояние замка (не является состоянием точки доступа)
  )))
  |(((
  {{code language="none"}}
@@ -1093,7 +1093,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Удержание двери точки доступа в состоянии "закрыта и заблокирована"
++Удержание двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1102,7 +1102,7 @@
  )))|(((
  )))|(((
--(% style="color: rgb(51,51,51);" %)Взлом двери точки доступа в состоянии "закрыта и заблокирована"
++Взлом двери точки доступа в состоянии "закрыта и заблокирована"
  )))
  |(((
  {{code language="none"}}
@@ -1121,7 +1121,7 @@
  Текущая транзакция пользователя обрывается.
  )))
  |(((
--##(% style="color: rgb(68,68,68);" %)ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
++##ARMED_CLOSE_BLOCKED_FORCE_OPEN(%%)##
  )))|(((
  )))|(((
@@ -1133,7 +1133,7 @@
  Функция {{code language="none"}}parse_ap_status{{/code}} возвращает Lua-таблицу следующего вида:
--{{code}}
++{{code language="java"}}
  {
    door_state = ..
    lock_state = ..
@@ -1144,7 +1144,6 @@
  где значение полей таблицы следующее:
--(% class="wrapped" %)
  |=(((
  Поле
  )))|=(((
@@ -1213,7 +1213,6 @@
  (% style="text-align: left;" %)
  Значение кода состояния алгоритма прохода (фазы прохода) {{code language="none"}}status, {{/code}}полученного в функции {{code language="none"}}lonpacs_on_pass_status_changed(token, status, notify_key),{{/code}} может принимать одно из следующих значений:
--(% class="wrapped" %)
  |=(((
  Код (условный)
  )))|=(((
@@ -1304,7 +1304,7 @@
  (% style="text-align: left;" %)
  Получить список точек доступа с их идентификаторами можно через поле {{code language="none"}}pacs.ap{{/code}}, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле {{code language="none"}}pacs.ap{{/code}} содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:
--{{code}}
++{{code language="java"}}
  pacs.ap = {
    "токен первой точки доступа" = {
      "#" = 0,
@@ -1320,7 +1320,7 @@
  (% style="text-align: left;" %)
  Соответственно, для перебора точек доступа (например, чтобы для каждой точки доступа проинциализировать свой алгоритм) удобно использовать следующий код:
--{{code}}
++{{code language="java"}}
  for key,item in pairs(pacs.ap) do
    if item["#"] == 0 or item["#"] == 1 then
      -- код обработки точки доступа с токеном = key
@@ -1423,7 +1423,7 @@
  (% style="text-align: left;" %)
  В режиме доступа «Пользовательский» для реализации алгоритма может потребоваться задать из Lua-скрипта для каждой точки доступа системные параметры. Для указания параметров из Lua-скрипта предназначена функция {{code language="none"}}pacs.set_configuration(token, {...}){{/code}}, в первом аргументе необходимо передать токен точки доступа, во втором аргументе — Lua-таблицу с параметрами. Например:
--{{code}}
++{{code language="java"}}
  for key,item in pairs(pacs.ap) do
    local configuration = {}
    configuration["input.mode"] = "card"
@@ -1555,7 +1555,7 @@
  {{info title="ВНИМАНИЕ"}}
  В данном случае это должны быть именно «глобальные функции», определённые, например, следующим образом:
--{{code}}
++{{code language="java"}}
  function pacs_reader_input(token, data)
    -- тело функции
  end
@@ -1563,7 +1563,7 @@
  Локальные функции с таким же именем не будут вызваны:
--{{code}}
++{{code language="java"}}
  local pacs_reader_input = function(token, data)
    -- функция не будет вызвана
  end
@@ -1596,7 +1596,7 @@
  В первом аргументе {{code language="none"}}token{{/code}} передаётся токен точки доступа, на которой предъявлен идентификатор; во втором аргументе передаётся Lua-таблица с идентификаторами:
--{{code}}
++{{code language="java"}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1622,7 +1622,7 @@
  Второй аргумент {{code language="none"}}args{{/code}} — параметры разрешения доступа:
--{{code}}
++{{code language="java"}}
  {
    "use_extended_time" = true,
    "access_time_duration" = число (unix-timestamp),
@@ -1766,12 +1766,12 @@
  {{/info}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-Изменениесостоянияпериферии"/}}(% style="color: rgb(112,112,112);" %)Изменение состояния периферии(%%) =====
++===== {{id name="РуководствопоскриптамLua-Изменениесостоянияпериферии"/}}Изменение состояния периферии(%%) =====
  (% style="text-align: left;" %)
  При изменении состояния какого-либо элемента периферии (обычно, это различные входы) вызывается функция-обработчик {{code language="none"}}pacs_input{{/code}}. Ниже приведён Lua-код, который позволит в зависимости от типа элемента периферии получить его логическое состояние.
--{{code}}
++{{code language="java"}}
  local fec = require("fec")
  -- Логическое состояние элемента
@@ -1855,7 +1855,7 @@
  (((
  Первый аргумент — токен точки доступа. Второй аргумент — Lua-таблица с идентификаторами (такая же, какая получена в функции-обработчике {{code language="none"}}pacs_reader_input{{/code}}):
--{{code}}
++{{code language="java"}}
  {
    "facility_code" = "123",
    "card_number" = "12345",
@@ -1944,7 +1944,7 @@
  Второй аргумент — Lua-таблица со значением состояния по различным «осям»:
--{{code}}
++{{code language="java"}}
  {
    "lock" = Unlocked,
    "door" = Open,
@@ -1985,7 +1985,7 @@
  (% style="text-align: left;" %)
  Пример использования модуля приведён ниже:
--{{code}}
++{{code language="java"}}
  local storage = require("storage")
  local my_options = storage.get("my_key")
@@ -2021,7 +2021,7 @@
  {{/info}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-set_timeout"/}}(% style="color: rgb(112,112,112);" %)set_timeout(%%) =====
++===== {{id name="РуководствопоскриптамLua-set_timeout"/}}set_timeout(%%) =====
  (% style="text-align: left;" %)
  Запланировать вызов указанной Lua-функции спустя заданное количество миллисекунд.
@@ -2040,7 +2040,7 @@
  (% style="text-align: left;" %)
  Пример:
--{{code}}
++{{code language="java"}}
  local log = require("log")
  local logger = log.get_logger("script.lua")
@@ -2081,7 +2081,7 @@
  {{/error}}
  (% style="text-align: left;" %)
--===== {{id name="РуководствопоскриптамLua-clear_interval"/}}(% style="color: rgb(112,112,112);" %)clear_interval(%%) =====
++===== {{id name="РуководствопоскриптамLua-clear_interval"/}}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}}.