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

Материал из Oktell
Перейти к: навигация, поиск
(Новая страница: «Наверх ==Служебные сообщения и эта...»)
 
 
(не показано 5 промежуточных версии этого же участника)
Строка 1: Строка 1:
−
[[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
+
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
 +
| [[Загрузка и выгрузка модуля|Загрузка и выгрузка модуля<<<]]
 +
| [[Служебные сообщения]]
 +
| [[Исключительные ситуации|>>>Исключительные ситуации]]
 +
|-
 +
|}
  
 
==Служебные сообщения и этапы подключения==
 
==Служебные сообщения и этапы подключения==
Строка 5: Строка 11:
 
В ходе загрузки сервер генерирует и передает служебные сообщения по каналу события <span style="color:darkred">OnServiceMessage</span>. Событие передает коды различных категорий в виде <span style="color:blue">int</span> параметра. Среди кодов присутствуют этапы загрузки, этапы подключения к серверу, ответы сервера на попытку логина, рабочие коды по коннекту с сервером.
 
В ходе загрузки сервер генерирует и передает служебные сообщения по каналу события <span style="color:darkred">OnServiceMessage</span>. Событие передает коды различных категорий в виде <span style="color:blue">int</span> параметра. Среди кодов присутствуют этапы загрузки, этапы подключения к серверу, ответы сервера на попытку логина, рабочие коды по коннекту с сервером.
  
−
Список кодов:
 
  
−
11001 <span style="color:gray">//Aborted</span>. Загрузка прервана.
+
'''Список кодов:'''
  
 +
:11001 <span style="color:gray">//Aborted</span>. Загрузка прервана.
  
−
Этапы загрузки
 
  
 +
'''Этапы загрузки'''
  
−
11011 //CheckingAssemblies. Этап проверки, поиска и загрузки сборок.
+
:11011 <span style="color:gray">//CheckingAssemblies</span>. Этап проверки, поиска и загрузки сборок.
 +
:11012 <span style="color:gray">//CreatingMapperObject</span>. Этап создания внутреннего объекта, нижестоящего под ком-оберткой.
 +
:11013 <span style="color:gray">//Configuring</span>. Этап конфигурации из файла. Поиск, обнаружение.
 +
:11014 <span style="color:gray">//CheckingMutex</span>. Этап проверки одной копии.
 +
:11015 <span style="color:gray">//NotStartedYetCannotStop</span>. Код случая, если вызывается стоп для нестартованного объекта.
 +
:11101 <span style="color:gray">//Initialization</span>. Инициализация загрузчика.
 +
:11102 <span style="color:gray">//WaitForConnection</span>. Ожидание подключения к серверу.
 +
:11103 <span style="color:gray">//WaitForLogin</span>. Ожидание обработки логина.
 +
:11104 <span style="color:gray">//LiveUpdate</span>. Закачаны обновления и запрошен перезапуск с замещением сборок.
 +
:11105 <span style="color:gray">//ConnectionError</span>. Ошибка подключения. Возможен вариант прерывания загрузки методом ModuleStop на этапе ожидания. подключения.
 +
:11106 <span style="color:gray">//LoadException</span>.
  
−
11012 //CreatingMapperObject. Этап создания внутреннего объекта, нижестоящего под ком-оберткой.
 
  
−
11013 //Configuring. Этап конфигурации из файла. Поиск, обнаружение.
+
'''Постлогин этапы'''
 +
:11201 <span style="color:gray">//LoginSuccess</span>. Успешный логин.
 +
:11202 <span style="color:gray">//LoadingHAL</span>. Загрузка аппаратного модуля.
 +
:11203 <span style="color:gray">//HALError</span>. Ошибка загрузки аппаратного модуля.
 +
:11204 <span style="color:gray">//AfterLoad</span>. После загрузки выставление служебных полей.
 +
:11205 <span style="color:gray">//LoadSuccess</span>. Загрузка завершена.
 +
:11206 <span style="color:gray">//Ready</span>. Модуль иницилизирован и готов к обработке вызовов.
  
−
11014 //CheckingMutex. Этап проверки одной копии.
 
  
−
11015 //NotStartedYetCannotStop. Код случая, если вызывается стоп для нестартованного объекта.
+
'''Этапы выгрузки'''
 +
:11301 <span style="color:gray">//StopConnection</span>. Подготовка к остановке.
 +
:11302 <span style="color:gray">//Dispose</span>. Выгрузка служебных объектов.
 +
:11303 <span style="color:gray">//StopHAL</span>. Остановка аппаратного модуля.
 +
:11304 <span style="color:gray">//Stopped</span>. Выгрузка завершена.
  
−
11101 //Initialization. Инициализация загрузчика.
 
  
−
11102 //WaitForConnection. Ожидание подключения к серверу.
+
'''Ответы сервера на логине'''
  
−
11103 //WaitForLogin. Ожидание обработки логина.
+
:11501 <span style="color:gray">//Unknown</span>
 +
:11502 <span style="color:gray">//Exception</span>
 +
:11503 <span style="color:gray">//IncorrectLoginPass</span>. Неверная комбинация Логин-пароль.
 +
:11504 <span style="color:gray">//WorkpaceUndefined</span>. Рабочее место не инициализировано (служебный код).
 +
:11505 <span style="color:gray">//WorkpaceNotFound</span>. Рабочее место не определено в карте офиса или не сопоставлено по адресам. В этом случае в логе появляется перечень адресов компьютера, переданных серверу на сопоставление рабочего места.
 +
:11506 <span style="color:gray">//UserAlreadyRegistered</span>. Пользователь уже зарегистрирован в системе и новый вход запрещен.
 +
:11507 <span style="color:gray">//IncorrectServer</span>. Клиент коннектится не к своему серверу. В смысле в карте существует несколько серверов, клиент цепляется не к тому, с которым соединен в карте.
 +
:11508 <span style="color:gray">//CannotLogin</span>. Подключение невозможно (разрыв связи на логине, изменение обстановки).
 +
:11509 <span style="color:gray">//SystemAdminDenied</span>. Вход системному администратору заблокирован в связи с работоспособностью сервера и наличием учетных записей администраторов.
 +
:11510 <span style="color:gray">//ServerInitializing</span>. Отказ сервера по причине загрузки его самого. Вход еще не разрешен (идет загрузка) или уже не разрешен (после команды на остановку и перезапуск).
 +
:11511 <span style="color:gray">//PBXSSNotReady</span>. Сервер состояний не готов или не запущен.
 +
:11512 <span style="color:gray">//IntegrationDenied</span>. Запрет работы сервером по причине отсутствия лицензии на использование интеграционного ядра.
 +
:11513 <span style="color:gray">//UserCountLicenseLimit</span>. Превышено число одновременных подключений пользователей к системе.
  
−
11104 //LiveUpdate. Закачаны обновления и запрошен перезапуск с замещением сборок.
 
  
−
11105 //ConnectionError. Ошибка подключения. Возможен вариант прерывания загрузки методом ModuleStop на этапе ожидания. подключения.
+
'''Этапы подключения к серверу.''' Возникают после 11102, но до следующих этапов
  
−
11106 //LoadException.
+
:12101 <span style="color:gray">//Started</span>. Запуск подключения.
 +
:12102 <span style="color:gray">//Restarted</span>. Перезапуск подключения.
 +
:12103 <span style="color:gray">//SearchingUpdates</span>. Подключение установлено. Поиск обновлений.
 +
:12104 <span style="color:gray">//DownloadingUpdates</span>. Загрузка обновлений.
 +
:12105 <span style="color:gray">//UpdatesDownloadFinish</span>. Загрузка обновлений завершена.
 +
:12106 <span style="color:gray">//FullRestartToMoveUpdates</span>. Ожидание перед возвратом и командой на перезапуск.
 +
:12107 <span style="color:gray">//RegisterCP</span>. Регистрация на сервере, настройка прокси, тестовый обмен объектами.
 +
:12108 <span style="color:gray">//SuccessConnection</span>. Успешное подключение.
 +
:12109 <span style="color:gray">//ConnectionError1</span>. Ошибка сокета на первой итерации.
 +
:12110 <span style="color:gray">//ConnectionError2</span>. Ошибка сокета на последующих итерациях.
 +
:12111 <span style="color:gray">//ConnectionError3</span>. Прочие ошибки подключения.
  
  
−
Постлогин этапы
+
'''Сообщения в ходе работы'''
−
 
+
−
 
+
−
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. В ходе работы потеряна связь с сервером. Пинг не прошел несколько раз подряд, или не поступил ответный пинг сервера по обратному каналу.
+
  
 +
:13101 <span style="color:gray">//Shutdown</span>. В ходе работы поступила команда сервера на выгрузку клиента (возможно администратор запросил).
 +
:13102 <span style="color:gray">//Restart</span>. В ходе работы поступила команда сервера на перезапуск клиента (либо перезагрузка сервера, либо админ запросил).
 +
:13103 <span style="color:gray">//ConnectionLost</span>. В ходе работы потеряна связь с сервером. Пинг не прошел несколько раз подряд, или не поступил ответный пинг сервера по обратному каналу.
  
  
Строка 143: Строка 94:
  
 
Вызов всех методов, работающих с объектами сервера, возможен только после получения события 11206 (Ready), так как только непосредственно перед его генерацией выставляется флаг успешной загрузки, допускающий сервисные вызовы.
 
Вызов всех методов, работающих с объектами сервера, возможен только после получения события 11206 (Ready), так как только непосредственно перед его генерацией выставляется флаг успешной загрузки, допускающий сервисные вызовы.
 +
 +
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
 +
| [[Загрузка и выгрузка модуля|Загрузка и выгрузка модуля<<<]]
 +
| [[Служебные сообщения]]
 +
| [[Исключительные ситуации|>>>Исключительные ситуации]]
 +
|-
 +
|}

Текущая версия на 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), так как только непосредственно перед его генерацией выставляется флаг успешной загрузки, допускающий сервисные вызовы.

Наверх Загрузка и выгрузка модуля<<< Служебные сообщения >>>Исключительные ситуации
Источник — «https://wiki.oktell.ru/index.php?title=Служебные_сообщения&oldid=8203»