Главная > Документация пользователя > Модели

Ассоциативные модели

Ассоциативные модели доступны с версии 36.1 в режиме beta-версии. Некоторые стандартные возможности могут быть ограничены для ассоциативных моделей и виджетов на их основе.

Ассоциативные модели - строятся на основе логических моделей, ранее загруженных в хранилище системы. Между моделями настраивается связь: один к одному, один ко многим, многие к одному или многие ко многим. Настройка связи позволяет устранить дублирование данных в модели (кроме связи один к одному).

Особенности использования ассоциативных моделей:

• для создания модели доступны только логические модели, загруженные в хранилище;

• работа с объектами выполняется без создания SQL-запросов, без объединений JOIN и UNION, без pyton-скриптов и ETL-блоков; 

• работа со связями блоков между собой выполняется по полям моделей одного типа данных. Поддерживаются следующие типы связей:

  • один к одному  - каждой записи одной модели соответствует одна запись другой модели;

  • один ко многим - каждой записи одной модели соответсвует несколько записей другой модели;

  • многие к одному - нескольким записям одной модели соответствует одна запись другой модели;

  • многие ко многим - нескольким записям одной модели соответствует несколько записей другой модели;

• НЕ доступен экспорт данных в форматы .xlsx и .csv.в виджетах, построенных на основе модели;

• НЕ поддерживается использование LOD выражений при обработке данных в виджетах, построенных на основе модели;

• НЕ доступно применение итоговой агрегации (Итоговое значение в настройках поля) в полях виджетов, построенных на основе модели, так как некоторые расчеты могут быть неверными;

• НЕ доступны ограничения доступа по строкам модели (раздел Правила доступа по кнопке );

• читают данные напрямую из хранилища, не используя модуль ETL;

• длительная обработка данных на больших объемах, так как построение запроса более сложное и требуется времени для обработки;

• построение виджета Таблица доступно только в сгруппированном виде - добавлено хотя бы одно поле в блок Группы структуры виджета;

• визуализация данных выполняется без дополнительной синхронизации с хранилищем.

Добавление ассоциативной модели

Чтобы создать новую ассоциативную модель, в разделе Модели в интерфейсе просмотра списка моделей нажмите на кнопку Добавить. В выпадающем меню выберите значение Ассоциативную модель. Откроется окно редактирования новой модели, в которую добавьте логические модели.

Создание модели может быть заблокировано, если квоты на создание моделей закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

После выполнения этих операций:

• созданная модель будет сохранена в общем списке доступных пользователю моделей. Так как список упорядочен по убыванию Даты изменения, данная модель будет первой строкой списка;

• для созданной модели будет присвоено наименование по умолчанию Новая ассоциативная модель. В Системе можно создавать модели с одинаковыми названиями;

• откроется окно редактирования для созданной модели.

Настройка структуры данных

Конструктор структуры данных позволяет:

• добавлять логические модели;

• настраивать связи между моделями;

• просматривать текущий результат в виде таблицы с описанием столбцов.

Добавление блока выполняется с помощью drag-and-drop - перемещение нужного блока на поле схемы модели.

Для удобства работы и более полного использования экрана можно изменить режим отображения модели. Для увеличения области отображения схемы модели в режиме редактирование модели нажмите кнопку Развернуть в правом верхнем углу окна. При разворачивании схемы скрывается область работы с источниками, а также область данных модели. Чтобы вернуть предыдущий режим, нажмите на кнопку Свернуть.

При удалении объекта со схемы проверяются связанные объекты - виджеты, информационные панели и системные виджеты с типом Фильтр.

• при отсутствии у объекта связей, отобразится окно подтверждения удаления; Чтобы подтвердить действие, нажмите на кнопку  Удалить, для отмены - нажмите на кнопку Отмена.

  

• при наличии у объекта хотя бы одной связи, удаление объекта недоступно. В окне удаления отобразится список созданных пользователем связанных объектов. Нажав на наименование нужного объекта, выполняется переход к объекту в новом окне браузера.

  

В режиме ручной публикации виджетов при удалении объекта в списке объектов доступен отдельный блок Неопубликованные виджеты.

При наличии связи с объектами, созданными другими пользователями при удалении в списке объектов доступен отдельный блок Настроены другими пользователями.

Связи данных моделей

Объединение данных моделей производится с помощью связей блоков:

• один к одному  - каждой записи одной модели соответствует одна запись другой модели;

