SEQUENCE コマンド

概念情報

Analytics テーブル内の 1 つ以上のフィールドが順番どおりに整列されているかどうかを確認したり、順序が正しくない項目を識別したりします。

構文

SEQUENCE <ON> {<FIELDS> キー フィールド <D> <...n>|<FIELDS> ALL <EXCLUDE フィールド名 <...n>>} <UNFORMATTED> <ERRORLIMIT n> <IF テスト> <WHILE テスト> <FIRST 範囲|NEXT range> <TO {SCREEN|ファイル名|PRINT}> <APPEND> <HEADER ヘッダー テキスト> <FOOTER フッター テキスト> <PRESORT> <ISOLOCALE ロケール コード>

パラメーター

名前	説明
ON FIELDS キーフィールド D <...n> \| FIELDS ALL	連続順序をテストする 1 つ以上の文字、数値、日付時刻フィールド。 FIELDS key_field指定した 1 つまたは複数のフィールドをテストします。複数のフィールドはスペースで区切る必要があります。また、異なるデータ型を指定できます。複数のフィールドでテストする場合、フィールドはリストの順でテストされます。キーフィールド値を降順でテストする D を含めます。デフォルトのテスト並べ順は昇順です。 FIELDS ALLテーブルのすべてのフィールドをテストします。すべてのフィールドでテストする場合、フィールドはテーブルレイアウトに表示される順序でテストされます。 FIELDS ALL の唯一のオプションは、昇順でキーフィールド値をテストすることです。メモ複数のフィールドでテストするときには、ソーステーブルでネストされた連続順序をテストしています。SEQUENCE の有効な使用には、ソーステーブルの既存のネストされた連続順序と同じ順序でテストフィールドを指定する必要があります。複数のテストフィールドはネストされたグループとしてテストされます。このようなフィールドは相互に独立してテストされることはありません。
EXCLUDE field_name 任意	FIELDS ALL を使用して連続順序のテストをするときにのみ有効です。コマンドから除外するフィールド。EXCLUDE では、指定したフィールドを除外して、ALL キーワードを微調整できます。 EXCLUDE は、FIELDS ALL の直後、または 1 つ以上の関連テーブルのフィールドを含める場合は ALL キーワードの最後の出現の直後に続く必要があります。例： FIELDS ALL EXCLUDE field_1 field_2 FIELDS ALL 関連テーブル名.ALL EXCLUDE field_1 field_2
UNFORMATTED 任意	結果をファイルに出力する場合、ページ見出しや改ページは除去されます。
ERRORLIMIT n 任意	コマンドが停止するまでに許容されるエラー数。デフォルト値は 10 です。
IF テスト任意	各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。メモ IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。
WHILE テスト任意	各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。メモ WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。
FIRST 範囲 \| NEXT 範囲任意	処理するレコード数： FIRST指定されたレコード数に達するまで、最初のレコードから処理を開始します NEXT指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します範囲は処理するレコード数を指定します。 FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。
TO SCREEN \| ファイル名 \| PRINT 任意	コマンドの結果を送信する場所： SCREENAnalytics の表示領域に結果を表示しますヒントヒント表示領域内で、リンク付きの任意の結果値をクリックすると、関連付けられているソーステーブル内の 1 つまたは複数のレコードにドリルダウンすることができます。ファイル名結果をファイルに保存しますファイル名を適切なファイル拡張子を持つ引用符で囲まれた文字列として指定します。例：TO "Output.TXT" デフォルトでは、出力ファイルは、Analytics プロジェクトが入っているフォルダーに保存されます。既存の異なるフォルダーにファイルを保存するには、絶対または相対ファイルパスを指定します。 TO "C:\Output.TXT" TO "Results\Output.TXT" PRINT通常使うプリンターに結果を送信します
APPEND 任意	コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。メモコマンドの出力と既存のファイルの構造が同一であるようにする必要があります。同じフィールド同じフィールド順序一致するフィールドが同じ長さ一致するフィールドが同じデータ型出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。
HEADER ヘッダーテキスト任意	レポートの各ページの最上部に挿入されるテキスト。ヘッダーテキストは引用符で囲んだ文字列として指定する必要があります。この値は、Analytics のシステム変数である HEADER の値よりも優先されます。
FOOTER フッターテキスト任意	レポートの各ページの最下部に挿入されるテキスト。フッターテキストは引用符で囲んだ文字列として指定する必要があります。この値は、Analytics のシステム変数である FOOTER の値よりも優先されます。
PRESORT 任意	コマンドを実行する前にキーフィールドでテーブルを並べ替えます。メモ GROUP コマンドの内部では PRESORT を使用することができません。
ISOLOCALE ロケールコード任意	メモ Analytics の Unicode 版にのみ適用されます。システムロケールは「言語-国」の形式で入力します。たとえば、カナダフランス語はコード fr_ca を入力します。次のコードを使用します。言語ISO 639 標準言語コード countryISO 3166 標準の国コード国コードを指定しない場合、その言語のデフォルトの国が使用されます。 ISOLOCALE を使用しない場合は、デフォルトシステムロケールが使用されます。

名前

説明

ON FIELDS キーフィールド D <...n> | FIELDS ALL

