В этой статье:

Настройка списка репозиториев

Перед настройкой списка репозиториев ознакомьтесь с ограничениями при работе с BI-сервером на Linux.

Список репозиториев в реестре

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

[HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\Metabases] - настройки репозиториев для текущего пользователя, не зависимо от разрядности системы;
[HKEY_LOCAL_MACHINE\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\Metabases] - настройки репозиториев в случае, когда разрядность «Форсайт. Аналитическая платформа» совпадает с разрядностью операционной системы. Для всех пользователей.

Для настройки конкретного репозитория используйте раздел реестра:

[HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\Metabases\<идентификатор репозитория>] - настройки конкретного репозитория для текущего пользователя, не зависимо от разрядности системы;
[HKEY_LOCAL_MACHINE\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\Metabases\<идентификатор репозитория>] - настройки конкретного репозитория в случае, когда разрядность «Форсайт. Аналитическая платформа» совпадает с разрядностью операционной системы. Для всех пользователей.

Допустимые параметры данного раздела аналогичны атрибутам, допустимым для создания файла Metabases.xml.

Для получения подробной информации о формировании списка репозиториев в реестре ОС Linux обратитесь к разделу «Конфигурация и настройка».

Список репозиториев в Metabases.xml

Для настройки подключения к репозиториям в ОС Linux создайте файл Metabases.xml в папке /opt/foresight/fp10.x-biserver/etc.

В ОС Windows для настройки списка репозиториев на нескольких рабочих станциях можно создать файл Metabases.xml на сетевом или локальном ресурсе. Путь к файлу должен быть прописан в системном реестре рабочих станций. Для этого создайте строковый параметр Path со значением пути до папки, в которой содержится файл Metabases.xml, в разделе реестра [HKEY_LOCAL_MACHINE\Software\Foresight\Foresight Analytics Platform\10.0\Metabases]. Изменения настроек подключения к репозиториям в файле Metabases.xml автоматически применяются на рабочих станциях, которые настроены на этот файл.

Репозитории, заданные через файл Metabases.xml, недоступны для редактирования с помощью мастера настройки репозитория в веб-приложении или окна «Параметры» в настольном приложении.

Примечание. При совпадении наименований репозиториев, заданных в файле Metabases.xml и мастере настройки репозитория/окне «Параметры», в списке будут отображены оба репозитория.

Структура файла Metabases.xml

Файл Metabases.xml должен состоять из раздела <PP>, включающего в себя раздел <Metabases>. Раздел <Metabases> представляет собой список репозиториев. Настройки каждого репозитория задаются в разделе, название которого соответствует идентификатору репозитория. Для каждого репозитория создаются разделы <LogonData> и <Credentials>.

Пример файла Metabases.xml с настройками двух репозиториев - REPOSITORY_ID и WAREHOUSE:

Ниже приведен список доступных настроек репозитория:

