テーブル

このトピックでは、Tosca Cloudを使用してテーブルを操縦する方法について説明します。

以下のアクション モードを使用して、テーブル内の列、行、セルを操縦します。

アクションモード

説明

入力

<value>

値の入力

確認する

<value>, <property>

値またはプロパティの検証

制約

<value>

これにより、検索が制限されます。

バッファ

<buffer name>, <property>-><buffer name>

セル、行、または列の値をバッファリングします。

Exclude

{TableCompare}

ベースライン比較から行および列を除外する。

アクションモードSelectを使用して、テーブルを選択します。

テーブルでアクションモードConstraintを使用する場合、値の比較時にスペース、タブ、改行は無視されます。

セルに対してアクションモードInputを使用する場合、値はCLICKのみ使用できます。セルに他のInput値を使用するには、埋め込みコントロールを作成する必要があります。

一般的なプロパティに加えて、以下のプロパティを検証できます。

プロパティ

説明

利用可能

ColumnCount

テーブルの列数。

テーブル

RowCount

テーブルの行数。

テーブル

ColumnNumber

選択された列のインデックス。ヘッダーカラムの値は0で、残りのカラムのインデックスはこのカラムからの相対値です。

RowNumber

選択されている行のインデックス。ヘッダー行の値は0で、残りの行のインデックスはこの行からの相対値です。

RawColumnNumber

選択された列のインデックス。常に1で始まります。

RawRowNumber

選択された行のインデックス。常に1で始まります。

ResultCount

指定した内容(Constraint)を含むテーブル内のセルの数。以下のことに注意してください。

  • このプロパティは、テーブルでヘッダとして設定したセルを無視します。一致するヘッダーを結果数に含めたい場合は、テーブルのヘッダーを適切に再構成してください。

  • テーブルコントロールは、アクションモードSelectを使用する必要があります。

  • 検索対象の内容を含むセルは、アクションモードConstraintを使用する必要があります。

  • 結果数を特定の行または列のセルに制限するには、検索対象を含むセルのある行または列に対してアクション モードVerifyを使用します。<Col>または<Row>の値を指定しない場合、Tosca Cloudはテーブル全体をスキャンし、該当する<Cell>に指定されたValueを検索します。

行、列

テーブル構造

テーブルコントロールは、<Col>および<Row>属性から構成されています。各行または列には複数の<Cell>属性を含めることができます。

行、列、セルは対応する属性名を使用して指定する必要があります。それにより、属性名が変更されます。セル内の値はValue列で指定します。

セルの識別には以下のオプションがあります。

 

テーブル属性

説明

Baseline

テーブルコントロールにベースラインが含まれていることを示します。

<Row>

行を識別するために使用可能な値

  • <Row name>: ヘッダーで定義した名前。

  • $1: テーブルの最初の行を操作します。

  • $<Row position>: テーブルの指定された行を操作します。

  • $header: テーブルのヘッダーを操作します。

  • $last: テーブルの最後の行を操作します。

  • $header: テーブルヘッダー内のセルを操作します。

  • $lastContentRow: 値を含む最後のテーブル行を操作します。

  • $firstEmptyRow: 値を含まない最初のテーブル行を操作します。

  • Value列でセルの値を指定します。

接頭辞$は、ヘッダーに対する相対位置で行を操作します。絶対位置に基づいて行を操作するには、接頭辞#を使用します。

<Col>

列を識別するために使用可能な値

  • <Column name>: ヘッダーで定義した名前。

  • $1: テーブルの最初の列を操作します。

  • $<Column position>: テーブルの指定された列を操作します。

  • $last: テーブルの最後の列を操作します。

  • Value列でセルの値を指定します。

接頭辞$は、ヘッダーに対する相対位置で列を操作します。絶対位置に基づいて行を操作するには、接頭辞#を使用します。

<Cell>

行または列の属性内で利用可能な、セルを識別するために使用可能な値

  • <Column or row name>: ヘッダーで定義した名前。

  • $1: テーブルの最初のセルを操作します。

  • $<Cell Position>: 行または列の指定されたセルを操作します。

  • $last: 行または列の最後のセルを操作します。

  • $header: テーブルヘッダー内のセルを操作します。

  • $lastContentRow: 値を含む最後のテーブル行を操作します。

  • $firstEmptyRow: 値を含まない最初のテーブル行を操作します。

  • Value列でセルの値を指定します。

接頭辞$は、ヘッダーに対する相対位置でセルを操作します。行または列における絶対位置に基づいてセルを操作するには、接頭辞#を使用します。

ヘッダーの定義

テーブルコントロールには、HeaderColumnおよびHeaderRow操縦パラメータが含まれています。Tosca Cloudはこれらを自動的に識別し、テクニカルIDとしてモジュールにコピーします。これらのプロパティの値は、ヘッダーとして使用される行または列を指定します。ヘッダーは、値$headerを指定して操作します。

指定されたヘッダー行または列の前に位置する列は、負の行または列番号を使用して制御します。

下の表は、行番号と列番号を用いて該当セルを操縦する方法を示す例です。:

 

 

 

 

 

 

$-2, $-2

 

 

 

 

$-2, 3$

 

$-1, $-1

 

$-1, 1$

 

 

 

$ヘッダー, $-1

$ヘッダー

$ヘッダー,1$

$ヘッダー,2$

 

 

 

 

1$,1$

1$,2$

 

2$, $-2

 

 

 

 

 

 

 

 

 

 

$3, $3

FirstEmptyコマンドおよびLastContentコマンドは、定義されたヘッダー行または列より外側に位置する行や列には使用できません。

セルの値範囲を定義する

Tosca Cloudは、セルの値をパラメータExplicitNameの値範囲としてモジュールにコピーします。これらの名前は、操縦用の入力値となり、列、行、およびセルのテストステップサブ値のドロップダウンメニューから選択できます。

値の定義には、日付と時刻の式、正規表現、およびランダム値を使用できます。

決定列の定義

一部の列には、通貨や日付の値などの標準的なデータのみが含まれる場合があります。これらの列のセルは、必ずしも重要なデータを含むとは限りません。重要なデータを含む列は、Tosca Cloudでは、決定列と呼ばれます。

システムは、具体的な値が入力された行を読み取ることができます。

テーブル属性のDecisiveColumnsパラメータを使用して、1 つ以上の決定列を定義します。複数の値を指定する場合は、セミコロンで区切ります。