Excel モジュール

Excel 用のテクノロジー固有モジュールは、特定のタスクを実行する標準モジュールです。

Excel ブックを開く

Excel ブックなどの Excel ファイルを開きます。各ワークブックには複数のワークシートを含めることができます。

値	説明
ワークブック名	ワークブックの名前です。任意の名前を使用できます。
パス	開きたい Excel ファイルのフルパスを、ファイル名と拡張子を含めて指定します。
新規作成	新しいExcelファイルを作成するかどうかを指定します。以下の値を使用できます。 False: 新しいファイルを作成しません。これはデフォルト値です。 TRUE: 新しいファイルを作成して開きます。システムはファイルをメモリ上に作成します。ファイルは、後でClose/Save Excel Workbookモジュールを使用して保存できます。
パスワード	パスワードで保護されたワークブックの任意のパスワード。
Open as Read-only	ファイルを読み取り専用モードで開くかどうかを指定します。 False：読み取り専用では開きません。これはデフォルト値です。 TRUE: 読み取り専用で開きます。
区切り文字	オプションMicrosoft Office の言語パックが原因で、Tosca Cloud が Excel でファイルを開いても列が変換されない場合に、このパラメータを使用します。たとえば、一部のロケールでは CSV ファイルで , の代わりに; を使用します。どの区切り文字を使用するか指定してください。現在のシステムの区切り文字を使用するようにシステムを設定します。 Excel の現在の設定で定義されている区切り文字を使用するようにOfficeを設定します。または、CSV ファイルで値を区切る文字を入力することもできます。

Excel 範囲を定義

操作したいデータ範囲を定義します。特定のデータ範囲を操作したいテストケースでは、この手順が必須です。

値	説明
Workbook Name	定義したワークブックの名前。
Worksheet Name	データを含むExcelワークシートの位置または名前。インデックス内でのワークシートの位置で識別する場合は、$<number> を入力します。たとえば、3 番目のワークシートを識別するには $3 を使用します。ワークシートを名前で識別するには、正確な名前を入力します。これはワークブックの名前と完全に一致しなければなりません。
範囲名	操作したいデータ範囲の名前です。任意の名前を使用できます。
データ範囲	Excelのデータ範囲をどのように定義するかを指定します。 Explicit: 開始セルと終了セルに基づいて範囲を手動で定義します。データ範囲→開始セルとデータ範囲→終了セルの両方に、対象となるセルを正確に指定して行います。 Used Range：ワークシート内で現在使用されている範囲に基づいて、Excel が自動的に範囲を定義します。指定した範囲は、ColumnCount、RowCount、ColumnNumber、RowNumber、ResultCount の各プロパティ値の計算方法に影響します。
読み取り専用で開く	ファイルを読み取り専用モードで開くかどうかを指定します。 False：読み取り専用では開きません。これはデフォルト値です。 TRUE: 読み取り専用で開きます。
区切り文字	オプションMicrosoft Office の言語パックが原因で、Tosca Cloud が Excel でファイルを開いても列が変換されない場合に、このパラメータを使用します。たとえば、一部のロケールでは CSV ファイルで , の代わりに; を使用します。どの区切り文字を使用するか指定してください。現在のシステムの区切り文字を使用するようにシステムを設定します。 Excel の現在の設定で定義されている区切り文字を使用するようにOfficeを設定します。または、CSV ファイルで値を区切る文字を入力することもできます。

Excel ワークシートを作成

既存の Excel ファイルに新しいワークシートを作成します。

値

説明

Workbook Name

定義したワークブックの名前。

ワークシート名

ワークシートの名前です。

ワークシート順序

システムがワークシートを追加する位置を指定します。次の値を入力できます。

位置を示す数字。例えば、「3」と入力すると、ワークシートがExcelファイルの3番目のシートとして作成されます。
値に「first」、「0」、または負の数を指定すると、ワークシートがExcel ファイルの最初のシートとして作成されます。
値に last、または既存のワークシート数より大きい数値を指定すると、ワークシートは Excel ファイルの最後のシートとして作成されます。

Excel ワークシートを削除

既存の Excel ファイル内のワークシートを削除します。

値

説明

Workbook Name

定義したワークブックの名前。

Worksheet Name

削除するExcelワークシートの位置または名前。

インデックス内でのワークシートの位置で識別する場合は、$<number> を入力します。たとえば、3 番目のワークシートを識別するには $3 を使用します。例えば、3枚目のワークシートを識別するには「3$」とします。
ワークシートを名前で識別するには、正確な名前を入力します。これはブック内の名前と完全に一致している必要があります。

ワークシートを更新

既存の Excel ファイル内のワークシートを更新します。

価値	説明
Workbook Name	定義したワークブックの名前。
現在のワークシート名	削除する Excel ワークシートの位置または名前です。インデックス内でのワークシートの位置で識別する場合は、$<number> を入力します。たとえば、3 番目のワークシートを識別するには $3 を使用します。例えば、3枚目のワークシートを識別するには「3$」とします。ワークシートを名前で指定する場合は、正確な名前を入力します。これはブック内の名前と一致している必要があります。
新しいワークシート名	ワークシートに付ける新しい名前。
新しい順序	システムがワークシートを移動する位置を指定します。次の値を入力できます。位置を示す数字。例えば、「3」と入力すると、ワークシートがExcelファイルの3番目のシートとして作成されます。値に「first」、「0、または負の数を指定すると、ワークシートがExcel ファイルの最初のシートとして作成されます。値に last、既存のワークシート数より大きい数値、または空白を指定すると、ワークシートは Excel ファイルの最後のシートとして作成されます。