• один ко многим - каждой записи одной модели соответсвует несколько записей другой модели;

• многие к одному - нескольким записям одной модели соответствует одна запись другой модели;

• многие ко многим - нескольким записям одной модели соответствует несколько записей другой модели;

Для первичной настройки связи кликните по блоку на схеме и нажмите на кнопку . Выберите Добавить связь.

Форма настройки связей содержит:

1.Открывающийся список для выбора объекта модели для установки связи. По умолчанию выбран объект, для которого было выполнено действие Добавить связь. В списке отображаются все объекты модели.

После выбора объекта в открывающемся списке и в блоке Модели, справа отображаются настроенные связи. При отсутствии соединений отображается уведомление Связи отсутствуют.

2.Список объектов модели, с которыми можно настроить связь. После выбора объекта в открывающемся списке, в блоке Модели список фильтруется - отображаются все объекты, кроме выбранного. Выбор объекта для связи выполняется кликом мыши. Для каждого объекта отображается наименование и иконка типа связи, если она была ранее настроена:

• один к одному  - каждой записи одной модели соответствует одна запись другой модели;

• один ко многим - каждой записи одной модели соответсвует несколько записей другой модели;

• многие к одному - нескольким записям одной модели соответствует одна запись другой модели;

• многие ко многим - нескольким записям одной модели соответствует несколько записей другой модели;

Доступно изменение ширины блока со списком объектов. Чтобы изменить ширину блок, наведите курсор мыши на вертикальную разделительную линию, зажмите левую кнопку мыши и перетащите линию влево или вправо для установки нужной ширины. Минимальная ширина блока составляет 260px, максимальная 400px.

Cистема запоминает настроенную ширину и состояние блока, при следующем переходе в настройку соединения панель откроется с сохранённой шириной и в последнем использованном состоянии.

3.Блок Добавленные связи отображает настроенные связи выбранной пары объектов.

Рекомендуется устанавливать связь между полями одного типа данных.

Соединения отображаются в табличном виде в следующих столбцах:

• объект, для которого устанавливается связь. В столбце отображается наименование поля и иконка типа данных:
  • - числовое значение;
  • - строка;
  • - логическое; 
  •  - дата;
  •  - иерархия;
• объект, который выбран для связи. В столбце отображается наименование поля и иконка типа данных:
  • - числовое значение;
  • - строка;
  • - логическое; 
  •  - дата;
  •  - иерархия;

При наведении на строку отображается кнопка Удалить связь.

4.Блок Доступные поля отображает список полей для обоих выбранных объектов. Блок содержит:

• кнопку Добавить связь, которая сохраняет выбранную связку полей в блоке Добавленные связи. Кнопка блокируется после создания связи, для изменения необходимо удалить добавленную связь и создать новую

Рекомендуется устанавливать связь между полями одного типа данных.

• кнопки для выбора типа связи:

  • один к одному  - каждой записи одной модели соответствует одна запись другой модели;

  • один ко многим - каждой записи одной модели соответсвует несколько записей другой модели;

  • многие к одному - нескольким записям одной модели соответствует одна запись другой модели;

  • многие ко многим - нескольким записям одной модели соответствует несколько записей другой модели;

Каждый блок полей объекта содержит:

• Поиск - поиск по алиасу поля модели;

• Дополнительные параметры - отображает строку с фильтрами по типам полей:

  • - число;
  • - строка;
  • - логическое; 
  •  - дата;
  •  - иерархия;  При выборе фильтра кнопка меняет цвет.

• сортировка полей по алиасу. По нажатию на кнопку меняется направление сортировки: по возрастанию А-Я - значение по умолчанию или по убыванию Я-А.

• список полей. Для каждого поля отображается флажок для выбора поля, алиас поля, наименование в скобках и иконка типа данных:
  • - число;
  • - строка;
  • - логическое; 
  •  - дата;
  •  - иерархия;

Для изменения связи, нажмите левой кнопкой мыши на пиктограмму связи на схеме и выберите Редактировать. Окно редактирования связи аналогично окну добавления.

Для удаления связи, наведите курсор мыши на линию связи на схеме и нажмите кнопку Удалить связь.

Обновление структуры объектов

В модели есть возможность обновить структуру объектов, выведенных на схему модели. Структуру таблиц можно обновить, если в источнике таблице были добавлены/удалены поля или изменен тип поля таблицы.

