Сервис заданий
Сервис заданий является инструментом, расширяющим возможности платформы Rightech IoT Cloud. Данный сервис предназначен для формирования, назначения и контроля за исполнением заданий, направленных на поддержание IoT-устройств в работоспособном состоянии.
Задания могут создаваться из интерфейса оператора — платформу Rightech, работником сервисной службы через мобильное приложение RIC Service, а также автоматически формироваться платформой через инструмент автоматов логики.
Исполнитель — работник компании, исполняющий задания.
Оператор — сотрудник, имеющий доступ к интерфейсу платформы и управляющий потоком задач из него.
Интерфейс оператора — платформа Rightech IoT Cloud.
Приложение — android-приложение RIC Service, с помощью которого Исполнитель создает или получает задачи и фиксирует результат их выполнения. Можно установить через Google Play.
Тип задания — шаблон задачи, который определяет список дополнительных полей, доступные исполнителю команды, иконку задания и т.п.
https://www.youtube.com/watch?v=h0zJTgUrBlM
Интерфейс сервиса заданий в платформе Rightech представляет собой Kanban-доску, на которой отображаются все задания и их текущий статус. Данный интерфейс оптимально подходит для работы операторов, которым важно видеть общую картину сервисного обслуживания компании

Помимо отображения в виде Kanban-доски пользователь может посмотреть задания на карте или вывести в виде таблицы. При выборе табличного представления есть возможность группировать задания по пользователям, которым они назначены, и по объектам. Это удобно для изучения статистики работы каждого из исполнителей и для анализа частоты сбоев на каждой единице


https://www.youtube.com/watch?v=ZJ3K2eOPNBI
Сервис заданий позволяет контролировать жизненный цикл каждого задания с момента его создания. Задания могут быть разделены на типы, которые настраиваются, исходя из потребностей пользователя.
На рабочем пространстве задание представляет собой карточку с описанием поставленной задачи, связанную с объектом. Для большей детализации пользователь опционально может добавлять в окне конкретного задания комментарии, срок исполнения, а также загружать и просматривать фото-материалы. В качестве примера — задания в платформе и в интерфейсе мобильного приложения RIC Service.


Более подробно о работе с карточкой в интерфейсе приложения RIC Service можно ознакомиться в соответствующем разделе.
На карточке цветовой индикацией помечен приоритет задания: зеленый (низкий), желтый (средний), красный (высокий).
Первая строка — имя типа задания с его иконкой.
Вторая строка — кликабельная ссылка на объект.
Третья строка — срок исполнения задачи.
Кнопка «Редактировать» (появляется при наведении) позволяет изменить задание.
Наличие исполнителя отмечается на карточке в правом нижнем углу. Там указывается первая буква имени пользователя-исполнителя.

Существуют четыре основных статуса задания:
Открытые — задача создана, исполнитель не выбран. В мобильном приложении такие задания видны всем исполнителям, и их может взять любой из них.
Назначенные — исполнитель взял задачу себе. Остальные исполнители теряют доступ к этой задаче. При назначении задачи никаких операций над объектом не производится. Исполнитель не может отправлять команды из мобильного приложения.
В работе — исполнитель начал работу над задачей. В этом случае выполняются действия, определенные в типе задачи. Чаще всего обязательным действием будет являться снятие объекта с линии (Смена статуса — Поломка). Исполнителю предоставляется доступ к тем командам, что определены в типе задания.
Завершенные — исполнитель закрыл задачу. После завершения задания исполнитель теряет доступ к объекту, а в задании фиксируется время завершения задания. Завершая задание, исполнитель заполняет отчет, который включает возможность оставить комментарий, прикрепить фотографии и заполнить дополнительные поля. Эти поля могут быть как обязательными, так и нет. Это определяется конфигурацией типа задания.
Чтобы изменить статус задания из интерфейса оператора необходимо кликнуть на карточку задания. Если кликнуть на несколько карточек, то будет произведен мультивыбор. Для выбранных карточек можно сделать групповое перемещение.

