ОАО «Сотовая связь Башкортостана» Описание программного модуля «Информатор о состоянии баланса» Версия для ОС Android Уфа, 2015 Содержание 1. Предназначение .......................................................................................................................2 2. Принципы работы ...................................................................................................................2 3. Порядок установки..................................................................................................................3 4. Описание элементов пользовательского интерфейса ......................................................3 4.1. Основной экран приложения .........................................................................................3 4.1.1. Закладка “Состояние” ..................................................................................................3 4.1.2 Закладка “Авторизация” ..............................................................................................4 4.1.3 Закладка “Настройки” ..................................................................................................4 4.1.4 Закладка “О программе” ..............................................................................................5 4.2. Сообщения в области системных уведомлений..........................................................5 4.3. Действие функциональных клавиш .............................................................................5 5. Контакты...................................................................................................................................5 1. Предназначение Мобильное приложение «Сотел», также имеющее название Информатор о состоянии баланса (в дальнейшем - Информатор), создано для оперативного оповещения абонента об изменениях состояния баланса лицевого счёта. Приложение периодически обращается к биллинговому серверу компании-оператора для обновления информации об остатке средств на балансе лицевого счёта. Имеет интерфейс для настройки параметров информирования и просмотра получаемой информации. Приложение может запускаться на любых мобильных устройствах (смартфонах, планшетах), работающих под управлением операционной системы Android 4.x и более поздних версий. Однако возможна не совсем корректная работа приложения на устройствах, которые не входят в число смартфонов, официально реализуемых компанией ОАО «Сотовая связь Башкортостана». К числу устройств, на которых приложение было оттестировано, а его функционирование признанно удовлетворительным, относятся следующие модели оборудования: Atel K100; HongKang HK-6186. 2. Принципы работы Информатор периодически посылает запросы к биллинговому серверу для получения информации о состоянии баланса телефонного номера. Периодичность запросов устанавливается в закладке “Настройки” основного экрана приложения, это настраиваемый параметр. Полученная информация отражается в закладке “Состояние” и в области системных уведомлений. При этом отображается не только само состояние баланса, но и оценка его уровня с точки зрения необходимости пополнения. Оценка уровня баланса зависит от настроек пользователя: порога оповещения и порога отключения. Также пользователь может выбрать баланс для сравнения, т.е. определить, по балансу какого типа будет проводиться оценка уровня баланса. Типы баланса: Текущий баланс; Баланс с учетом бонусов; Баланс с учетом кредитной линии. Уровень баланса может быть оценен как: Баланс достаточен для нормальной работы - если выбранный баланс для сравнения больше порога оповещения; Требуется пополнение баланса - если выбранный баланс для сравнения меньше порога оповещения, но больше порога отключения; Баланс снизился до критического значения - если выбранный баланс для сравнения меньше порога отключения. Отсутствие соединения с сервером – если связь с биллинговым сервером не установлена, и информацию о состоянии баланса получить не удалось. При изменении уровня баланса в области системных уведомлений появится сообщение. С момента запуска приложения «Сотел» и проходения процедуры авторизации к биллинговому серверу будут периодически осуществляться запросы для обновления данных о состоянии баланса. В случае, если параметры авторизации (номер телефона и пароль доступа) не были установлены или были установлены неверно, то периодические запросы к биллинговому серверу не будут осуществляться до тех пор, пока не будут установлены верные параметры авторизации, и их проверка на сервере не пройдет успешно. 3. Порядок установки Инсталляционный дистрибутив приложения представляет собой файл BalanceInformer.apk. Установка приложений данного формата на мобильные устройства возможна любым из способов, описанных в статье «Как установить *.apk файлы на Android», доступной по адресу http://droidtalk.org/articles/install-apk.html При установке следует обратить внимание на следующие моменты: Непосредственно перед инсталляцией необходимо разрешить установку приложений из неизвестных источников: перейти на экран «Настройки / Settings -> Безопасность / Security" (или «Настройки / Settings -> Приложения / Application Settings") и поставить галочку напротив пункта «Неизвестные источники / Unknown Sources». После инсталляции (согласно упомянутой выше инструкции) следует перейти на экран «Настройки / Settings -> Диспетчер приложений / Application Manager», выбрать приложение «Сотел» и поставить галочку напротив пункта «Выводить уведомления / Show notifications». В результате инсталляции на одном из экранов «Приложения» появится пиктограмма приложения «Сотел». Нажав на неё, можно запустить Информатор. Первый запуск приложения и авторизацию рекомендуется производить при наличии включенного доступа в Интернет (через Wi-Fi или «Мобильные данные»). 4. Описание элементов пользовательского интерфейса Пользовательский интерфейс Информатора представляет собой основной экран приложения, разделённый на закладки. Кроме того, при изменении уровня баланса Информатор направляет в область системных уведомлений сообщение соответствующего содержания. 4.1. Основной экран приложения Основной экран приложения включает в себя систему из четырёх закладок. Более подробно каждая из закладок описана ниже. 4.1.1. Закладка “Состояние” В закладке “Состояние” отражается: Состояние номера, которое может принимать значения: o o o o Активен; Заблокирован; Выключен; Не определено; Состояние баланса, измеряется в рублях, имеет варианты: o Текущий баланс; o Баланс с учетом бонусов; o Баланс с учетом кредитной линии; Сумма текущих начислений за услуги связи, произведенных с момента выставления последнего счёта; Оценка уровня баланса, которая может принимать значения: o o o o o o Баланс достаточен для нормальной работы; Требуется пополнение баланса; Баланс снизился до критического значения; Отсутствует соединение с сервером; Ошибка авторизации; Информация временно недоступна. В закладке “Состояние” находится кнопка “Обновить”. При нажатии на эту кнопку будет отправлен запрос к биллинговому серверу, и все поля закладки “Состояние” примут актуальные на данный момент значения. Если изменилась оценка уровня баланса, то обновленная информация будет показана не только в закладке “Состояние”, но и отразится в виде нового сообщения в области системных уведомлений. 4.1.2 Закладка “Авторизация” Закладка “Авторизация” содержит следующие поля ввода: Телефон – 10-значный номер телефона, используемый для идентификации лицевого счёта, по которому запрашивается баланс; Пароль доступа – комбинация символов (не более 8) для проверки прав доступа к информации о состоянии лицевого счёта (этот же пароль используется для проверки прав доступа к ИССА). Кроме этого, в закладке “Авторизация” находится кнопка “Проверить”. При нажатии на эту кнопку происходит проверка, заполнены ли поля, и совпадают ли данные из полей ввода пароля. Если поля не заполнены, или значения полей пароля не совпадают, то выдается сообщение об ошибке. Если проверка прошла успешно, то далее происходит соединение с биллинговым сервером. Обновленные данные будут показаны в закладке “Состояние”. Если изменилась оценка уровня баланса, то обновленная информация не только отобразится в закладке “Состояние”, но и в области системных уведомлений. 4.1.3 Закладка “Настройки” Закладка “Настройки” содержит следующие редактируемые настройки: Баланс для сравнения – поле выбора из нескольких предопределённых вариантов, по какому из балансов (текущему, с учетом бонусов, с учетом кредитной линии) будет производиться оценка уровня баланса; Порог оповещения – поле ввода денежного порогового значения, с которым будет сравниваться выбранный вариант баланса; Порог отключения - поле ввода денежного порогового значения, с которым будет сравниваться выбранный вариант баланса; Частота опроса – поле ввода периодичности обновления данных от биллингового сервера, в случае, если предыдущее соединение с сервером прошло без ошибок; Частота попыток соединения – поле ввода периодичности запросов к биллинговому серверу, если до этого была попытка соединения, но она прошла неудачно (пришло сообщение об ошибке). В нижней части закладки “Настройка” находится кнопка “Сохранить”. При нажатии на эту кнопку будут сохранены новые настройки и отправлен запрос к биллинговому серверу. Все поля закладки “Состояние” примут актуальные на данный момент значения. Если изменилась оценка уровня баланса, то обновленная информация будет показана не только в закладке “Состояние”, но и в области системных уведомлений. 4.1.4 Закладка “О программе” В закладке “О программе” собрана краткая информация о компаниях, заказавшей и разработавшей программный модуль Информатор о состоянии баланса. 4.2. Сообщения в области системных уведомлений При изменении уровня баланса в области системных уведомлений появится сообщение вида: «Сотел: Изменение баланса. <Текущий уровень баланса> ». Одновременно может быть подан звуковой и вибрирующий сигнал, если настройки оборудования позволят приложению подать такие сигналы. Также на экране на несколько секунд появится всплывающее текстовое сообщение, содержащее описание текущего уровня баланса. При нажатии на сообщение, появившееся в области системных уведомлений, на экран автоматически будет выведено основное окно приложения с открытой закладкой «Состояние», а сообщение из области системных уведомлений будет удалено. 4.3. Действие функциональных клавиш В заключение опишем способы управления приложением с помощью стандартных функциональных клавиш мобильного устройства: Перевод приложения в фоновый режим осуществляется коротким нажатием кнопки «Домой» («Home», средняя кнопка); Закрытие приложения осуществляется нажатием кнопки «Назад» («Back», правая кнопка) с последующим выбором варианта «Закрыть приложение - Да»; Возврат приложения из фонового режима осуществляется более длительным удерживанием кнопки «Домой» («Home», средняя кнопка) и выбором в появившемся списке приложения «Сотел». 5. Контакты По всем дополнительным вопросам следует обращаться в справочную службу ОАО «Сотовая связь Башкортостана» по телефонам: (347) 200-64-64, или 000 - с мобильных телефонов абонентов сети «Сотел».