Способы обновления структуры объектов:

• массовое обновление по кнопке Обновить структуру на схеме модели;

  

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

  

В объектах, в которые были добавлены новые поля, в режиме редактирования будет отображаться кнопка Обновить таблицу. Это значит, что структура таблицы на данный момент неактуальна и ее необходимо обновить. Данная кнопка отображается после сбора статистики, не чаще чем раз в шесть часов.

Система сбора статистики определяет наличие "битых" объектов в моделях. "Битый" - объект с измененной структурой в источнике. Такой объект помечается пиктограммой . На основе отметок определяется необходимость обновления структуры данных объектов схемы.

Объект считается "битым" в следующих случаях:

• таблица была удалена из источника;

• поле таблицы было удалено из источника;

• у поля таблицы изменился тип в источнике;

• источник не отвечал в момент анализа объектов.

Редактирование ассоциативной модели

Операции и возможности редактирования одинаковы как для новой модели, так и для существующих (созданных ранее). Переход в режим редактирования модели можно выполнить:

• сразу после создания новой модели - открывается форма редактирования;

• из реестра объектов в разделе Модели:

  • в табличном представлении объектов в строке модели нажмите на и далее Редактировать;

  • отметьте флажком одну модель и нажмите на кнопку Редактировать.

• из режима просмотра модели по кнопке Редактировать.

При переходе к редактированию модели, к которому у пользователя нет доступа на редактирование отобразится Модель недоступна. Отсутствуют права на редактирование модели.

Интерфейс редактирования модели содержит следующие элементы:

1.Иконка типа модели и наименование модели с возможностью его редактирования.

2.Панель кнопок управления:

• Создать виджет - при нажатии на кнопку откроется окно виджета в режиме редактирования; 

Добавление виджета может быть заблокировано, если квоты на создание виджетов закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

• Клонировать - для создания копии данной модели;

Клонирование модели может быть заблокировано, если квоты на создание моделей закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

• Удалить - для удаления данной модели;

• Настройка - переход к настройкам доступа данной модели;

3.Область источников данных модели:

• источники модели: Модели. Для каждой модели отображается иконка типа модели, наименование а также при наведении кнопка для удаления модели из структуры ассоциативной модели. Все поля модели источника передаются с реализованными настройками: алиасы полей, настроенные свойства Скрыто, Является справочником, Является ссылкой.

• добавление модели источника - добавить выбрать загруженную в хранилище модель как источник данных;

• поле Поиск для фильтрации моделей источников;

• кнопка  Свернуть для сворачивания блока источников. Для разворачивания блока необходимо нажать на кнопку Источники.

Система запоминает настроенное состояние блока, при следующем входе в окно редактирования моделей блок настроек примет последнее настроенное состояние.

Доступно изменение ширины блока. Ширина блока сохраняется при дальнейшем редактировании.

4.Область настройки схемы данных модели.

Доступно изменение ширины блока. Ширина блока сохраняется при дальнейшем редактировании.

Вкладка Схема содержит:

• панель кнопок для работы со схемой модели:

  • Обновить структуру - обновление структуры таблицы на схеме;
  • Развернуть / Свернуть - увеличение или уменьшение области схемы связей;

  

• схема связи исходных данных модели;

5.Просмотр описания столбцов. Содержит структуру полученной таблицы (названия столбцов и их типы). Для каждого столбца предусмотрено поле фильтра, обеспечивающее возможность поиска по данным модели.

Доступно изменение ширины блока. Ширина блока сохраняется при дальнейшем редактировании.

Блок содержит:

• Обновить - обновление данных;

• режимы отображения Описание столбцов - отображается описание столбцов модели, при котором для каждого столбца доступны параметры:

  • Наименование - неизменяемое, поступающее из источника;

  • Наименование в модели - наименование, для использования в вычисляемых полях или при создании SQL - запроса.

  • Алиас - псевдоним столбца, присвоенный пользователем и отображаемый далее в виджетах;

  • Таблица - название блока данных в составе модели, откуда данный столбец добавлен в модель;

  • Псевдоним таблицы - псевдоним блока данных в составе модели, откуда данный столбец добавлен в модель;

  • Скрыто - свойство поля, которое позволяет скрыть столбец в модели;

  • Является справочником - свойство поля, которое позволяет сформировать набор уникальных значений поля. В фильтрах виджетов будет доступен выбор значений из списка;

  Свойство Является справочником недоступно для полей с типом данных Дата и Число (дробное).

  • Отвечает за геолокацию - свойство поля, которое позволяет использовать поле для определения местоположения в гео-виджете. Возможные типы полей: Точки (Геоточки);

  Свойство Отвечает за геолокацию доступно для полей только с типом данных Строка и с неактивным свойством Является ссылкой или Является справочником.

  • Является ссылкой - свойство поля, которое позволяет отобразить значения поля ссылкой. В виджетах поле будет визуально отличаться от основного текста и будет содержать ссылку для перехода на другую страницу;

  • Тип - тип данных столбца.

  

