ConfigEditor (редактор конфигурационных файлов): руководство пользователя

Редактор конфигураций Atlas365 (далее - редактор) позволяет:

Создавать различные конфигурации системы, т.е. создавать и настраивать FTP- и Email-серверы, подключать файлы процессов и настраивать вызов внешних программ, а так же устанавливать дополнительные опции.
Запускать Atlas365.
Создавать файлы запросов.

Общая структура файла конфигурации Atlas365

<?xml version="1.0" encoding="windows-1251"?>
<config>
 <servers>
  <server>
   <emailservers>
   </emailservers>
   <ftpservers>
   </ftpservers>
   <processes>
    <process>
     <id>process1</id>
     <path>C:\Atlas365\examples\LocalFileOperations\ProcessCopyFile.xml</path>
     <active>1</active>
    </process>
   </processes>
   <exeservers>
   </exeservers>
   <active>1</active>
   <trackfilename>1</trackfilename>
   <id>Server1</id>
  </server>
 </servers>
 <licenses>
 </licenses>
 <logfile>
  <name>C:\Atlas365\logs</name>
  <loginfo>255</loginfo>
 </logfile>
</config>

Структура ФК состоит из трех частей: информация о используемых серверах (servers), информация о лицензиях (licenses) и информация о лог-файле (logfile). На рисунке ниже показан общий вид редактора при открытом ФК test.atlas).

Структура редактора

Редактор состоит из главного окна с меню «Файл»; информации о имени открытого конфигурационного файла «Конфигурационный файл» (если никакого файла не открыто, то имя установлено в «не выбран»); панели с вкладками на которых размещены таблица серверов («Серверы»), таблица лицензий («Лицензии») и настройки параметров лог-файла («Параметры лог-файла»). Также редактор позволяет запускать программу Atlas365 из главного окна при помощи кнопки «Запуск». На рисунке ниже показано главное окно программы в случае когда не выбран (не открыт) конфигурационный файл:

Кнопка «Запуск» позволяет запускать Atlas365 и не активна если не выбран конфигурационный файл или созданный файл не сохранен.

Меню «Файл»

Меню «Файл» позволяет создавать, открывать, сохранять и закрывать конфигурационые файлы, а также закрывать редактор:

Главная панель

На главной панели имеются следующие вкладки:

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

Вкладка «Серверы»

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

В нижей части таблицы расположены кнопки:

«Создать» - используется для создания нового сервера. Вызывает форму настройки сервера.
«Удалить» - используется для удаления существующего сервера: удаляет сервер из таблицы. Внимание: операцию удаления сервера отменить нельзя!
«Редактировать» - используется для редактирования существующего сервера. Вызывает форму настройки сервера.

Форма настройки программного сервера

Для доступа к настройкам сервера необходимо выделить соответствующий сервер в таблице и нажать кнопку “Редактировать”:

Форма настройки программного сервера содержит следующие вкладки:

Установки
Серверы FTP
Серверы ЭП (электронной почты)
Процессы
Внешние вызовы

Вкладка Установки

Эта вкладка определяет основные настройки сервера, на которой есть следующие элементы:

ID сервера – имя или «айди» сервера, используется в качестве уникального идентификатора сервера.
Активен – активный/неактивный. Если сервер активен, то он будет задействован в программе Atlas365.
Отслеживать имя файла – эта опиция позволяет пропускать уже обработанный файл, т.е. если файл с таки же именем уже был обработан (например, с помощью операций копирования, конвертации в xml и т.п.), то при последующем сканировании директории, программа его пропускает.

Вкладка Серверы FTP

Эта вкладка позволяет управлять существующими FTP-серверами, а так же создавать новые. Для этого используются следующие кнопки:

Создать – открывает форму создания нового сервера
Удалить – удаляет существующий FTP сервер. Внимание, операцию удаления отменить нельзя!
Редактировать – открывает форму настроек FTP сервера для редактирования
Копировать – создает копию существующего FTP сервера

Форма настроек FTP сервера

Имя сервера - имя сервера, как уникальный идентификатор, не должно содержать пробелов

