Создание куба в Дизайнере БД: различия между версиями

Материал из Intellex
Перейти к навигации Перейти к поиску
 
(не показано 17 промежуточных версий этого же участника)
Строка 1: Строка 1:
Осуществите вход в систему и откройте Дизайнер БД ([[Сценарий работы с платформой приложений ХМ]]).
[[Общие принципы работы с ХМ#Запуск и завершение работы в системе|Осуществите вход в систему]] и откройте Дизайнер БД.


== Создание куба БД ==
== Создание куба БД ==
Строка 31: Строка 31:
==== Добавление таблиц ====
==== Добавление таблиц ====
'''1.''' На закладке "Структура" добавьте таблицу, нажав на иконку на панели слева.
'''1.''' На закладке "Структура" добавьте таблицу, нажав на иконку на панели слева.
[[Файл:Рисунок 4 Куб.png|без|обрамить]]
[[Файл:Новый куб 1.png|без|обрамить]]
'''2.''' На панели справа в свойствах основной таблицы заполните следующие поля значениями:
 
{| class="wikitable"
 
!Наименование поля
'''2.''' На панели справа в свойствах основной таблицы в поле "Название в БД" введите "NEW_CUBE".
!Значение для ввода
<nowiki>*</nowiki>Остальные поля оставить без изменений
|-
[[Файл:Новый куб 2.png|без|обрамить]]
|Название
|Новый куб
|-
|Схема в БД
|SYS_CUBE
|-
|Название в БД
|NEW_CUBE
|}
[[Файл:Рисунок 5 Куб.png|без|обрамить]]


=== Добавление параметров ===
==== Добавление параметров ====
'''1.''' Выберите параметр "ИД ОСНОВНАЯ ТАБЛИЦА 1" и на панели справа в свойствах параметра заполните следующие поля значениями:
'''1.''' Выберите параметр "ИД ОСНОВНАЯ ТАБЛИЦА 1" и на панели справа в свойствах параметра заполните следующие поля значениями:
{| class="wikitable"
{| class="wikitable"
Строка 55: Строка 45:
|-
|-
|Название
|Название
|ИД
|ИД Новый куб
|-
|-
|Название в БД
|Название в БД
|ID
|ID_NEW_CUBE
|}
|}
[[Файл:Рисунок 6 Куб.png|без|обрамить]]
[[Файл:Новый куб 3.png|без|обрамить]]
'''2.'''  Добавьте 3 параметра нажав трижды на иконку «Добавить параметр» на панеле слева.
'''2.'''  Добавьте 3 параметра нажав трижды на иконку «Добавить параметр» на панели слева.[[Файл:Рисунок 7 Куб.png|без|обрамить]]
[[Файл:Рисунок 7 Куб.png|без|обрамить]]
'''3.''' Выберите "ПАРАМЕТР 1" и на панели справа в свойствах параметра заполните следующие поля значениями
'''3.''' Выберите "ПАРАМЕТР 1" и на панели справа в свойствах параметра заполните следующие поля значениями
{| class="wikitable"
{| class="wikitable"
Строка 78: Строка 67:
|}
|}
[[Файл:Рисунок 8 Куб.png|без|обрамить]]
[[Файл:Рисунок 8 Куб.png|без|обрамить]]


'''4.''' Выберите "ПАРАМЕТР 2" и на панели справа в свойствах параметра заполните следующие поля значениями:
'''4.''' Выберите "ПАРАМЕТР 2" и на панели справа в свойствах параметра заполните следующие поля значениями:
Строка 95: Строка 83:
|}
|}
[[Файл:Рисунок 9 Куб.png|без|обрамить]]
[[Файл:Рисунок 9 Куб.png|без|обрамить]]


'''5.''' Выберите "ПАРАМЕТР 3" и на панели справа в свойствах параметра заполните следующие поля значениями:
'''5.''' Выберите "ПАРАМЕТР 3" и на панели справа в свойствах параметра заполните следующие поля значениями:
Строка 111: Строка 98:
|Число
|Число
|}
|}
[[Файл:Рисунок 10 Куб.png|без|обрамить]]
[[Файл:Рисунок 10 1 Куб.png|без|обрамить]]