После этого становится доступным меню управления задачами. Перемещение задач из Открытых в любую другую стадию требует обязательного выбора исполнителя.
При переводе задания “Открытые” —> “Назначенные” появится окно с возможностью выбора исполнителя.

При переводе задания “Назначенные” —> “В работе” появится окно с настройкой отправки команд и проверкой статуса объекта перед взятием в работу.

При мультивыборе оператор может назначить выделенные задания на одного исполнителя, если в открывшемся окне выберет настройку “Перевести все задания с выбранными настройками”. Если отключить эту настройку, то каждое задание будет настраиваться оператором последовательно. При этом можно пропустить задание с помощью специальной кнопки.

Настройки “Отправлять команды” и Проверка статуса объекта перед взятием в работу” могут быть ситуативно отключены оператором. При этом в баннере перевода в работу можно увидеть подсказки по каждому переключателю.
Более подробно эти настройки будут рассмотрены в разделе Тип задания
https://www.youtube.com/watch?v=O3aKPme2MJk
Тип задания — это шаблон, который создается в панели администрирования и выбирается при создании задания из интерфейса платформы или из интерфейса мобильного приложения RIC Service.

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

Предварительно настраиваем параметры в модели устройства. Для удобства реализован соответствующий раздел, но так же можно настроить интересующий параметр напрямую в списке.


https://www.youtube.com/watch?v=J8gJo09JLFM
Для команд в модели устройства можно выбрать метки. Только команды с метками будут видны исполнителю, когда задание будет в статусе «В работе».
Сейчас доступны разные метки, например:
Смена статуса «Поломка» — метка соответствует соответствующей команде смены статуса ТС;
Смена статуса «Свободен» — метка соответствует соответствующей команде смены статуса ТС;
Заблокировать замок — метка для команд блокировки объекта;
Разблокировать замок — метка для команд разблокировки объекта
Заблокировать батарею — закрыть слот батареи;
Разблокировать батарею — открыть слот батареи;
Запустить двигатель — завести;
Остановить двигатель — заглушить.

⚠️ Важно! В модели объекта необходимо указать, какие команды будут соответствовать аналогичным в типе задания.

⚠️ Важно! Для корректной работы сервисов шеринга рекомендуем выбирать действие Смена статуса — Поломка для пункта «Выполнить» при взятии задания в работу. Чтобы Исполнитель получал полный доступ к ТС, а у клиентов сервиса пропадал доступ к объектам в клиентском приложении.

Команды могут отправляться автоматически при взятии задания в работу и при успешном/неуспешном завершении задания. Команды настраиваются в зависимости от сути задания.
⚠️ Обратите внимание. Команды отправляются не при назначении на исполнителя, а при взятии задания в работу.
📝 Пример. Когда исполнитель берет задание, необходимо снимать объект с линии (переводить в статус Поломка), чтобы клиенты сервиса шеринга не могли его взять в аренду. А при завершении задания лучше автоматически настроить отправку команды на блокировку объекта

Проверка статуса объекта перед взятием в работу — включенная настройка, которая не позволяет переводить в работу задание для арендованного объекта. Если данная настройка активирована в типе задания, то при переводе задания в работу через интерфейс оператора будет доступен соответствующий переключатель.


