Wiki [3.x] product:api:integration_examples

Интеграция ADVANTA с Analytic Workspace

anonymous@undisclosed.example.com (Anonymous) — Wed, 07 Aug 2024 05:55:10 +0000

Интеграция ADVANTA с Analytic Workspace

Analytic Workspace — российская BI-система, позволяющая обрабатывать данные из разных источников и визуализировать их при помощи широкого набора встроенных инструментов. Благодаря интеграции возможно использование инструментария Analytic Workspace для построения дашбордов на основе данных из ADVANTA. Это дает дополнительные возможности для анализа данных и последующего формирования управленческих решений.

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

1) Сформировать в ADVANTA LINQ-запросы

Интеграция с Analytic Workspace организована с использованием LINQ-запросов и Web-API ADVANTA. Таким образом, для того, чтобы загрузить данные в BI-систему, необходимо предварительно сформировать LINQ-запросы внутри ADVANTA для получения тех данных, которые в дальнейшем будут визуализированы.

Пример LINQ-запроса данных по проектам

 /* 1. перечень всех проектов (2 типа объектов - ИТ-проект и Организационный проект)
с UID и всеми системными реквизитами (сроки начала/завершения - план, факт, ответственные (ФИО), статус (текстом), последний базовый план)
- объект-родитель (название)
и пользовательскими реквизитами:
- жизненный цикл проекта
- описание
- масштаб проекта (текстовое значение)
- эффект
- последняя запись из справочника "Отчет о статусе" - все поля
- активная запись из справочника "Бюджет проекта" - только поле "Бюджет (план)"
*/
 
var projects = dataContext.Projects
      .Where(p => p is IT_proekt_d46b6d || p is Organizacionnij_proekt_a3e2fb)
      .OrderBy(p => p.CreationDate)
      .Select(p => new { p.Id, 
                          p.Name, ParentName = p.Parent.Name,
                          LifeCycleName = p.Fields.Zhiznennij_cikl_proekta_b07f57.Name,
                          p.SystemStartDate, p.SystemEndDate, p.ActualStartDate, p.ActualEndDate,
                          p.BaselinePlanStartDate, p.BaselinePlanEndDate,
                          BossFIO = String.Concat( p.Owner.LastName, " ", p.Owner.FirstName), RPFIO = String.Concat( p.Responsible.LastName, " ", p.Responsible.FirstName),
                          Description = p.Fields.Opisanie_caaaaa,
                          ProjectScaleName = p.Fields.Masshtab_proekta_04412f.Name,
                          ProjectGainName = p.Fields.Effekt_b6c145.Name,
                          StatusReport_Date = p.GetChildren<Otchet_o_statuse_440616>().OrderByDescending(o => o.Date).FirstOrDefault().Date,
                          StatusReport_Chto_sdelano_problemi_riski = p.GetChildren<Otchet_o_statuse_440616>().OrderByDescending(o => o.Date).FirstOrDefault().Chto_sdelano_problemi_riski_4a11b8,
                          StatusReport_Prichina_problemi = p.GetChildren<Otchet_o_statuse_440616>().OrderByDescending(o => o.Date).FirstOrDefault().Prichina_problemi_a3e564.Name,
                          StatusReport_StatusName = p.GetChildren<Otchet_o_statuse_440616>().OrderByDescending(o => o.Date).FirstOrDefault().Status_e05ba3.Name, 
                          BudjetSum = p.GetChildren<Byudzhet_plan_e5bee7>().Where(b => b.Aktivnostj_versii_281a38.Id == Classifier_Aktivnostj_versii_625508.Aktivnaya_4f5ba775_Id).Sum(b => b.Summa_06ff93)
                        });
return projects;

Пример LINQ-запроса данных по контрольным точкам

/*
2. перечень всех контрольных точек (1 тип объекта - КТ0)
с UID и всеми системными реквизитами (как и у проекта),
- UID - проекта-родителя (непрямой родитель)
и пользовательские поля:
- описание (текст)
- результат (текст)
- последняя запись из справочника "Отчет о мероприятии" - все поля
*/
var projects = dataContext.KT0_1ff431_List
      .Select(p => new { 
      				p.Id, 
      				p.Name,
                    ProjectId = (Guid?)p.GetParentHierarchy<Project>(false).Where(p => p is IT_proekt_d46b6d || p is Organizacionnij_proekt_a3e2fb).FirstOrDefault().Id,
                    // ProjectName = p.GetParentHierarchy<Project>(false).Where(p => p is IT_proekt_d46b6d || p is Organizacionnij_proekt_a3e2fb).FirstOrDefault().Name,
                    p.SystemStartDate, p.SystemEndDate, p.ActualStartDate, p.ActualEndDate,
                    p.BaselinePlanStartDate, p.BaselinePlanEndDate,
                    BossFIO = String.Concat( p.Owner.LastName, " ", p.Owner.FirstName), RPFIO = String.Concat( p.Responsible.LastName, " ", p.Responsible.FirstName),
                    Description = p.Opisanie_caaaaa,
                    Result = p.Rezuljtat_8e716f,
                    StatusReport_Date = p.GetChildren<Otchet_o_statuse_meropriyatiya_2bc942>().OrderByDescending(o => o.Date).FirstOrDefault().Date,
                    StatusReport_Chto_sdelano_problemi_riski = p.GetChildren<Otchet_o_statuse_meropriyatiya_2bc942>().OrderByDescending(o => o.Date).FirstOrDefault().Chto_sdelano_problemi_riski_4a11b8,
                    StatusReport_Prichina_problemi = p.GetChildren<Otchet_o_statuse_meropriyatiya_2bc942>().OrderByDescending(o => o.Date).FirstOrDefault().Prichina_problemi_a3e564.Name,
                    StatusReport_StatusName = p.GetChildren<Otchet_o_statuse_meropriyatiya_2bc942>().OrderByDescending(o => o.Date).FirstOrDefault().Status_e05ba3.Name
      });
