.. _spec_work-center_home: Рабочий стол ============ .. versionadded:: 1.29.0-ms6 :term:`Рабочий стол` - постоянная домашняя вкладка :term:`приложения <Приложение>`. Она открывается при каждом открытии приложения и располагается первой в полосе вкладок. Пользователь не может закрыть её отдельно, поскольку вкладка остаётся открытой, пока открыто приложение. .. seealso:: - :xsd:class:`Рабочий стол в метаданных Postgres решения `. .. _spec_work-center_home_tab: Вкладка Рабочего стола ------------------------ :term:`Форма` :term:`выборки <Выборка>` Рабочего стола открывается обычной вкладкой :term:`MDI`. У этой вкладки есть следующие особенности: - стоит первой в полосе вкладок независимо от порядка открытия; - не имеет кнопки закрытия. .. _spec_work-center_home_open: Открытие Рабочего стола ----------------------- .. _spec_work-center_home_open_order: Порядок открытия ```````````````` При каждом открытии приложения платформа пытается открыть настроенный Рабочий стол. Это происходит при входе в новую сессию и при смене приложения. При открытии приложения соблюдается следующий порядок: 1. Открывается :ref:`главная выборка приложения `. 2. Открывается Рабочий стол. 3. Если нужно восстановить формы из снимка сессии или открыть :ref:`форму выборки по ссылке `, то открываются соответствующие вкладки. Если прикладной код запросил закрытие приложения до начала открытия Рабочего стола, то Рабочий стол не открывается. Если при этом другая вкладка отказала в закрытии, то приложение остаётся открытым без Рабочего стола до следующего входа в новую сессию или смены приложения. .. seealso:: :java:meth:`CoreApplication.close `, :java:meth:`CoreApplication.closeAndNavigate `. .. _spec_work-center_home_open_session: Перезагрузка страницы, подключение и восстановление сессии `````````````````````````````````````````````````````````` При успешном подключении к той же открытой сессии, в том числе после перезагрузки страницы, используется прежняя форма Рабочего стола. Рабочий стол не создаётся заново. При восстановлении сессии из снимка платформа создаёт новую сессию и заново открывает приложение, а значит Рабочий стол создаётся заново. Такое восстановление доступно только при включённом :xsd:class:`кластере `. .. _spec_work-center_home_open_without_browser: Открытие до подключения браузера `````````````````````````````````` Приложение может начать открываться до присоединения браузера к сессии, например: - при создании новой сессии по :ref:`ссылке на выборку ` с указанным приложением; - при создании сессии с автоматическим открытием заранее указанного приложения; - при восстановлении сессии из снимка. .. attention:: В прикладном коде, выполняемом при первоначальном открытии формы Рабочего стола, не вызывайте :term:`диалоговые окна <Диалоговое окно>` и :term:`модальные формы <Модальная форма>`: - Вызов диалогового окна до подключения клиента завершается исключением. - Вызов модальной формы приостанавливает открытие Рабочего стола до её закрытия. .. _spec_work-center_home_open_errors: Ошибки открытия ````````````````` Ошибка при открытии Рабочего стола не прерывает открытие приложения. Платформа убирает недостроенную вкладку Рабочего стола и записывает ошибку в :ref:`журнал сервера `. В штатном случае пользователь получает одно сообщение об ошибке. Если отправить сообщение пользователю не удалось, сведения об ошибке остаются в журнале сервера. После устранения причины ошибки повторная попытка открытия Рабочего стола выполняется при входе в новую сессию или смене приложения. Перезагрузка страницы с подключением к той же сессии повторную попытку открытия Рабочего стола не запускает. .. _spec_work-center_home_open_errors_message: Показ сообщения об ошибке ^^^^^^^^^^^^^^^^^^^^^^^^^^^ Способ показа сообщения об ошибке зависит от подключения браузера к сессии: - Браузер подключён. Платформа использует штатный механизм обработки ошибок операций: - Если в цепочке причин есть исключение, реализующее интерфейс :java:type:`CoreInfoLogException `, сообщение добавляется в :java:type:`InfoLog `. Например, так обрабатывается ``InfoLogException``. - В остальных случаях открывается окно ошибки. - Браузер ещё не подключён. Пользователь увидит уведомление после подключения. .. _spec_work-center_home_open_permissions: Права доступа ```````````````` К выборке Рабочего стола применяются обычные правила проверки прав доступа. Если проверка прав при открытии выборки завершается ошибкой доступа, приложение открывается без вкладки Рабочего стола. Порядок показа сообщения описан в разделе :ref:`spec_work-center_home_open_errors`. .. _spec_work-center_home_runtime_errors: Ошибки после открытия формы ----------------------------- Если ошибка возникла внутри уже открытой формы, вкладка Рабочего стола остаётся открытой. Например, ошибка загрузки данных может оставить таблицу без данных. Платформа обрабатывает такую ошибку так же, как в обычной вкладке. .. _spec_work-center_home_reopen: Повторное открытие выборки Рабочего стола ----------------------------------------- При повторном открытии выборки платформа может найти уже открытую форму Рабочего стола. В этом случае активной становится вкладка Рабочего стола, а новая вкладка не создаётся. Для поиска формы должны выполняться все условия: - указано полное имя выборки; - указано то же :term:`представление <Отображение>`, в котором открыт Рабочий стол; - параметры открытия не заданы или передана пустая карта параметров; - не используется :ref:`открытие новой формы без поиска среди открытых `. При указании короткого имени платформа не находит форму Рабочего стола и открывает новую вкладку с той же выборкой. .. note:: Если при вызове Scala-метода :java:meth:`CoreApplication.newForm ` указать короткое имя выборки, последующий вызов ``open()`` не найдёт форму Рабочего стола и откроет новую вкладку. При открытии новой формы без поиска среди открытых платформа создаёт новую вкладку с той же выборкой. .. note:: При открытии Рабочего стола платформа не ищет уже открытую форму его выборки. Если эта форма уже открыта в другой вкладке, то для Рабочего стола создаётся ещё одна вкладка с той же формой. .. seealso:: :java:meth:`CoreApplication.findMdiFormBySelection `. .. _spec_work-center_home_closing: Закрытие Рабочего стола ------------------------- Форма Рабочего стола закрывается только вместе с приложением. .. _spec_work-center_home_closing_attempt: Попытка закрыть форму Рабочего стола ````````````````````````````````````` Форму Рабочего стола нельзя закрыть отдельно от приложения ни из интерфейса, ни из прикладного кода. При попытке закрыть непосредственно форму Рабочего стола платформа сообщает о запрете: - Если браузер подключён, то пользователь видит информационное окно "Рабочий стол нельзя закрыть." с кнопкой "OK". - Если браузер не подключён, то в :ref:`журнал сервера ` записывается предупреждение с именем выборки Рабочего стола. Сам отказ в закрытии Рабочего стола не отменяет сохранение, выполненное прикладной операцией до запроса закрытия формы. .. seealso:: - :btk:oper:`saveForm` - сохранение изменений на форме. - :btk:event:`beforeCloseForm` и :btk:event:`afterCloseForm` - события закрытия формы. .. _spec_work-center_home_closing_mass: Массовое закрытие вкладок ````````````````````````` При массовом закрытии вкладок Рабочий стол остаётся открытым, а остальные вкладки закрываются по обычным правилам. Сообщение о запрете закрытия Рабочего стола не показывается. .. seealso:: :java:meth:`CoreApplication.closeAllForms `, :java:meth:`CoreApplication.closeAllFormsNotActive `. .. _spec_work-center_home_closing_with_app: Закрытие вместе с приложением ````````````````````````````` Только при закрытии приложения к форме Рабочего стола применяется обычная процедура закрытия, включая :btk:event:`OnCloseFormQuery ` и другие обработчики закрытия формы. При наличии несохранённых изменений появляется вопрос о сохранении. Если одна из вкладок не разрешает закрытие приложения, то оно остаётся открытым: - Если закрытие запрещает другая вкладка, то до закрытия формы Рабочего стола очередь не доходит. Рабочий стол остаётся открытым вместе с этой вкладкой. - Если закрытие запрещает форма Рабочего стола, то остальные вкладки к этому моменту уже закрыты. .. warning:: Платформа не видит данные, которые :term:`ext-компонент <Внешний компонент>` хранит только в браузере. При выходе из приложения эти данные теряются, даже если пользователь ответил "Да" на вопрос о сохранении. .. attention:: При нажатии кнопки "Закрыть сессию" в аварийном диалоге обработчики закрытия приложения вызываются до закрытия вкладок. Если затем одна из форм не разрешит закрытие, то сессия останется открытой, хотя обработчики закрытия приложения уже выполнены. Этот порядок действует и в приложениях без Рабочего стола. .. _spec_work-center_home_closing_forced: Принудительное завершение сессии ```````````````````````````````` При принудительном завершении сессии форма Рабочего стола удаляется без обычной процедуры закрытия. Платформа не вызывает :btk:event:`OnCloseFormQuery `, :btk:event:`beforeCloseForm` и :btk:event:`afterCloseForm` этой формы и не задаёт вопрос о сохранении изменений. Несохранённые изменения на Рабочем столе теряются. .. toctree:: :maxdepth: 1 markup