Megatec Integration Service:Работа с окном История. Логирование.

Статья находится на стадии разработки.
Версия статьи от 11-12-2019.

Введение

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

Работа с окном История

В данном окне три режима, а именно:

• Ручной режим;
• Работа с внешней системой;
• Автоимпорт.

«Ручной режим» отображает информацию о возникших ситуациях во время работы пользователя (дата запуска «Megatec Integration Service», ручной импорт данных, предупреждения во время работы).
«Работа с внешней системой» отображает информацию об операциях с сервисом внешней системы (загрузка справочников, цен, квот и стопов).
«Автоимпорт» отображает информацию об операциях автоимпорта (автоимпорт цен, квот и стопов).

Настройка

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

Настройка логирования отправки данных

Раздел <appender name="HotelPricesImport" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">

name="HotelPricesImport" - действия в главном окне (фильтрация, поиск...) и ручной импорт данных в Мастер-Тур
name="HotelPricesAuto" - автоматический импорт данных в Мастер-Тур
name="HotelPricesExternal" - загрузка из внешней системы данных в промежуточную базу

   
      <maximumFileSize value="10MB" /> <!-- максимальный размер файла -->
      <file value="Logs\\Import\\ManualTravelLinePricesImport.log.txt" /> <!-- путь и название файла -->
      <layout type="log4net.Layout.PatternLayout">
        <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" /> <!-- формат строки логирования -->
      </layout>
    </appender>

Аналогичные настройки у разделов: AgreementsReservationImport/Auto/External(бронирование путевок), HotelQuotaImport/Auto/External (квоты и стопы).
Варианты записи логов:
ALL – все сообщения попадают в лог
DEBUG – отладочные сообщения
INFO - информационные сообщения
WARN - предупреждения
ERROR - ошибки
FATAL – ошибки, которые приводят к закрытию приложения
OFF – логирование отключено

Эти уровни вложены друг в друга.
Если стоит DEBUG, то в лог попадают сообщения с уровнем DEBUG и ниже – INFO, WARN, ERROR …
Если стоит INFO, то в лог попадают сообщения с уровнем INFO и ниже – WARN, ERROR … DEBUG уже не попадет. Логи хранятся в папке Import. Пример: D:\MasterTour15.3\MIS\Logs\Import

Отправка писем об ошибках на почту

Данная функция только для адаптеров ProTour и TravelLine 

Раздел <appender name="ImportSendMail" type="log4net.Appender.SMTPAppender">:

      <to value="" /> <!-- адресат, если несколько, то адреса прописываются через запятую -->
      <from value="" /> <!-- корреспондент -->
      <username value="" /> <!-- имя пользователя, учетная запись которого будет использоваться для отправки-->
      <password value="" /> <!-- пароль-->
      <subject value="INFO" /> <!-- тема письма-->
      <smtpHost value="" /> <!-- адрес почтового сервиса-->
      <port value="25" /> <!-- порт -->

После настройки необходимо выбрать к какому режиму будет применено и раскомментировать строку в выбранном режиме:

<!-- <appender-ref ref="ImportSendMail" />  -->

Полное логирование

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

<appender name="FullHotelPricesExternal" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">
     <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
     <encoding value="utf-8" />
     <appendToFile value="true" />
     <maximumFileSize value="5MB" />
     <compressRollingFile value="false" />
     <rollingStyle value="Size" />
     <maxSizeRollBackups value="-1" />
     <file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" />
     <layout type="log4net.Layout.PatternLayout">
       <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" />
     </layout>
   </appender>

appender name="FullHotelPricesExternal" -загрузка цен из внешней системы данных в промежуточную базу.
appender name="FullDictionariesExternal" - загрузка справочников из внешней системы данных в промежуточную базу.
appender name="FullHotelQuotaExternal" загрузка квот и стоп из внешней системы данных в промежуточную базу.
appender name="FullAgreementsReservationExternal" - отправка путевки и получение статуса.
<file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" /> - расположения файла с логами.
<maximumFileSize value="5MB" /> - максимальный размер файла с логами. В случае превышения размера файла создается новый.
<compressRollingFile value="false" /> - архивирование файла с логами если превышает допустимый размер. (false - настройка отключена, true - включена).
Далее в теге logger прописывается для какого процесса необходимо полное логирование.

 <logger name="FullHotelQuotaExternal">
     <level value="ALL" />
     <appender-ref ref="FullHotelQuotaExternal" />
   </logger>

Значения level value=
OFF значение по умолчанию, логирование выключено
ALL запись и запроса и ответа
Для хранения файлов с полным логами в папке Import создаётся папка Full.