return projects;

Данный код запросов приведен в качестве примера. На вашей инсталяции необходимо будет указать наименования сущностей, объектов, справочников, реквизитов, соответствующих сформированному контексту LINQ-запросов.

2) Создать шаблоны таблиц данных в формате .xlsx

Данные шаблоны необходимы для формирования структуры хранения данных в AW в соответствии со структурой получаемых их ADVANTA данных.

Для создания шаблона необходимо выполнить созданный LINQ-запрос в ADVANTA, скопировать шапку полученной таблицы в Excel и сохранить файл в формате .xlsx.

Пример шаблона для источника данных по проектам

Пример шаблона для источника данных по контрольным точкам

Загрузите данные шаблоны в Analytic Workspace, в раздел «Источники данных» — здесь необходимо создать источник, выбрать формат «Файл» и загрузить сформированный шаблон.

3) Создать модель в Analytic Workspace и сформировать скрипт в ETL-редакторе

После создания источника необходимо в соответствующем разделе Analytic Workspace создать модель, которая и будет служить витриной данных для созданного источника. Необходимо создать столько же моделей, сколько предполагается использовать LINQ-запросов.

Сразу после создания необходимо перейти в режим редактирования модели и зайти в ETL-редактор.

В открывшемся редакторе необходимо ввести скрипт для обработки получаемых из ADVANTA данных. Скрипт написан на Python.

Пример скрипта для проектов

# -----------------------------------------------------------------------------------
# Cкрипт для обработки модели * * *
# -----------------------------------------------------------------------------------
 
import requests
import datetime
from pyspark.sql import Row
 
# python - m pip install requests, matplotlib, pandas
 
from pandas import json_normalize 
 
def after_all(df, spark, app, *args, **kwargs):
    print(df.schema)
 
    LOGIN = '* * *'
    PASSWORD = '* * *'
    DOMAIN = 'https://* * *.ru'
 
    AUTH = {
    'Login': LOGIN,
    'Password': PASSWORD,
    }
 
    session = requests.Session()
    # cookies = session.cookies.get_dict() # {}
 
    # авторизация
    response = session.post(url=DOMAIN+'/api/auth/login', json=AUTH, verify=False)
 
    cookies = session.cookies.get_dict()
 
    # print(cookies)
 
    # получение LINQ-запроса
    LINQ = {
        'DataSourceKey': 'BI_projects',
        # нужен другой запрос для перечня проектов в модель list1
        # 'DataSourceKey': 'BI_projects', 
        # и еще один для перечня КТ из этих проектов в модель list1_ywrq
        # 'DataSourceKey': 'BI_milestones', 
        'PageSize': 100,     
    }
 
    r = session.post(url=DOMAIN+'/api/queries/get', cookies=cookies, json=LINQ, verify=False)
 
    if not r.ok:
        raise Exception(f'Ошибка в {r.url}. HTTP {r.status_code}: {r.text}')
 
    data = r.json()
 
    #Создадим список, который послужит основной для создания DataFrame
    rows = []
    for line in data:
        rows.append(Row(
            id=line['Id'],
            name=line['Name'],
            parentname=line['ParentName'],
            lifecyclename=line['LifeCycleName'],
            # systemstartdate=str(datetime.datetime.fromisoformat(line['SystemStartDate']).replace(tzinfo=datetime.timezone.utc)),
            # systemenddate=str(datetime.datetime.fromisoformat(line['SystemEndDate']).replace(tzinfo=datetime.timezone.utc)),
            # actualstartdate=str(datetime.datetime.fromisoformat(line['ActualStartDate']).replace(tzinfo=datetime.timezone.utc)),
            # actualenddate=str(datetime.datetime.fromisoformat(line['ActualEndDate']).replace(tzinfo=datetime.timezone.utc)),
            # baselineplanstartdate=str(datetime.datetime.fromisoformat(line['BaselinePlanStartDate']).replace(tzinfo=datetime.timezone.utc)),
            # baselineplanenddate=str(datetime.datetime.fromisoformat(line['BaselinePlanEndDate']).replace(tzinfo=datetime.timezone.utc)),
 
            systemstartdate=line['SystemStartDate'],
            systemenddate=line['SystemEndDate'],
            actualstartdate=line['ActualStartDate'],
            actualenddate=line['ActualEndDate'],
            baselineplanstartdate=line['BaselinePlanStartDate'],
            baselineplanenddate=line['BaselinePlanEndDate'],
 
            bossfio=line['BossFIO'],
            rpfio=line['RPFIO'],
            description=line['Description'],
            projectscalename=line['ProjectScaleName'],
            projectgainname=line['ProjectGainName'],
 
            # statusreport_date=str(datetime.datetime.fromisoformat(line['StatusReport_Date']).replace(tzinfo=datetime.timezone.utc)),
            statusreport_date=line['StatusReport_Date'],
 
            statusreport_chto_sdelano_problemi_riski=line['StatusReport_Chto_sdelano_problemi_riski'],
            statusreport_prichina_problemi=line['StatusReport_Prichina_problemi'],
            statusreport_statusname=line['StatusReport_StatusName'],
            budjetsum=line['BudjetSum']
        ))
 
    return spark.createDataFrame(rows)