=== Сохранение куба ===
=== Сохранение куба ===
'''1.''' Сохраните ку, нажав на кнопку сохранение в левом верхнем углу экрана. После нажатия система отобразит всплывающие сообщения об успешном сохранении.
'''1.''' Сохраните куб, нажав на кнопку сохранение в левом верхнем углу экрана. После нажатия система отобразит всплывающие сообщения об успешном сохранении.
[[Файл:Рисунок 11 1 Куб.png|без|обрамить]]


=== '''1.1.1       Добавьте таблицу ''' ===
=== Создание таблицы в БД ===
Для создания структуры необходимо нажать на панели инструментов слева «Добавить таблицу»  или перетащить иконку в рабочую область (Рисунок 4).
1.  Нажмите на панели слева кнопку «Открываем диалог Скрипты БД».
[[Файл:Рисунок 12 Куб.png|без|обрамить]]
'''2.''' В открывшемся диалоговом окне нажмите на кнопку «Применить в БД».
[[Файл:Рисунок 13 1 Куб.png|без|обрамить]]
Успешное выполнение применения в БД будет отображено информационным сообщением "Скрипт успешно выполнен!" в правом верхнем углу экрана.
[[Файл:Рисунок 14 1 Куб.png|без|обрамить]]
'''3.''' Закройте окно, нажав на кнопку "Закрыть".
[[Файл:Рисунок 15 1 Куб.png|без|обрамить]]


Рисунок 4 Добавление таблицы
=== Настройте представление ===
'''1.''' Перейдите на закладку "Представление".
[[Файл:Рисунок 16 Куб.png|без|обрамить]]
'''2.''' На панели слева нажмите на "+" для добавления АПИ.
[[Файл:Рисунок 17 Куб.png|без|обрамить]]
'''3.''' В открывшемся диалогом окне нажмите «ОК».
[[Файл:Рисунок 18 Куб.png|без|обрамить]]
'''4.''' Проставьте галки для полей:


Далее необходимо в свойствах ввести название таблицы <ins>[1] [2]  “Организации”</ins>и выбрать схему в БД “sys_cube” (Рисунок)
−  ИД;


−  Дата;


Рисунок 5 Свойства таблицы
−  Строка;


=== '''1.1.2       Добавьте параметры''' ===
−  Число.
'''<ins>Выберите таблицу и</ins>'''


Рисунок 9 Добавление параметров
Выбранные поля отобразятся в блоке «Колонки».
[[Файл:Рисунок 19 Куб.png|без|обрамить]]
'''5.''' Сохраните куб, нажав на кнопку в левом верхнем углу.
[[Файл:Рисунок 20 1 Куб.png|без|обрамить]]
'''6.''' Закройте документ и перейдите на главную страницу системы.


