Oracle® Business Intelligence Disconnected Analytics Administration and Configuration Guide > Preparing Applications for Oracle BI Disconnected Analytics > Example of an Application Configuration File >

Descriptions of Elements and Attributes in the Retail.xml Configuration File


Table 3 contains an explanation of each element and attribute in the retail.xml file. The elements and attributes are listed in the order in which they appear in the example file. All elements and attributes must be in lowercase. For a more complete list of XML elements that you might want to use in your configuration file, see Configuration File Reference.

Table 3. Description of Elements and Attributes in the Retail.xml Configuration File
<Element> or Attribute
Description

<remotecfg>

This element brackets the entire file and identifies it as a disconnected application configuration file.

<application>

This element identifies the disconnected application. The <application> element can have child elements such as <repository> and <webcatalog>. Additionally, the <application> element can have multiple <displayname> child elements. For more information, see the description of the <displayname> child element in this table. For more information, see Disconnected Application Metadata Directory.

name

This attribute for the <application> element identifies the application's internal name. This internal name is the same name as the disconnected application directory (Retail in this example). The disconnected application configuration file (Retail.xml in this example) resides in this directory.

displayname

This attribute for the <application> element identifies the application's default descriptive name that appears in the Oracle BI Disconnected Analytics Application Manager and on the Disconnected page of Oracle Business Intelligence.

dir

This attribute for the <application> element identifies the disconnected application metadata directory.

<repository> (child of <application element>)

A child element of the <application> element. This child element identifies the disconnected application repository that is downloaded to the disconnected machine during synchronization.

<webcatalog> (child of <application element>)

A child element of the <application> element. This child element identifies the local Oracle BI Presentation Catalog that is downloaded to the disconnected machine during synchronization.

<displayname> (child of <application element>)

The <application> element can also have multiple <displayname> child elements, each of which identifies the application's descriptive name in a specified language. The descriptive name appears in the Oracle BI Disconnected Analytics Application Manager and on the Disconnected page of Oracle Business Intelligence.

lang

(and)

value

For the <displayname> child element, the lang attribute identifies the language, and the value attribute identifies the descriptive name. When users log in to Oracle Business Intelligence, they specify their choice of language.

For example, in the retail application, a user that chooses English sees a display name of Retail Database Application. A user that chooses Spanish sees La Aplicación de la Base de datos al Por Menor. A user that chooses any other language would see the default display name specified by the displayname attribute for the <application> element.

<data>

This element identifies all data downloaded to the disconnected machine as part of synchronization. For more information, see Disconnected Application Data Directory.

dir

This attribute for the <data> element identifies the disconnected application data directory.

catalogfolder

This attribute for the <data> element identifies the full path of the folder in the full Oracle BI Presentation Catalog that contains the sourcing queries for the application. In this example, all sourcing queries for the retail application reside in the following web catalog folder:

/shared/Disconnected/Retail.

<dataset>

This element identifies a unit of synchronization. All tables specified in a data set are sent to the disconnected machine as an inseparable package during synchronization.

name

This attribute for the <dataset> element identifies the internal name of the data set.

incremental

This attribute for the <dataset> element specifies whether this data set uses incremental synchronization.

syncmode

This attribute for the <dataset> element identifies whether synchronization happens with preprocessed scripts or online.

subjectarea

This attribute for the <dataset> element identifies the name of the subject area in the repository of the Oracle BI Server that is associated with the disconnected application. Oracle Business Intelligence uses this name when storing filters for the application in the full Oracle BI Presentation Catalog.

<displayname> (child of <dataset element>)

This child element identifies the descriptive name of the data set in a specified language. The <dataset> element can have multiple <displayname> child elements, each identifying the descriptive name of the data set in a different language. This descriptive name appears in the advanced area of the Oracle BI Disconnected Analytics Application Manager and on the Disconnected Filter page of Oracle Business Intelligence on the Oracle BI Server. Users that choose a language not specified in one of the <displayname> elements will see the data set internal name (Retail in this example).

<table>

This element identifies a SQL table created on the disconnected machine as part of a data set. In the retail application example, two dimension tables and a fact table were created. Each table has a separate <table> element, and each <table> element can have several child elements, including <sourcingreport>, <tablesql>, and <indexsql>.

NOTE:  In the <table> element for the Product table, there is a sourcing query (report) also called Product. The output from that query goes to a file called Product.csv. During synchronization, the Oracle BI Disconnected Analytics Application Manager creates the Product table on the disconnected machine using the script file Product.sql, and creates any associated indexes using the script file ProductIdx.sql. After creating the table and its indexes, the Oracle BI Disconnected Analytics Application Manager populates the table from the Product.csv file.

<sourcingreport> (child of <table> element)

This child element identifies the sourcing query (report) used to generate the table's data.

<tablesql> (child of <table> element)

This child element identifies the script file used to create the SQL table on the disconnected machine.

<indexsql> (child of <table> element)

This child element identifies the script file used to create one or more indexes for the table.

Oracle® Business Intelligence Disconnected Analytics Administration and Configuration Guide Copyright © 2007, Oracle. All rights reserved.