Пример скрипта для контрольных точек

# # -----------------------------------------------------------------------------------
# Cкрипт для обработки модели * * *
# -----------------------------------------------------------------------------------
 
import requests
import datetime
from pyspark.sql import Row
from pandas import json_normalize 
 
def after_all(df, spark, app, *args, **kwargs):
 
    LOGIN = '* * *'
    PASSWORD = '* * *'
    DOMAIN = 'https://* * *.ru'
 
    AUTH = {
    'Login': LOGIN,
    'Password': PASSWORD,
    }
 
    session = requests.Session()
    # cookies = session.cookies.get_dict() # {}
 
    # авторизация
    response = session.post(url=DOMAIN+'/api/auth/login', json=AUTH, verify=False)
 
    cookies = session.cookies.get_dict()
 
    # print(cookies)
 
    # получение LINQ-запроса
    LINQ = {
        'DataSourceKey': 'BI_milestones',
        'PageSize': 1000,     
    }
 
    r = session.post(url=DOMAIN+'/api/queries/get', cookies=cookies, json=LINQ, verify=False)
 
    if not r.ok:
        raise Exception(f'Ошибка в {r.url}. HTTP {r.status_code}: {r.text}')
 
    data = r.json()
 
    #Создадим список, который послужит основной для создания DataFrame
    rows = []
    for line in data:
        print(line)
        rows.append(Row(
            id=line['Id'],
            name=line['Name'],
            projectid=line['ProjectId'],
            systemstartdate=line['SystemStartDate'],
            systemenddate=line['SystemEndDate'],
            actualstartdate=line['ActualStartDate'],
            actualenddate=line['ActualEndDate'],
            baselineplanstartdate=line['BaselinePlanStartDate'],
            baselineplanenddate=line['BaselinePlanEndDate'],
            bossfio=line['BossFIO'],
            rpfio=line['RPFIO'],
            description=line['Description'],
            result=line['Result'],
            statusreport_date=line['StatusReport_Date'],
            statusreport_chto_sdelano_problemi_riski=line['StatusReport_Chto_sdelano_problemi_riski'],
            statusreport_prichina_problemi=line['StatusReport_Prichina_problemi'],
            statusreport_statusname=line['StatusReport_StatusName']
        ))
 
    return spark.createDataFrame(rows)

Символами * * * в примерах скриптов обозначены автоматически формируемые данные (например, номер модели) или данные, имеющие отношение к конкретной учетной записи в ADVANTA (например, логин, пароль и домен).

Затем необходимо опубликовать скрипт и обновить модель. После обновления данные из ADVANTA автоматически загрузятся в модель.

Пример модели

4) Создать виджеты для отображения данных и дашборды из виджетов

Для реализации этих шагов необходимо ознакомиться с возможностями системы Analytic Workspace. В этом вам помогут база знаний, обучающий курс и специалисты, контакты которых вы можете найти на сайте Analytic Workspace.

Пример дашборда «Здоровье портфеля» в Analytic Workspace на основе данных, полученных из ADVANTA

Оставить заявку на демонстрацию или внедрение ADVANTA

Узнать подробнее о системе Analytic Workspace

Интеграция ADVANTA с Blitz Identity Provider

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Nov 2025 09:14:16 +0000

Интеграция ADVANTA с Blitz Identity Provider

Сервер аутентификации Blitz Identity Provider - это российское ПО для управления входом пользователей в приложения, позволяющее оснастить веб-сайты и мобильные приложения компании функциями защиты учетных записей пользователей. Благодаря интеграции возможно осуществлять авторизацию в Систему ADVANTA через сервер аутентификации по протоколу OpenIdConnect.

Подключение Системы ADVANTA к Blitz IDP выполняется по протоколу OpenIdConnect и состоит из двух этапов:

Настройки на стороне Системы ADVANTA.
Настройки на стороне Blitz Identity Provider.

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

О Blitz IDP

Blitz Identity Provider - платформа создания единого сервиса доступа в организации. Единый сервис доступа обеспечивает идентификацию, аутентификацию и контроль доступа пользователей к приложениям организации.

Продукт развертывается на серверах организации и позволяет оснастить внутреннюю ИТ-инфраструктуру функциями защиты учетных записей пользователей. Blitz IDP поддерживает современные протоколы аутентификации, популярные отечественные операционные системы и СУБД.

Основные функции Blitz IDP:

обеспечение единого сквозного входа пользователя в приложения (Single Sign-On);
двухфакторная аутентификация;
конфигурируемый пользовательский интерфейс страниц входа, регистрации, восстановления доступа, управления учетной записью;
вход с использованием сторонних поставщиков идентификации: вход с помощью аккаунтов социальных сетей, банков, Единой системы идентификации и аутентификации (ЕСИА, Госуслуги), Mos ID (СУДИР), федеративный вход пользователей с использованием внешних поставщиков идентификации;
проверка прав доступа на вход пользователей в приложения;
проверка прав доступа пользователей и приложений при использовании REST-сервисов;
протоколирование событий доступа и действий с учетными записями.

Подробнее о сервере можно узнать из документации на сайте Blitz IDP или скачать PDF-файлы.

Blitz IDP зарегистрирован в Едином реестре российского ПО (№842) и сертифицирован ФСТЭК России (№4525 от 10.03.2022), что подтверждает соответствие требованиям информационной безопасности и допускает применение продукта в государственных информационных системах.

Настройки интеграции на стороне ADVANTA

Настройка авторизации через Open ID Connect производится Администратором системы.

В настройках конфигурационного файла системы client.config, начиная с версии системы 3.29, появился раздел, в котором в виде массива можно указать перечень внешних сервисов аутентификации по протоколу OpenIdConnect:

 /* Массив */
 
...
<openIdConnect>
  <providers>
    <add caption="Имя кнопки входа с названием провайдера" clientId="advanta"
    metadataURL="https://ssotest.yourcompany.ru/.well-known/openid-configuration"
    authenticationType="OIDC1" enabled="true" scope="openid profile"
    clientSecret="Секретный код провайдера" responseType="code" claimType="user_id" />
    <add ... /> /* Описание второго провайдера */
  <providers/>
</openIdConnect>
...

Параметр	Описание
caption	Обязательный параметр Название провайдера авторизации для отображения кнопки с этим именем
metadataURL	Обязательный параметр URL-адрес удаленного сервера с метаданными
authenticationType	Обязательный параметр Идентификатор провайдера авторизации, под этим именем данный провайдер OpenIdConnect будет отображаться в профиле пользователя, а также использоваться в API методах. Можно использовать любой удобный
clientId	Обязательный параметр Идентификатор клиента (приложения), выбирается согласно правилам именования сервисов для аутентификации в OpenIdConnect
enabled	Обязательный параметр Включение/отключение провайдера, возможные значения: true и false
scope	Указываются запрашиваемые скоупы. Если параметр не задан, то используется только скоуп `openid` Может быть несколько
clientSecret	Обязательный параметр Указывается секрет приложения
responseType	Необязательный параметр. Тип ответа, по умолчанию `id_token`. Возможные значения: `code`, `code id_token`, `code id_token token`, `code token`, `id_token`, `id_token token`, `token`
claimType	Тип утверждения, используемый для получения идентификатора пользователя на сервере авторизации. Будет использоваться для связки пользователя системы с пользователем OpenIdConnect
disableSignatureValidation	Необязательный параметр Отключает валидацию токена. Если параметр не задан, то значение false и валидация включена
jwksFilePath	Опциональный параметр Файл, который содержит ключи валидации в формате JSON. Формат аналогичен странице `jwks_uri`. Если параметр не задан, то ключи берутся только с адреса `jwks_uri` Можно использовать, если по какой-то причине провайдер OpenIdConnect не предоставляет ключи валидации Пример использования: `jwksFilePath` = ″C:\inetpub\wwwroot\a2key\jwksFile.txt″

В client.config также необходимо добавить индикацию, что необходимо использовать интеграцию с OpenIdConnect. Для этого опционально в разделе <configSections> предусмотреть размещение секции ″<section name= ″openIdConnect″ type=″Config.OpenIdConnectConfigurationSection,smcorelib″/>″. При отсутствии данной секции, использование OpenIdConnect невозможно.

Пример настройки конфигурационного файла системы client.config для авторизации через провайдера Blitz IDP:

...
<configSections>
    ...
    <section name="openIdConnect" type="Config.OpenIdConnectConfigurationSection, smcorelib"/>
</configSections>
 
...
 
<openIdConnect>
    <providers>
      <add caption="Blitz IDP" clientId="Advanta"
      metadataURL="https://blitz.domain.ru/blitz/oauth/.well-known/openid-configuration"
      authenticationType="blitz" enabled="true" scope="openid" clientSecret="00000000"
      responseType="code" claimType="user_id" />
 
      <add caption="SSO" clientId="a2nta"
      metadataURL="https://blitz.domain2.ru/blitz/oauth/.well-known/11"
      authenticationType="blitz2" enabled="true" scope="profile" clientSecret="11111111"
      responseType="code" claimType="user_id" />
...
    </providers>
</openIdConnect>
 
...

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

в портлете с сервисами авторизации в настройках пользователя удалить привязку к сервису;
использовать метод API DeleteLinksWithOpenIdConnect. Подробнее о методах API на странице Описание методов API.

Установка и настройка Blitz IDP

Общая инструкция по установке

Подробная информация об установке и настройке Blitz IDP в документации на сайте Blitz IDP на странице Общая инструкция по установке.

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

