HeartCore Robo Desktop Docコレクション

30/08/19

HeartCore Robo Desktop 設定ガイド

1.クライアントのシステム要件

1.1 Javaの要件

• http://www.oracle.com/technetwork/java/javase/downloads/index.html

1.2 JDKのインストールと設定

1. HeartCore Robo Desktop GUI のファイル - >新規テストスクリプト - > Javaテストスクリプトを使用して、新しいJavaテストスクリプトを作成します。
2. エディタを右クリックし、[ コンパイル ]を選択します。
3. HeartCore Robo Desktopは、インストールされているJDKパッケージの既知のパスを検索します。JDKが見つかった場合、コンパイルは成功し、エラーは報告されません。それ以外の場合は、プリファレンスウィンドウに進むメッセージが表示され、JDKのインストールパスまたはjavacコンパイラの場所を手動で設定できます。
4. 自動設定をキャンセルするか、別のJDKに切り替える必要がある場合は、「編集」 - >「設定」 - >「Javaテストスクリプトの解釈」パネルでパスを再構成する必要があります。
   

1. オプション1：<JDK_dir>\bin パスをシステムパスに置きます。これにより、OSはすべてのJavaアプリケーションのデフォルト解釈としてJDKを使用します。
   

1. Windowsエクスプローラを起動し、コンピュータノードを右クリックし、コンテキストメニューで[ プロパティ ] を選択します。
   
2. [詳細設定] タブまたは項目 (Windows のバージョンによって異なります) に移動し、環境変数を選択します。
3. Path システム変数を編集し、パスを JDKのbin /ディレクトリに続けて、パスの先頭にセミコロン（通常は「C：¥Program Files¥Java¥jdk1.6.0_ <version>¥bin;」）を入力します。
4. 変数を保存し、OKですべてのウィンドウを閉じます。 
5. コマンドプロンプトを開き、javac と入力します。コマンドが見つかり、サポートされているパラメーターを出力する必要があります。

1. HeartCore Robo Desktop Windowsインストーラ（.exeまたはファイルを含むZIP .exeファイル）。このパッケージはMS Windowsにインストールするだけで、ソフトウェアを標準のWindowsプログラムとして管理することができます。また、Robotを.tprテストスクリプトファイル拡張子に関連付けます。インストーラは、デフォルトでこのツールをC:\Program Files (x86)\HeartCore\Roboディレクトリにインストールします。
2. HeartCore Robo Desktop Mac OS Xアプリケーション（.dmg またはファイルを含むZIP .dmgファイル）としてパッケージ化されています。このパッケージはApple Mac OS Xにのみインストールできます。Mac OSで製品をインストールするには 、システムがダウンロードしたファイルを開いた後に、HeartCore Robo DesktopアプリケーションをApplicationsにドラッグします。
   
3. HeartCore Robo Desktop ZIPファイル。必要なすべてのファイルを含む独立したプラットフォームに依存しないZIPアーカイブです。インストーラはありません。WindowsやMac OSを含むすべてのプラットフォームで使用できます。ファイルをハードドライブのフォルダに解凍するだけです。アーカイブには、少なくとも次のファイルが含まれている必要があります。
   

ファイルベースのキーは、v4.2以前のバージョンとの下位互換性のために維持されています。これらは、サーバーが適切でない場合にのみ新しい契約のために提供されます。キーは.tlic 、次のようなライセンスの詳細を含む拡張子を持つ暗号化されたファイルです。

• 有効期限。このプログラムは、契約に応じて期限が決定されます。
  
• シート数（ユーザ）とライセンスされたSUT接続数。この製品は「1人当たり」のライセンスを受けています。詳細については、インストールフォルダにあるLICENSE.txtファイルの第2章を参照してください。
  

HeartCore Robo Desktopライセンスを購入する際には、1つまたは複数のライセンスキーも受け取る必要があります。セキュリティ上の理由から、ファイルは、HeartCore Robo Desktopの販売代理店からの電子メールなど、製品とは別にお客様に配送される場合があります。インストールにはいくつかの方法があります：

