Varg
3.2.19 Varg
説明
Varg - 指定された可視性スコープを持つ変数を定義 ("Varg set") または削除 ("Varg delete") します。v6.3からサポートされています。
このコマンドは Varコマンドの拡張です:
Varは 、ローカル(コードブロック内)またはスクリプトの可視性を持つ変数のみを作成/設定できます。Varg は、スクリプトまたはワークアイテムがデータを共有できるようにするセッション(グローバル)変数のサポートを追加します。
Var は、コンテキストから可視性スコープを決定します。構造化されたコードブロック(if/else、for、procedure)の内部で定義された変数はローカル変数になりますが、メインスクリプト本体で定義された変数はスクリプトの可視性を持ちます。一方、Vargは明示的なスコープで動作します。このアプローチは、例えば構造化ブロックの中にスクリプト変数を作成することができるため、より柔軟です。
Vargには変数を削除する機能がある。これは、スクリプトが変数の存在によって分岐する必要がある場合に便利です('exists' boolean operator).スクリプトのXMLレポートには変数が格納されているので、機密データを削除するためにも使用できます。
自動化開始時にセッション変数を作成するためのCLIオプション --variable-sessionがあります。
概要
Varg set name=<variableName> [value=<variableValue>] [scope=<visibilityScope> ].
赤い色は必須パラメーターを示します
オプション
name==<変数名>
変数名。大文字と小文字を区別し、スペースや等号 ('=') を含めることはできません。
value=<変数値>
– 変数値。
scope=<変数スコープ>
- 視認範囲は以下のいずれかです:
local- 変数は宣言されたコードブロック内でのみ、 例えばFor Statement, If/Else Statementまたは Proceduresでのみ表示されます。
script- 単一のスクリプト内で表示され、すべてのスクリプトがそこから呼び出されます。
session- 同じセッション内のすべてのスクリプトに使用可能。変数は、アプリケーションが終了するまで存在します。
低いスコープほど優先順位が高くなります。たとえば、ローカル変数は同じ名前のセッション変数を上書きします。スコープが省略された場合、デフォルトは 'script' のものになります。
Varg delete name=<variableName> [scope=<visibilityScope> ]
赤色は必須パラメータです
オプション
name=<変数名>
削除する変数名。大文字と小文字は区別され、空白や等号 ('=') を含むことはできません。
scope=<変数のスコープ>
- 可視性のスコープで、「local」、「script」、「session」のいずれかを指定します。スコープが省略された場合、コマンドはすべてのスコープにわたって指定された名前の変数をすべて削除します。
戻り値
Varg コマンドは常に 0 (ゼロ) を返します。
例
Varg set name="S" value="Hello" scope="session"
S'というセッション変数を作成または設定する。
Varg delete name="S" scope="session"
前の例で作成したセッション変数を削除します。ローカルまたはスクリプト・スコープに存在する同名の他の変数はすべてそのままにしてください。