ORDERBY

Essbaseレポート・ライターのORDERBYコマンドは、指定された列のデータ値によってレポートの行を順序付けます。

構文

<ORDERBY ( [<rowgroupDimension>,] <column> [<direction>]{,<column> [<direction>]})

パラメータ

<Optional rowgroup Dimension>

セットとしてソートする行を決定する、行のグループ化ディメンション。

<column>

@DATACOLUMN (<colnumber>) | @DATACOLUMN (<colnumber>)

ここで、<colnumber>はターゲットの列番号で、1からレポートの最大列数までである必要があります。

<direction>

次のように、ソートの向きの異なる複数の列を指定できます。

  • ASCは昇順のソートです

  • DESCは降順のソートです

ノート

同じレポート・スクリプトで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コマンドでは、レポート出力の有効な行の数が制限されます。実行の順序は以下のとおりです。

  1. メンバー名でソートする任意のソート・コマンド(<SORTDESCまたは<SORTASCなど)

  2. RESTRICT

  3. TOPおよびBOTTOM

  4. 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