Connecting Extensions to Web Application

To connect extensions to Foresight Analytics Platform web application, the following installations and settings must be executed:

  1. Web application back end of Foresight Analytics Platform.

  2. Extensions of Foresight Analytics Platform.

  3. Designer of business applications back end.

How to connect extensions to Foresight Analytics Platform web application:

  1. Open the PP.xml file containing settings of Foresight Analytics Platform web application for edit.

  2. Create a new subsection with extension connection settings in the <Modules> section. The section name can be anything. The required attributes and subsections are given below.

  3. Save changes to PP.xml file.

  4. Restart BI server which is used by web application back end.

  5. Open web application of Foresight Analytics Platform.

As a result, the extension will be connected to the Foresight Analytics Platform web application and the welcome screen will display the button to work with extension.

The section about extension connection settings must contain the following attributes and subsections:

Attribute/section Description
name Name of extension which will be displayed in the web application welcome screen.
url Path to the extension in designer of business applications back end. It is specified in the format:

url="http://<server>/DBA_App_v9.2/#/<extension>"

The following can be set as extension:

  • agreement. Business process management.

  • dataentryform. Interactive data entry forms.

  • elt. Calculation Algorithms.

If web application and designer of business application back end are located at the same server, the path can be specified starting from the DBA_App_v9.2 virtual directory, for example:

url="/DBA_App_v9.2/#/dataentryform"
Visible The attribute that extension is displayed in the web application welcome screen. Available values:

  • 0. Extension is displayed.

  • 1. Extension is not displayed.
data Extension type. Available values:

  • 2168577. Business process management.

  • 2103041. Interactive data entry forms

  • 268033. Calculation Algorithms.
classId Identifier of extension object class. It is specified in the format:

classId="[&quot;<class>&quot;]"

To view class identifier:

  1. In the desktop application, in object navigator select the Service > Parameters item in the main menu.

  2. In the Parameters opened dialog box, go to theCustom Metadata section.

  3. Select the extension on theObject Classes tab.

  4. Click the Edit button.

In the displayed dialog box, on theDescription tab in the Identifier box, there will be an identifier of extension object class.

For example:

classId="[&quot;DATA_ENTRY_FORM_CLASS&quot;]"
actions Operations available for the extension in the web application welcome screen. Available operations:

  • 0. Open an object.

  • 1. Create a new object.

  • 2. Data import.

Operations are specified in squared brackets comma-separated. For example:

actions="[0, 1]"
<moduleUrlSettings> Determine a string:

<moduleUrlSettings sign="?"/>

Change character to specify parameters from # to ?.
This string is required in order that the Foresight Analytics Platform web application and designer of business applications web interface will be compatible.
<images>

The section with icon settings for extension. It contains the following subsections:

  • <WelcomeScreenIcon>. Icon settings in the welcome screen. The icon size is 32x32 pixels.

  • <AddressBarIcon>. Icon settings in address string. The icon size is 16x16 pixels.

  • <DocumentsIcon>. The icon settings for extension documents in the list of recent documents in the welcome screen. The icon size is 16x16 pixels.

Those sections contain the same set of attributes:

  • imageListId. Identifier of sprite with images.

  • rowIndex. Index of string in sprite containing an icon.

  • columnIndex. Index of column in sprite containing an icon.

Indexing of images in sprites contains from zero.

For icons of 32x32 pixels, the system sprite with the modules32 identifier is used. The sprite contains one string, determine the following columnIndex for extensions:

  • 8. Calculation algorithms.

  • 9. Business process management.

  • 10. Interactive Data Entry Forms.

For icons of 16x16 pixels, the system sprite with the modules16 identifier is used. The sprite contains one string, determine the following columnIndex for extensions:

  • 8. Calculation algorithms

  • 12. Business process management

  • 13. Interactive Data Entry Forms.

If you want to use your icons from your sprite, then after the <Modules> section create the <imageLists> section containing subsections with sprite settings.

Example

The example is given for the PP.xml file containing connection settings for Calculation Algorithms and Interactive Data Entry Forms extensions to the Foresight Analytics Platform web application:

<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="Calculation Algorithms"
            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="Data Entry Forms"
            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>

As a result, the web application welcome screen will contain buttons to work with extensions:

See also:

Basic Web Application Settings | Installing Foresight Analytics Platform Extensions