Компонент «Редактор объектов (oditor)»

Компонент «Редактор объектов (oditor)» – это средство просмотра/редактирования базы данных системы, построенной на платформе NetDB.

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

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

Информационная структура NetDB

Возможности многомерного анализа и агрегации данных обеспечиваются за счет гибкой сетевой модели организации данных NetDB.

Элементом данных в хранилище NetDB является информационный объект, который представляется как значение определенного показателя (число, строка, дата, значение из справочника и т.п.) с набором аналитических признаков, описывающих это значение.

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

_images/inf_object.png

На рисунке приведен пример информационного объекта, содержащего сведения о том, что «Оперативная отчетность содержит фактические данные о том, что поголовье молочных коров на сельхозпредприятии ООО «Заря» на отчетный период 15.02.2013 составляло 140 голов».

_images/inf_object_example.png

Отметим, что аналитический признак «Категория хозяйств» связан с рассматриваемым показателем «Поголовье КРС, голов» «по цепочке» через показатель «Административная структура». Связи между показателями формируют сетевую структуру информационных объектов.

Можно рассматривать информационные объекты NetDB как объекты многомерного координатного пространства. Каждая координатная ось в пространстве соответствует некоторому показателю, а информационные объекты являются точками в некоторых подпространствах общего пространства. К примеру, описанный выше информационный объект будет точкой в подпространстве, натянутом на 6 координатных осей: «Поголовье КРС, голов», «Источник данных», «План/Факт», «Период», «Административная структура», «Категория КРС».

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

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

На основе информационных объектов реализованы основные сущности NetDB:

  • Простой справочник - множество (список) объектов, используется для ограничения допустимых значений показателей.
  • Древовидный справочник - множество объектов, имеющее иерархическую (древовидную) структуру, используется для ограничения допустимых значений показателей и операций агрегирования данных.
  • Отчет - табличное представление, отображающее результат запроса к хранилищу на выдачу данных, удовлетворяющих определенным условиям. Структура отчета задается в конструкторе отчетов, причем ни количество условий (фильтров), ни количество запрашиваемых данных (источников значений) системой не ограничиваются. Отчет используется только для просмотра.
  • Форма - табличное представление, аналогичное отчету, но допускающее ввод и корректировку данных.
  • Реестр - перечень (список) объектов, удовлетворяющих определенным условиям. Каждый столбец реестра соответствует определенному показателю, а количество строк реестра не ограничено. В отличие от отчета (формы), где значению в каждой ячейке соответствует некоторый объект (м.б. вычисленный), в реестре каждой строке соответствует один объект. По сути реестр представляет собой некоторый срез (подпространство) всего пространства объектов.

Идентификационные номера объектов

Каждому информационному объекту система присваивает уникальный идентификационный номер (id объекта). Например, на стенде http://netdb.demo.chtd.ru показатель «Поголовье КРС, голов» имеет id = 1033369. Информационный объект, у которого значение показателя «Поголовье КРС, голов» равно 140, имеет id = 1033494.

Системные объекты имеют идентификаторы со знаком «минус». Например, системный показатель «Период» имеет id = -64, системный справочник «Варианты доступа» имеет id = -905.

Перечень системных справочников см. в подразделах Системные простые справочники, Системные древовидные справочники.

Перечень и описание системных показателей см. в подразделе Системные показатели.

Как определить идентификационный номер объекта в системе? Есть несколько способов просмотра id объекта.

1 способ: перейти на страницу просмотра объекта и скопировать последние цифры из URL.

Допустим, нужно узнать id Справочника «Группы отчетов». Переходим в раздел «Древовидные справочники», выбираем нужный справочник. В строке URL на странице просмотра справочника: net-dev.chtd.ru/relation/-206/, последние цифры и есть id. В данном примере id= «-206».

_images/id_object1.png

2 способ: если глобальным системным администратором включена соответствующая настройка в приложении - то в отчете/форме можно нажать правой кнопкой мыши на значение, и в выпадающем списке выбрать «Номер объекта».

Допустим, нужно узнать id объекта, содержащего значение показателя «Уровень инфляции» за 2011 год. На странице просмотра формы нажимаем правой кнопкой мыши на нужное значение и просматриваем «Номер объекта: 1554045».

_images/object.PNG

Идентификационные номера объектов используются:

Граф метаданных

Граф метаданных - это визуализация объекта и его исходящих связей. Данная визуализация помогает увидеть и понять структуру связей между объектами NetDB. Для того чтобы просмотреть граф метаданных определенного объекта, необходимо перейти по ссылке следующего вида: <url системы>/objgraph/<id объекта>/, где где <url системы> - адрес главной страницы системы, <id объекта> - идентификационный номер объекта.

На следующем рисунке приведен пример графа метаданных для описанного выше информационного объекта, у которого id = 1033494 и значение показателя «Поголовье КРС, голов» равно 140. Видны все исходящие связи данного объекта.

_images/oditor_objgraph.png

Доступ к редактору объектов

Функции редактора объектов доступны только глобальному администратору системы.

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

<url системы>/oditor/ , где <url системы> - адрес главной страницы системы, например http://netdb.demo.chtd.ru/oditor/

Если нужно перейти к странице просмотра/редактирования конкретного объекта, укажите адрес:

<url системы>/oditor/<id объекта> , где <id объекта> - идентификационный номер объекта (после id объекта – slash не требуется, например http://netdb.demo.chtd.ru/oditor/1033369 ).

На скриншоте показана страница информационного объекта - показателя «Поголовье КРС, голов»:

_images/oditor_descriptor.png

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

  • Поиск объектов (open object),
  • Создание нового объекта (Create object),
  • Создание связи слева (add inlink),
  • Создание признаков (add link),
  • Создание связи справа (add outlink),
  • Удаление объекта (destroy object),
  • Список открытых объектов в oditor (кнопка располагается в правом верхнем углу).

Для удаления объекта необходимо одновременно зажать клавишу ctrl и нажать кнопку «destroy object». При удалении объекта система не проводит анализ взаимосвязанных объектов – поэтому перед тем, как удалять объект, надо самостоятельно проанализировать каждую связь.

Справа вверху расположены кнопки операций, выполняемых над системой в целом:

Будьте осторожны при возврате к снапшоту - отменить данную операцию невозможно.

Страница просмотра и редактирования объекта разделена на три части:

  • Справа - значения признаков текущего объекта, при этом в первом столбце справа - признаки, а во втором столбце - значения признаков,
  • Слева - объекты, у которых текущий объект является значением признака, при этом в первом столбце объекты, связанные с текущим каким-то признаком, во втором столбце - сам признак, указывающий на текущий объект,
  • Центральная часть – это объекты, для которых текущий объект - признак, при этом в первом столбце - объекты с этим признаком, во втором столбце - значения этого признака (текущего объекта) у этих объектов,

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

В качестве примера рассмотрим страницу объекта - показателя «Поголовье КРС, голов» (см. выше). На странице данного объекта слева отображаются множества, элементами которых является данный показатель. Это множество всех показателей системы «Показатели», у которого id = -127, а также группа показателей, в которую включен данный показатель.

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

В центральной части страницы данного объекта отображается связанный с данным показателем информационный объект, у которого id = 1033494 и значение показателя «Поголовье КРС, голов» равно 140. Нажимая на id объекта, можно перейти к странице просмотра этого объекта, где отображаются его признаки:

_images/oditor_object_1033494.png

Примеры использования oditor

  1. Если при удалении элемента из справочника система выдает сообщение об имеющихся связях, можно:
  • открыть страницу просмотра элемента справочника в oditor (id элемента справочника можно просмотреть в первой колонке в редакторе справочника, или в истории изменений в режиме просмотра справочника),

  • просмотреть связи в левой части страницы.

    Первая связь «element» (id = -4) показывает, элементом какого справочника является объект, эта связь не влияет на удаление объекта. Остальные связи слева – это номера объектов (значений), в которых содержится данный элемент справочника. Для корректного удаления данных связей можно построить в системе реестр, содержащий показатель, ссылающийся на этот справочник.

  1. Если при удалении показателя система выдает сообщение об имеющихся связях, можно:
  • открыть страницу просмотра показателя в oditor (id показателя можно посмотреть в адресе url – после …/descriptor/ ),
  • просмотреть значения показателя в центральной части страницы, перейти на страницу просмотра объекта, содержащего данное значение.
  1. В oditor может быть скорректирован коннектор (например, строка подключения), для этого можно:
  • открыть коннектор в oditor (id коннектора можно посмотреть в адресе url – после …/adapters/ ),
  • отредактировать связь «строка подключения» в правой части страницы.
  1. Устранение дублирующихся связей.

Некоторые связи по определению должны быть уникальными. Если произошло дублирование связей в системе, необходимо найти дублирующиеся связи и удалить их вручную в редакторе объектов (на ненужной связи нажать «remove link»).

Например,

  • в связях справа – признаки должны быть уникальными: не может быть объекта, у которых два названия, или два времени создания. Исключение составляет связь «element» (id = -4).
  • показатель «Пользовательская конфигурация» (id = -369) хранит персональные настройки системы, выбранные определенным пользователем, поэтому в центральной области на странице просмотра данного показателя может быть указан только один пользователь.
  1. Настройка интерфейса стенда - см. в подразделе Настройка темы оформления.