Взаимодействие ADVANTA с BI-системой "Навигатор"

Навигатор - российская платформа визуализации данных (BI) от компании «Сбер». Она заменяет такие системы, как «Power BI», «Qlik» или «Tableu».

«Навигатор» позволяет создавать дашборды по информации, загружаемой из различных информационных систем. Чтобы создать в «Навигаторе» дашборд по данным о проектах из Системы ADVANTA, требуется выполнить шаги:

1. Выгрузить необходимые для построения дашборда данные из ADVANTA в файлы формата XLSX или в промежуточную базу данных.
2. Загрузить данные в Навигатор через ее функцию создания нового «источника».
3. Сконструировать дашборд средствами системы Навигатор.

Если выгружать данные для дашбордов требуется редко, можно выполнять эту задачу вручную, путём экспорта отчёта ADVANTA в файл формата Excel.

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

1. Автоматизировать процесс экспорта заранее настроенного отчёта типа «электронная таблица» в файл формата Excel, аналогично выгрузке вручную.
2. Получать данные об объектах ADVANTA в табличной форме через API-функции, без использования отчётов. Данные нужно записать либо в файлы, либо во внешнюю базу данных, откуда Навигатор сможет их загрузить.

Чтобы вручную выгрузить данные из ADVANTA, надо создать отчет, настроить в нем состав полей, после чего выгрузить его в XLSX-файл.

Подробно процесс выгрузки описан на страницах о соответствующих типах отчетов:

• выгрузка в ''XLSX'' отчета типа «Электронная таблица»;
• выгрузка в ''XLSX'' отчета типа «Проекты и работы».

Отчеты типа «электронная таблица» можно выгружать из ADVANTA автоматически. Для этого требуется написать приложение, которое будет по расписанию получать файл отчета через метод API DownloadSpreadsheetReportFile и сохранять его на диске.

При вызове этого метода в параметре reportId указывается идентификатор отчета ADVANTA, который можно найти в адресной строке браузера (UID).

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

Есть два способа получения данных через API:

1. API-функции SOAP позволяют получать данные из ADVANTA в формате XML. Например, для получения таблицы проектов можно использовать API GetProject, а для получения данных из прикреплённых к проектам таблиц – API GetRecords.
2. WebApi позволяет выполнять из внешнего приложения LINQ-запросы. Так можно получать данные об объектах ADVANTA в формате JSON. При этом структуру таблиц можно гибко настраивать, используя возможности языка C#. Принципы работы с LINQ-запросами представлены на странице "Модуль LINQ".

В примере будет создан дашборд, который покажет задачи проектов, завершённые с отклонением по времени. Для этого:

1. На демостенде ADVANTA будет создан отчет с перечнем просроченных задач.
2. Отчет будет выгружен в файл формата XLSX вручную и загружен в Навигатор в виде «источника».
3. Будет настроен дашборд.

На странице демостенда https://pmo.a2nta.ru нужно вызвать в Левом меню «Мои отчёты» → «Добавить отчёт». Запустится мастер создания отчёта. Выберем тип отчёта «Проекты и работы».

На шаге «Какие данные нужно показать в отчете?» выберем «Задача».

Ниже, в области «Используйте дополнительные фильтры», укажем, что нужны только проекты одного направления. В строке «Фильтр по родительскому проекту» нажмём кнопку «Включить».

Появится страница выбора узла в Дереве проектов - нажмём кнопку «Выбрать» в строке «Портфель проектов цифровизации». Выбранное направление будет добавлено в область «Проекты в профиле».

Завершим настройку фильтра по Дереву проектов кнопкой «Выбрать». Для завершения формирования отчета нужно нажать кнопку «Показать отчет» - появится страница отчета со стандартным набором полей:

• Название;
• Статус;
• Исполнитель;
• Планируемая дата завершения.

Добавим в отчет дополнительные поля, которые потребуются в дашборде. Для этого зайдем меню «три точки» → «Изменить» - появится редактор настроек отчета. В редакторе настроек нужно найти раздел «Даты объектов» и включть чекбоксы в полях «Утверждённая дата завершения» и «Фактическая дата завершения», в разделе «Системные показатели» включить чек-бокс у поля «Отклонение окончания».

Добавим поле с названием проекта, в который входит задача. Для этого в разделе «Источник» нажмем кнопку «Добавить» - появятся поля для выбора вышестоящего объекта. В списке типов объектов выберем «Проект цифровизации», а правее, в поле «Название колонки» напишем «Проект».

Завершим настройку кнопкой «Показать отчет» в верхней части окна настроек. Выбранные столбцы появятся в отчете.

Далее нужно настроить фильтры данных так, чтобы в отчет попадали только задачи, завершённые не вовремя. Для этого в области фильтров записей отчёта установим для параметра «Отобрать по» значение «Утверждённые даты» и включим чек-бокс «Только просроченные».

В табличной части отчёта, в поле «Статус» установим фильтр по значению «Завершен».

В верхней части страницы отчета, в поле «Название» введём «Задачи с отклонением по дате завершения» и сохраним отчёт кнопкой «Сохранить». Теперь отчет станет доступен в Левом меню ADVANTA, в разделе «Мои отчеты».

На странице отчета нужно вызвать меню «три точки» → «Экспорт в» → «Экспорт в XLSX». Проявится диалог сохранения Excel-файла на диск. Выберем каталог и сохраним файл.

В указанном каталоге появится XLSX-файл, можно просмотреть его в Excel.

В системе Навигатор нужно перейти в панель управления (АРМ: Администрирование).

Откроем страницу создания источника данных.

Добавим новый источник данных «Из файла».

В окне «Новый источник» введём название, аналогичное нашему отчёту («Задачи с отклонением по дате завершения»). Выберем предметную область и нажмём «Загрузить».

Далее найдем и откроем XLSX-файл, выгруженный ранее из ADVANTA. Появится страница загрузки данных из файла.

Для сохранения источника, нажимаем кнопку «Загрузить», справа внизу. Созданный источник проявится в списке.

Перейдём в раздел «Визуализация → Дэшборды» и создадим новый кнопкой «Новый дэшборд». Назовём его «Задачи проектов, завершённые не в срок».

На странице редактирования дашборда добавим новый «Экран» типа «Лента».

Лишний экран типа «Сетка», созданный по умолчанию, нужно удалить.

Переименуем экран в «Просроченные задачи проектов» и добавим новый глобальный набор данных. Он появится слева, в меню структуры экрана. Переименуем его в «Таблица задач».

Далее перейдем на страницу редактирования набора данных «Таблица задач» двойным кликом по его названию в левом меню.

В поле «Источник данных» выберем источник «Задачи с отклонением по дате завершения», настроим набор полей.

Переименуем поля для отображения на экране:

• nazvanie → Название задачи;
• ispolnitel → Исполнитель;
• proekt → Проект;
• otklonenie_okonchaniya → Отклонение.

Далее нужно вернуться на страницу дашборда по кнопке «Дэшборд». В окне структуры дашборда слева выберем каталог «Новая группа» и вызовем пункт меню «Добавить виджет». В списке возможных виджетов выберем диаграмму «Круговая».

Виджет диаграммы появится в каталоге группы виджетов в окне структуры. Переименуем его в «Наибольшее отклонение» с помощью поля свойств виджета справа.

Перейдём на страницу настройки виджета двойным кликом по нему в левом меню.На странице настроек виджета, в поле «Набор данных» выберем созданный нами набор «Таблица задач».

В поле «Название» выберем «Название задачи».

В поле «Значения» выберем «Отклонение».

В правой части окна мы увидим превью созданного виджета.

Далее вернемся на страницу дашборда. В правой части окна настроек дашборда установим параметры:

• Генерировать из = Таблица задач;
• Поле для сегментации = Проект.

Построим созданный дашборд кнопкой «Показать в Навигаторе».

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

Таков общий принцип ручной передачи данных из ADVANTA в BI-систему Навигатор для построения в ней дашбордов.