Вы<ins>берите добавленный параметр и в поле “Название” введите “ИНН”. Далее в поле “Тип” выберите “Число” (Рисунок)</ins>
==  Проверка созданной таблицы в БД ==
1. Для проверки и дальнейшей работы с кубом необходимо установить [https://dbeaver.io/download/ DBeaver Community] или другую программу для работы с БД.


Для подключения используйте следующие значения:
{| class="wikitable"
!Наименование поля
!Значение
|-
|Порт
|15432
|-
|База данных
|xm
|-
|Пользователь
|xm_user
|-
|Пароль
|123
|}
2. После запуска DBeaver Community на панели слева откройте xm/Базы данных/xm/Схемы/data/Таблицы/new_cube.
[[Файл:Рисунок 21 2 Куб.png|без|обрамить]]
3. Откройте new_cube двойным нажатием левой кнопкой мыши и проверьте состав и наименования колонок.
[[Файл:Рисунок 22 Куб.png|без|обрамить]]


Чтобы задать свойства необходимо выбрать параметр, после чего откроется блок заполнения в правой части экрана. <ins>Далее необходимо ввести наименование в поле “Название” и выбрать тип строки </ins><s>Набор свойств параметров зависит от выбранного типа поля</s> (Рисунок 10).
== Добавление записей в БД ==
 
'''1.''' Перейдите на вкладку "Данные".[[Файл:1 Записи БД.png|без|обрамить|ссылка=http://10.144.18.111/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:1_%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D0%B8_%D0%91%D0%94.png]]'''2.''' Нажмите на "Добавить новую запись".
Рисунок 10 Свойства параметра
[[Файл:2.1 Записи БД.png|без|обрамить]]
 
'''3.''' Введите следующие значения:
=== '''1.1.3      ''' <ins>Сохраните куб</ins> ===
{| class="wikitable"
<ins>Для сохранения куба в БД и присвоения id необходимо нажать на кнопку сохранения (Рисунок 16). Последующие внесенные изменения сохраняются также по данной кнопке и применяются ко всему кубу.</ins>
!Наименование колонки
 
!Значение
=== '''1.1.4       Применение в БД''' ===
|-
После того как будут добавлены все параметры и заполнены свойства необходимо нажать на «Открываем диалог Скрипты БД» (Рисунок 11)
|id
 
|1
Рисунок 11 Применение в БД
|-
 
|line
Далее раскроется диалоговое окно для создания таблиц, на основании предоставленной структуры в котором необходимо нажать на кнопку «Применить в БД» (Рисунок 12).
|Строка 1
 
|-
<ins>[3] </ins>
|date
 
|2021-07-30
Рисунок 12 Создание таблицы, на основании предоставленной структуры
|-
 
| number
== 1.2        Создайте юниверсы ==
|1
Юниверс - это мета представление структуры документа.
|}[[Файл:3 Записи БД.png|без|обрамить|ссылка=http://10.144.18.111/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:3_%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D0%B8_%D0%91%D0%94.png]]'''4'''. Добавьте вторую запись и введите следующие значения:
 
{| class="wikitable"
Юниверс создаётся, открывается и обновляется автоматически при открытии закладки «Юнивёрс» в соответствии с таблицами структуры базы данных.
!Наименование колонки
 
! Значение
Рисунок 13 Закладка «Юниверс»
|-
 
|id
Для первоначального сохранения юниверсов в базу данных необходимо нажать на  «Загрузить [4] юнивёрс» на панели инструментов. Дальнейшее сохранение происходит по общей кнопке  для всего режима.
|2
 
|-
<s>Настройка полей и поиска документов происходит для каждого параметра в зависимости от выбранного типа на закладке «Структура».</s>
|line
 
|Строка 2
<s>Рисунок 14 Настройка юниверсов</s>
|-
 
|date
== <s>1.1                  Настройте представление</s> ==
|2021-07-31
<s>Представление – это API к кубу, которое трансформируется в SQL запрос</s>
|-
 
|number
<s>Данный функционал предназначен для поиска значений по идентификатору, наименованию, выборку данных без параметров и их отображение в табличном виде, указанным в представлении.</s>
|2
 
|}[[Файл:4 Записи БД.png|без|обрамить|ссылка=http://10.144.18.111/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:4_%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D0%B8_%D0%91%D0%94.png]]'''5'''. Добавьте третью запись и введите следующие значения:
<s>Чтобы настроить представление необходимо в блоке «Список АПИ» нажать на Добавить (Рисунок 15).</s>
{| class="wikitable"
 
!Наименование колонки
<s>Рисунок 15 Добавление АПИ</s>
!Значение
 
|-
<s>Далее необходимо выбрать поля для построения фильтра, проставив галки, которые необходимы. Выбранные поля отобразятся в блоке «Колонки» (Рисунок 16) с выбором значения:</s>
|id
 
|3
<s>Без признака – отображение;</s>
|-
 
|line
<s>Идентификатор – поиск по ИД (доступно только для числовых полей)</s>
|Строка 3
 
|-
<s>Наименование - поиск по наименованию (доступно только для строкового поля)</s>
|date
 
| 2021-08-01
<s>Код – поиск по коду (доступно только для строкового поля)</s>
|-
 
| number
<s>Рисунок 16 Блок Колонки</s>
|3
 
|}[[Файл:5 Записи БД.png|без|обрамить|ссылка=http://10.144.18.111/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:5_%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D0%B8_%D0%91%D0%94.png]]'''6.''' Нажмите на кнопку "Save".[[Файл:6 Записи БД.png|без|обрамить|ссылка=http://10.144.18.111/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:6_%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D0%B8_%D0%91%D0%94.png]]Для проверки возможности выбора данных из куба "new_cube" перейдите в сценарий "[[Добавление в отчет выбор данных из куба БД]]".
<s>В блоках Сортировка (Рисунок 17) и Ограничения (Рисунок 18) поля добавляются аналогично Колонкам.</s>
 
<s>Рисунок 17 Блок «Сортировка»</s>
 
<s>Рисунок 18 Блок «Ограничения»</s>
 
<s>Предварительно можно посмотреть сгенерированный SQL запрос, на основе параметров и ограничений представления и протестировать в БД (Рисунок 19).</s>
 
<s>Рисунок 19 Проверка представления</s>
 
<s>Сгенерированный запрос разделен на 2 части. В первой формируется запрос для функции чтения данных представления, во второй - текст создания представления, как объекта в БД. Создается только в том случае, когда наложены ограничения на выборку данных или выбраны колонки из дочерних таблиц или связанных представлений через ссылку.</s>
 
<s>Если представление протестировано и удовлетворяет требованиям задания, необходимо сохранить его, нажав на .</s>
 
<s>Для использования, созданного АПИ необходимо выполнить связывание (Рисунок 20):</s>
 
<s>1)           На закладке Структура для поля выбрать тип "Ссылка"</s>
 
<s>1)           Настроить тип выбора, указав выбор из других документов/справочников.</s>
 
<s>1)           В поле Сущность выбрать куб из списка</s>
 
<s>1)           В поле АПИ чтения выбрать представление из списка представлений в выбранном кубе.</s>
 
<s>1)           В правилах заполнения разместить действие "Выбор из списка" (выбор из справочника).</s>
 
<s>1)           Настроить выходные параметры. Включает в себя, настройку отображения колонок грида, их текстовое описание, настройка первичного ключа и параметра для поиска по тексту, переменные привязки. Специфика настройки такая же, как и для выбора из апп-функции..</s>
 
<s>Рисунок 20 Связывание</s>
 
 
= 2          Просмотр истории создания куба =
На закладке «История» отображается список операций, в которых указаны следующие параметры внесённых изменений (Рисунок 21):
 
−       Дата
 
−       Время
 
−       Источник
 
−       Тип операции
 
−       ФИО пользователя
 
Рисунок 21<ins> </ins>Интерфейс закладки «История»
 
           <s>История операций отображается по всем закладкам или по выбранной. Для просмотра истории по выбранной закладке необходимо в выпадающем списке её выбрать (Рисунок 22).</s>
 
<s>Рисунок 22 Просмотр истории операций по выбранной закладке</s>
 
= <s>1              Просмотр объектов куба</s> =
<s>               Для построения первоначального списка объектов, входящих в куб и дальнейшего обновления необходимо на закладке «Объекты куба» нажать на кнопку «Обновить по документу» (Рисунок 23)</s>
 
<s>Рисунок 23 Интерфейс закладки «Объекты куба»</s>
 
<s>               Список формируется в виде дерева по типам объектов:</s>
 
<s>1)           Кубы:</s>
 
<s>a)           Кубы</s>
 
<s>a)           Представления (api)</s>
 
