set data set value
データセットの列の1つ以上のセルの値を設定します。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
data set | データセットの名前です。( を参照してください) | String | なし |
row | (任意・ を参照してください)セルの行番号です。(行番号は1から始まり、ヘッダー行は除外されます) | String | なし |
column | セルの列番号です。(列番号は1から始まります) | String | なし |
value | セルの内容を設定する値です。 | String | なし |
criterion | (任意・ を参照してください)フィルター条件を確立するブール式( を参照してください)、またはフィルターアクションで定義された名前付きフィルターです。 | String | なし |
なし
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
例・ケース1: 引数 row を使用します
- Customers専用のデータセットの行
1
、列5
の Address に新しい値1 Smith Lane
を追加します。 - 専用のデータセットで確認します。
data set row column value criterion
set data set value /Customer info/Customers 1 5 1 Smith Lane
 
data set path comments
check in data set /Customer info/Customers
結果
例・ケース2: インラインデータセット
data set row column value criterion
set data set value /Customer info/Customers 3 Patti CustID="04"
 
data set path comments
check in data set /Customer info/Customers
結果
- data set引数は、テスト内で既に定義されている dedicated data set または inline data set を指定することができます。
- dedicated data setの場合: Data ノードからのTAフルパスを指定する必要があり、階層ごとにスラッシュ(/)で区切ります。
- inline data setの場合: データセットの名前だけ(パスなし)が必要です。
- row, criterion
引数: これらの引数のうち、どちらか一方は必須ですが、両方を指定することはできません。両方を指定した場合、criterion
引数は無視されます。これらの引数のそれぞれは、セルを変更するための行を選択する責任があります。(criterion 引数の場合、複数の行が選択されることもあります)
- フィルターが適用されると、引数 criterion 内式に適用した際に True を生成しない値を持つデータセットの行はフィルタリングされます。例えば、 criterion が
region = 2 and period >= 2002
に設定されている場合、フィルターは region が 2 でない行と、period が 2002 より前の行を除外します。 次の演算子は、引数 criteria の内式で使用できます:
表1. 比較演算子優先 比較演算子 意味 4 = 等しい 4 <> 等しくない 4 > より大きい 4 >= 以上 4 < より小さい 4 <= 以下
表2. 論理演算子優先 論理演算子 意味 5 not オペランドが FALSE の場合、値は TRUE です。 6 and and 演算子の両側が TRUE の場合にのみ、値は TRUE です。 7 or or 演算子のどちらか一方の側が TRUE の場合、値は TRUE です。 注意:演算子の優先順位の完全なリストについては、 こちらを参照してください。
- フィルターが適用されると、引数 criterion 内式に適用した際に True を生成しない値を持つデータセットの行はフィルタリングされます。例えば、 criterion が
- rowの値が現在のデータセットの行数を超える場合、データセットには行がrow行になるまで空の行が追加され、その後に指定されたセルの値が設定されます。
- データセットがインラインの場合、追加された全てのデータはメモリに格納されます。
- データセットがモジュールである場合、データセットは最初にchecked
outされ(それがまだその状態でない場合)、その後変更されます。チェックアウトのプロセス中に、以下のいずれかの条件が満たされている場合、TestArchitect は警告/エラーを発行します:
- データセットが現在、別のユーザーによってチェックアウトされている場合。
- 現在のユーザーにはデータセットを変更する十分な権限がない場合。 このアクションの実行後、データセットの変更が実際に使用される前に、アクション check in data set を使用することを強くお勧めします。これにより、データセットへの全ての変更が実際に使用される前に利用可能になります。
- このアクションは <ignore>
修飾子をサポートしています。引数のいずれかの値として文字列
<ignore>
が含まれているか、或いはどの引数かが<ignore>
に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。