Служебные сообщения — различия между версиями

Текущая версия на 10:39, 1 апреля 2014

Служебные сообщения и этапы подключения

В ходе загрузки сервер генерирует и передает служебные сообщения по каналу события OnServiceMessage. Событие передает коды различных категорий в виде int параметра. Среди кодов присутствуют этапы загрузки, этапы подключения к серверу, ответы сервера на попытку логина, рабочие коды по коннекту с сервером.

Список кодов:

11001 //Aborted. Загрузка прервана.

Этапы загрузки

11011 //CheckingAssemblies. Этап проверки, поиска и загрузки сборок.

11012 //CreatingMapperObject. Этап создания внутреннего объекта, нижестоящего под ком-оберткой.

11013 //Configuring. Этап конфигурации из файла. Поиск, обнаружение.

11014 //CheckingMutex. Этап проверки одной копии.

11015 //NotStartedYetCannotStop. Код случая, если вызывается стоп для нестартованного объекта.

11101 //Initialization. Инициализация загрузчика.

11102 //WaitForConnection. Ожидание подключения к серверу.

11103 //WaitForLogin. Ожидание обработки логина.

11104 //LiveUpdate. Закачаны обновления и запрошен перезапуск с замещением сборок.

11105 //ConnectionError. Ошибка подключения. Возможен вариант прерывания загрузки методом ModuleStop на этапе ожидания. подключения.

11106 //LoadException.

Постлогин этапы

11201 //LoginSuccess. Успешный логин.

11202 //LoadingHAL. Загрузка аппаратного модуля.

11203 //HALError. Ошибка загрузки аппаратного модуля.

11204 //AfterLoad. После загрузки выставление служебных полей.

11205 //LoadSuccess. Загрузка завершена.

11206 //Ready. Модуль иницилизирован и готов к обработке вызовов.

Этапы выгрузки

11301 //StopConnection. Подготовка к остановке.

11302 //Dispose. Выгрузка служебных объектов.

11303 //StopHAL. Остановка аппаратного модуля.

11304 //Stopped. Выгрузка завершена.

Ответы сервера на логине

11501 //Unknown

11502 //Exception

11503 //IncorrectLoginPass. Неверная комбинация Логин-пароль.

11504 //WorkpaceUndefined. Рабочее место не инициализировано (служебный код).

11505 //WorkpaceNotFound. Рабочее место не определено в карте офиса или не сопоставлено по адресам. В этом случае в логе появляется перечень адресов компьютера, переданных серверу на сопоставление рабочего места.

11506 //UserAlreadyRegistered. Пользователь уже зарегистрирован в системе и новый вход запрещен.

11507 //IncorrectServer. Клиент коннектится не к своему серверу. В смысле в карте существует несколько серверов, клиент цепляется не к тому, с которым соединен в карте.

11508 //CannotLogin. Подключение невозможно (разрыв связи на логине, изменение обстановки).

11509 //SystemAdminDenied. Вход системному администратору заблокирован в связи с работоспособностью сервера и наличием учетных записей администраторов.

11510 //ServerInitializing. Отказ сервера по причине загрузки его самого. Вход еще не разрешен (идет загрузка) или уже не разрешен (после команды на остановку и перезапуск).

11511 //PBXSSNotReady. Сервер состояний не готов или не запущен.

11512 //IntegrationDenied. Запрет работы сервером по причине отсутствия лицензии на использование интеграционного ядра.

11513 //UserCountLicenseLimit. Превышено число одновременных подключений пользователей к системе.

Этапы подключения к серверу. Возникают после 11102, но до следующих этапов

12101 //Started. Запуск подключения.

12102 //Restarted. Перезапуск подключения.

12103 //SearchingUpdates. Подключение установлено. Поиск обновлений.

12104 //DownloadingUpdates. Загрузка обновлений.

12105 //UpdatesDownloadFinish. Загрузка обновлений завершена.

12106 //FullRestartToMoveUpdates. Ожидание перед возвратом и командой на перезапуск.

12107 //RegisterCP. Регистрация на сервере, настройка прокси, тестовый обмен объектами.

12108 //SuccessConnection. Успешное подключение.

12109 //ConnectionError1. Ошибка сокета на первой итерации.

12110 //ConnectionError2. Ошибка сокета на последующих итерациях.

12111 //ConnectionError3. Прочие ошибки подключения.

Сообщения в ходе работы

13101 //Shutdown. В ходе работы поступила команда сервера на выгрузку клиента (возможно администратор запросил).

13102 //Restart. В ходе работы поступила команда сервера на перезапуск клиента (либо перезагрузка сервера, либо админ запросил).

13103 //ConnectionLost. В ходе работы потеряна связь с сервером. Пинг не прошел несколько раз подряд, или не поступил ответный пинг сервера по обратному каналу.

При установленном флаге автоперезапуска (метод SetAutoRetryLoad) в случае возникновения сбоев система будет вновь запускать процесс логина. Это помогает в случаях 11511, 11510, 13101, 13102, 13103, если сбой носил временный характер. В любой момент отключением флага автоперезапуска или остановкой модуля можно прервать цикличность.

Список кодов может на этапе работы над модулем дополняться и возможно видоизменяться. Какие-то вещи можно зафильтровать, какие то расширить. Это касается и будущих блоков.

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