При создании типа задания можно указать теги для того, чтобы определить, какие действия будут применяться при взятии задания в работу, при успешном завершении задачи.
⚠️ Важно! В мобильном приложении будут видны только команды, отмеченные соответствующей меткой.
Для задания можно настроить поля, которые должен заполнять исполнитель.
Количество файлов - число обязательных фото, которые должен прикрепить исполнитель (можно прикрепить больше). Если выбрано 0, то у исполнителя все равно остается возможность прикрепить фото.
Поле «Комментарий» всегда будет доступно для заполнения исполнителем.
В таблице настраиваются заполняемые поля. Они могут быть четырех типов:
Логический — в мобильном приложении появится чекбокс с соответствующим именем.
Строка — поле для ввода текста.
Число — поле для вода числового значения.
Чекбокс (*) слева от поля определяет обязательность его заполнения для успешного завершения задачи.
Для удобства пользователей командой Rightech разработана специальная логика. Основная задача данной логики — контроль состояния заряда транспортного средства. Но помимо этого логика позволяет формировать задание на замену батареи при достижении уровня ниже установленного бизнесом значения. Это позволяет сэкономить время, необходимое на проверку объекта и формирование задания вручную. Данный автомат называется **[new] Контроль разряда с переводом в поломку** (доступен для скачивания и может быть импортирован в проект). Элемент логики, отвечающий за автоматическое формирование задания приведен ниже.

Пример создания автомата для автоматической генерации заданий:
В автомате можно добавить действие «Создать задачу». После выполнения этого действия создается задание, оно появляется в меню «Задания». Автомат необходимо назначить на объект.
⚠️ Обратите внимание! При создании задачи из автомата заложено ограничение: если в открытых, назначенных или задачах в работе есть задание для того же объекта и с тем же типом задания, то задание не будет создано. Это сделано для того, чтобы ошибка в логике работы автомата не приводила к созданию дубликатов заданий.
Для демонстрации создан автомат логики https://drive.google.com/file/d/1NqSzPTI3Y8_YifKgfDpIJzLaKJ1v5kfI/view?usp=drive_link.
https://www.youtube.com/watch?v=-ogHhHAv2yc&t=3s

Данная логика работает по следующему принципу:
После инициализации работы происходит переход в состояние «Ожидание пакета»;
В состоянии ожидания автомат оценивает приходящие пакеты данных объектов;
Если объект прислал значение «Кода ошибки» — True, то логика переходит к блоку «Создание задания»;

Создается задание с настроенным в автомате типом;

Происходит перевод статуса объекта в «Поломка»;
Выводится уведомление о созданном задании

Перевод в поломку

Данный пример демонстрирует возможность автоматизации постановки задания через автомат логики. Возможны и другие сценарии автоматизации на основе кодов ошибок или прочих параметров оборудования.
Помимо автоматизации формирования заданий у пользователей, осуществляющих обслуживание оборудования есть возможность использовать наше мобильное приложение RIC Service. С его помощью взять задание и начать устранение неполадок оборудования можно, находясь в любом месте. Таким образом можно брать несколько заданий и эффективнее выполнять плановые и внеплановые работы с оборудованием. Интерфейс приведен ниже. Ссылка на приложение https://play.google.com/store/apps/details?id=io.rightech.ric.service&pli=1
https://www.youtube.com/watch?v=NIWSHUh2veQ

При авторизации исполнителя в приложении есть возможность выбрать сервер своего проекта. Для этого необходимо нажать иконку шестеренки в правом верхнем углу окна авторизации.
На данный момент доступны на выбор 4 сервера:
sandbox.rightech.io — тестовый сервер;
app.rightech.io — боевой сервер;
dev.rightech.io — публичный сервер;
Custom — задается персональный сервер, например, если домен платформы для проекта отличается от общего домена.

⚠️ Обратите внимание. При сохранении изменений в выборе сервера приложение потребует авторизоваться заново!
После выбора сервера и авторизации пользователя производится переход на основной экран приложения. Основной экран представляет собой карту, на которой по умолчанию открывается раздел Мои заявки.
На карте пользователю доступны следующий функции:
Карта с отображением заданий и геозонами;
Масштабирование карты для удобства поиска;
Кнопка “Мое местоположение”;
Кнопка “Обновить” - Обновляет задания на карте;
Фильтр по типам заданий;
Кнопка настройки отображения геозон;
Баннер заданий со статусами “Назначен” и “В работе”;
Возможность создать задание;
Возможность выбрать несколько заданий и изменить статус либо в “Назначен”, либо в “В работе”;
Поиск объекта из списка, по названию или путем сканирования QR-кода.
Переключение на данный раздел пользовательского меню осуществляется через кнопку, расположенную в основании интерфейса. Для большей информативности реализован значок с количеством текущих заданий, который учитывает общее количество заданий в статусах “Назначен” и “В работе” у пользователя.

