Система информирования клиентов по электронной почте. e-Reporter (стр. 4 )

2.6.5  Просмотр сообщения.

Каждое из сообщений может быть детально просмотрено в окне просмотра сообщения. В данном окне отображается вся информация о сформированном сообщении:

2.7  Программа eSender.

Программа eSender. exe осуществляет непосредственную централизованную рассылку электронной почты по адресатам. Программа работает в автономном режиме и с помощью настроек работы может быть настроена таким, образом, чтобы автоматически закрывать соединения с базой данных в нерабочее время (например, для архивирования).

Программа eSender. exe периодически, с периодом, заданным в настройках системы, просматривает базу данных и отправляет сообщения, ожидающие отправку. Также осуществляется попытка повторно отправить ранее неудачно отправленные сообщения. Максимальное число попыток отправок каждого сообщения задается в настройках системы e-Reporter.

Отправка электронной почты происходит через SMTP сервер, настройки работы с SMTP сервером задаются в соответствующем разделе окна настроек.

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

2.7.1  Главное окно программы eSender.

Программа eSender. exe имеет три пункта меню, расположенных в верхней части программы:

Разослать - осуществляет рассылку сформированных электронных писем

Пауза - приостанавливает работу программы и закрывает соединения с базой данных

Параметры - параметры системы e-Reporter

2.7.2  Настройки программы eSender.

Настройки программы eSender полностью идентичны настройкам eReporter и хранятся в единой базе данных. Таким образом, независимо от того в какой программе и с какого рабочего места Вы изменяли настройки, они будут изменены для всей системы e-Reporter в целом.

3  Руководство программиста (Интеграция системы)

3.1  Формата базы данных.

База данных состоит из четырех таблиц:

OPTIONS - основные настройки системы

CLIENT - параметры зарегистрированных для обслуживания клиентов

CLIENT_ACCOUNT - информация об обслуживаемых счетах

CLIENT_REPORT - информация о подготовленных, а также об уже отправленных документах

Структура таблиц для базы в формате MS Access идентична базе MS SQL, различия лишь в типах некоторых данных.

3.2  REPORTGATE. DLL описание интерфейса COM объектов.

Для функционирования системы e-Reporter, предназначена COM библиотека REPORTGATE. DLL. Все взаимодействия с системой могут быть выполнены через указанную библиотеку. Таким образом, взаимодействие с системой e-Reporter может быть реализовано в любой банковской системе, поддерживающей работу с COM (ActiveX) объектами, как например в программе RS-Bank, а также в программах MS Access, MS Word, MS Excel, Internet Explorer и т. д.

Для взаимодействия с системой e-Reporter, библиотека REPORTGATE. DLL предоставляет три объекта:

RGATE - класс, предоставляющий основные функциональные возможности для взаимодействия с системой e-Reporter

TLOG - класс, осуществляющий обработку ошибок и ведение журнала ошибок

DB - класс, осуществляющий взаимодействие с базой данных.

3.2.1  Класс TLOG

Для использования журнала ведения ошибок, требуется создать и произвести инициализацию объекта класса TLOG процедурой InitLog:

InitLog ( useFileLOG As Boolean, FullFileName As String, TitlePROG As String, OverWrite As Boolean )

useFileLOG - значение TRUE говорит о необходимости вывода журнала ошибок в файл, при значении FALSE файл журнала не ведется, а уведомления об ошибках могут быть получены через событиe LOG класса TLOG

FullFileName - задает полный путь до файла ведения журнала ошибок. Файл может не существовать, но обязательно должен иметься доступ на запись в данный файл. Также один файл не должен быть использован несколькими экземплярами одной программы, т. к. одновременное открытие на запись одного и того же файла невозможно.

TitlePROG - заголовок для окон с сообщениями об ошибках.

GlobalDebug As Boolean

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

3.2.2  Класс RGATE

Основной класс для взаимодействия с системой e-Reporter. Основные, доступные для чтения свойства класса:

WasError - устанавливается TRUE, если произошла какая-либо ошибка при вызове функции или процедуры.

LastError - свойство содержит текст последней произошедшей ошибки.

mLicensedVersion - свойство возвращает значение TRUE в случае использования зарегистрированной версии. При использовании демонстрационной версии возвращается значение FALSE.

