Webサービス

概要

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);

詳細については、 [管理サービス] または [レポートサービス] を参照してください。