Также можно посмотреть демоверсию приложения.

Настройки интеграции на стороне Blitz IDP

Для настройки интеграции в консоли управления Blitz IDP перейдите в раздел «Приложения» и выполните действия:

1. Создайте новое приложение ADVANTA, задав его базовые настройки:

идентификатор (entityID или client_id): <client_id>;
название: <name>;
домен.

2. Нажмите «Сохранить».

3. Далее нажмите кнопку «Параметры» у приложения ADVANTA и отредактируйте параметры приложения:

протоколы: выберите OAuth 2.0 / OpenIdConnect и нажмите «Сконфигурировать»;
далее в параметрах укажите данные, как в конфигурационном файле client.config: секрет (client_secret), префиксы ссылок возврата, допустимые разрешения: profile.

4. Нажмите «Сохранить».

После прохождения всех шагов рекомендуем проверить корректность входа в ADVANTA.

Более подробную информацию о настройках интеграции можно найти в документации на сайте Blitz IDP в разделе Интеграция.

Результат интеграции

Вход в систему

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

Например, пользователь, нажимая на кнопку «Войти через SSO», перенаправляется на адрес провайдера авторизации Blitz IDP, указанный в настройках файла client.config. После успешного прохождения авторизации у провайдера OpenIdConnect, запрос будет перенаправлен обратно в систему ADVANTA. Система ADVANTA производит идентификацию пользователя и, в случае успешной идентификации, авторизует пользователя в системе.

Подробную информацию о входе в систему через провайдера аутентификации можно прочесть на странице Авторизация по протоколу Open ID Connect.

Портлет в настройках пользователя

После настройки интеграции с Blitz IDP в профиле пользователя также появится раздел для связывания учетной записи системы ADVANTA с учетной записью внешнего провайдера. Портлет находится в настройках пользователя, после портлета «Мои настройки».

В портлете указана информация:

название - название провайдера OpenIdConnect (соответствует authenticationType в конфигурационном файле);
заголовок - заголовок провайдера OpenIdConnect (соответствует caption в конфигурационном файле), название кнопки на странице входа;
учетная запись - учетная запись данного пользователя у провайдера OpenIdConnect;
столбец с кнопкой «Изменить» - нажимая на нее, открывается возможность редактирования соответствующей строки.

При нажатии кнопки «Изменить» в столбце «Учетная запись» появляется возможность ввести данные учетной записи данного пользователя у провайдера OpenIdConnect. Для сохранения данных необходимо нажать кнопку «Сохранить».

После того, как создана привязка и указана корректная информация учетной записи пользователя у провайдера OpenIdConnect, у пользователя появляется возможность входа в систему ADVANTA через Blitz IDP. Более подробную информацию можно прочесть на странице Настройка авторизации через Open ID Connect.

Экспорт данных из ADVANTA в Google-таблицы

anonymous@undisclosed.example.com (Anonymous) — Tue, 08 Apr 2025 10:27:03 +0000

Экспорт данных из ADVANTA в Google-таблицы

Google предоставляет множество сервисов для совместной работы с документами распространённых офисных форматов. В их числе - Google Sheets, облачный редактор электронных таблиц, аналогичный Excel.

Если требуется регулярно передавать данные о проектах в таблицы Google, можно автоматизировать этот процесс. Для этого надо написать приложение, которое будет получать данные из ADVANTA через ее API и записывать их в электронную таблицу через API системы Google Sheets.

Шаги, которые надо выполнить для автоматизации передачи информации из ADVANTA в таблицы Google Sheets:

Зарегистрировать «сервисный аккаунт» в системе «Google Cloud Console» для вызова API и получить «ключ доступа» к нему.
Настроить доступ к файлу электронной таблицы в Google Sheets для связанной с «сервисным аккаунтом» учётной записи.
Настроить в ADVANTA LINQ-запрос, который сформирует таблицу данных.
Написать приложение, которое выполнит LINQ-запрос и запишет полученные данные в Google Sheets.

Ниже рассмотрены примеры двух максимально простых приложений на C#, которые получают данные из ADVANTA и записывают их в таблицы Google. На основе этих примеров Вы можете создавать собственные приложения для решения задач по автоматизации передачи данных из ADVANTA в облачные сервисы Google.

Общие сведения об API сервисов Google

Доступ к API-функциям облачных сервисов Google настраивается в системе Google Cloud Console - это веб-сервис для разработчиков и системных администраторов организаций. Требуется создать в Google Cloud Console «проект» и подключить в него библиотеки API нужных сервисов Google.

При вызове API программа должна проходить авторизацию в «проекте». Есть несколько способов её организовать в зависимости от того, каким именно образом программа будет использоваться:

Если предполагается создание приложения с визуальным интерфейсом, в котором пользователи будут работать через персональные учётные записи Google, следует настроить доступ к «проекту» через протокол OAuth. При вызове API из такого приложения, будет открываться веб-страница авторизации Google, где пользователь должен ввести свои логин и пароль вручную.
Для приложений, работающих в автоматическом режиме, требуется создать специальную учётную запись Google – «сервисный аккаунт». Ключ доступа к такой учётной записи экспортируется в файл и включается в код программы.