WasUpdate - свойство, устанавливаемое функциями и процедурами, производящими обновление информации в базе данных. Значение TRUE сигнализирует о реальном изменении данных в базе данных при вызове последней процедуры. Так, например, при вызове функции UpdateClients, если информация, переданная в систему e-Reporter, совпала с хранимой в базе данных, то по возвращении из функции, значение WasUpdate будет равно FALSE, а если какое-либо поле было изменено, значение WasUpdate будет TURE.

Init(DBPath As String, LOG As TLog, PASS As String, SQLBase As Boolean, UDL As String = "")

DBPath - полный путь до файла базы данных MS Access ereporter. mdb, при использовании MS SQL сервера параметр игнорируется.

LOG - если требуется ведение журнала ошибок, то в параметре передается ссылка на уже созданный объект класса TLog.

PASS - если используется база данных MS Access, то этим параметром может быть задан пароль для доступа к базе данных.

SQLBASE - значение TRUE указывает на необходимость работы с MS SQL сервером. Одновременно с этим должен быть указан и параметр UDL. Если версия системы e-Reporter не поддерживает работу с MS SQL сервером, то данный параметр будет проигнорирован.

UDL - имя *.udl файла (с указанием полного пути) с настройками для подключения к MS SQL серверу, при работе с базой MS Access данный параметр игнорируется.

Function OpenConnections (UserID As String, Password As String )

Функция открывает соединения с базой данных, параметры UserID, Password могут дополнительно определять логин и пароль для доступа. Класс RGATE должен быть предварительно проинициализирован методом Init.

Function CloseConnections()

Функция осуществляет закрытие активных соединений с базой данных.

Function GetActiveClients(SILENT As Boolean) As ADODB. Recordset

Функция возвращает объект типа ADODB. Recordset всех активных на текущий момент клиентов (статус которых ACTIVE). Структура полей возвращаемого объекта ADODB. Recordset полностью соответствует формату и описанию таблицы CLIENT базы данных. Параметр SILENT = TRUE отключает вывод на экран каких-либо сообщений об ошибках, ошибки записываются только в лог файл, если это было указано при вызове метода Init.

Function GetActiveAccounts(ClientID As Long, SILENT As Boolean) As ADODB. Recordset

Функция возвращает объект типа ADODB. Recordset всех активных на текущий момент счетов клиента (статус которых ACTIVE). Структура полей возвращаемого объекта ADODB. Recordset полностью соответствует формату и описанию таблицы CLIENT_ACCOUNT базы данных. Параметр SILENT = TRUE отключает вывод на экран каких-либо сообщений об ошибках, ошибки записываются только в лог файл, если это было указано при вызове метода Init.

Function ShowClient_RS(ByRef RS As ADODB. Recordset, ByRef RS_ACCT As ADODB. Recordset, ByVal OnlyView As Boolean, edit As Boolean, add As Boolean, delete As Boolean, DisableCancel As Boolean) As Boolean

Функция отображает параметры клиента и его счетов, переданные в параметрах RS и RS_ACCT соответственно. Параметр OnlyView, установленный в TRUE отображает только окно для просмотра и не дает возможности редактирования. Параметры edit, add, delete при передачи их значений, равными TRUE, позволяют редактировать, добавлять и удалять соответственно счета клиента. В некоторых случаях обработка кнопки Cancel на форме не может быть применена, для этого кнопку Cancel рекомендуется скрыть, передав в параметре DisableCancel значение TRUE.

Function ShowHistory_RS(rs As ADODB. Recordset, ByVal ClientID As Long, Caption As String, ByVal OnlyView As Boolean, edit As Boolean, add As Boolean, delete As Boolean)

Функция отображает список отправленных и подготовленных к отправке сообщений для клиента ClientID. В параметре RS передается Recordset списка сообщений. Caption – заголовок отображаемого окна. Параметр OnlyView установленный в TRUE запрещает любые редактирования и изменения, форма открывается только на просмотр. Параметры edit, add, delete при передаче их значений, установленных в TRUE, позволяют редактировать, добавлять и удалять соответственно документы клиента.

Function ShowReport_RS(ByRef rs As ADODB. Recordset, ByVal OnlyView As Boolean) As Boolean

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