# SOAPコネクターと依存関係のインストール

SOAPコネクターとその依存関係をインストールするには、以下の手順を完了してください:

これらの依存関係をインストールした後、接続のセットアップを行うことができます。

# ステップ1:オンプレミスエージェント(OPA)のセットアップ

オンプレミスエージェント(OPA)のセットアップを行ってください。クラウドプロファイルまたは接続プロファイルのいずれかを使用できますが、いずれの場合もOPAがインストールされているマシンのconfig.ymlを手動で編集できる必要があります。

すでにOPAをセットアップ済みの場合は、ステップ2に進んでください。

# ステップ2:OPA拡張機能のインストール

オンプレミスエージェントのセットアップが完了したら、以下の手順を実行してOPA拡張機能をインストールしてください:

# ステップ2.1:オンプレミスエージェントの場所を特定する

ファイルシステム上でOPAディレクトリを特定してください。一般的な場所は次のとおりです:

  • Unix系オペレーティングシステム: /opt/workato
  • Windows: C:\Program Files\Workato Agent
  • macOS: 位置は異なります。
$ ls /opt/workato
bin  conf  jre  lib  lib_ext

このガイドの残りの部分では、このパスを$OPAとして参照します。

# ステップ2.2:Java Development Kit(JDK)のインストール

まず、JDKがすでにインストールされているかどうかを確認してください。バージョンは17以上である必要があります。一般的な場所は次のとおりです:

  • Linux: /usr/lib/java
  • Ubuntu: /usr/share/java/
  • Windows: C:\Program Files\Java\jdk-<リリース>
  • macOS: ディストリビューションによって場所が異なります。例:/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
$ ls /usr/lib/java
bin  conf  include  jmods  legal  lib  release

JDKのインストールが実際にJDKであり、単なるJREではないことを確認してください。これはApache CXFによって必要とされるためです。javacバイナリが存在するかどうかで確認できます:

$ ls /usr/lib/java/bin/java*
bin/java  bin/javac  bin/javadoc  bin/javap

JDKのバージョン17以上がまだインストールされていない場合は、JDKの配布 (opens new window)からいくつか選択し、インストール手順に従ってください。

JDKをインストールした後、JDKフォルダをリストアップしてインストールが正常に行われたことを確認してください:

$ ls /path/to/jdk
bin  conf  include  jmods  legal  lib  release

# ステップ2.3:SOAP拡張パッケージのダウンロード

SOAP拡張機能は、2つのJARファイルからなるパッケージで、以下のURLからダウンロードできます:

https://workato-opa-extensions.s3.amazonaws.com/soap-extensions/soap-extension-latest.zip (opens new window)

以下のコマンドを使用してパッケージをダウンロードし、JARファイルを$OPA/extフォルダに移動します。ここで$OPAは、オンプレミスエージェントがインストールされているディレクトリを表します。

$ curl -o soap-extension.zip https://workato-opa-extensions.s3.amazonaws.com/soap-extensions/soap-extension-latest.zip
$ unzip soap-extension.zip -d $OPA/ext

SOAP拡張機能の両方のファイルが$OPA/extに存在することを確認してください:

$ ls $OPA/ext | grep soap_extension
soap_extension.jar
soap_extension_client.jar

古いバージョンのインストール

古いバージョンのSOAP拡張機能をインストールする必要がある場合は、このディレクトリ (opens new window)からパッケージをダウンロードしてください。

# ステップ2.4:OPAと拡張機能の設定

OPAの設定ファイルは$OPA/conf/config.ymlです。SOAP拡張機能を使用するためには、以下の手順に従って設定ファイルを更新する必要があります。この手順は、OPAがクラウドプロファイルまたは接続プロファイルを使用して構成されている場合に適用されます。

1

classpathをSOAP拡張機能のJARファイルが存在するフォルダのパス(通常は$OPA/extで、$OPAオンプレミスエージェントがインストールされているディレクトリを表します)に設定してください:

server:
   classpath: /opt/workato/ext
2

SOAP拡張機能を登録してください:

extensions:
   soap:
      controllerClass: com.workato.extension.soap.ExtensionController
3

OPAがJDKを見つけることができるようにしてください。デフォルトでは、SOAP拡張機能は次の場所でJDKをチェックします:

  • JDK_HOME環境変数
  • jdk.homeシステムプロパティ

または、JDKのパスを明示的に設定してください:

extensions:
   soap:
      controllerClass: com.workato.extension.soap.ExtensionController
      jdkHome: /path/to/jdk

# ステップ2.5:OPAを再起動する

OPAのドキュメントに従って、OPAを停止し、再起動します。

# ステップ3:SOAPコネクタをインストールする

OPAとSOAP拡張を設定した後、SOAPコネクタをインストールできます。

1

Workatoアカウントにログインします。

3

インストールを選択します。

4

リリースコネクタを選択します。


Last updated: 2024/2/13 16:59:53