Непосредственный вызов API Google может быть выполнен либо с помощью библиотек, либо напрямую, через REST API. В первом случае код намного проще, но библиотеки надо устанавливать в проект в среде разработки.

Получение доступа к API через Google Cloud Console

Для вызова API-функций Google-таблиц требуется выполнить шаги:

Создать в сервисе Google Cloud Console новый проект.
Подключить к этому проекту библиотеку API-функций «Google Sheets».
Создать сервисный аккаунт – специальную учётную запись, которую можно использовать лишь для идентификации приложений.
Создать ключ доступа к сервисному аккаунту - файл формата JSON, который содержит данные для автоматической авторизации приложения.

Создание «проекта» в Google Cloud Console

Перейти на сайт Google Cloud Console. При первом входе система автоматически создаст новый «проект» с названием «My First Project».

Подключение к «проекту» библиотеки API Google Sheets

Для подключения к созданному проекту библиотеки API-функций Google Sheets необходимо перейти в раздел «APIs & Services» по кнопке под названием проекта.

Затем необходимо открыть список библиотек кнопкой «Enable APIs and services».

В поле поиска ввести «Sheets», нажать Enter и выбрать найденную библиотеку «Google Sheets API». Включить библиотеку кнопкой Enable.

Библиотека появится в проекте, на странице «Enabled APIs & services».

Создание сервисного аккаунта Google для доступа к API «проекта»

Для создания сервисного аккаунта Google необходимо в разделе «Credentials» вызвать меню «Create credentials > Service account».

Далее на странице «Create service account» ввести название аккаунта в поле «Service account name» и описание в поле «Service account description». Система автоматически заполнит поле «Service account ID». Для продолжения настройки нажать «Create and continue».

На странице «Grant this service account access to project» в выпадающем списке «Role» выбрать роль «Basic / Editor».

Для перехода к следующему шагу нажать Continue.

В разделе «Grant users access to this service account» ничего вводить не нужно. Нажать Done, чтобы завершить создание сервисного аккаунта. Сервисный аккаунт будет создан и появится в поле «Service account». Адрес электронной почты этого сервисного аккаунта нужно будет указать далее при настройке доступа к Google-таблице.

Создание ключа доступа к сервисному аккаунту

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

Перейти по ссылке с именем аккаунта в разделе «Service Accounts»:

На странице настроек аккаунта нужно перейти на вкладку «Keys» и вызвать команду создания нового ключа через меню «Add key / Create new key».

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

Полученный файл нужно сохранить на диске и изменить его название на «service-account.json». Далее он потребуется при создании кода приложения. Пример структуры файла «service-account.json»:

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

Настройка доступа в Google-таблице

В Google-таблице, в которую приложение будет записывать данные, надо дать доступ на редактирование сервисной учётной записи. Диалог настройки вызывается кнопкой «Доступ» справа на панели инструментов.

В поле email-адреса необходимо ввести адрес почты сервисной учётной записи. Его можно найти в JSON-файле с данными авторизации, который был сохранен ранее. Он записан в элементе client_email.

Система предложит указать уровень доступа – нужно выбрать «Редактор». Опцию «Уведомить пользователей» можно отключить и нажать «Открыть доступ».

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

Примеры программного кода

Общие сведения о примерах

К инструкции прилагаются два примера кода, созданные в Visual Studio Code:

exporttogooglesheets1libs.zip - демонстрирует выгрузку данных из ADVANTA в Google-таблицу с помощью библиотек Google, которые загружены в проект через NuGet. Библиотеки удобно использовать, если есть полный доступ к среде разработки, как например, при создании самостоятельного веб-сервиса:
exporttogooglesheets2nolibs.zip - вариант экспорта данных без использования библиотек Google. Он значительно более сложный, но такой вариант можно использовать, например, в модуле триггеров, где нельзя подключить сторонние библиотеки.

Общий алгоритм работы примеров кода одинаков:

Проверяется доступ к Google-таблице, с помощью данных авторизации, настроенный в «Google Cloud Console» и сохранённых в файл.
Проводится авторизация в ADVANTA.
Выполняется запрос списка объектов с помощью заранее настроенного в ADVANTA LINQ-запроса.
Выполняется очистка Google-таблицы от всех данных.
Список объектов записывается в Google-таблицу.

Чтобы открыть и запустить эти примеры, на ПК должен быть установлен DotNet SDK 8 и сама среда разработки Visual Studio Code. Для работы с C# в Visual Studio Code надо добавить расширение «C# Dev Kit».

Подготовка LINQ-запроса в ADVANTA

Для выгрузки списка объектов воспользуемся LINQ-запросом «Все объекты» (ключ «GetAllObjects»).

var projects = dataContext.Projects
      .Where(p => p.Name != null)
      .OrderBy(p => p.CreationDate)
      .Select(p => new { 
        	p.Id, 
        	p.Name,
        	//p.Code,
        });
return projects;

Необходимо убедиться, что запрос работает. Для этого, заходим в раздел LINQ-запросов Системы и проверяем, что запрос существует.

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

Как запустить примеры кода

Подготовка каталога для примеров