Клонирование ассоциативной модели

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

При выполнении клонирования из исходной модели:

• копируются все настройки, так что модель-клон имеет абсолютно такой же вид и структуру;

• НЕ копируются установленные разрешения доступа - все дальнейшие операции с клоном разрешены только для пользователя-создателя;

• в список моделей будет добавлена новая модель с названием модели-источника и припиской (клон);

• автоматически откроется окно просмотра клонированной модели.

Клонирование модели можно выполнить нажав кнопку Клонировать в режиме просмотра или редактирования модели. Функция клонирования также доступна из реестра объектов моделей:

• через выпадающий список кнопок для выполнения действий над моделью - в табличном представлении объектов в рамках модели нажмите на и выберите действие Клонировать;

• через панель для выполнения действий над выбранными моделями - отметьте флажком модель и нажмите на кнопку Клонировать.

Клонирование модели может быть заблокировано, если квоты на создание моделей закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

Также клонирование может быть недоступно, если один из пользователей занял квоты, а второй пользователь в это время находился в этом же разделе.

Удаление ассоциативной модели

Удалить модель можно при наличии у пользователя такого права в отношении данной модели. Чтобы удалить модель, выполните одно из действий:

• на форме просмотра или редактирования модели нажмите на кнопку Удалить;

• в реестре объектов моделей в табличном представлении объектов в рамках модели нажмите на и далее на Удалить;

• в реестре объектов моделей отметьте флажком модель и в появившейся панели нажмите на кнопку Удалить.

После нажатия на кнопку Удалить появится окно удаления для подтверждения действия. Чтобы подтвердить действие, нажмите на кнопку  Удалить, для отмены - нажмите на кнопку Отмена.

Связанными объектами для модели являются виджеты, построенные на этой модели, системные виджеты - фильтры и информационные панели, в которых используются виджеты или системные виджет-фильтры.

• при отсутствии у модели связанных объектов отобразится окно подтверждения удаления;

• при наличии у модели хотя бы одного связанного объекта, созданного текущим пользователем, отобразится окно подтверждения удаления. В окне удаления отобразится список созданных пользователем связанных объектов. Опция С содержимым позволяет удалить созданные пользователем связанные объекты. Нажав на наименование нужного объекта, выполняется переход к объекту в новом окне браузера:

Если для модели созданы связанные объекты другими пользователями, то при удалении отобразится количество таких объектов в блоке Настроены другими пользователями. Объекты созданные другими пользователями не удалятся даже с включенной опцией С содержимым.

В режиме ручной публикации виджетов при удалении модели в списке объектов доступен отдельный блок Неопубликованные виджеты.

При удалении модели удаляется и настроенный на ней планировщик.

Чтобы массово удалить модели, отметьте  флажком нужные объекты в реестре объектов и на появившейся панели нажмите на кнопку  Удалить. Чтобы подтвердить действие, нажмите на кнопку  Удалить, для отмены - нажмите на кнопку Отмена.

Создание виджета из ассоциативной модели

Перейти к его созданию можно из окна работы с моделями следующими способами:

• в окне просмотра или редактирования модели, нажмите на кнопку Создать виджет;

Создание виджета может быть заблокировано, если квоты на создание виджетов закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

• в списке Модели, установите флажок в строке модели, нажмите на кнопку Добавить и выберите из выпадающего списка:
  • Добавить в новый виджет - создать новый виджет на основе данной модели;
  • Добавить в сущ. виджет - добавить данные модели в уже существующий виджет;

Создание виджета может быть заблокировано, если квоты на создание виджетов закончились. Количество квот определяется лицензией с ограничениями по количеству активных объектов.

В результате выполнения данных операций откроется окно редактирования нового виджета, основанного на данных этой модели.