When
when プレフィックスとサフィックスは、条件節の作成に使用します。条件節は、ステートメントまたは exit 節を実行するかどうかを決定します。これは、if..end if ステートメントの簡単な代替として使用されることがあります。
構文:
(when condition statement | exitstatement when condition )
戻り値データ型: ブール値
Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。
statement または exitstatement は、condition が True と評価された場合に限り、実行されます。
When プレフィックスは、他の When や Unless プレフィックスなどの 1 つまたは複数のステートメントを含むステートメントで使用できます。
使用に適しているケース
When ステートメントはブール値の結果を返します。一般的に、このタイプの関数は、ユーザーがスクリプトの一部をロードまたは除外する場合の条件として使用されます。
引数 | 説明 |
---|---|
condition | TRUE または FALSE の評価を実施する論理式 |
statement | 制御ステートメント以外の任意の Qlik Sense スクリプト ステートメント。 |
exitstatement | exit for、exit do、exit sub 節、あるいは exit script ステートメント。 |
地域の設定
特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。
App の既定の地域設定は、Qlik Sense がインストールされているコンピューターまたはサーバーの地域システム設定に基づいています。アクセスしている Qlik Sense サーバーがスウェーデンに設定されてい場合、データ ロード エディターは、日付、時間、および通貨にスウェーデンの地域設定を使用します。これらの地域の書式設定は、Qlik Sense ユーザー インターフェースに表示される言語とは関係ありません。Qlik Sense は使用しているブラウザと同じ言語で表示されます。
例 | 結果 |
---|---|
exit script when A=1; | ステートメント A=1 が TRUE と評価された場合、スクリプトは停止します。 |
when A=1 LOAD * from myfile.csv; | ステートメント A=1 が TRUE と評価された場合、myfile.csv スクリプトは停止します。 |
when A=1 unless B=2 drop table Tab1; | ステートメント A=1 が TRUE と評価され、B=2 が FALSE と評価された場合、Tab1 テーブルが停止します。 |