Описание приложения Adsl_stat.exe

Содержание

• Назначение
• Требования к программному обеспечению
• Обзор диалогов:
  • Пункты меню вызова диалогов
  • Назначения диалогов
  • Общие функциональные возможности диалогов просмотра данных
• Описания диалогов:
  • Авторизация и загрузка
  • Назначение диалога
  • Авторизация
  • Загрузка
  • Данные по карточкам/счёту
  • Общее описание диалога
  • Описание элементов окна и HTML-представления для случая выбора данных по счёту
  • Описание элементов окна и HTML-представления для случая выбора данных по карточке
  • Данные по дням
  • Данные по месяцам
  • Данные по годам
  • Фильтры
  • Диаграмма
  • О приложении Adsl_stat
• Поддержка приложения, адрес загрузки и обратная связь

Назначение

Приложение Adsl_stat.exe предназначено для ведения базы данных, содержащей информацию о статистике использования Вами Интернет, если Вы являетесь абонентом услуги "Предоставление доступа к сети передачи данных по технологии ADSL/ADSL2/ADSL2+" Интернет Turbo, предоставляемой Пермским филиалом электросвязи OAO "Уралсвязьинформ". Информация включает в себя трафик (объёмы) и денежные расходы (состояния счёта) с разбивкой по дням, месяцам, годам, а также по используемым сервисам Вашего Интернет-провайдера.

Вся исходная информация берётся со страницы статистики на сайте Вашего Интернет-провайдера, а в приложении имеются средства, обеспечивающие такую загрузку и обновление информации в базе данных. Никаких неявных доступов в Интернет для обновления данных по статистике приложение не производит. Вместо этого, Вы должны с определённой (и приемлемой для Вас) частотой беспокоиться об обновлении Ваших данных, загружая их со странички Вашей Интернет статистики (все подробности о загрузке данных см. в разделе Авторизация и загрузка данного документа).

Средствами этого приложения для каждого вида данных Вы также можете получить их HTML-представление/документ (о подробностях см. в разделе Общие функциональные возможности диалогов просмотра данных). Никаких других средств создания отчётов для Ваших данных в рамках этого приложения в настоящий момент не предусмотрено.

Рис. 1

На Рис. 1 показан общий вид приложения с раскрытыми несколькими наиболее типичными диалогами просмотра данных.

Требования к программному обеспечению

Приложение Adsl_stat создано средствами Microsoft® Visual FoxPro® 9.0 (SP1VFP9), поэтому для своей работы требует предварительной установки VFP-runtime для версии 9.0 с включённым в неё SP1VFP9. Ниже перечислены общие требования к системе для работы этого продукта:

• Операционные системы: Windows 98, Windows Me, Windows 2000 Service Pack 3 или позже, Windows XP и Windows Server 2003.
• Память: 64 MB RAM (128 MB или выше рекомендуется).
• Видео: 800 х 600 разрешение, 256 цветов (High color 16-bit рекомендуется).

Программа установки VFP-runtime 9.0 (SP1) является свободно распространяемой и может быть загружена, например с адреса: ftp://prolib.de/Public/VFP9SP1RT.exe, а все компоненты, входящие в состав VFP-runtime 9.0, можно посмотреть по ссылке: http://fox.wikis.com/wc.dll?Wiki~VFP9RuntimeFiles~VFP (en).

В приложении также использован ряд ActiveX/COM-компонент:

Таб. 1

которые также должны быть установлены на компьютер перед использованием приложения Adsl_stat.

Обзор диалогов

Пункты меню вызова диалогов:

На Рис. 2 ниже показаны пункты меню, позволяющие открывать диалоговые окна приложения:

Рис. 2

Назначение диалогов:

В Таб. 2 сведено описание пунктов основного меню по работе с диалогами:

Таб. 2

Общие функциональные возможности диалогов просмотра данных:

• Автосохранение размеров: Любой из диалогов способен сохранять своё текущее положение, а если допускает изменения своих размеров, то и свои текущие размеры. Это означает, что диалог будет появляться в том месте экрана и с такими размерами, с которыми он был на момент своего последнего закрытия.
• Сортировка данных: Любой из столбцов списка данных (исключая списки расшифровок по сервисам), позволяет изменять текущий режим сортировки. Так одиночный щелчок на заголовке любого из столбцов списка данных, изменяет текущий режим сортировки в последовательности: "по возрастанию", "по убыванию", "отмена" сортировки. Так на Рис. 3 ниже, данные в диалоге "Данные по дням" отсортированы в порядке "по возрастанию" в столбце "Трафик".
• Получение HTML-документов: Любой из диалогов просмотра данных позволяет получить HTML-представление/документ своих данных, при этом используется Microsoft® XML Core Services (MSXML) 3.0/4.0 (см. также в разделе Требования к программному обеспечению). Чтобы получить HTML-документ, достаточно на фоне открытого текущего диалога с данными выбрать пункт меню приложения Adsl_stat: "Файл/Сохранить как HTML...":

  

  Рис. 3

  На Рис. 3 изображена ситуация получения HTML-документа для диалога "Данные по дням". Далее, используя Ваши средства просмотра HTML-документов, Вы можете сохранить полученный таким образом документ как файл (обычно пункт меню: "Файл/Сохранить как...") чтобы в дальнейшем иметь возможность его распечатать на Вашем устройстве печати, причём сделать это следует до завершения приложения Adsl_stat, т.к. по завершению приложения все временные файлы, в т.ч. и htm, будут удалены с диска. Никакими другими средствами получения "твёрдой копии" данных приложение Adsl_stat в настоящий момент не располагает.
• Фильтрация данных: каждый из диалогов с данными позволяет установить для него один интервал дат, вне которого данные будут недоступны (невидимы), как при просмотре их из окна диалога, так и при формировании HTML-представления/документа. Это делается с помощью окна установки фильтров (более подробно см. описание в разделе Фильтры данного документа.)
• Диаграммы данных: все диалоги с данными, за исключением "Данные по карточкам/счёту", позволяют просматривать свои данные в виде диаграмм, при этом используется элемент управления «Диаграмма Office» 11.0 (более подробно см. описание в разделах: Требования к программному обеспечению и Диаграмма данного документа.)

Авторизация и загрузка

Назначение диалога

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

Авторизация

Чтобы выполнить загрузку из Интернет самых последних данных о состоянии Вашего счёта/карточки, Вам следует воспользоваться пунктом меню: "Данные/Авторизация и загрузка", при этом будет сделана попытка соединения с Интернет через Ваш ADSL-модем. Если соединение будет успешно установлено, то перед вами откроется форма авторизации на страничку статистики сайта Вашего Интернет-провайдера (для показа содержания веб-страниц в форме используется ActiveX-компонент "Обозреватель веб-страниц Microsoft®", см. также раздел Требования к программному обеспечению):

Рис. 4

Здесь во время первой загрузки, Вам следует в поля "Имя пользователя" и "Пароль" правильно ввести Ваше имя (Логин) и пароль соответственно. Обратите внимание, что во время запуска приложения Adsl_stat текущая раскладка клавиатуры будет всегда установлена в состояние "Русская", поэтому скорее всего, перед вводом данных, Вам следует выполнить переключение раскладки клавиатуры на "Английская". (Если Вы после первой удачной загрузки данных, как рассказано ниже в этом разделе, отредактируете поле "Пароль" так, как изложено в разделе Данные по карточкам/счёту для соответствующего счёта/карточки, то при последующих загрузках страницы авторизации, поля "Имя пользователя" и "Пароль" будут заполняться автоматически)...

Загрузка

Далее, после нажатия на кнопку "Войти", данные в форме перезагрузятся на страницу Вашей статистики, подобно изображённой на Рис. 5:

Рис. 5

После удачной загрузки этой страницы, Вам следует щёлкнуть на кнопку "Сохранить", отмеченную красным эллипсом вверху справа (вернее ближе к центру), при этом содержимое данных этой страницы будет сохранено на локальный диск (в подкаталог Text Вашего каталога с данными) в виде текстового файла с именем, отмеченным красным эллипсом вверху слева. При этом будет также произведён "разбор" содержимого этой страницы, а результаты этого "разбора" сохранены в Вашу локальную базу данных (которая расположена в подкаталоге Data Вашего каталога с данными). Обратите также внимание, что Вам не следует беспокоиться о размере этой страницы, стремясь её открыть и изменить размер так, чтобы все её данные были видимы, т.к. безусловно, все данные этой страницы будут обработаны независимо от её текущего размера. По завершению всех этих действий, в правом верхнем углу приложения возникнет временное окно, информирующее Вас о произведённых изменениях в Вашей базе данных, подобно изображению на Рис. 6:

Рис. 6

По существу это краткий журнал-отчёт о выполненных изменений в Вашей локальной базе данных. Здесь выражения вида: -<Название характеристики>: (<n>,<m>) означает, что для <Название характеристики> выполнено <n> добавлений и/или <m> изменений. После любых нажатий на клавиши и/или движения мыши информационное окно будет закрыто, а данные в любых открытых в настоящий момент диалогах обновлены. Обратите внимание, что это не означает, что Вы увидите самые последние данные в свих диалогах, например Вы не увидите последних загруженных данных, если они будут вне диапазонов дат, установленных с помощью фильтров (более подробно см. описание в разделе Фильтры).

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

Данные по карточкам/счёту

Общее описание диалога

Назначение диалога: позволяет просматривать данных по карточкам/счёту, а также получать HTML-документы для этих данных.

Как работать с этим окном: для открытия окна этого диалога следует воспользоваться пунктом меню: "Данные/Данные по карточкам/счёту". После выбора этого пункта перед Вами будет открыто окно, подобное следующему:

Рис. 7

На Рис. 7 изображена форма, в которой отображается список "Истории состояний счёта" (не карточки).

Работа с раскрывающимся списком "Карточка/счёт": верхний раскрывающийся список "Карточка/счёт" этого окна, позволяет выбрать конкретный счёт (или карточку), данные которого вы желаете просматривать. Данные этого списка не редактируются непосредственно из диалогов, а попадают сюда после загрузки данных со странички статистики Вашего Интернет-провайдера, работа с которой была описана в разделе Авторизация и загрузка выше. Предполагается также, что конкретный пользователь в любой текущий момент времени всегда имеет только один "активный" счёт (или карточку), с которым производится работа, причём таким счётом (карточкой) является последний добавленный. Поэтому, при первом открытии этой формы, всегда в качестве текущего элемента выбирается последний элемент в списке... и соответственно данные для него. Изменения выбранного элемента приводят к обновлению всех данных этого окна для Вами выбранного счёта/карточки. Если после выбора элемента список состояний счёта/карточки оказался пуст, а Вы, тем не менее уверены, что соответствующие данные в базе данных имеются, то скорее всего, проблема в текущих значениях фильтров, ограничивающих множество доступных для просмотра данных. Для урегулирования этого вопроса смотрите раздел Фильтры ниже.

Назначение поля ввода "Пароль": Выбрав в раскрывающемся списке "Карточка/счёт" конкретный элемент, Вы можете ввести в поле "Пароль" значение пароля для выбранного элемента. (Обратите внимание на текущую раскладку клавиатуры, состояние которой отображается в виде значка: "EN/RU" слева от поля ввода. И Вам следует предварительно переключиться именно на ту раскладку клавиатуры, в которой Вами был введён пароль при загрузке станицы авторизации). Это в свою очередь обеспечит автоматическое заполнение полей "Имя пользователя" и "Пароль" во время загрузки странички авторизации на страницу статистики Вашего Интернет-провайдера, работа с которой описана в разделе Авторизация и загрузка выше.

Назначение поля ввода "Дата закрытия": содержание этого поля не является важным с точки зрения "функционирования системы", значение в это поле может быть введено пользователем т.с. "постфактум", уже после реального закрытия срока действия конкретного счёта/карточки.

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

Описание элементов окна и HTML-представления для случая выбора данных по счёту

Ниже приводится описания столбцов этого списка, если в качестве текущего элемента выбран счёт.

Описание столбцов в списке "История состояний счёта":

Таб. 3

Расцветка столбцов и строк в списке "История состояний счёта":

Таб. 4

Нужно сказать, что абонентская плата не отображается среди данных этого окна, а указывается лишь используемый Вами "Тариф". Расходы на абонентскую плату появляются лишь в HTML-представлении этих данных. На Рис. 9 изображено HTML-представление части данных "Истории состояний счёта" (не карточки), получаемых для диалога "Данные по карточкам/счёту" (после выбора пункта меню "Файл/Сохранить как HTML...", см. также раздел Общие функциональные возможности диалогов просмотра данных) и содержащую первую часть отчёта, включающую таблицу списка операций с лицевым счётом:

Рис. 8

На Рис. 9 изображено HTML-представление следующей части данных "Истории состояний счёта" (не карточки), получаемых для диалога "Данные по карточкам/счёту" и содержащую вторую часть отчёта:

Рис. 9

Описание элементов окна и HTML-представления для случая выбора данных по карточке

Ниже даются описание окна для случая, если в качестве текущего элемента в раскрывающемся списке "Карточка/счёт" выбрана карточка. Так, на Рис. 10 изображена форма, в которой отображён список "Истории состояний карточки" (не счёта):

Рис. 10

Описание столбцов в списке "История состояний карточки":

Таб. 5

Нужно сказать, что стоимость карточки не отображается среди данных этого окна, а указывается лишь объём карточки в поле "Тариф". Ниже на Рис. 11 изображено HTML-представление данных "Истории состояний карточки" (не счёта), получаемых для диалога "Данные по карточкам/счёту" (после выбора пункта меню "Файл/Сохранить как HTML...", см. также раздел Общие функциональные возможности диалогов просмотра данных) и содержащую таблицу истории состояний карточки:

Рис. 11

Другие функциональный возможности диалога: все средства, описанные в разделе Общие функциональные возможности диалогов просмотра данных применимы к данному диалогу.

Данные по дням

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

Назначение диалога: позволяет просматривать данных по дням, а также получать HTML-документы для этих данных. Вызов диалога осуществляется с помощью пункта меню "Данные/Данные по дням".

Описание элементов окна: окно выглядит так, как это показано на Рис. 12 ниже:

Рис. 12

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

Таб. 6

а описание столбцов с данными нижнего списка в Таб. 7:

Таб. 7

В верхнем списке при отображении данных использована различная расцветка строк/столбцов. В Таб. 8 описано назначения цветов:

Таб. 8

Нужно сказать также, что суммы, отображаемые в этом окне, не включают в себя расходы на абонентскую оплату.

HTML-представление: можно получить выбрав пункт меню "Файл/Сохранить как HTML..." для данного диалога (см. также раздел Общие функциональные возможности диалогов просмотра данных этого документа), и оно состоит из двух частей: верхняя содержит итоговые суммы за каждый из дней и выглядит так, как показано на Рис. 13

Рис. 13

Вторая (нижняя) часть содержит разбиения дневных оплат по сервисам и выглядит так, как показано на Рис. 14:

Рис. 14

Другие функциональный возможности диалога: все средства, описанные в разделе Общие функциональные возможности диалогов просмотра данных применимы к данному диалогу.

Данные по месяцам

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

Назначение диалога: позволяет просматривать данных по месяцам, а также получать HTML-документы для этих данных. Вызов диалога осуществляется с помощью пункта меню "Данные/Данные по месяцам".

Описание элементов окна: окно выглядит так, как это показано на Рис. 15 ниже:

Рис. 15

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

Таб. 9

а описание столбцов с данными нижнего списка в Таб. 10:

Таб. 10

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

HTML-представление: можно получить выбрав пункт меню "Файл/Сохранить как HTML..." для данного диалога (см. также раздел Общие функциональные возможности диалогов просмотра данных этого документа), и оно состоит из двух частей: верхняя содержит итоговые суммы за каждый из месяцев и выглядит так, как показано на Рис. 16

Рис. 16

Вторая (нижняя) часть содержит разбиения месячных оплат по сервисам и выглядит так, как показано на Рис. 17:

Рис. 17

Другие функциональный возможности диалога: все средства, описанные в разделе Общие функциональные возможности диалогов просмотра данных применимы к данному диалогу.

Данные по годам

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

Назначение диалога: позволяет просматривать данных по месяцам, а также получать HTML-документы для этих данных. Вызов диалога осуществляется с помощью пункта меню "Данные/Данные по годам".

Описание элементов окна: окно выглядит так, как это показано на Рис. 18 ниже:

Рис. 18

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

Таб. 11

а описание столбцов с данными нижнего списка в Таб. 12:

Таб. 12

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

HTML-представление: можно получить выбрав пункт меню "Файл/Сохранить как HTML..." для данного диалога (см. также раздел Общие функциональные возможности диалогов просмотра данных этого документа), и оно состоит из двух частей: верхняя содержит итоговые суммы за каждый из годов, а во второй части (нижней) содержится распределение годовых оплат по сервисам и выглядит это так, как показано на Рис. 19:

Рис. 19

Другие функциональный возможности диалога: все средства, описанные в разделе Общие функциональные возможности диалогов просмотра данных применимы к данному диалогу.

Фильтры

Назначение диалога: позволяет установить (или отменить) диапазон дат, вне которого просмотр данных как в окнах просмотра данных, так и в HTML-представлениях/документах, будет недоступен. Вызов диалога осуществляется с помощью пункта меню "Данные/Фильтры".

Описание элементов окна: окно выглядит так, как это показано на Рис. 20 ниже:

Рис. 20

Назначения элементов окна приведено в Таб. 13:

Таб. 13

При установки признака "все" значения полей с диапазоном дат "с" и "по" очищаются, а при снятии признака "все" в эти поля каждый раз автоматически заносится интервал дат. Этот интервал зависит как от диалога, для которого производится установка диапазона дат, так и от текущей даты. В Таб. 14 приводятся правила, согласно которым выбирается интервал дат:

Таб. 14

Эти же правила действуют и при изменении текущего месяца. Т.е. если при загрузке данных с страницы статистики Вашего Интернет-провайдера будет обнаружена смена месяца, то если для какого-нибудь из диалогов будет установлен интервал дат (не включен признак "все"), то значения интервалов у соответствующих диалогов будут переустановлены согласно правилам, приведённым в Таб. 14.

Для полей "с" и "по" с помощью расположенных справа от них кнопок [...] также можно вызвать окно "Календарь" для выбора даты. При отображении календаря используется элемент управления Календарь 11.0 (Microsoft®) (см. также в разделе Требования к программному обеспечению). На Рис. 21 показано изображение этого окна:

Рис. 21

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

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

Диаграмма

Назначение диалога: все диалоги с данными, исключая Данные по карточкам/счёту, позволяют просматривать свои данные в виде диаграмм, при этом используется элемент управления "Диаграмма Office" 11.0 (из Microsoft® Office® 2003) (см. также Требования к программному обеспечению). Вызов диалога осуществляется с помощью пункта меню "Данные/Диаграмма" для одного из открытых окон с данными. На Рис. 22 ниже показана диаграмма для данных диалога "Данные по дням":

Рис. 22

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

HTML-представление: можно получить выбрав пункт меню "Файл/Сохранить как HTML..." для данного диалога (см. также раздел Общие функциональные возможности диалогов просмотра данных этого документа).

О приложении Adsl_stat

Назначение диалога: позволяет просматривать общие сведенья о приложении, такие как: текущая версия приложения, авторские права, месторасположение базы данных, для перехода по ссылке на сайт поддержки и т.п... Вызов диалога осуществляется с помощью пункта меню "Справка/О приложении Adsl_stat...".

Описание элементов окна: окно выглядит так, как это показано на Рис. 23 ниже:

Рис. 23

Поддержка приложения, адрес загрузки и обратная связь

Ряд общих вопросов по поддержке работоспособности приложения adsl_stat.exe:

• Условия распространения: бесплатное для не коммерческого использования.
• Адрес для загрузки последней версии: http://vfpdev.narod.ru/download/pdslstat.zip (2,12МБ)
• Месторасположение файла-журнала ошибок: При возникновении любых ошибок, помимо выдачи соответствующего сообщения, информация об ошибке будет записана в текстовый файл Events.log, расположенный в том же каталоге, где находится и исполняемый файл Adsl_stat.exe.
• Как связаться с автором: Если при использовании приложения Adsl_stat у Вас возникли проблемы и Вы не можете устранить их причину, то с автором программы можно связаться, используя ссылку в конце данной страницы, при этом обязательно присоедините к посланию Ваш файл Events.log.
• Форум для обсуждений: Обсудить возможные проблемы можно также и интерактивно на форуме этого сайта, который расположен по адресу: http://narod.yandex.ru/userforum/?owner=vfpdev.
• Отзывы и пожелания: Вы можете также оставить свои отзывы в Гостевой книге сайта.

Список выпущенных версий и изменений в них: 

Таб. 15

По вопросам, связанным с этим веб-узлом, обращайтесь по адресу: © Michael Drozdov, 2000-2007. Все права защищены. Последнее изменение страницы: Сб, 24 марта 2007