Navikey Wiki Pages

Использование функций позволяет выполнять дополнительные настройки для мобильного приложения AirLay Control. На текущий момент доступны следующие функции:

• Визуальное разграничение атрибутов в форме;
• Установка связи с категорией;
• Включение уменьшенных отступов между элементами формы;
• Включение разрешений на добавление медиа из галереи (В ПРОЦЕССЕ РЕАЛИЗАЦИИ);
• Включение компактного представления формы, скрывая необязательные поля к заполнению (В ПРОЦЕССЕ РЕАЛИЗАЦИИ);
• Включение автозаполнения формы данными с раннее заполненной формы (В ПРОЦЕССЕ РЕАЛИЗАЦИИ);
• Проверка поля на совпадение с раннее введенными данными (предупреждение) (В ПРОЦЕССЕ РЕАЛИЗАЦИИ);
• Проверка поля на совпадение с раннее введенными данными (блокировка отправки) (В ПРОЦЕССЕ РЕАЛИЗАЦИИ).

С целью удобства формирования формирования функций можно воспользоваться шаблонизатором функций

Функции представляют из себя json элемент, в котором содержится описание правила подключаемого модуля.

Для добавления визуального разграничения формы в схему, необходимо:

1. Войти в систему с правами администратора;
2. Нажать кнопку «Главное меню»;
3. Нажать кнопку «Администрирование»;
4. Выбрать «Модуль трека»;
5. Выбрать необходимый модуль, который будет использоваться для схемы в мобильном приложении AirLay Control, путем нажатия ЛКМ;
6. Перейти во вкладку «Схемы»;
7. Напротив необходимой схемы нажать кнопку «Настройки»;
8. Перейти во вкладку «Список параметров»;
9. В поле «Имя» добавить _group1, а в поле «Псевдоним» задать наименование группы и нажать кнопку «Добавить»;
10. В поле «Задать значение» добавить необходимую цветовую схему в формате HEX, где:
    1. первые две цифры - установка прозрачности;
    2. остальные - код цветовой схемы.

Пример добавленной функции визуального разграничения атрибутов в форме представлен на рисунке 1.
Рисунок 1. Добавленная функция в схему для разграничения атрибутов формы

Рисунок 2. Пример отображения функции визуального разграничения атрибутов

Для добавления функции в схему, необходимо:

1. Войти в систему с правами администратора;
2. Нажать кнопку «Главное меню»;
3. Нажать кнопку «Администрирование»;
4. Выбрать «Модуль трека»;
5. Выбрать необходимый модуль, который будет использоваться для схемы в мобильном приложении AirLay Control, путем нажатия ЛКМ;
6. Перейти во вкладку «Схемы»;
7. Напротив необходимой схемы нажать кнопку «Настройки»;
8. Перейти во вкладку «Список параметров»;
9. В поле «Имя» добавить _properties и нажать кнопку «Добавить»;
10. Поле «Псевдоним» добавить любой символ (не влияет на используемую фукнцию и отображение);
11. В поле «Задать значение» добавить необходимую функцию.

Пример добавленной функции представлен на рисунке 3.
Рисунок 3. Добавленная функция в схему для разграничения атрибутов формы

Визуальное разграничение позволяет устанавливать цветовые схемы и группировать поля в форме.
Правила формирования разграничения атрибутов формы включают в себя:

• Атрибуты _group* заканчиваются числом, которая образует последовательность. Например при первичном добавлении разграничения необходимо указывать _group1, а для следующих групп необходимо указывать _group2 и т.д.;
• Если в схеме используется 1 группа и необходимо ввести ограничение на кол-во сгруппированных элементов, необходимо после закрывающиего элемента добавить атрибут _endgroup1, где цифра - указатель на имя группы, с которой выполнялось ограничение;
• Если в схеме используются 2 группы и более, то для введения ограничения на кол-во сгруппированных элементов, будет достаточным добавления следующего атрибута _group2, где цифра указывает номер следующей группы.
• Все цветовые схемы HEX начинаются с #
• Для установки прозрачности цвета, необходимо после # добавить число, которое будет указывать на прозрачность (измеряется в процентах). Например, при добавлении цвета #f01616, необходимо установить прозрачность 40%. Для этого необходимо после # добавить значение 40. Конечный вариант выглядит следующим образом: #40f01616

Рисунок 4. Пример настроенной схемы для визуального разграничения атрибутов в форме

Рисунок 5. Пример отображения настроенны схемы для визуального разграничения атрибутов в форме мобильного приложения

