ソースコードを使用したテスト作成 / ユーザーコードコレクション
![](https://sp-ao.shortpixel.ai/client/to_webp,q_glossy,ret_img,w_1024,h_598/http://3.113.231.48/wp-content/uploads/2020/06/図1-1024x598.png)
Ranorexでソースコードを使用する方法の1つとして、ユーザーコードコレクションがあります。 ユーザーコードコレクション は、専用のソースファイルにコーディングをおこないます。また以下の特徴があります。
- 作成したソースファイル(メソッド)は、User codeアクションを使用することで、他のアクションのようにアクションテーブルにてソースコードを呼び出して実行できます。
- どのレコーディングモジュールからでも、ソースコードを呼び出すことができます。
ユーザーコードコレクションによるコーディング方法
① Ranorex Studioのプロジェクトビューにて、プロジェクトを右クリックし、ショートカットメニューから、追加 – ファイルを選択します。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図1-1.png)
② 表示された新しいファイルの追加画面にて、Ranorex – User code collectionを選択し、ファイル名(任意)を指定後、作成ボタンをクリックします。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図1-3.png)
③ プロジェクトビューにユーザーコードコレクションのソースファイルが追加され、ソースファイルの内容が表示されます。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図2-1-1024x608.png)
④ ソースファイルに定義されたクラス内で右クリックをおこない、ショートカットメニューから新しいメソッドの追加を選択します。(下図では、コメントの後に空行を追加し、空行の上で右クリックをおこなっています)
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図3-1.png)
⑤ 表示されるユーザーコードメソッドの追加画面にて、メソッド名(任意)を入力し、OKボタンをクリックします。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図4.png)
⑥ クラス内にメソッドが追加され、 そのメソッド内にコーディングをおこないます。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図5-1024x537.png)
※Ranorex ユーザーガイド(コードサンプル)にて、幾つかのサンプルコードによる解説が載っています。
※Ranorexが提供するAPIについては、Ranorex Studioのヘルプメニューある、API ドキュメントで参照できます。
⑦ レコーディングモジュール内で、User codeアクションを使用することにより、 作成したメソッドを呼び出すことが可能です。レコーディングモジュールの新しいアクションの追加のプルダウンメニューから、ユーザーコード(User code)‐ライブラリから選択を選択します。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/04/図6.png)
ライブラリから選択にて、作成したメソッド名が表示されます。使用したいメソッドを選択後、選択項目を追加ボタンをクリックすることで、User codeアクションとしてアクションテーブルに追加できます。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図6-1024x604.png)
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図7.png)
※ユーザーコードと同様に、 ソースコード内のメソッドにsummaryタグを使用することで、ライブラリから選択の説明欄にメソッドの説明を表示できます。
![](http://ranorex.techmatrix.jp/wp-content/uploads/2020/05/図8-1024x664.png)
まとめ
ユーザーコードコレクションは、どのレコーディングモジュールからでも使用できる汎用的なソースコードを記述したい場合に役立ちます。 また、作成されたユーザーコードコレクションを使用する人は、プログラムの知識を必要とせず、Ranorexが提供するアクションと同様に使用できます。