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