REPORT コマンド
開いている Analytics テーブルに基づき、レポートを書式設定し、生成します。
構文
REPORT <ON 内訳フィールド <PAGE> <NODUPS> <WIDTH 文字数> <AS 表示名>> <...n> FIELD その他のフィールド <WIDTH 文字数> <AS 表示名> <...n> <SUPPRESS> <NOZEROS> <LINE n その他のフィールド> <PRESORT <並べ替えフィールド>> <...n> <SUMMARIZED> <SKIP n> <EOF> <TO {SCREEN|PRINT|ファイル名 <HTML>}> <IF >テスト> <WHILE テスト> <FIRST 範囲|NEXT 範囲> <HEADER ヘッダー テキスト> <FOOTER フッター テキスト> <APPEND>
パラメーター
| 名前 | 説明 |
|---|---|
|
ON 内訳フィールド PAGE NODUPS WIDTH 文字 AS 表示名 <...n> 省略可能 |
レポートをセクションに区切るために使用される文字フィールド。 内訳フィールドの値が変わるたびに、新しいレポート セクションと小計が作成されます。 レポートをセクションに分割することで、レポートがスキャンしやすくなります。
メモ 内訳フィールド、PAGE、NODUPS、または PRESORT を使用するには、ON を指定する必要があります。 |
| FIELD 他のフィールド WIDTH 文字 AS 表示名 <...n> |
レポートに含めるフィールド。
SUBTOTAL および ACCUMULATE キーワードは、廃止され、FIELD に取って代わられました。 すべての数値フィールドの小計は、自動で計算されます。 メモ 内訳フィールドは、自動的にレポートに追加されるため、その他のフィールドに指定する必要はありません。 |
|
SUPPRESS 省略可能 |
レポートから空白の明細行を除外します。 |
|
NOZEROS 省略可能 |
フィールドのゼロ値に空白値を使用します。 たとえば、レポートのフィールド大量のゼロ値がある場合、ゼロ以外の値のみを表示すると読みやすくなります。 |
| LINE n その他のフィールド 省略可能 |
行番号 n に表示される列とフィールドの出力行数を指定します。 値が指定されない場合、列は単一行をデフォルトとします。 n には、2 ～ 60 に含まれる値（両端を含む）を指定する必要があります。 レポートの列見出しは、最初の行にあるフィールドによって決まります。 その他のフィールドは、レポートに使用するフィールドや式を指定します。 |
|
PRESORT 並べ替えフィールド <...n> 省略可能 |
PRESORT は、 並べ替えフィールドとしてリストされていない限り、その他のフィールドとしてリストされたフィールドを並べ替えません。 |
|
SUMMARIZED 省略可能 |
詳細行のない、小計と合計のみのレポートを作成します。 小計は、一意の内訳フィールドの値に対して生成されます。 SUMMARIZED を指定しない場合には、KEY で指定した各内訳フィールドの小計だけでなく詳細行も含んだレポートが作成されます。 |
| SKIP n 省略可能 |
レポート内の詳細行の間に空白行を挿入します。 n には、挿入する行数を示す整数を指定する必要があります。 たとえば、SKIP 1 は 1 行おきの行間のレポートを生成します。 |
|
EOF 省略可能 |
ファイルの終わりに達した後、コマンドをもう一度実行します。 これにより、GROUP コマンド内でテーブルの最後のレコードが処理されることが保証されます。 すべてのフィールドが以前のレコードを参照する演算フィールドである場合にのみ使用してください。 |
|
TO SCREEN | PRINT| ファイル名 <HTML> 省略可能 |
コマンドの結果を送信する場所：
デフォルトでは、レポートはファイルに出力され、ASCII テキスト ファイルとして保存されます。 レポートを HTML ファイル（.htm）として出力したい場合は、HTML を指定します。 TO を省略した場合は、レポートが画面に出力されます。 |
|
IF テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。 コマンドは、その条件を満たすレコードに対してのみ実行されます。 メモ IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。 |
|
WHILE テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。 条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。 メモ WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。 |
|
FIRST 範囲 | NEXT 範囲 省略可能 |
処理するレコード数：
範囲は処理するレコード数を指定します。 FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。 |
|
HEADER ヘッダーテキスト 省略可能 |
レポートの各ページの最上部に挿入されるテキスト。 ヘッダーテキストは引用符で囲んだ文字列として指定する必要があります。 この値は、Analytics のシステム変数である HEADER の値よりも優先されます。 |
|
FOOTER フッターテキスト 省略可能 |
レポートの各ページの最下部に挿入されるテキスト。 フッターテキストは引用符で囲んだ文字列として指定する必要があります。 この値は、Analytics のシステム変数である FOOTER の値よりも優先されます。 |
|
APPEND 省略可能 |
コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。 メモ コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。
出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。 出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。 |
例
HTML レポートを生成する
次の例では、Ar テーブルからレポートを生成し、書式付きの HTML ファイルに出力します。
OPEN Ar REPORT ON No FIELD Due Type Amount TO "C:\Reports\AR.htm" HTML
