Page History

Sv translation

language	en

Section

Column

width	50%

You can define the data model either via GUI during the import or in more advanced way using the XML file. The XML definition is submitted to BellaDati's REST API or uploaded via GUI.

Basic concept

XML definition can be applied to objects, the data model consists of:

dataset - dataset is a virtual cube consisting of attributes and indicators
attributes - attribute is descriptor of indicator typically strings like ID, name, city etc.
attribute members - represents the single value of the attribute - e.g. New York, London, Berlin for attribute City.
indicators - is a data column containing computational data - prices, amounts etc.

Column

Panel

On this page:

Table of Contents

maxLevel	4
minLevel	1

XML configuration file structure

As described above, data model contains of data set definition including attributes and indicators. Each data set can be also connected to external data source. Following example illustrates how to do it:

Code Block

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:dataSet xmlns:ns2="http://www.belladati.com/api/v1.0" name="CRM - opportunities">
    <indicators>
        <indicator code="M_AMOUNT" name="Amount"/>
        <indicator code="M_PROBABILITY" name="Probability"/>
    </indicators>
    <attributes>
        <attribute code="L_CITY" name="City"/>
        <attribute code="L_ID" name="Id"/>
        <attribute code="L_NAME" name="Name"/>
        <attribute code="L_OFFICE" name="Office"/>
        <attribute code="L_PRODUCT" name="Product"/>
        <attribute code="L_STATUS" name="Status"/>
    </attributes>
    <dataSources>
        <dataSource name="SQL data source">
            <sql dbType="MYSQL">
                <columns>
                    <timeColumn localeString="cs" format="dd.MM.yyyy" index="0" name="Date"/>
                    <attributeColumn code="L_ID" index="1" name="Id"/>
                    <attributeColumn code="L_NAME" index="2" name="Name"/>
                    <attributeColumn code="L_OFFICE" index="3" name="Office"/>
                    <attributeColumn code="L_PRODUCT" index="4" name="Product"/>
                    <attributeColumn code="L_STATUS" index="5" name="Status"/>
                    <attributeColumn code="L_CITY" index="6" name="City"/>
                    <indicatorColumn code="M_AMOUNT" index="7" name="Amount"/>
                    <indicatorColumn code="M_PROBABILITY" index="8" name="Probability"/>
                </columns>
                <overridingTimeColumnDate>2010-12-17</overridingTimeColumnDate>
                <properties>
                    <entry name="SQL" value="select * from crm_opportunities"/>
                </properties>
                <connectionParameters>
                    <entry name="database" value="crm_db"/>
                    <entry name="host" value="host_address"/>
                    <entry name="password" value="password"/>
                    <entry name="user" value="user"/>
                </connectionParameters>
            </sql>
        </dataSource>
    </dataSources>
    <permissions>
        <owner>support@belladati.com</owner>
    </permissions>
</ns2:dataSet>

Content of the XML configuration file corresponds with the XSD schema belladati_1_0.xsd.

Creating data set

Data set is defined by <dataSet> tag.

Example

Code Block
<ns2:dataSet xmlns:ns2="http://www.belladati.com/api/v1.0" name="CRM - opportunities"> ... </ns2:dataSet>

Section

Column

width	50%

Tag attribures

name	type	required	description
`name`	string	true	Name of the data set

Column

Nested tags

name	type	cardinality	description
`indicators`	complex	0..1	Encloses the indicators and indicator groups
`attributes`	complex	0..1	Encloses the attributes
`drilldownPaths`	complex	0..1	Encloses the possible drilldown paths
`dataSources`	complex	0..1	Defines the data source
`alers`	complex	0..1	Encloses the alerts
`permissions`	complex	0..1	Encloses the permissions
`reports`	complex	0..1	Encloses the reports definitions

Creating indicators and indicators groups

Indicator is represented by single object or is a part of a group of indicators. Indicators and groups are enclosed by <indicators> tag.

Creating indicator

Single indicator is represented by <indicator> tag.

Example

Code Block
<indicators> <indicator code="M_AMOUNT" name="Amount" unit="USD"/> <indicator code="M_COUNT" name="Count"/> </indicators>

Tag attribures

name	type	required	description
`code`	string	true	Indicator's code. Must start with "M_" prefix and is unique within the dataset.
`name`	string	true	Name of the indicator
`unit`	string	false	Unit of the indicator
`roundingType`	string	false	Rounding mode - see http://download.oracle.com/javase/6/docs/api/java/math/RoundingMode.html for more information
`format`	string	false	Defines how the value of the indicator should be formatted

Nested tags

`translations`	complex	0..1	Encloses the indicator's translation
`formula`	CDATA value	0..1	Defines the formula, if the indicator's value is evaluated

Creating indicator with formula

Example

Code Block