Атрибуты	Описание
Name	Наименование репозитория.
Authentication	Тип аутентификации: 0. Любой принятый тип аутентификации; 1. Парольная. Аутентификация пользователя производится при указании имени пользователя и пароля в явном виде; 2. Интегрированная доменная. Аутентификация пользователя производится с использованием доменного имени пользователя и пароля (текущей учётной записи ОС). Если тип аутентификации выбран для Oracle, то выполните дополнительные настройки сервера; 3. Ролевая. При данном типе аутентификации каждый пользователь ассоциируется с определенной ролью. Примечание. Ролевой тип аутентификации является устаревшим. Оставлен для совместимости с предыдущими версиями. 4. Доменная. Аутентификация пользователя производится при указании домена, имени пользователя и пароля в явном виде. Тип аутентификации доступен, если выбран тип драйвера: Oracle, Microsoft SQL Server 2008, 2012\2014\2016, ODBC, PostgreSQL; 7. OAuth. Аутентификация пользователя производится под учётной записью сервисов, поддерживающих протокол OAuth 2.0 или OpenID Connect. Для использования данного типа аутентификации обратитесь к разделу «Настройка входа через внешние сервисы». Если используется данный тип аутентификации, то дополнительно задайте атрибут OAuthService. Примечание. При авторизации в веб-приложении тип аутентификации определяется настройками BI-сервера. Если в файле PP.xml в разделе <metabase> заданы репозиторий по умолчанию с помощью атрибута id и тип аутентификации с помощью атрибута authentication, то для данного репозитория будет применяться заданный тип аутентификации независимо от настроек BI-сервера. Для получения подробной информации о настройках BI-сервера в ОС Linux обратитесь к разделу «Конфигурация и настройка».
OAuthService	Параметры авторизации через протокол OAuth/OpenID Connect, если атрибут Authentication принимает значение «7»: Providers. Массив наименований сервисов авторизации, учётные записи которых можно использовать для входа в веб-приложение. Допустимые значения определяются тем, какие сервисы заданы при настройке параметров для протокола OAuth/OpenID Connect, и указываются через точку с запятой. Обязательный параметр; AutoStartProvider. Порядковый номер сервиса авторизации, указанного в массиве параметра Providers. На выбранный сервис будет выполняться автоматическая переадресация при попытке входа в веб-приложение с использованием протокола OAuth/OpenID Connect. Необязательный параметр. Если в качестве значения параметра используется сервис, который не содержится в параметре Providers, то автоматическая переадресация выполняться не будет; UseDefaultUser. Признак, который определяет, под какими учётными данными выполняется подключение к СУБД при авторизации через протокол OAuth/OpenID Connect: 1. По умолчанию. Подключение к СУБД выполняется под одной технологической учётной записью для всех пользователей внешнего сервера. Учётные данные должны быть сохранены с помощью утилиты PP.Util с параметром /DC; Примечание. При входе в систему выполняется проверка имени пользователя, полученного от внешнего сервиса с учётом формата, заданного в параметре PPUserNameFormat. Если пользователь с указанным именем не найден в менеджере безопасности, то создаётся временный пользователь в группе «Пользователи». Временный пользователь обладает привилегиями группы «Пользователи» и удаляется по истечении времени жизни текущей сессии. При этом подключение к базе данных СУБД выполняется под одной технологической учётной записью. 0. Подключение к СУБД выполняется под технологической учётной записью, соответствующей пользователю, который проходил авторизацию на внешнем сервере. Учётные данные каждого пользователя должны быть сохранены с помощью утилиты PP.Util без параметра /DC. Необязательный параметр.
Driver	Идентификатор СУБД.
Package	Тип пакета безопасности: STANDARDSECURITYPACKAGE. Стандартный пакет безопасности.
DebugMode	Тип кэширования сборок: 0. Кэширование сборок осуществляется на сервере БД и на локальном диске. При запуске/компиляции модуля/формы/сборки будет осуществляться проверка скомпилированной версии сборки. Если версии одинаковые, то работа продолжается со сборкой на локальном диске. Если версии разные или сборка на локальном диске отсутствует, то на сервере БД будет скомпилирована и скопирована новая версия сборки на локальный диск. После чего работа со сборкой будет продолжаться на локальном диске; 1. Кэширование сборок осуществляется только на локальном диске. Сборки, образующиеся при компиляции модулей/форм/сборок, будут кэшироваться на локальном диске.
DL	Признак отложенной загрузки дескрипторов: true. При подключении к репозиторию выполняется отложенная загрузка дескрипторов объектов репозитория; false. По умолчанию. При подключении к репозиторию не выполняется отложенная загрузка дескрипторов объектов репозитория. Для получения подробной информации об особенностях использования отложенной загрузки дескрипторов обратитесь к разделу «Настройка подключения к репозиторию».
CompileAssemblyOnly	Признак возможности компиляции форм/модулей вне сборок: true. Компиляции форм/модулей вне сборок недоступна; false. По умолчанию. Компиляции форм/модулей вне сборок доступна.
VcsLocalPath и VcsStoredPath	Путь до папки на диске, в которой хранятся локальные файлы объектов, если репозиторий добавлен в систему управления Git. Для атрибутов указывается одинаковое значение.
VcsName	Тип системы управления версиями. Актуально, если репозиторий добавлен в систему управления Git. В качестве значения атрибута указывается - «Git».

Раздел <LogonData>

