Параметры и ресурсы в скриптах

Чтобы создать в скрипте блок параметров и/или добавить в скрипт дополнительные ресурсы, необходимо в начале кода поместить следующий блок:

"""
<parameters>
    <company>My Company</company>
    <title>My Script</title>
    <version>1.0</version>

    <parameter>
        <type>caption</type>
        <name>Настройки</name>
    </parameter>
    <parameter>
        <type>channel</type>
        <id>param_channel_1</id>
        <name>Камера</name>
        <value></value>
    </parameter>
    <parameter>
        <type>integer</type>
        <name>Параметр 1</name>
        <id>param_1</id>
        <value>100</value>
        <min>1</min>
        <max>100000</max>
    </parameter>

    <resources>
        <resource>httpserver.py</resource>
        <resource>index.html</resource>
    </resources>
</parameters>
"""

При этом вкладка параметров в редакторе скриптов будет выглядеть так:

После этого значение параметра, указанное в тегах value может быть использовано в скрипте при помощи идентификатора параметра, указанного в тегах id:

def f():
    message("Камера %s" % param_channel_1)
    message("Параметр 1 = %s" % param_1)
f()

В качестве типа параметра, указанного в тегах type, могут быть использованы следующие значения:

  • caption - название (например, название группы параметров)
    <parameter>
        <type>caption</type>
        <name>Настройки</name>
    </parameter>
    
  • integer - целое число
    <parameter>
        <type>integer</type>
        <name>Параметр 1</name>
        <id>param_1</id>
        <value>100</value>
        <min>1</min>
        <max>100000</max>
    </parameter>
    
  • float - вещественное число
    <parameter>
        <type>float</type>
        <name>Параметр 1</name>
        <id>param_2</id>
        <value>6.00</value>
        <min>1.00</min>
        <max>10.00</max>
    </parameter>
    
  • string - строка (например, название шаблона)
    <parameter>
        <type>string</type>
        <name>Шаблон для вывода текущей сводки</name>
        <id>tpl_for_events</id>
        <value>&AT;</value>
    </parameter>
    
  • boolean - логическое выражение
    <parameter>
        <type>boolean</type>
        <id>autoupdate_events</id>
        <name>Автообновление результатов измерений</name>
        <value>0</value>
    </parameter>
    
  • date - дата
    <parameter>
        <type>date</type>
        <id>date_start</id>
        <name>Дата начала</name>
        <value>2014-03-01</value>
    </parameter>
    
  • time - время
    <parameter>
        <type>time</type>
        <id>time_start</id>
        <name>Время начала</name>
        <value>10:00:00</value>
    </parameter>
    
  • string_list - список значений через запятую
    <parameter>
        <type>string_list</type>
        <id>cams</id>
        <name>Камеры</name>
        <value>cam1,cam2,cam3</value>
    </parameter>
    
  • string_from_list - список значений для выбора
    <parameter>
        <type>string_from_list</type>
        <id>user_function</id>
        <name>Пользовательская функция</name>
        <value>U1</value>
        <string_list>U1,U2,U3,U4,U5,U6,U7,U8,U9,U10</string_list>
    </parameter>
    
  • channel - поле для выбора канала из подключенных к серверу
    <parameter>
        <type>channel</type>
        <id>channel_id</id>
        <name>Камера</name>
        <value></value>
    </parameter>
    
  • objects - поле для выбора объектов сервера
    <parameter>
        <type>objects</type>
        <id>objects_id</id>
        <name>Объекты</name>
        <value></value>
    </parameter>
    
  • server - поле для выбора сервера
    <parameter>
        <type>server</type>
        <id>server_id</id>
        <name>Сервер</name>
        <value></value>
    </parameter>
    

В тегах resources указывается относительный путь к файлу, который будет выполнятся вместе со скриптом.