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

SOAPコネクターとその依存関係をインストールするには、次のセクションを参照してください:

• オンプレミスエージェント（OPA）を設定する
• OPA拡張機能をインストールする
• SOAPコネクターをインストールする

これらの依存関係をインストールしたら、コネクションを設定できます。

オンプレミスエージェント（OPA）の設定 ​

オンプレミスエージェント（OPA）を設定します。 クラウドプロファイルまたはコネクションプロファイルのいずれかを使用できます。 どちらのオプションでも、OPAがインストールされているマシン上のconfig.ymlファイルを手動で編集できる必要があります。

OPA拡張機能のインストール ​

OPA拡張機能をインストールするには、次の手順を実行します:

• オンプレミスエージェントを見つける
• Java Development Kit（JDK）をインストールする
• SOAP拡張機能パッケージをダウンロードする
• OPAと拡張機能を設定する
• OPAを再起動する

オンプレミスエージェントを見つける ​

ファイルシステム上でOPAディレクトリを見つけます。 一般的な場所は次のとおりです:

• Unix系オペレーティングシステム: /opt/workato
• Windows: C:\Program Files\Workato Agent
• macOS: 場所は異なります。

$ ls /opt/workato
bin  conf  jre  lib  lib_ext

このガイドの以降の部分では、このパスを$OPAと呼びます。

Java Development Kit（JDK）のインストール ​

23.0未満のOPAバージョンを使用している場合は、Java SDKのバージョン17以降がインストールされていることを確認します。 デフォルトのJDKインストール場所は次のとおりです:

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

$ ls /usr/lib/java
bin  conf  include  jmods  legal  lib  release

JDKのインストールがJREだけではなく実際にJDKであることを確認してください。これはApache CXFで必要です。 これはjavacバイナリの有無を確認することで確かめられます:

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

JDKのバージョン17以降がまだインストールされていない場合は、多数あるJDKディストリビューションのいずれかを選択し、インストール手順に従ってください。

JDKをインストールしたら、JDKフォルダを一覧表示してインストールを確認します:

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

SOAP拡張機能パッケージのダウンロード ​

SOAP拡張機能は2つのJARファイルで構成され、パッケージ化されて次のURLからダウンロードできます:

https://workato-opa-extensions.s3.amazonaws.com/soap-extensions/soap-extension-latest.zip

次のコマンドはパッケージをダウンロードして展開し、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

OPAと拡張機能の設定 ​

OPA設定ファイルは$OPA/conf/config.ymlです。 SOAP拡張機能を使用するには、次の手順に従って設定ファイルを更新する必要があります。 この手順は、OPAがクラウドプロファイルまたはコネクションプロファイルのどちらを使用して設定されている場合にも適用されます。

server:
   classpath: /opt/workato/ext

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

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

OPAの再起動 ​

OPAを停止および再起動する方法については、OPAドキュメントの手順に従ってください。

SOAPコネクターのインストール ​

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