1. キーファイルをHeartCore Robo Desktopインストールディレクトリ（robot.jarファイルがある場所）に保存します。 ツールは起動時にライセンスキーファイルのフォルダをチェックするので、すぐに取得されます。インストールディレクトリには、任意の数のライセンスファイルが存在することがあります。
   
2. または、キーファイルをハードドライブ上のカスタムの場所に保存し、License Key Managerを利用して登録します。Managerを開くには、GUIモードでHeartCore Robo Desktopを起動します（カスタムCLI引数なし）。有効なライセンスがインストールされていない場合、ツールには「ライセンスなし」というエラーメッセージが表示され、License Key Managerを起動できます。既に有効なライセンスがインストールされている場合は、[ツール] - > [ライセンスキーマネージャ] メニュー項目。次に、登録されたライセンスキーのリストにファイルを追加します。そのようなファイルのリスト（インストールディレクトリ以外のキーを意味する）は、ユーザー設定のリストに保存され、ユーザー設定ファイルもコピーしない限り、移行中に失われる可能性があることに注意してください。ライセンスキー構成を変更するには、製品を再起動する必要があります。
3. --licensekey CLIオプションを使用してキーパスを指定します。
   
4. Robotをサードパーティ製のJavaフレームワークおよび/またはアプリケーションに統合するソリューションでは、ライセンスキーパスまたはセミコロンで区切られたパスのリストをrobot.licenseKey システムプロパティで指定できます。ApplicationSupport クラスがインスタンス化される前に実行する必要があります。このオプションはv4.0.3から利用可能です。例：

   System.setProperty("robot.licenseKey","C:\\MyData\\robot.tlic");
...
ApplicationSupport robot = new ApplicationSupport();

ファイルベースのキーは自由に組み合わせることができます。つまり、ファイルがインストールフォルダにあるのか、外部にあるのかにかかわらず、任意の数のライセンスキーを一度にインストールすることができます。接続数は、インストールされているすべての有効なライセンスのライセンス付き接続の合計に等しくなります。このシステムでは、スケールアップが必要なときに、追加のライセンスを購入して製品に簡単に接続することができます。

1. GUIのツール-> アップデート＆アップグレードを選択します。ロボットの書き込み権限が不十分な場合は、管理者権限で再起動してください。
• Windows：
  
• 代替1：   管理者としてログインし、ロボットを再起動します。
  
• 代替2：   管理者権限を持つユーザーとしてログオンしている場合 は、Windowsメニューの[アクセサリ ] - > [コマンドプロンプト ]を右クリックし、[ 管理者として実行 ]を選択します。次に、コマンドラインのインストールフォルダに切り替えて、Robotを実行します。
  
• Windows 32ビット：    

1. 必要なスタンドアロンのクロスプラットフォームZIPリリースをダウンロードします。あなたはこれらのリソースのいずれかからそれを得るかもしれません：
• [ 更新とアップグレード]ウィンドウの[ ダウンロードと保存 ]ボタンを使用してダウンロードします。
• HeartCore Robo Desktop Releases Support Forumに掲載されているダウンロードリンクに従ってください。
• カスタムビルドまたはプライベートビルドの場合、HeartCore Robo Desktopのスタッフが直接ダウンロードリンクを送信することがあります。
  
2. 製品ファイルを変更またはカスタマイズした場合（たとえば、robot.shまたはの開始スクリプトなどrobot.bat）は、更新プロセス後にバックアップして復元します。影響を受けないため、テストスクリプト、テンプレートイメージ、または構成ファイルをバックアップする必要はありません。
   
3. ZIPアーカイブをインストールフォルダに解凍し、yesと答えてファイルを上書きします。インストールフォルダは、robot.jar ファイルを含むディレクトリです。
• Windowsインストーラー （.exeリリース）を使用して製品をインストールした場合は、アーカイブをC:\Program Files\HeartCore\Robot（またはインストール時に選択したカスタムディレクトリに）解凍します。
• Mac OS Xリリース（.dmg）をインストールしている場合は、アーカイブを解凍して/Applications/TPlanRobot.app/Contents/Resources/Java 
• スタンドアロンのクロスプラットフォームZIPリリースを使用している場合は、前のバージョンを解凍したフォルダにアーカイブを解凍します。
  