Excel 範囲を操作

値	説明
Range Name	定義したデータ範囲の名前。
データ表およびサブ属性	テーブルの要素。Excel ファイル内のデータを、テーブルを操作するのと同じように操作できます。

Excel 範囲をクリア

Excel ファイル内のセル範囲からデータと書式をクリアします。

値	説明
Range Name	定義したデータ範囲の名前です。
内容	指定した範囲の内容を消去するかどうかを指定します。以下の値を使用できます。 False: セルの内容を削除しません。 TRUE : セルの内容を削除します。これはデフォルト値です。
Formats	指定した範囲の書式設定を解除するかどうかを指定します。以下の値を使用できます。 False: セルの書式設定を解除しません。これはデフォルト値です。 True: セルの書式設定を解除します。
Notes and Comments	指定した範囲のメモとコメントを消去するかどうかを指定します。以下の値を使用できます。 False: メモとコメントを消去しません。これはデフォルト値です。 TRUE : メモとコメントを消去します。
Hyperlinks	指定した範囲のハイパーリンクを削除するかどうかを指定します。以下の値を使用できます。 False: ハイパーリンクを削除しません。これはデフォルト値です。 True: ハイパーリンクを削除します。
アウトライン	指定した範囲からメモとコメントをクリアするかどうかを指定します。次の値を使用できます。 False：アウトラインを消去しません。これはデフォルト値です。 TRUE ：アウトラインを消去します。

Excel マクロを実行

既存の Microsoft Excel マクロを Excel ファイル上で実行します。

値	説明
ワークブック名	定義したブック名です。
マクロ名	実行する Microsoft Excel マクロの名前です。
タイムアウト	マクロの実行を許可する最大時間（ミリ秒単位）。このしきい値に達すると、実行中のマクロは終了し、テストステップは失敗します。

Excel ブックを閉じる／保存

開いているブックを閉じます。

値	説明
ワークブック名	定義したブック名です。パスを指定する場合、ワークブック名を指定する必要はありません。
パス	閉じるまたは保存する Excel ファイルのフルパス（ファイル名と拡張子を含みます）。ワークブック名を提供した場合、パスを指定する必要はありません。
操作	以下のうち、実行する操作の種類を指定します。 Excel ファイルを保存します。 Excel ファイルを保存して閉じます。 Excel ファイルを閉じます。
Save Path	ファイルを保存する場所への、ファイル名と拡張子を含む絶対パス。パスを指定しない場合、Tosca Cloud が既存のファイルを上書きします。
種類を指定して保存	ファイルを保存する際のファイル形式です。これは Save Path と併せて使用する場合にのみ機能します。Save Path が空の場合、 Tosca Cloud は、選択した Save As Type の値を無視します。 Save Path を指定し、Save As Type を空のままにした場合、Tosca Cloud は既存ファイルのファイル形式を使用します。ファイル破損を防ぐため、Save Path に指定するファイル拡張子は、選択した拡張子と一致している必要があります。

Excel 1:1 ファイル比較

2 つの Excel ファイルのセル内容、セルの書式設定、およびオブジェクトを比較します。

値	説明
Reference File	参照Excelファイルへの、ファイル名と拡張子を含む完全なパス。
Reference Password	参照ファイルがパスワードで保護されている場合に、パスワードを入力します。
Target File(s)	Reference File と比較するファイルを指定します。
ターゲットファイルのパスワード	ターゲットファイルを復号するためのパスワードです。複数のパスワードを指定する場合は、セミコロン（;）を区切りとして使用してください。さらに、以下のことに注意してください。パスワードの数は、ターゲットファイルとして指定するファイル数と一致している必要があります。フォルダパスをターゲットファイルとして指定した場合、指定した各フォルダ内のすべてのファイルに同じパスワードが適用されます。
セルデータを含める	セル内容をデフォルトで比較したくない場合は、値に False を入力します。
書式を含める	セルの書式設定を比較したい場合は、値「 TRUE 」を入力します。非常に大きな Excel スプレッドシートを扱っている場合、このオプションはテストのパフォーマンスに悪影響を及ぼす可能性があります。セルの書式設定が使用目的に関係する場合にのみ、これを TRUE に設定することを推奨します。
オブジェクトを含める	画像、図形、グラフなどのオブジェクトの種類を比較する場合は、値に TRUE を入力します。
シートを含める	Excelファイルに複数のデータシートがある場合、比較に使用する参照ファイルのシートを定義することができます。そのためには、シート名をセミコロン（;）で区切って入力してください。すべてのシートを比較する場合は、この値を空のままにします。
Output Path	結果をテキストファイルに保存する場合は、このファイルへの、ファイル名と拡張子を含む完全なパスを入力します。
Abort after Differences	オプションで、比較を停止してテストを失敗させるファイル内の差分数を指定します。これは、特に大きな参照ファイルやターゲットファイルの場合でも、比較処理全体の完了を待つ必要がないことを意味します。数値を指定しない場合、Tosca Cloud は完全な比較を実行し、すべてのファイル差分を報告します。