Page History

Sv translation

language	en

Using ATTRIBUTE VALUES LOOPING functions

Info
This recommendation applies to functions *eachMember(), membersSum(), membersAvg(), membersMin()* and *membersMax()*.

The common principle of these functions is iterating over the desired attribute values. E.g. eachMember('L_CITY') { ... } iterates over cities contained in the source data set. If there are N unique cities, the loop is executed N times. Depending on the hardware configuration, execution of one of these function is very demanding and affects the performance of the entire system if not used properly. The main criterion is how many times is the loop executed, in other words, how many unique entries does the chosen attribute have. According to our best practices and feedback from customers, the correct usage should follow this matrix:

Unique attribute values	Usage	Example
100.000	KPI label, chart, table or map with up to 20 elements (time entries, attribute values).	Table showing indicator with looping function for list of 20 cities.
20.000	KPI label, chart, table or map with up to 100 elements (time entries, attribute values).	Table showing indicator with looping function for list of 20 cities for 5 months.
5.000	KPI label, chart, table or map with up to 500 elements (time entries, attribute values).	Table showing indicator with looping function for list of 20 cities and 4 countries over 1 month.
1.000	KPI label, chart, table or map with up to 2.000 elements (time entries, attribute values)	Table showing indicator with looping function for list of 50 cities and 10 countries over 5 months.

The conclusion derived from the matrix above is, that these functions should be used in combination with maximum 100.000 unique attribute values. For larger amount of data users may want to use the BellaDati-R module, which is coming in Q2/2016.

Tip
For some use cases, consider using *forEachRow()* instead of looping functions.

Sv translation

language	ja

属性値のルーピング関数の使用

Info
この推奨事項は、*eachMember(), membersSum(), membersAvg(), membersMin(), membersMax()*関数に適用されます。

これらの関数の一般的な原則は、目的の属性値を反復することです。例: eachMember('L_CITY') { ... } は、ソースデータセットに含まれる都市を反復処理します。 N個の一意の都市がある場合、ループはN回実行されます。ハードウェア構成に応じて、これらの機能のいずれかの実行は非常に要求が厳しく、適切に使用しないとシステム全体のパフォーマンスに影響します。主な基準は、ループが何回実行されるか、つまり、選択された属性が持つ一意のエントリーの数です。お客様からのベストプラクティスとフィードバックによると、正しい使用法は次のマトリックスに従う必要があります:

一意の属性値	使用法	例
100.000	最大20までのエレメント（時間入力、属性値）を持つKPIラベル、チャート、表、マップ	20都市のリストのループ機能を備えたインジケータを示す表
20.000	最大100までのエレメント（時間入力、属性値）を持つKPIラベル、チャート、表、マップ	20都市5ヶ月間のリストのループ機能付きインジケータを示す表
5.000	最大500までのエレメント（時間入力、属性値）を持つKPIラベル、チャート、表、マップ	４ヶ国20都市1ヶ月間のリストのループ機能付きインジケータを示す表
1.000	最大2,000までのエレメント（時間入力、属性値）を持つKPIラベル、チャート、表、マップ	10ヶ国50都市5ヶ月間のリストのループ機能付きインジケータを示す表

上記のマトリックスから導き出された結論は、これらの関数は最大100.000の一意の属性値と組み合わせて使用する必要があるということです。大量のデータには、2016年第2四半期に提供されるBellaDati-Rモジュールを使用することをお勧めします。

Tip
いくつかの場合では、ルーピング機能の代わりに*forEachRow()*を使用することを検討してください。

Sv translation

language	de

Verwendung von ATTRIBUTE VALUES LOOPING-Funktionen

Info
Diese Empfehlung gilt für die Funktionen eachMember(), membersSum(), membersAvg(), membersMin() und membersMax().

Das gemeinsame Prinzip dieser Funktionen ist die Iteration über die gewünschten Attributwerte. Z.B. eachMember('L_CITY') { ..... } iteriert über Städte, die im Quelldatensatz enthalten sind. Wenn es N eindeutige Städte gibt, wird die Schleife N mal ausgeführt. Je nach Hardwarekonfiguration ist die Ausführung einer dieser Funktionen sehr anspruchsvoll und beeinträchtigt die Leistung des gesamten Systems, wenn sie nicht richtig genutzt wird. Das Hauptkriterium ist, wie oft die Schleife ausgeführt wird, d.h. wie viele eindeutige Einträge das gewählte Attribut hat. Gemäß unseren Best Practices und dem Feedback der Kunden sollte die korrekte Verwendung dieser Matrix folgen:

Eindeutige Attributwerte	Verwendung	Beispiel
100.000	KPI-Label, Chart, Tabelle oder Karte mit bis zu 20 Elementen (Zeitangaben, Attributwerte).	Tabelle mit Indikator und Schleifenfunktion für die Liste der 20 Städte.
20.000	KPI-Label, Chart, Tabelle oder Karte mit bis zu 100 Elementen (Zeitangaben, Attributwerte).	Tabelle mit Indikator und Schleifenfunktion für die Liste der 20 Städte für 5 Monate.
5.000	KPI-Label, Chart, Tabelle oder Karte mit bis zu 500 Elementen (Zeitangaben, Attributwerte).	Tabelle mit Indikator und Schleifenfunktion für die Liste der 20 Städte und 4 Länder über einen Monat.
1.000	KPI-Label, Chart, Tabelle oder Karte mit bis zu 2.000 Elementen (Zeitangaben, Attributwerte)	Tabelle mit Indikator und Schleifenfunktion für die Liste der 50 Städte und 10 Länder über 5 Monate.

Die Schlussfolgerung aus der obigen Matrix ist, dass diese Funktionen in Kombination mit maximal 100.000 eindeutigen Attributwerten verwendet werden sollten. Für größere Datenmengen kann das Modul BellaDati-R verwendet werden, das in Q2/2016 erhältlich ist.

Tip
In einigen Anwendungsfällen sollten Sie die Verwendung von forEachRow() anstelle von Schleifenfunktionen in Betracht ziehen.

Page tree

Versions Compared

Old Version 13

New Version Current

Key

Using ATTRIBUTE VALUES LOOPING functions

属性値のルーピング関数の使用

Verwendung von ATTRIBUTE VALUES LOOPING-Funktionen