С помощью Проводника Windows необходимо создать на диске каталог C:\Projects и скопировать в него каталоги проектов из прилагаемых архивов ExportToGoogleSheet1Libs.zip и ExportToGoogleSheet2NoLibs.zip. В итоге, в каталоге «Projects» должны располагаться подкаталоги с программными файлами.

Запуск примера «ExportToGoogleSheet1Libs» (с библиотеками Google)

Необходимо запустить Visual Studio Code и выполнить команду «File > Open Folder…». В окне «Open Folder» перейти в каталог C:\Projects\ExportToGoogleSheet1Libs и нажать «Выбор папки».

Содержащийся в каталоге код откроется в Visual Studio Code:

Прежде, чем запускать его на исполнение, необходимо проверить настройки параметров подключения к ADVANTA и к Google в коде:

1. Адрес сервера ADVANTA, логин и пароль пользователя, от имени которого будет выполняться LINQ-запрос:

2. Имя ключа LINQ-запроса и количество объектов, которые программа из него получит. Большое количество объектов может потребовать большого объёма оперативной памяти компьютера, на котором выполняется программа:

3. Далее нужно заменить в каталоге с кодом файл «service-account.json» на тот, который сгенерировали при настройке сервисного аккаунта в Google Cloud Console. При необходимости, можно разместить в каталоге с кодом несколько файлов авторизации и указать имя нужного в коде:

Также нужно зарегистрировать дополнительный JSON в файле проекта «ExportToGoogleSheets1Lib.csproj», добавив в него код с новым именем файла, аналогично существующему:

<ItemGroup>  
    <None Update="service-account.json">  
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>  
    </None>  
  </ItemGroup>

4. Далее указать идентификатор Google-таблицы, к которой дали доступ для сервисного аккаунта, а также имя листа в ней, на который требуется выгрузить данные:

Идентификатор - часть адреса страницы с таблицей, между /d/ и /edit, а имя листа – аналогично Excel:

Перед запуском примера необходимо обязательно сохранить изменения. После этого можно запускать решение. Для запуска служат команды справа на панели закладок Visual Studio Code.

Работа с примером exporttogooglesheets2nolibs.zip полностью аналогична. Доступ к ADVANTA и Google настраивается точно также.

Если потребуется проводить собственные эксперименты с примерами в Visual Studio Code, рекомендуется создать новый проект, скопировать в него код из примера и подключить библиотеки Google.

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

anonymous@undisclosed.example.com (Anonymous) — Fri, 11 Apr 2025 17:38:51 +0000

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

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

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

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

Способы выгрузки из ADVANTA данных для "Навигатор"

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

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

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

Выгрузка отчетов из ADVANTA в XLSX вручную

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

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

Автоматизация экспорта отчетов ADVANTA в XLSX

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

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

Автоматизация выгрузки данных об объектах в форматах XML или JSON

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

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

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

Пример создания дашборда в BI "Навигатор" по данным из ADVANTA

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

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

Создание отчета типа «Электронная таблица» в ADVANTA

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

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

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

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

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

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

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

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

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

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

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

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

Выгрузка отчета ADVANTA в файл формата XLSX

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

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

Создание источника данных в BI «Навигатор»

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

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

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

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

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

Поля отчета ADVANTA, на которые были наложены фильтры, загружаются с символом «*» в названии (в нашем случае, поле «Статус»). Чтобы в работе с таким полем далее не возникло проблем, Навигатор автоматически заменяет спецсимвол на знак подчёркивания.

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

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

Создание дашборда на основе источника данных из ADVANTA

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Интеграция ADVANTA с Power BI

anonymous@undisclosed.example.com (Anonymous) — Mon, 21 Jul 2025 10:12:44 +0000

Интеграция ADVANTA с Power BI

Power BI Desktop - это настольное приложение от Microsoft, предназначенное для создания интерактивных отчетов и визуализаций данных.

Подключение Power BI Desktop к Системе ADVANTA выполняется с помощью скрипта на языке Python. В качестве источника для получения данных используются LINQ-запросы, настроенные в ADVANTA.

Чтобы настроить в Power BI Desktop визуализацию по данным из Системы ADVANTA, требуется выполнить следующие шаги:

Настроить LINQ-запросы с необходимыми данными в разделе Администрирования ADVANTA.
Создать проект в PowerBI.
Добавить в PowerBI новый источник данных.
Добавить в источник данных обработчик для получения данных из API ADVANTA.
Сконструировать дашборд в PowerBI.

Ниже рассмотрен пример настройки дашборда в PowerBI на основе двух источников (LINQ-запросов) из Системы ADVANTA. На основе этого примера Вы можете создавать собственные источники в Системе для автоматического получения данных из ADVANTA в Power BI Desktop.

Настройка LINQ-запросов

Чтобы загрузить данные из ADVANTA в PowerBI, необходимо сначала создать в ADVANTA источники данных в виде LINQ-запросов (необходим хотя бы один запрос). LINQ-запросы станут источниками данных для соответствующих дашбордов в PowerBI.

Для этого перейти в Системе ADVANTA в раздел Администрирование → Дополнительные сервисы → Источники LINQ. На странице выбрать либо уже созданный источник, либо создать новый. В примере ниже выбрано два уже созданных источника для BI: «КТ» и «Проекты».