• 設定ファイル <home>/.tplanrobot/tplanrobot.cfg と従来のVNCRobotの<home>/config.propertiesの名前を変更するか削除してください。このステップでは、最終的にユーザー設定パラメータの非互換性が解決されます。
• プラグインマップファイルの 名前を変更するか、削除してください<home>/.tplanrobot/PluginMap.xml。この手順は、プラグインクラスの欠落による最終的なダウングレードエラーを解決します。
  

6.アンインストール

7.スタートアップ

MS Windows ：

• windowsインストーラを使用してロボットをインストールした場合は、windows のスタートメニューから HeartCore Robo Desktopを起動します (C:\Program Files\HeartCore\Robot\robot.bat ファイルを実行します)
• クロスプラットフォームビルドを使用している場合 (解凍 & 実行) インストールフォルダーに切り替えて、robot.batを実行します。
• ロボットの起動コマンドをカスタマイズする必要がある場合は、robot.batファイルを編集し、そこにある2つのjava呼び出しを更新する必要があります。または、コマンドプロンプトから直接javaを実行します (下記参照)。これは、たとえば、Java 9+で >Android Over ADB接続を介して Android を有効にするために必要な場合があります。

Mac OS X：

• Robot for Mac（.dmg）をインストールした場合は、Mac OS Xメニューから実行します。あるいは、/Applications/TPlanRobot.app/Contents/Java/robot.shファイルを実行します。
  
• クロスプラットフォームビルドを使用している場合 (解凍 & 実行) インストールフォルダーに切り替えて、robot.batを実行します。
• ロボットの起動コマンドをカスタマイズする必要がある場合は、robot.shファイルを編集し、ツールを起動するために使用します。または、コマンドプロンプトから直接javaコマンドを実行します (下記を参照)。

Linux / Unix：

• クロスプラットフォームビルドフォルダに切り替えて、robot.shファイルを実行します。

Linux / Unix：	java -Xmx512m -classpath robot.jar:jh.jar:activation.jar:mail.jar:poi-3.6-20091214.jar:cron4j-2.2.5.jar:gson-2.5.jar:jna-3.5.1.jar:platform-3.5.1.jar:JNativeHook.jar com.tplan.robot.ApplicationSupport <HeartCore Robo Desktop CLI parameters>
MS Windows：	java -Xmx512m -classpath robot.jar;jh.jar;activation.jar;mail.jar;poi-3.6-20091214.jar;cron4j-2.2.5.jar;gson-2.5.jar;jna-3.5.1.jar;platform-3.5.1.jar;JNativeHook.jar com.tplan.robot.ApplicationSupport <HeartCore Robo Desktop CLI parameters>

1. HeartCore Robo Desktopのインストールパスを設定するには、統合リファレンスのT-Plan Professional 7.0の統合の概要の章に記載されているT-Plan ProfessionalのInstalled Extensionsモジュールに移動します。
2. HeartCore Robo Desktopベース開始コマンドを変更する必要がある場合 （カスタムJava環境を使用する場合やJVMによって割り当てられるヒープメモリの量を増やす場合など）は、次の手順を実行します。
1. ロボットの拡張設定ファイルRobotExtn.iniを探します。このファイルは、T-Plan Professional Enterprise GUIからHeartCore Robo Desktopを初めて呼び出すときに作成されます。アプリケーションのデータフォルダに保存され、場所はWindowsのバージョンと構成によって異なります。典型的な経路は：
• Windows XP：  C:\Documents and Settings\<user>\Local Settings\Application Data\T-Plan\Extensions\RobotExtn\RobotExtn.ini
• Windows Vista：  C:\Users\<user>\AppData\Local\T-Plan\Extensions\RobotExtn\RobotExtn.ini
2. ファイルを編集します。これには、それぞれがT-Plan Professional GUIから呼び出された特定のアクションに対応する一連のコマンドテンプレートが含まれています。
   

   実行= java -Xmx256m -cp "％1 \ robot.jar;％1 \ jh.jar;％1 \ activation.jar;％1 \ mail.jar;％1 \ poi-3.6-20091214.jar" com.tplan.robot.ApplicationSupport