<indicators>
       <indicator code="M_AMOUNT" name="Amount" unit="USD"/>
       <indicator code="M_COUNT" name="Count"/>
       <indicator code="M_RATE" name="Rate">
           <formula>M_AMOUNT / M_COUNT</formula>
       </indicator>
   </indicators>

Creating indicator's translation

Translation for indicator is supported by nested tag <translation>. Translations are compliant with indicators and indicator groups as well.

Example

Code Block
<indicators> <indicator code="M_AMOUNT" name="Amount" unit="USD"> <translations> <translation locale="de" value="Translated value"/> </translations> </indicator> </indicators>

Tag attribures

name	type	required	description
`locale`	string	true	Locale of the translation
`value`	string	true	Translated value

Creating indicator group

If you want more structured and hierarchical organized indicators, you can define it within the indicator group. Each indicator group consists of single indicators or nested indicators groups. Indicator group definition is enclosed in tag <indicatorGroup>.
Example

Code Block

<indicators>
        <indicatorGroup name="group">
            <indicator code="M_INDICATOR" name="indicator"/>
            <indicatorGroup name="sub-group">
                <indicator code="M_SUBGROUP_INDICATOR" name="sub-group indicator"/>
            </indicatorGroup>
        </indicatorGroup>
    </indicators>

Tag attribures

name	type	required	description
`code`	string	true	Indicator's code. Must start with "M_" prefix and is unique within the dataset.
`name`	string	true	Name of the indicator
`unit`	string	false	Unit of the indicator
`roundingType`	string	false	Rounding mode - see http://download.oracle.com/javase/6/docs/api/java/math/RoundingMode.html for more information
`format`	string	false	Defines how the value of the indicator should be formatted

Nested tags

`indicator`	complex	0..1	Nested indicator
`indicatorGroup`	complex	0..1	Nested indicator group

Creating attributes

Attributes entries <attribute> are defined within the <attributes> tag.

Example

Code Block

<attributes>
        <attribute code="L_CITY" name="City"/>
        <attribute code="L_ID" name="Id"/>
        <attribute code="L_NAME" name="Name"/>
        <attribute code="L_OFFICE" name="Office"/>
        <attribute code="L_PRODUCT" name="Product"/>
        <attribute code="L_STATUS" name="Status"/>
    </attributes>

Tag attribures

name	type	required	description
`code`	string	true	Attribute's code. Must start with "L_" prefix and is unique within the dataset.
`name`	string	true	Name of the attribute

Nested tags

`translations`	complex	0..1	Encloses the attribute's translation (see indicator's translation)
`memberTranslations`	complex	0..1	Encloses the attribute member's translation
`memberSettings`	complex	0..1	Holds the attribute member's settings, like appearance

Creating attribute's translation

Translation for attributes is supported by nested tag <translation>.

Example

Code Block

<attributes>
        <attribute code="L_CITY" name="City"/>
            <translations>
                <translation locale="de" value="Translated value"/>
                <translation locale="cs" value="Another translated value"/>
            </translations>
       </attribute>
    </attributes>

Tag attribures

name	type	required	description
`locale`	string	true	Locale of the translation
`value`	string	true	Translated value

Creating member's translation

Example

Code Block

<attribute code="L_CITY" name="City">
   <memberTranslations>
       <memberTranslation memberValue="Prague" locale="cs" value="Praha"/>
       <memberTranslation memberValue="Prague" locale="de" value="Prag"/>
   </memberTranslations>
</attribute>

Defining attribute's appearance

Example

Code Block
<attribute code="L_CITY" name="City"> <memberSettings> <memberSetting icon="cs" backgroundColor="#c41019" color="#ffffff" memberValue="Prague"/> </memberSettings> </attribute>

Defining drilldown paths

Example

Code Block
<drilldownPaths> <pathAttribute code="L_ATTRIBUTE_1"> <pathAttribute code="L_ATTRIBUTE_2"/> <pathAttribute code="L_ATTRIBUTE_2"/> </pathAttribute> </drilldownPaths>

Sv translation

language	ja

Section

Column

width	50%

あなたは、インポート時に、またはXMLファイルを使用して、より高度な方法でデータモデルのいずれかのGUIを介して定義できます。 XML定義はBellaDatiのREST APIに提出またはGUIを介してアップロードされます。

基本コンセプト

XML定義をオブジェクトに適用することができます。データモデルは次の要素で構成されます。

データセット - データセットは、属性とインジケータで構成される仮想キューブです。
属性 - 属性はインジケータの記述、典型的には、ID、名前、市などの一般的な文字列の記述子です。
属性メンバー - 属性の単一の値を表し、 - 例えば、都市属性のニューヨーク、ロンドン、ベルリンなど。
インジケータ - 計算データを含むデータ列です（価格、金額など）。

Column

Panel

