Подключение расширений в веб-приложение

Для подключения расширений в веб-приложение продукта «Форсайт. Аналитическая платформа» понадобятся установленные и настроенные:

  1. Серверная часть веб-приложения продукта «Форсайт. Аналитическая платформа».

  2. Расширения продукта «Форсайт. Аналитическая платформа».

  3. Серверная часть конструктора бизнес-приложений.

Порядок подключения расширения в веб-приложение продукта «Форсайт. Аналитическая платформа»:

  1. Откройте на редактирование файл PP.xml, содержащий настройки веб-приложения продукта «Форсайт. Аналитическая платформа».

  2. Создайте в разделе <Modules> новый подраздел с настройками подключения расширения. Название раздела может быть любым. Требуемые атрибуты и подразделы приведены ниже.

  3. Сохраните изменения в файле PP.xml.

  4. Перезапустите BI-сервер, который используется серверной частью веб-приложения.

  5. Откройте веб-приложение продукта «Форсайт. Аналитическая платформа».

В результате расширение будет подключено в веб-приложение продукта «Форсайт. Аналитическая платформа» и в окне приветствия будет отображаться кнопка для работы с расширением.

Раздел с настройками подключения расширений должен содержать следующие атрибуты и подразделы:

Атрибут/раздел Описание
name Название расширения, которое будет отображаться в окне приветствия в веб-приложении.
url Путь к расширению в серверной части конструктора бизнес-приложений. Указывается в формате:

url="http://<сервер>/DBA_App_v9.2/#/<расширение>"

В качестве расширения можно указать:

  • agreement. Управление бизнес-процессами;

  • dataentryform. Интерактивные формы ввода данных;

  • elt. Алгоритмы расчёта.

Если веб-приложение и серверная часть конструктора бизнес-приложений находятся на одном сервере, то путь можно указать начиная с виртуального каталога DBA_App_v9.2, например:

url="/DBA_App_v9.2/#/dataentryform"
Visible Признак того, что расширение отображается в окне приветствия в веб-приложении. Возможные значения:

  • 0. Расширение отображается;

  • 1. Расширение не отображается.
data Тип расширения. Возможные значения:

  • 2168577. Управление бизнес-процессами;

  • 2103041. Интерактивные формы ввода данных;

  • 268033. Алгоритмы расчёта.
classId Идентификатор класса объектов расширения. Указывается в формате:

classId="[&quot;<класс>&quot;]"

Для просмотра идентификатора класса:

  1. В настольном приложении в навигаторе объектов выполните команду «Сервис > Параметры» в главном меню.

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

  3. На вкладе «Классы объектов» выберите расширение.

  4. Нажмите кнопку «Редактировать».

В отобразившемся диалоге на вкладке «Описание» в поле «Идентификатор» будет указан идентификатор класса объектов расширения.

Например:

classId="[&quot;DATA_ENTRY_FORM_CLASS&quot;]"
actions Действия, доступные для расширения в окне приветствия в веб-приложении. Доступные действия:

  • 0. Открытие объекта;

  • 1. Создание нового объекта;

Примечание. Параметр недоступен для использования. Зарезервированно на будущее.

  • 2. Импорт данных.

Действия указываются в квадратных скобках через запятую. Например:

actions="[0, 1]"
<moduleUrlSettings> Укажите строку:

<moduleUrlSettings sign="?"/>

Смена символа для обозначения параметров с «#» на «?».
Данная строка необходима для совместимости веб-приложения продукта «Форсайт. Аналитическая платформа» и веб-интерфейса конструктора бизнес-приложений.
<images>

Раздел с настройками пиктограмм для расширения. Содержит следующие подразделы:

  • <WelcomeScreenIcon>. Настройки пиктограммы в окне приветствия. Размер пиктограммы 32x32 пикселя;

  • <AddressBarIcon>. Настройки пиктограммы в адресной строке. Размер пиктограммы 16x16 пикселей;

  • <DocumentsIcon>. Настройки пиктограмм для документов расширения в списке недавних документов в окне приветствия. Размер пиктограммы 16x16 пикселей.

Данные разделы содержат одинаковый набор атрибутов:

  • imageListId. Идентификатор спрайта с изображениями;

  • rowIndex. Индекс строки в спрайте, содержащей пиктограмму;

  • columnIndex. Индекс столбца в спрайте, содержащего пиктограмму.

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

Для пиктограмм 32x32 пикселя используются системный спрайт с идентификатором modules32. Спрайт содержит одну строку и для расширений укажите следующий columnIndex:

  • 8. Алгоритмы расчёта;

  • 9. Управление бизнес-процессами;

  • 10. Интерактивные формы ввода данных.

Для пиктограмм 16x16 пикселей используются системный спрайт с идентификатором modules16. Спрайт содержит одну строку и для расширений укажите следующий columnIndex:

  • 8. Алгоритмы расчёта;

  • 12. Управление бизнес-процессами;

  • 13. Интерактивные формы ввода данных.

Если вы хотите использовать собственные пиктограммы из собственного спрайта, то после раздела <Modules> создайте раздел <imageLists>, содержащий подразделы с настройками спрайтов.

Пример

Приведён пример файла PP.xml, содержащего настройки подключения расширений «Алгоритмы расчёта» и «Интерактивные формы ввода данных» к веб-приложению «Форсайт. Аналитическая платформа»:

<pp>
    <service url="http://localhost/FPBI_App_v9.2x64/axis2/services/PP.SOM.Som" />

    <metabase id="REPOSITORY" recentObjects="true" />
    <cultures>
        <culture cultureName="ru" />
        <culture cultureName="en" />
    </cultures>
    <Modules>
        <algorithm name="Алгоритмы расчёта"
            url="/DBA_App_v9.2/#/elt" 

            Visible="1" 
            data="268033"
            classId="[&quot;P10002_CALC_ALG&quot;]" 
            actions="[0]"> 
            <moduleUrlSettings sign="?"/>
            <images> 
                <WelcomeScreenIcon imageListId="modules32" rowIndex="0" columnIndex="8"/> 
                <AddressBarIcon imageListId="modules16" rowIndex="0" columnIndex="8" /> 
                <DocumentsIcon imageListId="modules16" rowIndex="0" columnIndex="8" /> 
            </images>
        </algorithm>
        <entryform name="Формы ввода"
            url="/DBA_App_v9.2/#/dataentryform" 

            Visible="1" 
            data="2103041"
            classId="[&quot;DATA_ENTRY_FORM_CLASS&quot;]" 
            actions="[0]"> 
            <moduleUrlSettings sign="?"/>
            <images> 
                <WelcomeScreenIcon imageListId="modules32" rowIndex="0" columnIndex="10"/> 
                <AddressBarIcon imageListId="modules16" rowIndex="0" columnIndex="13" /> 
                <DocumentsIcon imageListId="modules16" rowIndex="0" columnIndex="13" /> 
            </images>
        </entryform>
    </Modules>
</pp>

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

См. также:

Базовые настройки веб-приложения | Установка расширений продукта