3. 必要に応じてコマンドを調整します。上記の例の％1変数は、前の段落で指定した製品のインストールパスに置き換えられます。各コマンドには、T-Plan ProfessionalのCLIオプション値が入力された追加の変数が含まれている場合があります。
   
4. ファイルを保存し、T-Plan Professionalを再起動して変更を適用します。

• 「スタートアップ」の章で説明しているようにJavaを直接呼び出す場合は、使用するコマンドを変更してください。
  
• robot.shまたはrobot.batスクリプトを利用してロボットを起動する場合は、スクリプトを編集してそこのjava起動コマンドを変更してください。
  
• Windowsの[スタート]メニューからロボットを起動する場合は、メニュー項目に関連付けられているコマンドを更新します。
  
• T-Plan Professionalからロボットを起動する場合は、ロボットの起動コマンドでWindows INIファイルを見つける場所については、T-Plan Professionaとの統合の章を参照してください。
• robot.jarファイルをダブルクリックしてロボットを起動する場合は、代わりにスクリプトの使用を開始してください。JARファイルを起動すると、OSはデフォルトのヒープサイズ（通常は128MB）でプログラムを実行します。
  

2. ロボットが OutOfMemoryError で失敗すると、ヒープサイズを上げる必要があります。java (または javaw) コマンドの後の-Xmx パラメータは、java 仮想マシンが最大で使用できるヒープメモリの量を示します。この数値を高い値に上げます。たとえば、-Xmx512m を使用すると、必要に応じて JVM ヒープを512mb まで拡張できます。この制限は、メモリがすぐに割り当てられることを意味しません。

3. ロボットが StackOverflowError で失敗した場合、-Xss パラメータを使用してスタックサイズを上げます。構文は、-Xmx 1 と同じです。デフォルトスタックサイズは、通常、x86 システムの場合は384k と512k、x64 の場合は1mb の間になりますが、通常は、スタックメモリを x86 (-Xss1m) の1mb に、または x64 (-Xss2m) で2mb に増やすだけで十分です。
   

• Java は約2倍以上を割り当てることはできません。32ビットシステム（x86）で1GBのメモリ これは2つの要因によって引き起こされます。Javaでは、ヒープに連続した（中断のない）メモリのチャンクが必要です。ほとんどの32ビットシステムでは、2GB以上のRAMを直接扱うこともできません。OSが大量のメモリを消費するため、Javaがこのような環境で割り当てることができる最大の連続領域は、通常約1GBです。
  

• 十分な量の物理RAMを備えた64ビットシステム（OSとJavaの両方が64ビットである）では、より大きなメモリを必要とする配備が推奨されています。Robotアプリケーションは、64ビットJVMで32ビットのメモリより2倍のメモリを占有することに注意してください。これは、ほとんどのメモリを占めるすべての参照（ポインタ）が2倍のサイズ（64ビットが32ビットに反対）であるためです。このような観点から、1GBのRAMを搭載した32ビット環境から2GBのRAMを搭載した64ビットのRAMにロボットを移動させることは、アプリケーションが余分なメモリを割り当てることができないため、あまり意味がありません。そのような場合は、x64システムと32ビットJavaインストールを併用する方が良いかもしれません。
  

• 開いているスクリプトエディタの数は最低限に抑えてください。通常、一度に数十のスクリプトを編集する必要はありません。

• 画面上のコンポーネントを検索するための "search2"画像比較方法を推奨します。これは、従来の「検索」よりもはるかに低いメモリ要件を備えています。
  

• テストスクリプトがスクリーンショット、ログ、警告またはテストステップなどの多くの出力オブジェクトを作成する場合は、レポートコールをスクリプトの最後に移動します。途中でXML / HTMLの結果が何世代にもわたってくることを避けることができるため、メモリの消費を大幅に削減し、メモリ消費を抑えることができます。この手順は、最終レポートの内容には影響しません。