このページ上で:

Table of Contents

maxLevel	4
minLevel	1

XML構成ファイルの構造

上述したように、データモデルは、属性およびインジケータを含むデータセットの定義を含んでいます。各データセットは、外部データソースに接続できます。例のようにそれを行う方法を示ています。

Code Block

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:dataSet xmlns:ns2="http://www.belladati.com/api/v1.0" name="CRM - opportunities">
    <indicators>
        <indicator code="M_AMOUNT" name="Amount"/>
        <indicator code="M_PROBABILITY" name="Probability"/>
    </indicators>
    <attributes>
        <attribute code="L_CITY" name="City"/>
        <attribute code="L_ID" name="Id"/>
        <attribute code="L_NAME" name="Name"/>
        <attribute code="L_OFFICE" name="Office"/>
        <attribute code="L_PRODUCT" name="Product"/>
        <attribute code="L_STATUS" name="Status"/>
    </attributes>
    <dataSources>
        <dataSource name="SQL data source">
            <sql dbType="MYSQL">
                <columns>
                    <timeColumn localeString="cs" format="dd.MM.yyyy" index="0" name="Date"/>
                    <attributeColumn code="L_ID" index="1" name="Id"/>
                    <attributeColumn code="L_NAME" index="2" name="Name"/>
                    <attributeColumn code="L_OFFICE" index="3" name="Office"/>
                    <attributeColumn code="L_PRODUCT" index="4" name="Product"/>
                    <attributeColumn code="L_STATUS" index="5" name="Status"/>
                    <attributeColumn code="L_CITY" index="6" name="City"/>
                    <indicatorColumn code="M_AMOUNT" index="7" name="Amount"/>
                    <indicatorColumn code="M_PROBABILITY" index="8" name="Probability"/>
                </columns>
                <overridingTimeColumnDate>2010-12-17</overridingTimeColumnDate>
                <properties>
                    <entry name="SQL" value="select * from crm_opportunities"/>
                </properties>
                <connectionParameters>
                    <entry name="database" value="crm_db"/>
                    <entry name="host" value="host_address"/>
                    <entry name="password" value="password"/>
                    <entry name="user" value="user"/>
                </connectionParameters>
            </sql>
        </dataSource>
    </dataSources>
    <permissions>
        <owner>support@belladati.com</owner>
    </permissions>
</ns2:dataSet>

XML設定ファイルのコンテンツはbelladati_1_0.xsd XSDスキーマに対応します。

データセットの作成

データセットが<dataSet>によって定義されます。

例

Code Block
<ns2:dataSet xmlns:ns2="http://www.belladati.com/api/v1.0" name="CRM - opportunities"> ... </ns2:dataSet>

Section

Column

width	50%

タグ属性

名	タイプ	必須	説明
`name`	string	true	データセット名

Column

ネストされたタグ

名	タイプ	カーディナリティ	説明
`indicators`	コンプレックス	0..1	インジケータやインジケータのグループを囲みます
`attributes`	コンプレックス	0..1	属性を囲みます
`drilldownPaths`	コンプレックス	0..1	可能なドリルダウンパスを囲みます
`dataSources`	コンプレックス	0..1	データソースを定義します
`alers`	コンプレックス	0..1	アラートを囲みます
`permissions`	コンプレックス	0..1	許可を囲みます
`reports`	コンプレックス	0..1	レポートの定義を囲みます

インジケータとインジケータグループの作成

インジケータは、単一のオブジェクト、またはインジケータのグループの一部によって表されます。インジケータとインジケータグループは、<indicators>タグで囲まれています。

インジケータ作成

<indicator>タグによって単一インジケータが示されます

例

Code Block
<indicators> <indicator code="M_AMOUNT" name="Amount" unit="USD"/> <indicator code="M_COUNT" name="Count"/> </indicators>

タグ属性

名	タイプ	必須	説明
`code`	string	true	インジケータのコード。「M_」接頭辞で始まり、データセット内で一意である必要があります。
`name`	string	true	インジケータ名
`unit`	string	false	インジケータの単位
`roundingType`	string	false	丸めモード - 詳細についてはhttp://download.oracle.com/javase/6/docs/api/java/math/RoundingMode.html を参照してください。
`format`	string	false	インジケータの値をフォーマットする方法を定義すます

ネストされたタグ

`translations`	complex	0..1	インジケータの翻訳を囲みます
`formula`	CDATA value	0..1	インジケータ値が評価される場合、式を定義します

数式インジケータを作成

例

Code Block

<indicators>
       <indicator code="M_AMOUNT" name="Amount" unit="USD"/>
       <indicator code="M_COUNT" name="Count"/>
       <indicator code="M_RATE" name="Rate">
           <formula>M_AMOUNT / M_COUNT</formula>
       </indicator>
   </indicators>

