オペレータおよびアイコン › オペレータ › Java および外部 JAR › Java コードの実行オペレータの設定

Java コードの実行オペレータの設定

Java コードの実行オペレータから、外部の Java Archive （JAR）ファイル内のクラスを呼び出すことができます。 Java コードの実行オペレータは、オペレータ レベルおよびモジュール レベルの両方の JAR を使用できます。 また、モジュール レベルの設定に優先するように、Java コードの実行オペレータを設定することもできます。 オペレータを使用して、既存の Java コードで提供される機能を活用します。

以下の手順に従います。

1. まだ Java モジュールを設定していない場合は、最初にこのタスクを完了します。 「Java モジュールの設定」を参照してください。
2. Java コードの実行オペレータを設定します。

   Java コードの実行オペレータによって使用される外部 JAR へのパスを指定します。 各パスで、次のように入力できます。

   • オーケストレータまたはエージェントが実行されているホスト上に存在する JAR ファイルへのフル パス。 フル パスは次のいずれかのスラッシュ記号で始まります。

     /
     

     ¥¥
     
     

     また、1 文字の後にコロン（:）が続き、次に残りの文字列が続く正規表現を（ドット表記を含む）を使用することもできます。

     ^.:.* 
     

   • JAR ファイルへのフル パスは、http:// または https:// 経由で利用できます。 パスは認証を必要とせず、HTTP プロキシを介したアクセスを行うことはできません。
   • CA Process Automation ユーザ リソース フォルダに存在する JAR ファイルへの相対パス。

   フル パスを指定しない場合、アプリケーションは入力されたパスを相対パスとして認識します。

   オペレータは、このフィールドにリスト表示された JAR をロードし、実行中のオペレータの Java コードで利用できるようにします。 これらの JAR で定義されたクラスは、モジュール レベルの JAR で指定された同じクラスよりも優先されます。

3. 外部 JAR に加えて、Java コードの実行オペレータの任意の .class ファイルへのパスを入力します。
   1. 無名のパッケージ内の .class ファイルについては、.class ファイルが含まれるディレクトリで終了するパスを入力します。 たとえば、MyAccount.java がパッケージに属さず、MyAccount.class が次の場所にあるとします。

      C:¥java¥tests¥MyAccount.class
      

      以下のパスを使用するように、オペレータを設定します。

      C:¥¥java¥¥tests
      

   2. 名前付きのパッケージ内の .class ファイルについては、ルート パッケージが含まれるディレクトリで終了するパスを入力します。 ルート パッケージは、完全なパッケージ名の最初のパッケージです。 たとえば、MyAccount.java がパッケージ com.ca.tech に属し、MyAccount.class が次のパスにあるとします。

      C:¥java¥othertests¥com¥ca¥tech¥MyAccount.class
      

      以下のパスを使用するように、オペレータを設定します。

      C:¥¥java¥¥othertests
      

      注： フォルダへのパスは、フル パスまたは CA Process Automation ユーザ リソースへの相対パスとして指定します。 http パスは指定しません。 JAR ファイルではなく .class ファイルをロードするためのフォルダへのパスを指定します。 .class ファイルと異なり、JAR ファイルはそれぞれ、そのファイルが存在するディレクトリではなく、JAR ファイルで終わる個別のパスを必要とします。

4. （オプション）使用する JAR を CA Process Automation ユーザ リソースにアップロードします。

   CA Process Automation は自動的に JAR をミラーリングします。

   注： リソースは（ユーザ リソースを含む）、オーケストレータ/エージェントのミラーリング間隔でミラーリングされます。 ユーザ リソースにアップロードされた JAR ファイルを Java モジュール オペレータで使用する前に、その JAR ファイルがすでにミラーリングされていることを確認します。

5. 実行するコードを指定します。
6. Java コードへ渡す入力パラメータを指定します。
7. オペレータ Java コードで作成された変数の出力名を指定します。 コードが実行を完了するときに、出力変数名はオペレータ データセットで保存される必要があります。

   注： CA Process Automation はブール値、日付、整数、数値、文字列、文字、またはこれらのタイプの配列ではない Java オブジェクトをシリアル化して、JavaObject として保存します。

8. （オプション）この Java コードの実行オペレータのロガー設定を指定します。 これらの設定は、モジュール レベルのロガー設定に優先します。
9. Java コードの実行オペレータを実行します。

   Java モジュールは、操作中に遭遇した例外またはエラーをキャプチャし、問題のあるオペレータの［理由］フィールドにアラートを表示します。