GAPS コマンド
Analytics テーブルの数値または日付時刻フィールドに 1 つ以上のギャップが連続して含まれるかどうかを検出します。
構文
GAPS <ON> キーフィールド <D> <UNFORMATTED> <PRESORT> <MISSING 制限> <HEADER ヘッダー テキスト> <FOOTER フッター テキスト> <IF テスト> <WHILE テスト> <FIRST範囲|NEXT 範囲> <TO {SCREEN|テーブル名|ファイル名|PRINT}> <LOCAL> <APPEND> <OPEN>
パラメーター
| 名前 | 説明 |
|---|---|
| ON キーフィールドD |
欠落を検査するフィールドや式。 キー フィールドを降順に並べ替える D を含めます。 デフォルトのソート順は昇順です。 |
|
UNFORMATTED 省略可能 |
結果をファイルに出力する場合、ページ見出しや改ページは除去されます。 |
|
PRESORT 省略可能 |
コマンドを実行する前にキー フィールドでテーブルを並べ替えます。 メモ GROUP コマンドの内部では PRESORT を使用することができません。 |
| MISSING 制限 省略可能 |
ギャップの幅ではなく、欠落している個々の項目を出力結果に含めません。 制限値は、識別された各ギャップでレポートする欠落項目の最大数を指定します。 デフォルト値は 5 です。 制限を超えると、欠落項目はその特定のギャップの範囲としてレポートされます。 制限値は、レポートされる欠落項目の総数を制限するものではなく、特定のギャップの範囲内でレポートされる欠落項目の数を制限するだけです。 |
|
HEADER ヘッダーテキスト 省略可能 |
レポートの各ページの最上部に挿入されるテキスト。 ヘッダーテキストは引用符で囲んだ文字列として指定する必要があります。 この値は、Analytics のシステム変数である HEADER の値よりも優先されます。 |
| FOOTER フッターテキスト 省略可能 |
レポートの各ページの最下部に挿入されるテキスト。 フッターテキストは引用符で囲んだ文字列として指定する必要があります。 この値は、Analytics のシステム変数である FOOTER の値よりも優先されます。 |
|
IF テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。 コマンドは、その条件を満たすレコードに対してのみ実行されます。 メモ IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。 |
| WHILE テスト 省略可能 |
各レコードを処理するために真である必要がある条件式。 条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。 メモ WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。 |
| FIRST 範囲 | NEXT 範囲 省略可能 |
処理するレコード数：
範囲は処理するレコード数を指定します。 FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。 |
|
TO SCREEN | テーブル名 | ファイル名 | PRINT 省略可能 |
コマンドの結果を送信する場所：
|
|
LOCAL 省略可能 |
Analytics プロジェクトと同じ場所に出力ファイルを保存します。 メモ Analytics テーブルである出力ファイルを含むサーバー テーブルに対してコマンドを実行するときにのみ適用されます。 LOCAL パラメーターは TO パラメーターの直後に置く必要があります。 |
|
APPEND 省略可能 |
コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。 メモ コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。
出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。 出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。 |
|
OPEN 省略可能 |
コマンドを実行した後、コマンドによって作成されたテーブルを開きます。 コマンドが出力テーブルを作成する場合にのみ有効です。 |
Analytics の出力変数
| 名前 | 含む |
|---|---|
| GAPDUPn |
コマンドによって確認されたギャップ、重複、またはあいまい重複グループの合計数。 |
例
欠落した請求書番号がないかどうかをテストする
次の例では、GAPS を使用して、Invoices テーブルから欠落している請求書番号がないことを確認しています。
OPEN Invoices GAPS ON Inv_Num PRESORT TO "Invoices_Gaps.fil"
備考
メモ
このコマンドの動作の詳細については、Analytics のヘルプを参照してください。
文字フィールドに対して GAPS を使用する
数値または日付時刻フィールドをテストする他に、文字フィールドに存在する数値データに対してもギャップがないかどうかをテストすることができます。 たとえば、通常、文字データとして書式設定される小切手番号などに対してテストを行うことができます。
文字フィールドに文字と数字が続けて現れる場合は、数字のみが検査され、文字は無視されます。