<s>1)           Программный код</s>
 
<s>a)           App функции</s>
 
<s>a)           Пакеты</s>
 
<s>a)           Процедуры</s>
 
<s>a)           Функции</s>
 
<s>1)           Данные:</s>
 
<s>a)           Данные</s>
 
<s>a)           Отчеты</s>
 
<s>a)           Джобы</s>
 
<s>1)           БД:</s>
 
<s>a)           Таблицы</s>
 
<s>a)           Представления (view)</s>
 
<s>a)           Сиквенсы</s>
 
<s>a)           Триггеры</s>
 
<s>a)           Типы</s>
 
<s>a)           Синонимы</s>
 
== <s>1.1                  Свойства объектов куба</s> ==
<s>               Для отображения свойств объекта необходимо выделить подгруппу. Свойства объектов отобразятся списком (Рисунок 24), если необходимо отобразить свойства только выбранного объекта, то необходимо его выделить в дереве или открыть двойным щелчком левой кнопки мыши.</s>
 
<s>Рисунок 24 Отображение списка объектов, входящих в подгруппу</s>
 
== <s>1.1                  Связи объектов куба</s> ==
<s>Для отображения связей справочника, используемые в нем и использующие его, необходимо нажать на кнопку «Связи куба».</s>
 
<s>Для отображение подробной информации нужного куба необходимо навести курсор или нажать одни кликом на нужный объект.</s>
 
