こちらのwebサービスの呼び出しは、レポート、ストーリーボード、ビューなどのアイテムを、ユーザのお気に入り一覧に追加します。また、ダッシュボードタブをユーザーのダッシュボードに追加し、コメントにフラグ付けすることもできます。 リクエストパラメーター以下の要素は、こちらのリクエストとともに渡されます。 リクエスト要素 | データ型 | 説明 | LoginId | String | Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。 このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。 | Password | String | 上記アカウントのパスワードです。 | OrgId | Integer | Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。 | Function | String | Webサービス関数です。こちらは、「SAVEPERSONFAVOURITE」に設定します。 | Favourite | PersonFavourite | こちらのオブジェクトは、ユーザーのお気に入りアイテムを指定するために使用します。こちらではユーザーも指定します。より詳細な情報は、以下の表を参照してください。 |
以下は、こちらのwebサービスの呼び出しのPersonFavouriteオブジェクトに設定しなくてはいけない主要なパラメーターです。 PersonFavourite要素 | データ型 | 説明 | PersonId | Integer | 内部ID(IP IDです)とともにユーザーを識別するために必須のパラメーターです。選択されたアイテムは、ユーザーのお気に入りに追加されます。 | ContentType | String | こちらの必須パラメーターは、お気に入りに追加するアイテムのコンテンツタイプを姉弟するために使用します。値の選択肢は、以下の通りです。 - REPORT
- REPORTGROUP
- DISCUSSIONGROUP
- REPORTVIEW
- STORYBOARD
- IMAGE
| ContentId | Integer | こちらの必須パラメーターは、内部IDを提供することで、ユーザーのお気に入りアイテムを定義するために使用します。 | FavouriteType | String | | CreationCode | String | | TextEntityId | Integer | こちらのパラメーターは、コメントにフラグ付けをする場合に必要です。 |
リクエストの例以下は、こちらのリクエストのSOAP XMLの例です。 応答パラメーター返される応答には、これらのパラメーターが含まれます。 応答要素 | データ型 | 説明 | StatusCode | String | Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。 | Personfavourites | Personfavourite[] | ユーザーのお気に入りオブジェクトを含む配列です。 |
応答の例サービスは、今回のSOAPの例に基づき、以下の応答を返します。 Code Block |
---|
| <S <soapenv:Envelope xmlns:Ssoapenv="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body>
<ns2:remoteAdministrationCallResponse xmlns:ns2web="http://webservices.web.mi.hof.com/">
<soapenv:Header/>
<soapenv:Body>
<return> <web:remoteAdministrationCall>
<errorCode>0</errorCode> <arg0>
<messages>Successfully Authenticated User: admin@yellowfin<loginId>admin@yellowfin.com.au</messages>loginId>
<messages>Web Service Request Complete</messages><password>test</password>
<personfavourites><orgId>1</orgId>
<contentId>61209</contentId><function>SAVEPERSONFAVOURITE</function>
<favourite>
<contentType>REPORTGROUP</contentType> <personId>13000</personId>
<creationCode/> <creationDate>2017-06-26</creationDate><contentType>REPORTGROUP</contentType>
<creatorId>0<<contentId>61209</creatorId>contentId>
</favourite> <favouriteType>REPORTDASHBOARD</favouriteType>
</arg0>
<message/> </web:remoteAdministrationCall>
</soapenv:Body>
</soapenv:Envelope> |
応答パラメーター返される応答には、これらのパラメーターが含まれます。 応答要素 | データ型 | 説明 | StatusCode | String | Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。 |
応答の例サービスは、今回のSOAPの例に基づき、以下の応答を返します。 Code Block |
---|
| <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<personId>5</personId> <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
<textEntityId>0</textEntityId><return>
<<errorCode>0</personfavourites>errorCode>
<personfavourites><messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
<contentId>61250</contentId><messages>Web Service Request Complete</messages>
<contentType>REPORTGROUP<<sessionId>6eb0b81605d3b355cf4a43ae608ab274</contentType>sessionId>
<creationCode/>
<creationDate>2017-06-26</creationDate>
<creatorId>0</creatorId>
<favouriteType>REPORTDASHBOARD</favouriteType>
<message/>
<personId>5</personId>
<textEntityId>0</textEntityId>
</personfavourites>
<sessionId>09123071f17afb11be74ca07a6d25aef</sessionId>
<statusCode>SUCCESS<<statusCode>SUCCESS</statusCode>
</return>
</ns2:remoteAdministrationCallResponse>
</S:Body>
</S:Envelope> |
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。 Expand |
---|
| 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。
Code Block |
---|
| AdministrationServiceRequest rsr = new AdministrationServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(1);
rsr.setFunction("LISTPERSONFAVOURITESSAVEPERSONFAVOURITE"); |
PersonFavouriteオブジェクトを使用して、ユーザーを識別します。 Code Block |
---|
| PersonFavourite pf = new PersonFavourite();
pf.setPersonId(13073); |
以下の手順はオプションであり、こちらの呼び出しの応答にフィルターを適用するために含めることができます。オブジェクト内でお気に入りに登録されるコンテンツを指定します。 ユーザーのお気に入りレポートを取得する場合 setContentType"REPORT"
setFavouriteTypeFAVOURITE
|
完成例以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。 - コードをコピーして、「ws_savepersonfavourite.jsp」として保存します。
- root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
- 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
- インターネットブラウザから、「http://<host>:<port>/ws_savepersonfavourite.jsp」を実行します。
インターネットブラウザから、「http://<host>:<port>/ws_listpersonfavourites.jsp」を実行します。
Code Block |
---|
| pf.setContentType("REPORTGROUP");<%
/ /* use this for dashboards, or pf.setContentType("REPORT") to get distributed reports
pf.setFavouriteType("INBOX");ユーザーがメンバーであるディスカッションを取得する場合 Code Block |
---|
| pf.setContentType("DISCUSSIONGROUP");
pf.setFavouriteType("DISCUSSIONMEMBER"); |
ユーザーのお気に入りビューを取得する場合 Code Block |
---|
| pf.setContentType("REPORTVIEW"); |
ユーザーのお気に入りストーリーボードを取得する場合 Code Block |
---|
| pf.setContentType("STORYBOARD");
pf.setFavouriteType("FAVOURITE"); |
リクエストにこちらのオブジェクトを追加します。 Code Block |
---|
| rsr.setFavourite(pf); |
リクエストを構成したら、呼び出しを実行します。
Code Block |
---|
| AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr); |
管理サービスを初期化します。実行方法の詳細は、こちらを参照してください。 |
完成例以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。 コードをコピーして、「ws_listpersonfavourites.jsp」として保存します。root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。<% ws_savepersonfavourite.jsp */
%>
<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<%@ page import="com.hof.util.*, java.util.*, java.text.*" %>
<%@ page import="com.hof.web.form.*" %>
<%@ page import="com.hof.mi.web.service.*" %>
<%
AdministrationServiceService s_adm = new AdministrationServiceServiceLocator("localhost",8080, "/services/AdministrationService", false); // adjust host and port number
AdministrationServiceSoapBindingStub adminService = (AdministrationServiceSoapBindingStub) s_adm.getAdministrationService();
AdministrationServiceRequest rsr = new AdministrationServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au"); // provide your Yellowfin web services admin account
rsr.setPassword("test"); // set to the password of the account above
rsr.setOrgId(1);
rsr.setFunction("SAVEPERSONFAVOURITE");
PersonFavourite pf = new PersonFavourite();
pf.setPersonId(13073);
pf.setContentId(61252);
pf.setContentType("REPORTVIEW");
rsr.setFavourite(pf);
AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
if ("SUCCESS".equals(rs.getStatusCode()) ) {
out.write("<br>Success");
} else {
out.write("Failure");
out.write(" Code: " + rs.getErrorCode());
}
%> |
|