Нужно присвоить LINQ-запросам имена и ключи. Для удобства имена, ключи и id запросов необходимо скопировать и сохранить.

Настройка Python

Для того чтобы при импорте в PowerBI обращаться к API ADVANTA, надо использовать скрипт на Python. Для этого необходимо установить Python на ПК и проверить, что он работает.

В используемой инсталляции Python для работы скрипта нужно также установить менеджер пакетов - pip и выполнить команду для установки библиотек:

python -m pip install requests matplotlib pandas

requests - чтобы обращаться к API через HTTP-протокол;
matplotlib и pandas - библиотеки для работы с данными, которые использует PowerBI для конвертации полученных в формате JSON данных из Системы ADVANTA в свой внутренний формат таблиц.

Создание проекта в PowerBI

Заходим в Power BI Desktop и создаем/открываем отчет - в этом отчете будет настраиваться новый источник данных.

Добавление нового источника данных

В параметрах PowerBI необходимо проверить, что выбран правильный путь к установленному интерпретатору Python. Для этого:

Зайти во вкладку «Файл» → Параметры и настройки → Параметры.
В открывшемся окне зайти на вкладку «Создание скриптов Python» и выбрать либо домашний каталог Python, либо указать конкретный корневой каталог.

В отчете создаем новый источник данных: вкладка «Получить данные» → Другие → Скрипт Python → Подключить.

В поле «Сценарий» вставить код из примера:

# не забудьте установить требуемые библиотеки Python: 
# python -m pip install requests matplotlib pandas
 
import requests
from pandas import json_normalize 
 
# данные пользователя для подключения к инсталляции ADVANTA
# LOGIN = ''
# PASSWORD = ''
 
# лучше использовать токен - см. Вики 
# https://wiki.a2nta.ru/doku.php/product/auth/users/token_management
# https://wiki.a2nta.ru/doku.php/product/linq/new#webapi
 
TOKEN = 'enter_your_token_here'
 
# адрес сервера с системой ADVANTA (при необходимости можно указать справа от домена каталог установки, если система расположена не в корне домена)
DOMAIN = 'https://test.a2nta.ru'
 
# переменная для хранения параметров сессии
session = requests.Session()
 
# авторизация в ADVANTA
response = session.post(
    url=DOMAIN+'/api/auth/login', 
    ### если используем подключение с помощью логина и пароля 
    # json={
    #     'Login': LOGIN, 
    #     'Password': PASSWORD,
    #     },
 
    ### если подключаемся, используя токен
    json={
        'tokenValue': TOKEN,
        },
)
 
# сохранение полученных авторизационных cookies для дальнейшего использования
cookies = session.cookies.get_dict()
 
# получение данных из LINQ-запроса
response = session.post(
    url=DOMAIN+'/api/queries/get', 
    cookies=cookies, 
    json={
        # указать ваш код LINQ-запроса и его параметры
        'DataSourceKey': 'enter_your_linq_code_here',
        'PageSize': 100,
    },
)
 
# возвращаем данные в Power BI в нужном для дальнейшей обработки формате  
projects = json_normalize(response.json())

Заполнить данные для авторизации, указав свой логин и пароль для подключения к Системе ADVANTA (но лучше использовать токен).
В строке DOMAIN указать адрес сервера, на котором размещена Система ADVANTA, из которой нужно будет получать данные.
Подключить использование сессии - выбрав авторизацию в Системе ADVANTA через логин и пароль, или через токен.
Указать ключ LINQ-запроса из ADVANTA, который был сохранен ранее. Также можно ограничить количество данных, приходящих в запросе.

Подробнее о параметрах вызовов Web API ADVANTA для получения данных из LINQ-запросов можно прочитать на отдельной странице.

После заполнения всех параметров нажимаем «Ок» - начнется подключение к ADVANTA. Если скрипт успешно отработал, в PowerBI появятся импортированные данные. Надо выбрать источник слева и затем нажать «Загрузить» внизу окна. Далее полученные из ADVANTA данные можно обрабатывать и преобразовывать средствами PowerBI для большего удобства работы с ними в дашбордах.

Для формирования дашборда необходимо сделать столько источников в PowerBI, сколько их нужно импортировать из ADVANTA, т.е. один LINQ-источник = один источник данных в PowerBI. В последующем, при нажатии кнопки «Обновить данные» в отчете PowerBI, информация из Системы ADVANTA будет запрашиваться автоматически с использованием сохраненного в параметрах источника данных Python-скрипта.

Формирование дашборда в PowerBI

После добавления всех необходимых источников в модели данных PowerBI можно связать поля источников между собой для автоматической фильтрации данных в дашбордах. В примере свяжем ProjectId из таблицы «milestones» и Id из таблицы «projects».

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

Например, можно сделать панель в виде таблицы, которая будет содержать список проектов с их id и статусом.

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

Так как данные двух таблиц связаны, то при выборе «Проекта» в верхнем списке - перечень «Контрольных точек» в нижней части дашборда будет автоматически фильтроваться по id выбранного проекта за счет ранее установленной связи между таблицами.

После настроек визуализации готовый файл PowerBI необходимо сохранить. Дальнейшая настройка дашбордов в PowerBI осуществляется стандартными средствами данного приложения.