<s>Переход в соответствующий дизайнер, где расположен куб, осуществляется двойным щелчком левом кнопки мыши.</s>
 
<s>Рисунок 25 Инструменты навигации диаграммы</s>
 
<s>Инструменты навигации диаграммы расположены в нижнем левом и правом углах.</s>
 
= 3          <s>Чтобы настроить отображение диаграммы необходимо выбрать куб и зажав левую кнопку</s> мыши его переместить. =
 
= 4          Проверка созданной таблицы БД =
a)      Найти созданную таблицу в БД по наименованию таблицы и выбранной схеме
 
b)     Проверить соответсвие наименование полей в таблице
 
c)     Запольнить таблицу необходимыми данными и сохранить изменения
 
d)     Проверка использования созданной таблицы БД в Дизайнере документов
 
e)     Открыть существующий документв в ДД
 
f)      На закладке Структура:
 
g)     в существующей или новой таблице добавить новый параметр
 
h)     "в свойствах нового параметра указать тип: ""Ссылка"",
 
i)       тип выбора: ""Из других документов/справочников"",
 
j)       сущность: наименование созданной таблицы в БД
 
k)     АПИ чтения: наименование созданной в таблице БД АПИ"
 
l)       нажать на кнопку Применить в БД и сохранить
 
m)    На закладке Правила:
 
n)     добавить правило с действием "Выбор из списка" для созданного ранее параметра
 
o)     настроить правило и нажать на сохранить
 
p)     На закладке GUI:
 
q)     вручную добавить поле, соотвествующее новому параметру и сохранить
 
r)      Проверка отображения таблицы БД в Документе
 
s)      найти нужный режим в интерфейсе и нажать на кнопку "Создать документ"
 
t)      в открывшемся окне документа найти поле, добавленное в предыдущих пунктах
----схема в БД  не выбирается, а вводится вручную
 
Должны сделать выбор. Сейчас вбивается руками. Создала файл для записи ошибок при создании куба
 
добавить закрытие этого окна, после нажатия кнопки оно не закрывается само
 
сохранить, а не загрузить

Текущая версия на 11:00, 4 июля 2022

Осуществите вход в систему и откройте Дизайнер БД.

Создание куба БД

1. После открытия Дизайнера БД нажмите на иконку  в правом нижнем углу экрана для создания куба.

Рисунок 1 Куб.png

2. В открывшемся диалоговом окне «Добавление нового куба» введите наименование "Новый куб" и нажмите на кнопку «Создать новый куб».

Рисунок 2 Куб.png

Дизайнер БД содержит следующие закладки:

−       Структура

−       Юнивёрс

−       Представление

−       Свойства

−       История

−       Объекты куба

Рисунок 3 Куб.png

Создайте структуру

На закладке «Структура» необходимо выполнить следующие действия:

  • Добавить таблицу и задать основные свойства
  • Добавить параметры и задать основные свойства
  • Создать таблицы в БД, на основании созданной структуры
  • Сохранить документ

Добавление таблиц

1. На закладке "Структура" добавьте таблицу, нажав на иконку на панели слева.

Новый куб 1.png


2. На панели справа в свойствах основной таблицы в поле "Название в БД" введите "NEW_CUBE". *Остальные поля оставить без изменений

Новый куб 2.png

Добавление параметров