Установка связи с категорией позволяет присваивать сущностям, отправленным из настроенной схемы, значения по умолчанию.

Сценарий использования: в наборе данных с объектами электросети содержится множество типов объектов (опоры, линии, подстанции и т.д.). Для каждого типа объекта необходимо использовать соответствующую форму заполнения отчета. Для этого, администратор ИС создает соответствующие категории, куда добавляет атрибуты, позволяющие идентифицировать отчет, а именно по какому типу объекта он был отправлен.

Для добавления функции установки связи с категорией в схему, необходимо:

1. Войти в систему с правами администратора;
2. Нажать кнопку «Главное меню»;
3. Нажать кнопку «Администрирование»;
4. Выбрать «Список категорий»;
5. Создать новую категорию и установить необходимые параметры;
6. Скопировать идентификатор категории, путем нажатия ЛКМ под наименованием категории;
7. Перейти в «Модуль трека»;
8. Выбрать необходимый модуль, который будет использоваться для схемы в мобильном приложении AirLay Control, путем нажатия ЛКМ;
9. Перейти во вкладку «Схемы»;
10. Напротив необходимой схемы нажать кнопку «Настройки»;
11. Перейти во вкладку «Список параметров»;
12. В поле «Имя» добавить _properties и нажать кнопку «Добавить»;
13. Поле «Псевдоним» добавить любой символ (не влияет на используемую фукнцию и отображение);
14. В поле «Задать значение» добавить функцию, которая формируется следующим образом:

    {"category_id": "id"}

где, id - идентификатор скопированной категории.

Пример добавленной функции установки связи с категорией представлен на рисунке 6.
Рисунок 6. Добавленная функция установки связи с категорией в схему

Включение уменьшенных отступов между элементами формы позволяет сократить отступы между полями для заполнения в форме.

Для добавления функции уменьшения отступов в схему, необходимо:

1. Войти в систему с правами администратора;
2. Нажать кнопку «Главное меню»;
3. Нажать кнопку «Администрирование»;
4. Выбрать в «Модуль трека»;
5. Выбрать необходимый модуль, который будет использоваться для схемы в мобильном приложении AirLay Control, путем нажатия ЛКМ;
6. Перейти во вкладку «Схемы»;
7. Напротив необходимой схемы нажать кнопку «Настройки»;
8. Перейти во вкладку «Список параметров»;
9. В поле «Имя» добавить _properties и нажать кнопку «Добавить»;
10. Поле «Псевдоним» добавить любой символ (не влияет на используемую фукнцию и отображение);
11. В поле «Задать значение» добавить следующую функцию:

    {"slim_view": true}

Примечание: для использования нескольких функций, необходимо разделять запятыми внутри json элемента, например:

{"category_id":"663491dc5cb8f5bb43020446","slim_view":true}

Пример добавленной функции уменьшения отступов представлен на рисунке 7.
Рисунок 7. Добавленная функция уменьшения отступов

Сравнение включенной и выключенной функции уменьшения отступов представлено на рисунке 8.

Рисунок 8. Сравнение включенной и выключенной функции

Для добавления возможности прикрепления медиа к полю схемы, необходимо:

1. Войти в систему с правами администратора;
2. Нажать кнопку «Главное меню»;
3. Нажать кнопку «Администрирование»;
4. Выбрать «Модуль трека»;
5. Выбрать необходимый модуль, который будет использоваться для схемы в мобильном приложении AirLay Control, путем нажатия ЛКМ;
6. Перейти во вкладку «Схемы»;
7. Напротив необходимой схемы нажать кнопку «Настройки»;
8. Перейти во вкладку «Список параметров»;
9. В том поле где необходимо прикрепление медиа в поле «Имя» добавить в конце наименования поля _media (пример: name_media - у поля name в приложении будет возможность прикрепить медиа к конкретному полю;

Перечень опций которые влияют на поведение программы при работе со схемой в которой они указаны:

{"category_id":"id", ...}

{"allow_gallery": true|false}

{"compact_view": true|false}

{"slimView": true|false}

{"check_unique_warn": 
  ["num","name", ...]
}

{"check_unique_err": 
  ["id", "num", ...]
}

{"auto_fill_form": 
  ["dname", "num_pilon", ...]
}

{"auto_fill_master_form": 
  ["properties.name", 
   "length", 
   "issue", ...]
}

{"gps_accuracy_limit":5}

{"require_field_media_count":0|1}

{"allow_link_objects": true|false}

{"add_creation_issue_data": true|false}

{"min_object_creation_distance": 0-999}