Skip to content

Commit 0332d2a

Browse files
committed
cleanup tut titles, hint in xml, xml cleanup
Signed-off-by: Stefan Bischof <[email protected]>
1 parent 43b3c8d commit 0332d2a

File tree

107 files changed

+618
-618
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

107 files changed

+618
-618
lines changed

docs/cubeserver/tutorial/complex.school.md

Lines changed: 208 additions & 208 deletions
Large diffs are not rendered by default.

docs/cubeserver/tutorial/index.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -31,33 +31,33 @@ A recommended reading order is provided below to help you build your understandi
3131

3232
[Cube - Minimal](./tutorial.cube.minimal.md)
3333

34-
[Cube - Measures and Aggregators](./tutorial.cube.measure.aggregator.base.md)
34+
[Measure - Basic Aggregators](./tutorial.cube.measure.aggregator.base.md)
3535

36-
[Cube - Measures Multiple](./tutorial.cube.measure.multiple.md)
36+
[Measure - Multiple Measures](./tutorial.cube.measure.multiple.md)
3737

38-
[Cube - Measures and Datatypes](./tutorial.cube.measure.datatype.md)
38+
[Measure - Datatypes](./tutorial.cube.measure.datatype.md)
3939

40-
[Cube - Measures and Formats](./tutorial.cube.measure.format.md)
40+
[Measure - Formats](./tutorial.cube.measure.format.md)
4141

42-
[Cube - Measures and MeasureGroups](./tutorial.cube.measure.group.md)
42+
[Measure - MeasureGroups](./tutorial.cube.measure.group.md)
4343

44-
[Cube - Measures and Aggregators](./tutorial.cube.measure.aggregator.bit.md)
44+
[Measure - Bit Aggragators](./tutorial.cube.measure.aggregator.bit.md)
4545

46-
[Cube - Percentile](./tutorial.cube.measure.aggregator.percentile.md)
46+
[Measure - Percentile Aggragator](./tutorial.cube.measure.aggregator.percentile.md)
4747

48-
[Cube - Measures and Text Aggregators with comments](./tutorial.cube.measure.aggregator.textagg.md)
48+
[Measure - Text Aggregator](./tutorial.cube.measure.aggregator.textagg.md)
4949

5050
[Dimension - Introduction](./tutorial.cube.dimension.intro.md)
5151

52-
[Hierarchy - Query based on seperate Tables for Fact and Dimension](./tutorial.cube.hierarchy.query.table.base.md)
52+
[Hierarchy - Query - seperate Tables, Fact and Dimension](./tutorial.cube.hierarchy.query.table.base.md)
5353

54-
[Hierarchy - Query based on a Table with 2 Levels](./tutorial.cube.hierarchy.query.table.multilevel.multitable.md)
54+
[Hierarchy - Query - 1 Table, 2 Levels](./tutorial.cube.hierarchy.query.table.multilevel.multitable.md)
5555

56-
[Hierarchy - Query based on all in one Table](./tutorial.cube.hierarchy.query.table.multilevel.singletable.md)
56+
[Hierarchy - Query - all in 1 Table](./tutorial.cube.hierarchy.query.table.multilevel.singletable.md)
5757

58-
[Hierarchy - Query based on Join](./tutorial.cube.hierarchy.query.join.base.md)
58+
[Hierarchy - Query - 1 Join](./tutorial.cube.hierarchy.query.join.base.md)
5959

60-
[Hierarchy - Query based on a 2 Joind with 3 Levels](./tutorial.cube.hierarchy.query.join.multi.md)
60+
[Hierarchy - Query - 2 Joins, 3 Levels](./tutorial.cube.hierarchy.query.join.multi.md)
6161

6262
[Hierarchy - HasAll-Level](./tutorial.cube.hierarchy.hasall.md)
6363