1. Выберите параметр "ИД ОСНОВНАЯ ТАБЛИЦА 1" и на панели справа в свойствах параметра заполните следующие поля значениями:

Наименование поля Значение для ввода
Название ИД Новый куб
Название в БД ID_NEW_CUBE
Новый куб 3.png

2. Добавьте 3 параметра нажав трижды на иконку «Добавить параметр» на панели слева.

Рисунок 7 Куб.png

3. Выберите "ПАРАМЕТР 1" и на панели справа в свойствах параметра заполните следующие поля значениями

Наименование поля Значение для ввода
Название Строка
Название в БД LINE
Тип Строка
Рисунок 8 Куб.png

4. Выберите "ПАРАМЕТР 2" и на панели справа в свойствах параметра заполните следующие поля значениями:

Наименование поля Значение для ввода
Название Дата
Название в БД DATE
Тип Дата
Рисунок 9 Куб.png

5. Выберите "ПАРАМЕТР 3" и на панели справа в свойствах параметра заполните следующие поля значениями:

Наименование поля Значение для ввода
Название Число
Название в БД NUMBER
Тип Число
Рисунок 10 1 Куб.png

Сохранение куба

1. Сохраните куб, нажав на кнопку сохранение в левом верхнем углу экрана. После нажатия система отобразит всплывающие сообщения об успешном сохранении.

Рисунок 11 1 Куб.png

Создание таблицы в БД

1. Нажмите на панели слева кнопку «Открываем диалог Скрипты БД».

Рисунок 12 Куб.png

2. В открывшемся диалоговом окне нажмите на кнопку «Применить в БД».

Рисунок 13 1 Куб.png

Успешное выполнение применения в БД будет отображено информационным сообщением "Скрипт успешно выполнен!" в правом верхнем углу экрана.

Рисунок 14 1 Куб.png

3. Закройте окно, нажав на кнопку "Закрыть".

Рисунок 15 1 Куб.png

Настройте представление

1. Перейдите на закладку "Представление".

Рисунок 16 Куб.png

2. На панели слева нажмите на "+" для добавления АПИ.

Рисунок 17 Куб.png

3. В открывшемся диалогом окне нажмите «ОК».

Рисунок 18 Куб.png

4. Проставьте галки для полей:

−  ИД;

−  Дата;

−  Строка;

−  Число.

Выбранные поля отобразятся в блоке «Колонки».

Рисунок 19 Куб.png

5. Сохраните куб, нажав на кнопку в левом верхнем углу.

Рисунок 20 1 Куб.png

6. Закройте документ и перейдите на главную страницу системы.

 Проверка созданной таблицы в БД

1. Для проверки и дальнейшей работы с кубом необходимо установить DBeaver Community или другую программу для работы с БД.

Для подключения используйте следующие значения:

Наименование поля Значение
Порт 15432
База данных xm
Пользователь xm_user
Пароль 123

2. После запуска DBeaver Community на панели слева откройте xm/Базы данных/xm/Схемы/data/Таблицы/new_cube.

Рисунок 21 2 Куб.png

3. Откройте new_cube двойным нажатием левой кнопкой мыши и проверьте состав и наименования колонок.

Рисунок 22 Куб.png

Добавление записей в БД

1. Перейдите на вкладку "Данные".

1 Записи БД.png

2. Нажмите на "Добавить новую запись".

2.1 Записи БД.png

3. Введите следующие значения:

Наименование колонки Значение
id 1
line Строка 1
date 2021-07-30
number 1
3 Записи БД.png

4. Добавьте вторую запись и введите следующие значения:

Наименование колонки Значение
id 2
line Строка 2
date 2021-07-31
number 2
4 Записи БД.png

5. Добавьте третью запись и введите следующие значения:

Наименование колонки Значение
id 3
line Строка 3
date 2021-08-01
number 3
5 Записи БД.png

6. Нажмите на кнопку "Save".

6 Записи БД.png

Для проверки возможности выбора данных из куба "new_cube" перейдите в сценарий "Добавление в отчет выбор данных из куба БД".

Источник — http://xmdocs.intellex.ru/index.php?title=Создание_куба_в_Дизайнере_БД&oldid=2081