4.1. Общие сведения#

Выборка - фундаментальный объект системы, отвечающий за:

  • Способ получения данных из БД или иного источника.

  • Способ отображения данных пользователю в графическом интерфейсе.

  • Бизнес логику обработки пользовательских действий.

Объект выборка существует только в момент выполнения кода программы, когда происходит объединение метаданных выборки и кода выборки в едином объекте.

4.1.1. Именование выборок#

Идентификация выборок в системе производится по системному имени выборки.

4.1.1.1. В решениях для PostgreSQL#

Имя выборки:

  • Регистрозависимо.

  • Может содержать алфавитные символы, цифры, знак подчёркивания _.

  • Отделяется от имени отображения символом решётка #.

    Note

    Пример: gtk-ru.bitec.module.Module_EntityName#List
    Если отображение не указано, будет использовано отображение с именем Default.

  • Имеет формат:

    gtk@{sbt_name}-{company.namespace.module}.{Module}_{SomeName}

    где:

    • {sbt-name} - имя образа решения. Обычно не указывается, подразумевается текущее решение. Символ @ является разделителем префикса gtk и имени образа решения. Разделитель не указывается, если не указано имя образа решения.

    • {company.namespace.module} - java/scala пространство имён.

    • {Module} - системное имя прикладного модуля.

    • {SomeName} - имя, отражающее функциональную принадлежность выборки.

При указании имени выборки в запросах или avm.xml других выборок, например, при определении динамических компоновщиков или закладок, допускается опускание (неуказание) префикса gtk[@sbt_name]- и/или пространства имён.

Таким образом, возможны следующие варианты указания имени выборки:

  • gtk@sbtname-company.namespace.module.Module_SomeName

  • gtk@sbtname-Module_SomeName

  • gtk-company.namespace.module.Module_SomeName

  • gtk-Module_SomeName

  • Module_SomeName

Note

В любом из указанных вариантов, за именем выборки может следовать имя отображения, отделённое разделителем #.

Получение полного (канонического) имени выборки по её краткому имени, производится по карте соответствия кратких имён классов образа решения их полным именам (карта формируется при загрузке кода образа решения). Предполагается, что выборке всегда соответствует Avi-класс.

Note

Для поиска полного имени выборки:

  1. К краткому имени выборки добавляется суффикс Avi.

  2. Выполняется поиск Avi-класса по карте.

  3. От полного имени Avi-класса отсекается суффикс Avi.

4.1.1.2. В решениях для Oracle#

Имя выборки:

  • Регистронезависимо.

  • Всегда начинается с префикса SEL_

  • Может содержать алфавитные символы, цифры и знак подчёркивания _.

  • Отделяется от имени отображения символом точка ..

    Note

    Пример: gtk-company.namespace.module.Module_SomeName#List
    Если отображение не указано, будет использовано отображение с именем DEFAULT.

  • Имеет формат SEL_{MODULE}_{SOMENAME}.

    • {MODULE} - имя образа решения. Если не указано, подразумевается текущее решение.

    • {SOMENAME} - имя, отражающее функциональную принадлежность выборки.

Note

Решения для Oracle, могут обращаться к gtk- выборкам по полному имени, содержащему имя sbt. Указанная возможность используется для открытия окна отладки выборок.

Все выборки зарегистрированы в таблице “BTK.BTK_CLASS”, которой имя выборки является уникальным индексом.