4.2. Рабочий стол¶
Added in version 1.29.0-ms6.
Рабочий стол - постоянная домашняя вкладка приложения. Она открывается при каждом открытии приложения и располагается первой в полосе вкладок. Пользователь не может закрыть её отдельно, поскольку вкладка остаётся открытой, пока открыто приложение.
4.2.1. Вкладка Рабочего стола¶
Форма выборки Рабочего стола открывается обычной вкладкой MDI.
У этой вкладки есть следующие особенности:
стоит первой в полосе вкладок независимо от порядка открытия;
не имеет кнопки закрытия.
4.2.2. Открытие Рабочего стола¶
4.2.2.1. Порядок открытия¶
При каждом открытии приложения платформа пытается открыть настроенный Рабочий стол. Это происходит при входе в новую сессию и при смене приложения. При открытии приложения соблюдается следующий порядок:
Открывается главная выборка приложения.
Открывается Рабочий стол.
Если нужно восстановить формы из снимка сессии или открыть форму выборки по ссылке, то открываются соответствующие вкладки.
Если прикладной код запросил закрытие приложения до начала открытия Рабочего стола, то Рабочий стол не открывается. Если при этом другая вкладка отказала в закрытии, то приложение остаётся открытым без Рабочего стола до следующего входа в новую сессию или смены приложения.
4.2.2.2. Перезагрузка страницы, подключение и восстановление сессии¶
При успешном подключении к той же открытой сессии, в том числе после перезагрузки страницы, используется прежняя форма Рабочего стола. Рабочий стол не создаётся заново.
При восстановлении сессии из снимка платформа создаёт новую сессию и заново открывает приложение,
а значит Рабочий стол создаётся заново.
Такое восстановление доступно только при включённом кластере.
4.2.2.3. Открытие до подключения браузера¶
Приложение может начать открываться до присоединения браузера к сессии, например:
при создании новой сессии по ссылке на выборку с указанным приложением;
при создании сессии с автоматическим открытием заранее указанного приложения;
при восстановлении сессии из снимка.
Attention
В прикладном коде, выполняемом при первоначальном открытии формы Рабочего стола, не вызывайте диалоговые окна и модальные формы:
Вызов диалогового окна до подключения клиента завершается исключением.
Вызов модальной формы приостанавливает открытие Рабочего стола до её закрытия.
4.2.2.4. Ошибки открытия¶
Ошибка при открытии Рабочего стола не прерывает открытие приложения. Платформа убирает недостроенную вкладку Рабочего стола и записывает ошибку в журнал сервера.
В штатном случае пользователь получает одно сообщение об ошибке. Если отправить сообщение пользователю не удалось, сведения об ошибке остаются в журнале сервера.
После устранения причины ошибки повторная попытка открытия Рабочего стола выполняется при входе в новую сессию или смене приложения. Перезагрузка страницы с подключением к той же сессии повторную попытку открытия Рабочего стола не запускает.
4.2.2.4.1. Показ сообщения об ошибке¶
Способ показа сообщения об ошибке зависит от подключения браузера к сессии:
Браузер подключён. Платформа использует штатный механизм обработки ошибок операций:
Если в цепочке причин есть исключение, реализующее интерфейс
CoreInfoLogException, сообщение добавляется вInfoLog. Например, так обрабатываетсяInfoLogException.В остальных случаях открывается окно ошибки.
Браузер ещё не подключён. Пользователь увидит уведомление после подключения.
4.2.2.5. Права доступа¶
К выборке Рабочего стола применяются обычные правила проверки прав доступа.
Если проверка прав при открытии выборки завершается ошибкой доступа, приложение открывается без вкладки Рабочего стола. Порядок показа сообщения описан в разделе Ошибки открытия.
4.2.3. Ошибки после открытия формы¶
Если ошибка возникла внутри уже открытой формы, вкладка Рабочего стола остаётся открытой. Например, ошибка загрузки данных может оставить таблицу без данных. Платформа обрабатывает такую ошибку так же, как в обычной вкладке.
4.2.4. Повторное открытие выборки Рабочего стола¶
При повторном открытии выборки платформа может найти уже открытую форму Рабочего стола. В этом случае активной становится вкладка Рабочего стола, а новая вкладка не создаётся.
Для поиска формы должны выполняться все условия:
указано полное имя выборки;
указано то же представление, в котором открыт Рабочий стол;
параметры открытия не заданы или передана пустая карта параметров;
не используется открытие новой формы без поиска среди открытых.
При указании короткого имени платформа не находит форму Рабочего стола и открывает новую вкладку с той же выборкой.
Note
Если при вызове Scala-метода CoreApplication.newForm указать короткое имя выборки, последующий вызов open() не найдёт форму Рабочего стола и откроет новую вкладку.
При открытии новой формы без поиска среди открытых платформа создаёт новую вкладку с той же выборкой.
Note
При открытии Рабочего стола платформа не ищет уже открытую форму его выборки. Если эта форма уже открыта в другой вкладке, то для Рабочего стола создаётся ещё одна вкладка с той же формой.
See also
4.2.5. Закрытие Рабочего стола¶
Форма Рабочего стола закрывается только вместе с приложением.
4.2.5.1. Попытка закрыть форму Рабочего стола¶
Форму Рабочего стола нельзя закрыть отдельно от приложения ни из интерфейса, ни из прикладного кода.
При попытке закрыть непосредственно форму Рабочего стола платформа сообщает о запрете:
Если браузер подключён, то пользователь видит информационное окно “Рабочий стол нельзя закрыть.” с кнопкой “OK”.
Если браузер не подключён, то в журнал сервера записывается предупреждение с именем выборки Рабочего стола.
Сам отказ в закрытии Рабочего стола не отменяет сохранение, выполненное прикладной операцией до запроса закрытия формы.
See also
saveForm- сохранение изменений на форме.beforeCloseFormиafterCloseForm- события закрытия формы.
4.2.5.2. Массовое закрытие вкладок¶
При массовом закрытии вкладок Рабочий стол остаётся открытым, а остальные вкладки закрываются по обычным правилам. Сообщение о запрете закрытия Рабочего стола не показывается.
4.2.5.3. Закрытие вместе с приложением¶
Только при закрытии приложения к форме Рабочего стола применяется обычная процедура закрытия, включая OnCloseFormQuery и другие обработчики закрытия формы.
При наличии несохранённых изменений появляется вопрос о сохранении.
Если одна из вкладок не разрешает закрытие приложения, то оно остаётся открытым:
Если закрытие запрещает другая вкладка, то до закрытия формы Рабочего стола очередь не доходит. Рабочий стол остаётся открытым вместе с этой вкладкой.
Если закрытие запрещает форма Рабочего стола, то остальные вкладки к этому моменту уже закрыты.
Warning
Платформа не видит данные, которые ext-компонент хранит только в браузере. При выходе из приложения эти данные теряются, даже если пользователь ответил “Да” на вопрос о сохранении.
Attention
При нажатии кнопки “Закрыть сессию” в аварийном диалоге обработчики закрытия приложения вызываются до закрытия вкладок. Если затем одна из форм не разрешит закрытие, то сессия останется открытой, хотя обработчики закрытия приложения уже выполнены. Этот порядок действует и в приложениях без Рабочего стола.
4.2.5.4. Принудительное завершение сессии¶
При принудительном завершении сессии форма Рабочего стола удаляется без обычной процедуры закрытия.
Платформа не вызывает OnCloseFormQuery, beforeCloseForm и afterCloseForm этой формы и не задаёт вопрос о сохранении изменений.
Несохранённые изменения на Рабочем столе теряются.