概要
Webサービスは、OEMアプリケーションとYellowfinとの間の通信を管理するために使用されます。Webサービスは、XMLベースであり、OEMアプリケーションを開発するために使用されるプログラミング言語には依存しません。
Yellowfin Webサービスを対象に開発を行う場合、WSDL定義に対して関数スタブを生成することができます。これらの定義は、http://<yellowfin-server>:<port>/services
(例:http://localhost:8080/services)で見つかります。
関数スタブにより、開発者は、ネイティブのプログラミング言語で標準の関数呼び出しを行い、Yellowfinで提供されるWebサービスと直接通信できます。関数スタブを作成するプロセスでは、Webサービスで必要になるオブジェクトがある場合はそれらも生成されます。
Webサービスの例で使用されるいくつかのオブジェクトには以下のようなものがあります:
AdministrationServiceRequest
- Webサービスに対して行われる呼び出しのタイプを定義するオブジェクトAdministrationServiceResponse
- Webサービスによって返されるオブジェクトAdministrationPerson
- ユーザー情報を含むオブジェクトAdministrationGroup
- グループ情報を含むオブジェクト
Yellowfin WebサービスAPI
Yellowfinには、
yfws-<date>.jar
というJARファイルが付属しています。このファイルはYellowfinのインストールディレクトリYellowfin\development\lib
にあります。
Yellowfin WebサービスAPIには、あらかじめ生成されたスタブが含まれます。これを直接、JavaまたはJava統合をサポートする他の言語(Cold FusionやLotus Scriptなど)で開発されたアプリケーションで使用できます。ほとんどのWebサービスが標準のJava関数によってラップされるため、各リクエストを手動で生成する必要がなくなることから、統合が若干容易になります。
Webサービスリクエストの形式は次の通りです:
AdministrationServiceRequest rsr = new AdminstrationServiceRequest(); AdministrationServiceResponse rs = null; AdministrationPerson person = new AdministrationPerson(); rsr.setLoginId(this.username); rsr.setPassword(this.password); rsr.setOrgId(new Integer(1)); rsr.setFunction("ADDUSER"); rs = AdministrationService.remoteAdministrationCall(rsr);