docs/cubeserver/tutorial/tutorial.accessallnonecustom.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -42,11 +42,10 @@ This files represent the complete definition of the catalog.
4242
<measures xsi:type="roma:SumMeasure" id="Measure1" name="Measure1" column="Fact_VALUE"/>
4343
</measureGroups>
4444
</roma:PhysicalCube>
45-
<roma:AccessRole id="role1" name="role1">
46-
<accessCatalogGrants catalogAccess="all">
47-
<cubeGrants cube="Cube2"/>
48-
</accessCatalogGrants>
45+
<roma:AccessRole id="role3" name="role3">
46+
<accessCatalogGrants catalogAccess="all"/>
4947
</roma:AccessRole>
48+
<roma:AccessRole id="role2" name="role2"/>
5049
<roma:AccessRole id="manager" name="manager">
5150
<accessCatalogGrants>
5251
<cubeGrants cubeAccess="all" cube="Cube1">
@@ -61,7 +60,6 @@ This files represent the complete definition of the catalog.
6160
</cubeGrants>
6261
</accessCatalogGrants>
6362
</roma:AccessRole>
64-
<roma:AccessRole id="role2" name="role2"/>
6563
<roma:AccessRole id="role_u" name="role_u">
6664
<referencedAccessRoles id="role11" name="role11">
6765
<accessCatalogGrants>
@@ -74,8 +72,10 @@ This files represent the complete definition of the catalog.
7472
</accessCatalogGrants>
7573
</referencedAccessRoles>
7674
</roma:AccessRole>
77-
<roma:AccessRole id="role3" name="role3">
78-
<accessCatalogGrants catalogAccess="all"/>
75+
<roma:AccessRole id="role1" name="role1">
76+
<accessCatalogGrants catalogAccess="all">
77+
<cubeGrants cube="Cube2"/>
78+
</accessCatalogGrants>
7979
</roma:AccessRole>
8080
<roma:AccessRole id="role3" name="role3">
8181
<accessCatalogGrants>

docs/cubeserver/tutorial/tutorial.aggregatetables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,11 +49,11 @@ This files represent the complete definition of the catalog.
4949
<tables xsi:type="roma:PhysicalTable" id="AGG_LC_100_SALES_FACT_1997" name="AGG_LC_100_SALES_FACT_1997"/>
5050
</roma:DatabaseSchema>
5151
<roma:TableQuery id="productClassQuery" table="PRODUCT_CLASS"/>
52-
<roma:TableQuery id="productQuery" table="PRODUCT"/>
5352
<roma:TableQuery id="salesFact1997Query" aggregationTables="aggregationName" table="SALES_FACT_1997">
5453
<aggregationExcludes name="AGG_C_14_SALES_FACT_1997"/>
5554
<aggregationExcludes name="AGG_LC_100_SALES_FACT_1997"/>
5655
</roma:TableQuery>
56+
<roma:TableQuery id="productQuery" table="PRODUCT"/>
5757
<roma:JoinQuery id="joinQuery">
5858
<left key="PRODUCT_PRODUCT_CLASS_ID" query="productQuery"/>
5959
<right key="PRODUCT_CLASS_PRODUCT_CLASS_ID" query="productClassQuery"/>

docs/cubeserver/tutorial/tutorial.cube.calculatedmember.intro.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -24,37 +24,37 @@ The Database Schema contains the Fact table with three columns: KEY and VALUE an
2424
</roma:DatabaseSchema>
2525

2626
```
27-
27+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
2828
## Query
2929

3030
The Query is a simple TableQuery that selects all columns from the Fact table to use in in the hierarchy and in the cube for the measures.
3131

3232

3333
```xml
34-
<roma:TableQuery id="_query" table="roma:PhysicalTable _table_fact"/>
34+
<roma:TableQuery id="_query" table="_table_fact"/>
3535

3636
```
37-
37+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
3838
## Level
3939

4040
This Example uses one simple Level bases on the KEY column.
4141

4242

4343
```xml
44-
<roma:Level id="_level" name="theLevel" column="roma:PhysicalColumn _col_fact_key"/>
44+
<roma:Level id="_level" name="theLevel" column="_col_fact_key"/>
4545

4646
```
47-
47+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
4848
## Hierarchy without hasAll Level
4949

5050
The Hierarchy is defined with the hasAll property set to true and the one level.
5151

5252

5353
```xml
54-
<roma:Hierarchy id="_hierarchy" name="theHierarchy" levels="_level" hasAll="true" primaryKey="roma:PhysicalColumn _col_fact_key" query="roma:TableQuery _query"/>
54+
<roma:Hierarchy id="_hierarchy" name="theHierarchy" levels="_level" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
5555

5656
```
57-
57+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
5858
## Dimension
5959

6060
The dimension is defined with the one hierarchy. The hierarchy is used in the cube and in the calculated member.
@@ -64,7 +64,7 @@ The dimension is defined with the one hierarchy. The hierarchy is used in the cu
6464
<roma:StandardDimension id="_dimension" name="theDimension" hierarchies="_hierarchy"/>
6565

6666
```
67-
67+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
6868
## Calculated Member in Measure
6969

7070
This calculated member only coes a calculation with both of the existing Measures. The Forula holds the calculation instruction. The Formula Expression is a MDX expression.
@@ -74,7 +74,7 @@ This calculated member only coes a calculation with both of the existing Measure
7474
<roma:CalculatedMember id="_cm1" name="Calculated Member 1" formula="[Measures].[Measure1-Sum] / [Measures].[Measure2-Count]"/>
7575

7676
```
77-
77+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
7878
## Calculated Member in Dimension
7979

8080
This calculated member has also a Formula. Additionaly it references the Hierarchy where it should be addes and a Parent Expression that defins unter wich Element it should be added. The Parent Expression is a MDX expression.
@@ -85,25 +85,25 @@ This calculated member has also a Formula. Additionaly it references the Hierarc
8585
<roma:CalculatedMember id="_cm2" name="Calculated Member 2" formula="[Measures].[Measure1-Sum] / [Measures].[Measure2-Count]" parent="[theDimension].[theHierarchy].[All theHierarchys]" hierarchy="_hierarchy"/>
8686

8787
```
88-
88+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
8989
## Cube and DimensionConnector and Measure
9090

9191
The cube is defines by the DimensionConnector and the MeasureGroup and most importantly the calculated members.
9292

9393

9494
```xml
95-
<roma:PhysicalCube id="_cube" name="Cube CalculatedMember" query="roma:TableQuery _query">
95+
<roma:PhysicalCube id="_cube" name="Cube CalculatedMember" query="_query">
9696
<calculatedMembers id="_cm1" name="Calculated Member 1" formula="[Measures].[Measure1-Sum] / [Measures].[Measure2-Count]"/>
9797
<calculatedMembers id="_cm2" name="Calculated Member 2" formula="[Measures].[Measure1-Sum] / [Measures].[Measure2-Count]" parent="[theDimension].[theHierarchy].[All theHierarchys]" hierarchy="_hierarchy"/>
9898
<dimensionConnectors foreignKey="roma:PhysicalColumn _col_fact_key" dimension="roma:StandardDimension _dimension"/>
9999
<measureGroups>
100-
<measures xsi:type="roma:SumMeasure" id="Measure1-Sum" name="Measure1-Sum" column="roma:PhysicalColumn _col_fact_value"/>
101-
<measures xsi:type="roma:CountMeasure" id="Measure2-Count" name="Measure2-Count" column="roma:PhysicalColumn _col_fact_value"/>
100+
<measures xsi:type="roma:SumMeasure" id="Measure1-Sum" name="Measure1-Sum" column="_col_fact_value"/>
101+
<measures xsi:type="roma:CountMeasure" id="Measure2-Count" name="Measure2-Count" column="_col_fact_value"/>
102102
</measureGroups>
103103
</roma:PhysicalCube>
104104

105105
```
106-
106+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
107107

108108
## Definition
109109

docs/cubeserver/tutorial/tutorial.cube.dimension.intro.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -25,27 +25,27 @@ The cube defined in this example is based on a single table that stores all the
2525
</roma:DatabaseSchema>
2626

2727
```
28-
28+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
2929
## Query
3030

3131
This example uses a TableQuery, as it directly references the physical table `Fact`.
3232

3333

3434
```xml
35-
<roma:TableQuery id="_query" table="roma:PhysicalTable _tab"/>
35+
<roma:TableQuery id="_query" table="_tab"/>
3636

3737
```
38-
38+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
3939
## Level
4040

4141
The level is the most basic element of a hierarchy. It defines the granularity of the data in the hierarchy. To create a Level we need do set the key column, which is the column that uniquely identifies the Level in the table. In this example we use the `KEY` column of the `Fact` table as the key column of the level.
4242

4343

4444
```xml
45-
<roma:Level id="_level" name="theLevel" column="roma:PhysicalColumn _col_key"/>
45+
<roma:Level id="_level" name="theLevel" column="_col_key"/>
4646

4747
```
48-
48+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
4949
## Hierarchy
5050

5151
A hierarchy is a collection of levels that defines the structure of data within a dimension. It provides a name for the group the contained Level elements.
@@ -56,10 +56,10 @@ Additionally, a primary key column can be specified for the hierarchy. The prima
5656

5757

5858
```xml
59-
<roma:Hierarchy id="_hierarchy" name="theHierarchy" levels="_level" primaryKey="roma:PhysicalColumn _col_key" query="roma:TableQuery _query"/>
59+
<roma:Hierarchy id="_hierarchy" name="theHierarchy" levels="_level" primaryKey="_col_key" query="_query"/>
6060

