ORDERBY
Essbaseレポート・ライターのORDERBYコマンドは、指定された列のデータ値によってレポートの行を順序付けます。
構文
<ORDERBY ( [<rowgroupDimension>,] <column> [<direction>]{,<column> [<direction>]})
パラメータ
ノート
同じレポート・スクリプトでORDERBY、TOP、BOTTOMおよびRESTRICTを使用できますが、各コマンドを使用できるのは1つのレポートで1回のみです。同じレポート・スクリプトの2回目のレポートで同じコマンドを繰り返した場合、2回目のコマンドで1回目が上書きされます。グローバルなスクリプトのフォーマット・コマンド(SAVEROWなど)は、PAGE、COLUMNコマンドまたは関連付けられたメンバー(<ICHILDRENまたは<IDESCENDANTSなど)の前に配置します。
ORDERBY、TOP、BOTTOMまたはRESTRICTコマンドのいずれかがレポート・スクリプト内で共存している場合、行グループ・ディメンション<rowgroupDimension>は同じである必要があります。この制限により、行グループ内の行のソートおよび順序付けの混乱を避けられます。それ以外の場合は、エラーが発行されます。
TOPまたはBOTTOMコマンドがORDERBYと同じレポート内にある場合、ORDERBYの順序付けの列はTOPまたはBOTTOMの列と同じである必要はありません。
ORDERBY、TOPおよびBOTTOMコマンドは、レポート出力をデータ値を基準にソートします。RESTRICTコマンドでは、レポート出力の有効な行の数が制限されます。実行の順序は以下のとおりです。
-
メンバー名でソートする任意のソート・コマンド(<SORTDESCまたは<SORTASCなど)
-
RESTRICT
-
TOPおよびBOTTOM
-
ORDERBY
実行の順序は、レポート・スクリプトにコマンドが表示される順序に関係なく適用されます。
TOP、BOTTOM、ORDERBYおよびRESTRICTを一緒に使用する例は、BOTTOMコマンドのエントリを参照してください。
デフォルト値
最も内側の行グループは、デフォルトの行グループ・ディメンションです。デフォルトの向きは昇順です。
例
次のレポート・スクリプトは、ギャラリで使用できるSample Basicキューブ用に設計されています。
//Page dimension
<PAGE("Measures")
//Column dimensions
<COLUMN("Scenario", "Year")
//Row dimensions
<ROW("Market", "Product")
// Page Members
"Sales"
// Column Members
"Scenario"
"Jan" "Feb" "Mar"
// Row Members
"New York"
"Product" "100" "100-10" "100-20" "100-30" "200" "200-10" "200-20" "200-30" "200-40" "300" "300-10" "300-20" "300-30" "400" "400-10" "400-20" "400-30" "Diet" "100-20" "200-20" "300-30"
// Data sorting
<ORDERBY ("Product", @DATACOLUMN(1) ASC, @DATACOLUMN(2) DESC, @DATACOLUMN(3) ASC)
!
// End of report
前述のレポート・スクリプトでは、次のレポートが作成されます:
Sales Scenario
Jan Feb Mar
======== ======== ========
New York 100-20 #Missing #Missing #Missing
100-30 #Missing #Missing #Missing
200-20 #Missing #Missing #Missing
200-30 #Missing #Missing #Missing
300-30 #Missing #Missing #Missing
Diet #Missing #Missing #Missing
200-10 61 61 63
400-30 134 189 198
300-20 180 180 182
400-20 219 243 213
400-10 234 232 234
300-10 483 495 513
200-40 490 580 523
200 551 641 586
400 587 664 645
300 663 675 695
100-10 678 645 675
100 678 645 675
Product 2,479 2,625 2,601