4.2.5.4.1. Подключение Рабочего стола к приложению

4.2.5.4.1.1. Разметка

Настройка Рабочего стола хранится в разметке главной выборки приложения.

Добавьте элемент home в фрейм desktop нужного представления главной выборки. Укажите в элементе имя и представление выборки Рабочего стола:

Пример подключения Рабочего стола
<representation name="Default">
    <layout>
        <simpleComposer>
            <desktop>
                <home selection="Mod_Warehouse" representation="Main"/>
            </desktop>
        </simpleComposer>
    </layout>
</representation>

В этом примере при открытии приложения платформа откроет форму выборки Mod_Warehouse в представлении Main.

4.2.5.4.1.1.1. Наследование настройки

  • Если текущее представление использует фрейм <desktop> без <home>, а в Default-представление этот элемент есть, то настройка наследуется из Default-представления.

  • Если элемента <home> нет ни в текущем представлении приложения, ни в Default, то у приложения нет Рабочего стола.

  • Если текущее представление использует нет <desktop>-фрейм, то у приложения нет Рабочего стола.

Note

Если <home> задан в Default, то его отсутствие в другом представлении с фреймом <desktop> не отключает Рабочий стол.

4.2.5.4.1.1.2. Требования к разметке

  • Внутри <desktop> допускается не более одного элемента <home>. Если элементов несколько, платформа использует один из них, но не гарантирует, какой именно.

4.2.5.4.1.2. Имя выборки и представления

В элементе <home> укажите два обязательных атрибута:

  • selection - имя выборки Рабочего стола;

  • representation - имя её представления.

Представление нужно указать явно. Платформа не подставляет Default, если представление не задано или не существует.

Для атрибута selection допускаются два формата имени:

  • Полное имя: gtk-<пакет>.<Имя>, например gtk-ru.bitec.app.mod.Mod_Warehouse.

  • Короткое имя: <Имя>, например Mod_Warehouse.

Короткое имя платформа дополняет до полного по правилам загрузки метаданных выборки. Для этого она ищет класс <Имя>Avi. Имя класса должно совпадать точно, с учётом регистра.

При обработке имени выборки и представления платформа отбрасывает пробелы по краям. В имени выборки допускаются суффиксы Avi и $: Mod_WarehouseAvi и Mod_Warehouse$ равносильны Mod_Warehouse.