6161
```
62-
62+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
6363
## Dimension
6464

6565
The Dimension is the main element of the cube. It defines the structure of the data in the cube. The dimension can contain one or multiple hierarchies. In this example we use one hierarchy, which contains one level.
@@ -69,7 +69,7 @@ The Dimension is the main element of the cube. It defines the structure of the d
6969
<roma:StandardDimension id="_dimension" name="theDimension" hierarchies="_hierarchy"/>
7070

7171
```
72-
72+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
7373
## Cube and DimensionConnector and Measure
7474

7575
The cube contains only one Measure in a unnamed MeasureGroup and references to the Dimension.
@@ -78,15 +78,15 @@ To connect the dimension to the cube, a DimensionConnector is used. The Dimensio
7878

7979

8080
```xml
81-
<roma:PhysicalCube id="_cube" name="CubeWithSimpleDimension" query="roma:TableQuery _query">
81+
<roma:PhysicalCube id="_cube" name="CubeWithSimpleDimension" query="_query">
8282
<dimensionConnectors dimension="roma:StandardDimension _dimension"/>
8383
<measureGroups>
84-
<measures xsi:type="roma:SumMeasure" id="_measure" name="theMeasure" column="roma:PhysicalColumn _col_value"/>
84+
<measures xsi:type="roma:SumMeasure" id="_measure" name="theMeasure" column="_col_value"/>
8585
</measureGroups>
8686
</roma:PhysicalCube>
8787

8888
```
89-
89+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
9090

9191
## Definition
9292

docs/cubeserver/tutorial/tutorial.cube.hierarchy.hasall.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ group: Hierarchy
44
kind: TUTORIAL
55
number: 2.3.4
66
---
7-
# Hierarchy - HasAll-Level
7+
# Hierarchy - Level - HasAll
88

99
In a hierarchy, the top level can sometimes be a special case. Typically, levels are created using a Level object, along with a reference to a column and a query on the hierarchy. However, there are situations where no dedicated column or table entry exists for the top level. For example if you want to represent a grand total. In such cases, you can generate a generic top level that serves as a final aggregation for all members of the level below.
1010

@@ -36,58 +36,58 @@ The cube defined in this example is based on three table: Fact.
3636
</roma:DatabaseSchema>
3737

3838
```
39-
39+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
4040
## Query
4141

4242
This Query references the Fact table and will be udes for the Cube and all Hierarchies in same way.
4343

4444

4545
```xml
46-
<roma:TableQuery id="_query" table="roma:PhysicalTable _table"/>
46+
<roma:TableQuery id="_query" table="_table"/>
4747

4848
```
49-
49+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
5050
## Level
5151

5252
The Level object uses the column attribute to specify the column names `KEY` that represents the level and its members.
5353
This the only Level that exists in this example and will be used in all hierarchies the same way.
5454

5555

5656
```xml
57-
<roma:Level id="_level" name="theLevel" column="roma:PhysicalColumn _col_fact_key"/>
57+
<roma:Level id="_level" name="theLevel" column="_col_fact_key"/>
5858

5959
```
60+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
61+
## Hierarchy without hasAll Level
6062

61-
## Hierarchy with hasAll Level and defaut names
62-
63-
This hierarchy sets the attribute `hasAll` to true, which means that a top level will be generated. The hierarchy will contain the levels defined in the Level object and an additional top level with the default Name for the All-Level and the All-Member.
63+
This Hierarchy sets the attribute `hasAll` to false, which means that no top level will be generated. The hierarchy will only contain the levels defined in the Level object.
6464

6565

6666
```xml
67-
<roma:Hierarchy id="_hierarchy_hasall_simple" name="Hierarchy - with HasAll" levels="_level" hasAll="true" primaryKey="roma:PhysicalColumn _col_fact_key" query="roma:TableQuery _query"/>
67+
<roma:Hierarchy id="_hierarchy_hasall_no" name="Hierarchy - Without HasAll" levels="_level" primaryKey="_col_fact_key" query="_query"/>
6868