• デフォルトの"Graphite"ルックアンドフィール（LAF）はきれいに見えますが、CPUとRAMも多く消費されます。 プリファレンス ウィンドウの外見＆アクセシビリティ パネルに移動し、LAFを最初のOSのデフォルト値に設定すると（ロボットを再起動する必要があります）、パフォーマンスが大幅に向上することがあります。

• ロボットは、デフォルトで、Result ManagerおよびT-Plan Ltdへのエクスポート ウィザードのニーズに合わせて、最新のスクリプトを最大20件まで実行します。GUIモードで大量のスクリプトを大量に実行した場合、結果マネージャの [最近のリストを制限する]の設定でこの制限値を低く設定してくださいプリファレンス（環境設定）ウインドウのパネルで少し余分なメモリが得られるかもしれません。

• プロダクション自動化は、CLIモードで実行することをお勧めします。これはGUIを回避し、メモリ要件が非常に低くなります。詳細については、-n CLIスイッチのマニュアルを参照してください。
  

• サーバーのデスクトップの背景を、エンコーディングによって効率的に圧縮できる単色に変更します。画像または写真は、ネットワークを介して転送される画像データの量を著しく増加させます。
• ループ内の写真を表示している時計やガジェットなど、不要な動的更新オブジェクトをデスクトップからすべて削除します。これらのコンポーネントは、デスクトップの頻繁な更新の原因となり、ネットワークトラフィックを増加させます。
  
• 可能であれば、異なるプロデューサーからサーバーを試してください。一部の製品には、パフォーマンスを向上させるカスタムビデオドライバまたはフックアップが付属しています。
• 適切なリモートデスクトップサイズ（解像度）を使用してください。画像データの量はデスクトップサイズに比例します。
  

10.トラブルシューティング

マシンにJavaがインストールされていないか、Java実行ファイルのパスがOSパスに含まれていません。 このドキュメントのクライアントシステム要件の章を読んでください。

HeartCore Robo Desktopは、「スレッド内の例外」メイン「java.lang.NoClassDefFoundError：com / tplan / robot / ApplicationSupport」というメッセージで開始できません。

これは、HeartCore Robo Desktop JAR（Java ARchive）ファイルrobot.jarがJavaクラスパスに正しく含まれていないことを示します。

• HeartCore Robo Desktopインストールディレクトリに切り替え、robot.jarファイルが存在し、そのファイルを読む権限があることを確認します。
• このディレクトリから robot.shまたはrobot.batを再実行します。または、このライブラリを-classpath引数に含めるように javaコマンドを変更します。
  

HeartCore Robo Desktopが起動しますが、「JavaHelpライブラリが見つかりません。ファイルjh.jarがJavaクラスパスに含まれていることを確認してください」というメッセージが表示されます。

これは、JavaHelp JARファイルjh.jarがJavaクラスパスに正しく含まれていないことを示します。ツールは実行されますが、オンラインヘルプにアクセスすることはできません。ただし、Webブラウザで開いているリンクの中にはうまくいくものもあります。すべてのヘルプ文書は、http://www.heartcorerobo.com/hcrobodesktop/docsからオンラインで入手できるため、オンラインマニュアルに切り替えてこのエラーを無視することができます。それを解決するには：

• HeartCore Robo Desktopインストールディレクトリに切り替え、jh.jarファイルが存在し、そのファイルを読む権限があることを確認します。
• このディレクトリから robot.shまたはrobot.batを再実行します。または、このライブラリを-classpath引数に含めるように javaコマンドを変更します。

HeartCore Robo DesktopがNoClassDefNotFoundError、NoSuchFieldErrorまたは他の重大なJavaエラーで起動できない

上記のケースのいずれかが当てはまる場合を除き、これらの問題は通常、必要なバージョンより低いバージョンのJavaを使用すると発生します。 必要なJavaバージョンについては、「クライアントシステム要件」の章を参照して、java -versionコマンドで インストールしたバージョンを確認してください。

スクリプトrobot.sh またはrobot.batスクリプトのいずれかがCLIオプションを渡さない

HeartCore Robo Desktopがjava.lang.OutOfMemoryErrorでクラッシュする