このコマンドファミリでは、アップロード ファイル コントロールの操作が可能です。「
FileUpload コマンドの例」を参照してください。 [ File Upload Base Path ] プロパティと組み合わせて使用できます。
ページ上のコントロール用にファイルをアップロードできます。
パラメーター:
- ControlName: ナレッジベース内で定義されているコントロールの名前
- FileName: アップロードするファイルのパス
例:
&driver.FileUpload("&blobVar", "pathToFile/fileName.extension")
ページ上のグリッド内にあるコントロール用にファイルをアップロードできます。
パラメーター:
- ControlName: ナレッジベース内で定義されているコントロールの名前
- Row: グリッド内の行番号
- FileName: アップロードするファイルのパス
例:
&driver.FileUpload("&blobVar", 2, "pathToFile/fileName.extension")
このコマンドでは 4 つの HTML セレクターを使用できます: ID、Name、CSS、および XPath。
ID を使用してファイルをインプット ファイル エレメントにアップロードできます。
パラメーター:
- ID: ターゲットのインプット ファイル エレメントの ID
- FileName: アップロードするファイルのパス
例:
&driver.FileUploadByID("fileUploadID", "pathToFile/fileName.extension")
name 項目属性を使用してファイルをインプット ファイル エレメントにアップロードできます。
パラメーター:
- Name: ターゲットのインプット ファイル エレメントの名前
- FileName: アップロードするファイルのパス
例:
&driver.FileUploadByName("fileUploadName", "pathToFile/fileName.extension")
CSS セレクターを使用してファイルをインプット ファイル エレメントにアップロードできます。
パラメーター:
- CSS: ターゲットのインプット ファイル エレメントの CSS セレクター
- FileName: アップロードするファイルのパス
例:
&driver.FileUploadByCSS("#vATTACHEBLOB", "pathToFile/fileName.extension")
XPath セレクターを使用してファイルをインプット ファイル エレメントにアップロードできます。
パラメーター:
- XPath: ターゲットのインプット ファイル エレメントの XPath セレクター
- FileName: アップロードするファイルのパス
例:
&driver.FileUploadByXPath("//* [ @id='vATTACHEBLOB' ] ", "pathToFile/fileName.extension")
この新しいコマンドに加え、FileUploadBy コマンドでファイル名または相対パスのみを使用する場合、GXtest がファイルを選択する際に使用するベースフォルダを設定するのに便利な、別の新規コマンドがあります。
FileUpload コマンドで FileName パラメーターに相対パスが指定されている場合に、アップロードするファイルを検索する既定のベースディレクトリーを設定します。
パラメーター:
- FileName: テスト用リソースが配置されているディレクトリーのパス
例:
&driver.SetFileUploadBasePath("C:\\testingFiles\\")
&driver.FileUploadByName("fileUploadName", "fileName.extension")
注:
- ファイルアップロードのベースパスは対応する環境レベルのプロパティによって自動的に設定されますが、特定のテストにこのコマンドを使用することもできます。
- [ File Upload Base Path ] プロパティ、SetFileUploadBasePath および FileUploadBy コマンドは、設定したパスが有効かどうかは検証しません。そのため、ファイルが正しくアップロードされたかどうかを確認する検証 (アサーション、GetValue、Verify、Contains、EndsWith など) を実行する必要があります。次に例を示します:
&driver.FileUploadByName("fileUploadVar", "C:\testingResources\userForm.pdf")
if (&driver.GetValueByName("fileUploadVar").EndsWith("userForm.pdf"))
//ファイルは正常にロードされました
else
//ファイルはロードされていません
endif