6969
```
70+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
71+
## Hierarchy with hasAll Level and custom names
7072

71-
## Hierarchy without hasAll Level
72-
73-
This Hierarchy sets the attribute `hasAll` to false, which means that no top level will be generated. The hierarchy will only contain the levels defined in the Level object.
73+
tHis hierarchy sets the attribute `hasAll` to true, which means that a top level will be generated. The hierarchy will contain the levels defined in the Level object and an additional top level with the custom Name for the All-Level and the All-Member.
7474

7575

7676
```xml
77-
<roma:Hierarchy id="_hierarchy_hasall_no" name="Hierarchy - Without HasAll" levels="_level" primaryKey="roma:PhysicalColumn _col_fact_key" query="roma:TableQuery _query"/>
77+
<roma:Hierarchy id="_hierarchy_hasall_complex" name="Hierarchy - with HasAll and Names" levels="_level" allLevelName="theAllLevelName" allMemberName="theAllMemberName" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
7878

7979
```
80+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
81+
## Hierarchy with hasAll Level and defaut names
8082

81-
## Hierarchy with hasAll Level and custom names
82-
83-
tHis hierarchy sets the attribute `hasAll` to true, which means that a top level will be generated. The hierarchy will contain the levels defined in the Level object and an additional top level with the custom Name for the All-Level and the All-Member.
83+
This hierarchy sets the attribute `hasAll` to true, which means that a top level will be generated. The hierarchy will contain the levels defined in the Level object and an additional top level with the default Name for the All-Level and the All-Member.
8484

8585

8686
```xml
87-
<roma:Hierarchy id="_hierarchy_hasall_complex" name="Hierarchy - with HasAll and Names" levels="_level" allLevelName="theAllLevelName" allMemberName="theAllMemberName" hasAll="true" primaryKey="roma:PhysicalColumn _col_fact_key" query="roma:TableQuery _query"/>
87+
<roma:Hierarchy id="_hierarchy_hasall_simple" name="Hierarchy - with HasAll" levels="_level" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
8888

8989
```
90-
90+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
9191
## Dimension
9292

9393
The Dimension that containes all the hierarchies.
@@ -97,22 +97,22 @@ The Dimension that containes all the hierarchies.
9797
<roma:StandardDimension id="_dimension" name="Dimension1" hierarchies="_hierarchy_hasall_simple _hierarchy_hasall_complex _hierarchy_hasall_no"/>
9898

9999
```
100-
100+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
101101
## Cube and DimensionConnector and Measure
102102

103103
The cube contains only one Measure in a unnamed MeasureGroup and references to the Dimension.
104104

105105

106106
```xml
107-
<roma:PhysicalCube id="_cube" name="HasAll Cube" query="roma:TableQuery _query">
107+
<roma:PhysicalCube id="_cube" name="HasAll Cube" query="_query">
108108
<dimensionConnectors dimension="roma:StandardDimension _dimension"/>
109109
<measureGroups>
110-
<measures xsi:type="roma:SumMeasure" id="_measure" name="theMeasure" column="roma:PhysicalColumn _col_fact_value"/>
110+
<measures xsi:type="roma:SumMeasure" id="_measure" name="theMeasure" column="_col_fact_value"/>
111111
</measureGroups>
112112
</roma:PhysicalCube>
113113

114114
```
115-
115+
*<small>Note: This is only a symbolic example. For the exact definition, see the [Definition](#definition) section.</small>*
116116

117117
## Definition
118118

@@ -130,9 +130,9 @@ This files represent the complete definition of the catalog.
130130
</roma:DatabaseSchema>
131131
<roma:TableQuery id="_query" table="_table"/>
132132
<roma:Level id="_level" name="theLevel" column="_col_fact_key"/>
133-
<roma:Hierarchy id="_hierarchy_hasall_simple" name="Hierarchy - with HasAll" levels="_level" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
134133
<roma:Hierarchy id="_hierarchy_hasall_no" name="Hierarchy - Without HasAll" levels="_level" primaryKey="_col_fact_key" query="_query"/>
135134
<roma:Hierarchy id="_hierarchy_hasall_complex" name="Hierarchy - with HasAll and Names" levels="_level" allLevelName="theAllLevelName" allMemberName="theAllMemberName" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
135+
<roma:Hierarchy id="_hierarchy_hasall_simple" name="Hierarchy - with HasAll" levels="_level" hasAll="true" primaryKey="_col_fact_key" query="_query"/>
136136
<roma:StandardDimension id="_dimension" name="Dimension1" hierarchies="_hierarchy_hasall_simple _hierarchy_hasall_complex _hierarchy_hasall_no"/>
137137
<roma:PhysicalCube id="_cube" name="HasAll Cube" query="_query">
138138
<dimensionConnectors dimension="_dimension"/>

0 commit comments

Comments
 (0)