インジケータの翻訳を作成

インジケータの翻訳は、ネストされたタグ<translation>でサポートされています。翻訳は、インジケータとインジケータグループとしても準拠しています。

例

Code Block
<indicators> <indicator code="M_AMOUNT" name="Amount" unit="USD"> <translations> <translation locale="de" value="Translated value"/> </translations> </indicator> </indicators>

タグ属性

名	タイプ	必須	説明
`locale`	string	true	翻訳のロケール
`value`	string	true	翻訳値

インジケータグループの作成

より構造化と階層的に組織インジケータが必要な場合は、インジケータ・グループでそれを定義できます。各インジケータのグループは、単一のインジケータまたはネストされたインジケータグループで構成されています。インジケータグループ定義は、タグ<indicatorGroup>で囲まれています。

例

Code Block

<indicators>
        <indicatorGroup name="group">
            <indicator code="M_INDICATOR" name="indicator"/>
            <indicatorGroup name="sub-group">
                <indicator code="M_SUBGROUP_INDICATOR" name="sub-group indicator"/>
            </indicatorGroup>
        </indicatorGroup>
    </indicators>

タグ属性

名	タイプ	必須	説明
`code`	string	true	インジケータのコード。「M_」接頭辞で始まり、データセット内で一意である必要があります。
`name`	string	true	インジケータの名前
`unit`	string	false	インジケータの単位
`roundingType`	string	false	丸めモード - 詳細についてはhttp://download.oracle.com/javase/6/docs/api/java/math/RoundingMode.html を参照してください。
`format`	string	false	インジケータの値をフォーマットする方法を定義します

ネストされたタグ

`indicator`	complex	0..1	ネストされたインジケータ
`indicatorGroup`	complex	0..1	ネストされたインジケータグループ

属性作成

<attribute>エントリが<attribute>タグでの定義されています。

例

Code Block

<attributes>
        <attribute code="L_CITY" name="City"/>
        <attribute code="L_ID" name="Id"/>
        <attribute code="L_NAME" name="Name"/>
        <attribute code="L_OFFICE" name="Office"/>
        <attribute code="L_PRODUCT" name="Product"/>
        <attribute code="L_STATUS" name="Status"/>
    </attributes>

タグ属性

名	タイプ	必須	説明
`code`	string	true	インジケータのコード。「M_」接頭辞で始まり、データセット内で一意である必要があります。
`name`	string	true	インジケータの名前

ネストされたタグ

`translations`	コンプレックス	0..1	属性の翻訳を囲みます（インジケータの翻訳を参照してください）
`memberTranslations`	コンプレックス	0..1	属性メンバーの翻訳を囲みます
`memberSettings`	コンプレックス	0..1	外観のように、属性メンバーの設定を保持します

翻訳属性を作成

属性の翻訳は、ネストされたタグ<translation>でサポートされていみます。

例

Code Block

<attributes>
        <attribute code="L_CITY" name="City"/>
            <translations>
                <translation locale="de" value="Translated value"/>
                <translation locale="cs" value="Another translated value"/>
            </translations>
       </attribute>
    </attributes>

タグ属性

名	タイプ	必須	説明
`locale`	string	true	翻訳のロケール
`value`	string	true	翻訳値

メンバーの翻訳を作成

例

Code Block

<attribute code="L_CITY" name="City">
   <memberTranslations>
       <memberTranslation memberValue="Prague" locale="cs" value="Praha"/>
       <memberTranslation memberValue="Prague" locale="de" value="Prag"/>
   </memberTranslations>
</attribute>

外観属性の定義

例

Code Block
<attribute code="L_CITY" name="City"> <memberSettings> <memberSetting icon="cs" backgroundColor="#c41019" color="#ffffff" memberValue="Prague"/> </memberSettings> </attribute>

ドリルダウンパスの定義

例

Code Block
<drilldownPaths> <pathAttribute code="L_ATTRIBUTE_1"> <pathAttribute code="L_ATTRIBUTE_2"/> <pathAttribute code="L_ATTRIBUTE_2"/> </pathAttribute> </drilldownPaths>

Page tree

Versions Compared

Old Version 46

New Version Current

Key

Basic concept

XML configuration file structure

Creating data set

Creating indicators and indicators groups

Creating indicator

Creating indicator with formula

Creating indicator's translation

Creating indicator group

Creating attributes

Creating attribute's translation

Creating member's translation

Defining attribute's appearance

Defining drilldown paths

基本コンセプト

XML構成ファイルの構造

データセットの作成

インジケータとインジケータグループの作成

インジケータ作成

数式インジケータを作成

インジケータの翻訳を作成

インジケータグループの作成

属性作成

翻訳属性を作成

メンバーの翻訳を作成

外観属性の定義

ドリルダウンパスの定義