連続順序をテストする 1 つ以上の文字、数値、日付時刻フィールド。

FIELDS key_field指定した 1 つまたは複数のフィールドをテストします。
複数のフィールドはスペースで区切る必要があります。また、異なるデータ型を指定できます。
複数のフィールドでテストする場合、フィールドはリストの順でテストされます。
キーフィールド値を降順でテストする D を含めます。デフォルトのテスト並べ順は昇順です。
FIELDS ALLテーブルのすべてのフィールドをテストします。
すべてのフィールドでテストする場合、フィールドはテーブルレイアウトに表示される順序でテストされます。
FIELDS ALL の唯一のオプションは、昇順でキーフィールド値をテストすることです。

メモ

複数のフィールドでテストするときには、ソーステーブルでネストされた連続順序をテストしています。SEQUENCE の有効な使用には、ソーステーブルの既存のネストされた連続順序と同じ順序でテストフィールドを指定する必要があります。複数のテストフィールドはネストされたグループとしてテストされます。このようなフィールドは相互に独立してテストされることはありません。

EXCLUDE field_name

任意

FIELDS ALL を使用して連続順序のテストをするときにのみ有効です。

コマンドから除外するフィールド。EXCLUDE では、指定したフィールドを除外して、ALL キーワードを微調整できます。

EXCLUDE は、FIELDS ALL の直後、または 1 つ以上の関連テーブルのフィールドを含める場合は ALL キーワードの最後の出現の直後に続く必要があります。例：

FIELDS ALL EXCLUDE field_1 field_2

FIELDS ALL 関連テーブル名.ALL EXCLUDE field_1 field_2

UNFORMATTED

任意

結果をファイルに出力する場合、ページ見出しや改ページは除去されます。

ERRORLIMIT n

任意

コマンドが停止するまでに許容されるエラー数。デフォルト値は 10 です。

IF テスト

任意

各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。

メモ

IF パラメーターは、任意の範囲パラメーター（WHILE、FIRST、NEXT）が適用された後に、テーブルに残るレコードに対してのみ評価されます。

WHILE テスト

任意

各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。

メモ

WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。

FIRST 範囲 | NEXT 範囲

任意

処理するレコード数：

FIRST指定されたレコード数に達するまで、最初のレコードから処理を開始します
NEXT指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します

範囲は処理するレコード数を指定します。

FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。

TO SCREEN | ファイル名 | PRINT

任意

コマンドの結果を送信する場所：

SCREENAnalytics の表示領域に結果を表示します
ヒント
ヒント表示領域内で、リンク付きの任意の結果値をクリックすると、関連付けられているソーステーブル内の 1 つまたは複数のレコードにドリルダウンすることができます。
ファイル名結果をファイルに保存します
ファイル名を適切なファイル拡張子を持つ引用符で囲まれた文字列として指定します。例：TO "Output.TXT"
デフォルトでは、出力ファイルは、Analytics プロジェクトが入っているフォルダーに保存されます。
既存の異なるフォルダーにファイルを保存するには、絶対または相対ファイルパスを指定します。
- TO "C:\Output.TXT"
- TO "Results\Output.TXT"
PRINT通常使うプリンターに結果を送信します

APPEND

任意

コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。

メモ

コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。

同じフィールド
同じフィールド順序
一致するフィールドが同じ長さ
一致するフィールドが同じデータ型

出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。

HEADER ヘッダーテキスト

任意

レポートの各ページの最上部に挿入されるテキスト。

ヘッダーテキストは引用符で囲んだ文字列として指定する必要があります。この値は、Analytics のシステム変数である HEADER の値よりも優先されます。

FOOTER フッターテキスト

任意

レポートの各ページの最下部に挿入されるテキスト。

フッターテキストは引用符で囲んだ文字列として指定する必要があります。この値は、Analytics のシステム変数である FOOTER の値よりも優先されます。

PRESORT

任意

コマンドを実行する前にキーフィールドでテーブルを並べ替えます。

メモ

GROUP コマンドの内部では PRESORT を使用することができません。

ISOLOCALE ロケールコード

任意

メモ

Analytics の Unicode 版にのみ適用されます。

システムロケールは「言語-国」の形式で入力します。たとえば、カナダフランス語はコード fr_ca を入力します。

次のコードを使用します。

言語ISO 639 標準言語コード
countryISO 3166 標準の国コード
国コードを指定しない場合、その言語のデフォルトの国が使用されます。

ISOLOCALE を使用しない場合は、デフォルトシステムロケールが使用されます。

Analytics の出力変数

名前	含む
WRITEn	コマンドによって検出された順番検査エラーの合計数。

例

順番誤りの従業員 ID のテスト

次の例は、EmployeeID フィールドで特定されたすべての順番検査エラーをテキストファイルに書き込んでいます。

SEQUENCE ON EmployeeID ERRORLIMIT 10 TO "SequenceErrors.txt"

備考

このコマンドの動作の詳細については、「順番検査」を参照してください。

SEQUENCE を GROUP 内で使用する

SEQUENCE コマンドは、GROUP コマンド内で実行しても、グループの処理に影響を及ぼさないようになっています。ただし、GROUP コマンド以降のデータ順番検査エラーを報告することはありません。