IP адрес – IP-адрес FTP сервера
Порт – порт соединения
Логин –логин пользователя для входа на даннй FTP-сервер
Пароль –пароль пользователя для входа на данный FTP-сервер
Кодировка – кодировка FTP сервера

Вкладка серверы ЭП (серверы электронной почты)

Эта вкладка отображает существующие серверы электронной почты, например:

Форма настроек почтового сервера

Адрес эл. почты – адрес ящика электронной почты пользователя.
Имя пользователя – имя пользователя (логин), испольющееся для данного почтового ящика.
Сервер входящих сообщений: группа настроек сервера входящей почты
- Имя сервера – имя сервера входящей почты
- Аутентификация – тип аутентификации (password, NONE, External (требуется TLS сертификат), Kerberos Version 5, NTLM, MD5 Challenge - Response).
- Порт – входящий порт
- Использовать SSL – использование SSL-шифрование
- Логин – имя пользователя (логин)
- Пароль – пароль пользователя для данного сервера входящей почты
Сервер исходящих сообщений: группа настроек исходящего почтового сервера
- Имя сервера – имя сервера исходящих сообщений
- Аутентификация – тип аутентификации (password, NONE, External (требуется TLS сертификат), Kerberos Version 5, NTLM, MD5 Challenge - Response).
- Порт – исходящий порт
- Испоьзовать SSL – использовать SSL шифрование
- Имя пользователя – имя пользователя (логин)
- Пароль – пароль пользователя для данного сервера исходящих сообщений
Сертификат TLS– полный путь к файлу сертификата

Вкладка Процессы

Эта вкладка позволяет манипулировать процессами: подключать, удалять, делать процессы неактивными (отключать):

Форма настройки процесса

ID процесса – уникальный (без пробелов) идентификатор процесса, использующийся в программе Atlas365
Имя файла – полный путь к файлу процесса, может быть задан вручную или через кнопку «Обзор»
Активен – активен/неактивен

Вкладка Внешние вызовы

Позволяет задавать вызовы внешних програм:

Форма настройки внешних вызовов

.exe Сервер – уникальный идентификатор исполняемой внешней программы
Имя файла (полный путь) – полный путь к исполняемому файлу
Активен – установка активен/неактивен

Вкладка «Лицензии»

Эта вкладка используется для установки лицензии. В таблице показаны используемые в данный момент (или использованные в прошлом лицензии). Для создания, удаления и редактирования лицензии используются соответсвующие кнопки «Создать», «Удалить», «Редактировать».
Также для формирования файла запроса (см. «Получение лицензии и установка ее в системе») используется соответствующая кнопка «Сформировать файл запроса».

Форма создания/редактирования лицензии

Эта форма состоит из:

Имя файла лицензии – текстовое поле, в котором указан полный путь к файлу лицензии.
Активна – установка лицензии в активный/неактивный режим
Обзор – кнопка выбора файла лицензии
ОК, Отменить, Применить – стандартные кнопки пользовательского интерфейса
Формирования файла запроса

При нажатии на кнопку «Сформировать файл запроса», появляется диалог сохранения файла:

После указания имени и нажатия кнопки «Save» (Сохранить), запустится программа формирования лицензии. После успешного формирования лицензии появится следующее окно сообщения:

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

Вкладка «Параметры лог-файла»

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

Вкладка содержит:

Директория лог-файла – текстовое поле, в котором указана директория в которой будет сохраняться лог-файл.
Дополнительные опции – набор флагов, показывающих вид информации, записываемой в лог-файл:
- Report
- Info
- Error
- Warning
- FTP error
- Email error
- File error
- Debug

Пример создания файла конфигурации

Рассмотрим пошаговое создание простого файла конфигурации, состоящего из одного сервера и файла с процессами, обеспечивающими копирование (перемещение) файлов из одной директории в другую.

Шаг 1

Запустить редактор конфигураций:

Шаг 2

Создание серверов. Для этого в меню «Файл» выберите «Создать»:

Появится таблица с новыми серверами. Удалите один сервер, чтобы получилось так, как показано на рисунке ниже:

Шаг 3

Откройте только что созданний сервер: выделите соответствующую строку в таблице и нажмите кнопку «Редактировать», откроется окно редактирования сервера: