Взаимодействие 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.