Переключатели “Назначен” и в “В работе” позволяют отображать на карте задания данных типов.

⚠️ Обратите внимание. Один из типов должен быть обязательно выбран. Приложение не позволит сделать неактивными оба.
Если потянуть баннер вверх то развернется список заданий пользователя. В данном состоянии можно дополнительно отсортировать список заданий по приоритету или по удаленности от фактического местоположения пользователя.

Переключение на данный раздел пользовательского меню осуществляется через кнопку, расположенную в основании интерфейса

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

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

Работать с заданием можно по нескольким сценариям. Если задание еще нельзя завершить, но необходимо внести данные в протокол, то необходимо нажать на кнопку “Заполнить данные”. Исполнителю будут доступны поля для заполнения. После заполнения необходимых полей изменения применяются после нажатия кнопки “Сохранить изменения”.

Кнопка геопозиции позволяет выставить точку с местоположением задания (объекта) на Google Maps, что позволит построить маршрут до него.

Нажатие на кнопку “Действие” позволит открыть меню смены статуса задания.

В случае успешного назначения, появится сообщение.

При выборе статуса “Завершен” исполнителю будет предложено окно с протоколом задания. Если до этого уже были введены данные, то часть полей будут заполнены.

В карточке задания обязательные поля отображаются со знаком “*****”. Обязательными могут быть текстовое и числовое поля, а так же количество фотографий. Более подробно о настройке обязательных полей для отчета можно посмотреть в разделе Конфигурация отчета о завершении задания.
В случае, если исполнитель попытается завершить задание, не заполнив обязательные поля, приложение не позволит это сделать. Так же будет выведено сообщение-подсказка с указанием полей, которые необходимо заполнить.

Когда все обязательные поля заполнены, исполнитель завершает задание и в приложении появляется сообщение об успешном выполнении.

Если у исполнителя настроено право доступа для создания заданий, то он имеет возможность создавать их из интерфейса мобильного приложения. Для этого в разделах “Мои заявки” и “Открытые заявки” есть кнопка “Создать задание”.

При нажатии на кнопку откроется интерфейс создания задания. Обязательные поля подсвечиваются знаком “*”. Поиск объекта возможен несколькими способами, в том числе с помощью сканирования камерой QR-кода объекта.

https://www.youtube.com/watch?v=O3aKPme2MJk
Настройка доступов для каждой роли сервиса заданий — процесс индивидуальный и зависящий от потребностей конкретного пользователя или бизнеса.
Мы выделяем три основные роли для сервиса заданий:
Администратор — Осуществляет настройку и отладку сервиса, обладает максимальным набором доступов;
Оператор — Осуществляет контроль за своевременным выполнением заданий, обладает средним набором прав доступа для конфигурации проекта;
Исполнитель (работник) — Выполняет задания, обладает наименьшими правами доступа для конфигурации проекта.
Основные права доступа роли, необходимые для настройки сервиса заданий находятся в консоли, раздел “Задания”.

В заключение хочется отметить, что сервис заданий в платформе Rightech является гибким инструментом, который позволяет сэкономить время и ресурсы, затрачиваемые на обслуживание IoT-устройств. Данный инструмент обладает удобным интерфейсом, гибкими настройками представления и подробной статистикой. Встроенная автоматизация и мобильное приложение дополнительно сокращают время между возникновением неисправности и возвращением устройства в работу.
По вопросам настройки сервиса заданий и возникающим проблемам создавайте обращения по конфигурации и консультации в нашем