Раздел содержит параметры подключения к репозиторию:

Атрибуты	Описание
DATABASE и DATABASE_ONLY	Идентификатор базы данных, к которой будет осуществляться подключение по умолчанию. Идентификатор базы данных должен совпадать с идентификатором репозитория.
SCHEMA_ONLY	Идентификатор используемой схемы по умолчанию. По умолчанию для Microsoft SQL Server используется схема «dbo», а для PostgreSQL - «public». Если при подготовке серверной части СУБД была создана пользовательская схема, которая используется в качестве схемы по умолчанию, то укажите её. Также идентификатор пользовательской схемы можно указать через точку после идентификатора базы данных в атрибуте DATABASE и DATABASE_ONLY, например: REPOSITORY_ID.myschema.
SERVER	IP-адрес или DNS-имя, под которым зарегистрирован сервер с подключаемой базой данных (репозиторий). Параметр доступен, если выбран тип драйвера: Oracle, Microsoft SQL Server 2008, 2012\2014\2016, ODBC, Teradata, PostgreSQL.
CASESENSITIVE	Признак учёта регистра при работе с СУБД: true. Регистр учитывается; false. По умолчанию. Регистр не учитывается. Параметр доступен, если выбран тип драйвера: Microsoft SQL Server 2008, 2012\2014\2016, ODBC, PostgreSQL. Примечание. При подготовке серверной части СУБД PostgreSQL параметры задаются в верхнем регистре. Для корректного подключения к СУБД используйте параметр со значением true.
PQGSSAPI	Признак использования аутентификации к серверу СУБД PostgreSQL по механизму GSS API: true. GSS API используется; false. По умолчанию. GSS API не используется. Вместе с GSS API используется сервис Kerberos, указанный в атрибуте PQKRBSRVNAME. GSS API позволяет использовать разные реализации Kerberos без изменения кода приложения.
PQKRBSRVNAME	Наименование сервера Kerberos, которое задано в настройках сервера СУБД PostgreSQL. Для использования сервиса Kerberos атрибут PQGSSAPI должен принимать значение true.
SUPPORTBINARYPROTOCOL	Признак использования запросов для работы с сервером СУБД PostgreSQL в бинарном виде: true. Для работы с сервером используются запросы, приведённые к бинарному виду. Использование бинарных запросов позволяет сократить объем трафика, который требуется для отправки запросов и получения данных с сервера; false. По умолчанию. Для работы с сервером используются текстовые запросы.
USEUPN	Признак учёта домена при подключении доменного пользователя: true. Полное имя пользователя с доменом; false. По умолчанию. Короткое имя пользователя без учёта домена. Параметр доступен, если выбран тип драйвера PostgreSQL.

Раздел <Credentials>

Раздел содержит параметры сохранения учётных данных пользователя, используемых при подключении к базе данных:

Атрибуты	Описание
Authentication	Тип аутентификации, заданный в атрибуте Authentication для репозитория.

Сводный список идентификаторов

Ниже приведен список идентификаторов драйверов, которые могут использоваться для настройки различных объектов репозитория. Идентификаторы используются различными свойствами при настройке объектов с помощью макросов на Fore, а также при создании списка репозиториев в файле Metabases.xml:

Идентификатор	Драйвер СУБД
ORCL8	Oracle
MSSQL2008	Microsoft SQL Server 2008
MSSQL2012	Microsoft SQL Server 2012\2014\2016\2017
MSSQL2012ODBC	Microsoft SQL Server (ODBC)
OLEDB(ODBC HIVE)	OLE DB (ODBC HIVE)
OLEDB(DB2)	OLE DB (DB2)
OLEDB(ODBC)	OLE DB (ODBC)
OLEDB(VISTADB)	OLE DB (VISTADB)
OLEDB	OLE DB провайдер
DB2	Реляционная базы данных DB2
TRDT	Teradata
POSTGRES	PostgreSQL/Postgres Pro
POSTGRES(NO_LO)	Greenplum/Pivotal HD Hawq
VERTICA	HP Vertica
ODBC	Generic ODBC
ODBC(CLICKHOUSE)	ClickHouse (ODBC)

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