Setting Up Repositories, Autoupdate, Contact Information, and so on from File

An XML file is used to specify the settings, which are determined in the product update process:

Additional settings are specified in the update process after executing the actions.

In the <XML file> substitution specify the file with the *.xml extension containing information about additional settings, for example, tuner.xml.

Additional settings are specified in the update process after executing the actions.

XML File Structure

Repository parameters.

The <Metabases> section can contain one or several <Metabase> subsections to set up parameters of certain repositories.

The <Metabase> subsection can contain the following attributes and subsections:

Attributes/subsection	Description
Driver	Driver identifier. List of DBMS and corresponding identifiers is presented in the Supported DBMS section.
Package	Standard security package of Foresight Analytics Platform: STANDARDSECURITYPACKAGE.
Authentication	Authentication type: 1. Default value. Password. 2. Integrated domain. 3. Role. NOTE. The role authentication type is outdated and is kept for compatibility with previous versions. 4. Domain.
DebugMode	Assembly caching type: 0. No caching. 1. Build caching.
Name	Repository name.
Ident	Repository identifier.
Scope	Registry key where repository connection settings are added: LM. The HKEY_LOCAL_MACHINE registry key, the repository is set for all users. CU. Default value. The HKEY_CURRENT_USER registry key, the repository is set for the current user. Optional attribute.
<LogonData>	The subsection determines the DBMS settings and contains the following attributes: Server. Server name. The attribute is relevant for the following DBMS: Oracle, Microsoft SQL Server, MSSQL2012, MSSQL2012ODBC, PostgreSQL, Teradata. FileName. Database file name. The attribute is relevant for SQLite DBMS. Scheme. Repository schema name. The attribute is relevant for Oracle DBMS. Database. Repository schema name. The attribute is relevant for the following DBMS: Microsoft SQL Server, MSSQL2012, MSSQL2012ODBC, PostgreSQL, Teradata. Metabase. Repository schema identifier. The attribute is relevant for WSF DBMS. EndPoint. BI server URL. The attribute is relevant for WSF DBMS. The list of relevant DBMS based on which the repository can be created is presented in the Supported DBMS section.

Autoupdate parameters.

The section can contain the following attributes:

Attributes	Description
Profile	Profile name where autoupdate settings are written. Profile path in the registry: 32-bit Windows OS: HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Foresight\Foresight Analytics Platform\10.0\AutoUpdate\Profiles\<profile name>. 64-bit Windows OS: HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\AutoUpdate\Profiles\<profile name>. By default, profile name matches with the version number - 10.5.
SourceType	Update source: Path. Disk folder. Db. Database server.
Update	Autoupdate: Ask. Request for permission before starting the update. ""(empty). Do not update. Always. Update automatically (no request).
Db	Database server parameters with the update: DB:LABEL;SERVER@, Where: Db. DBMS type: ORACLE or MSSQL. LABEL. Update label. SERVER. Database server. NOTE. The attribute is only relevant when using update files located on the database server.
Source	Path to update source. NOTE. The attribute is only relevant when using update files located in the disk folder.

It determines system environment variables.

The <Environments> section can contain one or several <Environment> subsections to determine certain system environment variables.

The <Environment> subsection can contain the following attributes and subsections:

Attributes	Description
Name	Variable name.
Args	Variable value.

It displays image in the login dialog box.

The section can contain the following attribute:

Attribute	Description
Visible	It indicates whether an image is displayed in the login dialog box: 0. Do not display image in the login dialog box. 1. Display image in the login dialog box.

For details about disabling image in the login dialog box using registry settings see the Disabling Image in Login Dialog Box section.

For details about changing icon and image in the login dialog box see the Changing Icon and Image in Login Dialog Box section.

It displays the Setting button in the login dialog box.

The section can contain the following attribute:

Attribute	Description
VisibleAdvanced	It indicates whether a button is displayed in the login dialog box: 0. Do not display the Settings button. 1. Display the Settings button.

For details about hiding the Settings button using registry settings see the Hiding the Settings Button in Login Dialog Box section.

It determines contact information in the About dialog box.

The section contains the following subsections:

Subsection	Description
<App>	Information about the program. The subsection can contain the following attributes: Name. Program name. Version. Program version.
<Info>	Technical support information. The subsection can contain the following attributes: Address. Address. Phone. Phone. Fax. Fax. Email. Email. Website. Website address. Title. Column header containing information about technical support.
<Copyright>	Additional information. The subsection can contain the following attributes: Value. Copyright.

NOTE. The license number cannot be changed or hidden.

To cancel configured settings and show standard information in the About window delete the About section in the registry:

32-bit Windows OS: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Foresight\Foresight Analytics Platform\10.0\About.
64-bit Windows OS: HKEY_LOCAL_MACHINE\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\About.

It determines email address for sending the Foresight Analytics Platform using the main menu command Help > Error Message in the object navigator.

The section can contain the following attribute:

Attribute	Description
EMail	Email address which is substituted in the recipient field when sending a platform error message.

Examples

<?xml version="1.0" encoding="utf-8"?>
<Configuration>
    <Metabases>
        <Metabase Driver="MSSQL2012" Package="STANDARDSECURITYPACKAGE" DebugMode="1" Name="MSSQL Repository" Ident="MSSQLRepository">
            <LogonData Server="MSSQLSERVER" Database="MSSQLDB" />
        </Metabase>
    </Metabases>
</Configuration>

<?xml version="1.0" encoding="utf-8"?>
<Configuration>
    <Metabases>
        <Metabase Driver="ORCL8" Package="STANDARDSECURITYPACKAGE" DebugMode="1" Name="Oracle Repository" Ident="OracleRepository">
            <LogonData Server="OracleServer" Scheme="OracleScheme" />
        </Metabase>
    </Metabases>
</Configuration>

<?xml version="1.0" encoding="utf-8"?>
<Configuration>
    <Metabases>
        <Metabase Driver="POSTGRES" Package="STANDARDSECURITYPACKAGE" DebugMode="1" Name="POSTGRES Repository" Ident="POSTGRESRepository">
            <LogonData Server="POSTGRES" Database="POSTGRES" />
        </Metabase>
    </Metabases>
</Configuration>

<?xml version="1.0" encoding="utf-8"?>
<Configuration>
    <Metabases>
        <Metabase Driver="SQLITE" Package="STANDARDSECURITYPACKAGE" DebugMode="1" Name="SQLITE Repository" Ident="SQLITERepository">
            <LogonData FileName="C:\Work\sqlite_repo" />
        </Metabase>
        <Metabase Driver="MSSQL2008" Package="STANDARDSECURITYPACKAGE" Authentication="1" DebugMode="1" Name="MSSQL Repository" Ident="MSSQLRepository" Scope="LM">
            <LogonData Server="MSSQLServer" Database="Warehouse" />
        </Metabase>
    </Metabases>
    <AutoUpdate Profile="9.2" Source="Z:\WebBuild\LastKnowGood\Win" SourceType="Path" Update="Ask" Db="ORACLE:LABEL;SERVER@" />
    <Splash Visible="1"/>
    <Login VisibleAdvanced = "1" />
    <Environments>
        <Environment Name="TEST_PER1" Args="ARGS_VALUE1"/>
        <Environment Name="TEST_PER2" Args="ARGS_VALUE2"/>
        <Environment Name="TEST_PER3" Args="ARGS_VALUE3"/>
    </Environments>
    <AboutWindow>
        <App Name="Prognoz" Version="Custom-built 2018"/>
        <Info Title="Technical support" Email="support@organizationname.com" Website="www.organizationname.com"/>
        <Copyright Value="Organization name"/>
    </AboutWindow>
    <Exception EMail = "support@mail.com" />
</Configuration>

Section	Brief description
<Metabases>	Repository parameters.
<AutoUpdate>	Autoupdate parameters.
<Environments>	It determines system environment variables.
<Splash>	It displays image in the login dialog box.
<Login>	It displays the Settings button in the login dialog box.
<AboutWindow>	It determines contact information in the About dialog box.
<Exception>	It determines email address for sending the Foresight Analytics Platform error message using the main menu item Help > Error Message in the object navigator.