Anchor | ||||
---|---|---|---|---|
|
Yellowfinのレポートwebサービスは、Yellowfinのレポートには必須ではないが、いまだ有効ないくつかのレガシー関数から構成されています。以下は、これらの概要です。これらのサービスについてより詳細な情報はご希望の場合は、Yellowfinのサポートチームにお問い合わせください。
基礎的な関数
Expand | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
こちらの関数は、レポートwebサービスが機能しているかをテストするために使用します。EXPIRESESSIONリクエストは、指定したYellowfinのセッションを期限切れにします。 これを実行するコードは、以下の通りです。 リクエスト要素サービスは、今回のSOAPの例に基づき、以下の応答を返します。
以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素返される応答には、これらのパラメーターが含まれます。
応答の例
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
こちらの関数は、特定のレポートにコメントがあれば、それをすべて取得します。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
手順 応答要素Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。応答には、これらの主要なパラメーターが含まれます。 expand
| java | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("TEST"); |
Comments | ReportComment[] | 指定したレポートのコメントを含むオブジェクトです。 |
応答の例
サービスは、今回のSOAPの例に基づき、以下の応答を返します。
Code Block | ||||||
---|---|---|---|---|---|---|
| java | rsr.setOrgRef("org1");
|
Code Block | |||||
---|---|---|---|---|---|
| |||||
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://search for the report in this client orgリクエストを構成したら、呼び出しを実行します。
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。 返される応答には、StatusCodeパラメーターが含まれます。詳細は、応答パラメーターの表を参照してください。 |
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
<%webservices.web.mi.hof.com/"> <return> <author>System /*Administrator</author> <authoringMode>JAVA</authoringMode> ws_test_reportservices.jsp <averageRunTime>0</averageRunTime> */ %> <%@ 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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% <canDrill>false</canDrill> <category>Tutorial</category> <comments> <author>System Administrator</author> ReportService rsc = new ReportService(); <authorId>5</authorId> //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService"); ReportServiceRequest rsr = new ReportServiceRequest(); <comment><span>Great info.</span></comment> rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(new Integer(1)); rsr.setReportRequest("TEST"); <commentDate>2018-03-18 17:32:54</commentDate> rsr.setOrgRef("1"); <commentId>2004</commentId> ReportServiceResponse rs=rsc.remoteReportCall(rsr); if ("SUCCESS".equals(rs.getStatusCode())) { <lastActivityDate>2018-03-18 17:33:13</lastActivityDate> JAXBContext context = JAXBContext.newInstance(ReportServiceResponse.class); <parentCommentId>0</parentCommentId> Marshaller m = context.createMarshaller(); <reportId>70012</reportId> m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE); // To format<statusCode>OPEN</statusCode> XML </comments> JAXBElement<ReportServiceResponse> rootElement = new JAXBElement<ReportServiceResponse>(new QName("ReportServiceResponse"), ReportServiceResponse.class, rs); <comments> m.marshal(rootElement,out); <author>System //out.write("Success");Administrator</author> } else { out.write("Failure");<authorId>5</authorId> out.write(" Code: " + rs.getErrorCode()); <comment><span>Want to see more structure.</span></comment> } %> |
title | INFO |
---|
こちらのwebサービスは、指定したレポートの詳細を取得します。
リクエスト要素
以下の要素は、こちらのリクエストとともに渡されます。
リクエスト要素 | データ型 | 説明 |
LoginId | String | Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。 このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。 |
Password | String | 上記アカウントのパスワードです。 |
OrgId | Integer | Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。 |
ReportRequest | String | webサービス関数です。「INFO」に設定します。 |
OrgRef | String | クライアント組織内部参照IDです。(オプション設定) |
ReportId | Integer | 特定のレポートを検索するために、レポートIDを提供することができます。 |
リクエストの例
以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
Code Block | ||
---|---|---|
| ||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/"> <soapenv:Header/> <soapenv:Body> <commentDate>2018-03-18 17:33:13</commentDate> <commentId>2005</commentId> <lastActivityDate>2018-03-18 17:33:13</lastActivityDate> <parentCommentId>2004</parentCommentId> <web:remoteReportCall> <reportId>70012</reportId> <arg0> <loginId>admin@yellowfin.com.au</loginId><statusCode>OPEN</statusCode> <password>test<</password>comments> <orgId>1<<dashboardEnabled>true</orgId>dashboardEnabled> <reportRequest>INFO<<dataOutput>COLUMN</reportRequest>dataOutput> <datasource>Ski <reportId>60712<Team</reportId>datasource> <errorCode>0</errorCode> </arg0> </web:remoteReportCall><formatCode>CHART</formatCode> </soapenv:Body> </soapenv:Envelope> |
応答要素
応答には、これらのパラメーターが含まれます。
応答要素 | データ型 | 説明 |
StatusCode | String | Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。
|
ReportName | String | 指定したレポートの名前です。 |
ReportDescription | String | 指定したレポートの説明です。 |
ReportUUID | Integer | 指定したレポートの一意のID(または、UUID)です。 |
HitCount | Integer | レポートがアクセスされた回数です。 |
FormatCode | String | レポートの書式コードです。 |
AverageRunTime | Integer | レポートの平均実行時間です。 |
Category | String | レポートが保存されているカテゴリーです。 |
SubCategory | String | レポートのサブカテゴリーです。 |
ReportUsage | Integer | レポートが使用、またはアクセスされた回数です。 |
ViewName | String | ビューの名前です。 |
Datasource | String | データソースの名前です。 |
Author | String | レポートを作成したユーザーです。 |
AuthoringMode | String | レポートが作成されたモードです。 |
ReportTemplate | String | レポートのテンプレートです。 |
DataOutput | String | データ出力です。例:カラム(列) |
DashboardEnabled | Boolean | ダッシュボードが有効化されている場合はTrueです。 |
LastModifiedDate | Date | レポートが最後に変更された日付です。 |
応答の例
サービスは、今回のSOAPの例に基づき、以下の応答を返します。
Code Block | ||||
---|---|---|---|---|
| ||||
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/"> <return> <hitCount>3</hitCount> <lastModifiedDate>2018-03-07</lastModifiedDate> <lastRunDuration>0</lastRunDuration> <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages> <messages>Loaded Report: 70012 Successfully</messages> <messages>Web Service Request Complete</messages> <preRunFilterString><![CDATA[<div class="rptFilterLogicText"> <span class="rptFilterLogicIdentifier">Invoiced Date</span> Between <span class="rptFilterLogicIdentifier">Current Date - 6 Years And Current Date</span> </div> . . . ]]></preRunFilterString> <author>System Administrator</author> <private>false</private> <authoringMode>JAVA</authoringMode> <reportDescription>This report provides a high level summary of <averageRunTime>0<campaigns</averageRunTime>reportDescription> <canDrill>false<<reportId>70012</canDrill>reportId> <category>Tutorial<<reportName>Campaign Summary</category>reportName> <dashboardEnabled>true<<reportTemplate>CHART</dashboardEnabled>reportTemplate> <dataOutput>COLUMN</dataOutput><reportUUID>3e842fae-02f7-4ad3-a632-ca267e0078da</reportUUID> <datasource>Ski Team<<reportUsage>100</datasource>reportUsage> <errorCode>0<<sessionId>3ab136a400081d88c09526f8bdf9e2e7</errorCode>sessionId> <formatCode>REPORTANDCHART<<statusCode>SUCCESS</formatCode>statusCode> <subCategory>Marketing & <hitCount>0<Booking</hitCount>subCategory> <tags>No <lastModifiedDate>2017-06-26</lastModifiedDate>tags</tags> <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages><viewName>New View</viewName> <messages>Loaded Report: 60712 Successfully</messages></return> </ns2:remoteReportCallResponse> <messages>Collating Report Information</messages> <messages>Web Service Request Complete</messages> <preRunFilterString><![CDATA[<div class="rptFilterLogicText"> <span class="rptFilterLogicIdentifier">Company Name</span> In List <span class="rptFilterLogicIdentifier">[User Prompt]</span> </div>]]></preRunFilterString> <private>false</private> <reportDescription>Top N Agencies compared to all other Agencies by demographic</reportDescription></S:Body> </S:Envelope> |
手順
Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
Expand | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
|
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
- コードをコピーして、「ws_getcomments.jsp」として保存します。
- root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
- 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
- インターネットブラウザから、「http://<host>:<port>/ws_getcomments.jsp」を実行します。
Code Block | ||||
---|---|---|---|---|
| ||||
<% /* <reportId>60712</reportId>ws_getcomments.jsp <reportName>Agency Benchmark<*/reportName> %> <%@ page <reportTemplate>REPORTANDCHART</reportTemplate> <reportUUID>c83357db-8aef-4ec7-ab72-fce34de9ee77</reportUUID> <reportUsage>0</reportUsage> <sessionId>900e9dfabd21bdef75410fa88fe501dd</sessionId> <statusCode>SUCCESS</statusCode> <subCategory>Marketing & Booking</subCategory> <tags>No tags</tags> <viewName>New View</viewName> </return> </ns2:remoteReportCallResponse> </S:Body> </S:Envelope> |
手順
Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
Expand | ||
---|---|---|
| ||
管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの呼び出しを実行するための基礎的なリクエストです。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.*" %>
<%@ page import="javax.xml.bind.JAXBContext" %>
<%@ page import="javax.xml.bind.Marshaller" %>
<%@ page import="java.io.StringWriter" %>
<%@ page import="javax.xml.bind.JAXBElement" %>
<%@ page import="javax.xml.namespace.QName" %>
<%
/*
Create Group
Using Java generated stubs rather that using the Yellowfin webservices API..
*/
ReportService rsc = new ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService");
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("GETCOMMENTS");
rsr.setReportId(56401);
ReportServiceResponse rs=rsc.remoteReportCall(rsr);
%> |
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
LEAVECOMMENTリクエストは、特定のレポートのコメントに、コメントや応答を追加します。 これを実行するコードは、以下の通りです。
|
Expand | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
DELETECOMMENTリクエストは、レポートから特定のコメントを削除します。 これを実行するコードは、以下の通りです。
完成例以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
こちらの関数は、レポートのコメントのステータスを設定するために使用します。ステータスのオプションは、次の通りです。:OPEN、EDITED、RESOLVED、DELETED
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらの主要なパラメーターが含まれます。
応答の例サービスは、今回のSOAPの例に基づき、以下の応答を返します。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
こちらのwebサービスは、レポートのカラム(列)やフィルターのメタデータを含む、指定したレポートのスキーマ情報を返します。レポートは、そのレポートID、またはwebサービス名を提供することで指定しなくてはいけません。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらの主要なパラメーターが含まれます。
Anchor | | 以下の表 | 以下の表 | ReportSchemaオブジェクトは、レポートカラム(列)の情報を含む、以下のパラメーターを返します。
パラメーター | 型 | 説明 |
ColumnName | String | レポートカラム(列)の名前です。 |
DisplayName | String | カラム(列)の表示名です。 |
ColumnLength | String | レポートカラム(列)の長さです。 |
FieldId | Integer | カラム(列)のフィールドIDです。 |
DataType | String | レポートカラム(列)のデータ型です。 |
SortOrder | Integer | カラム(列)を並べかえる順序です。 |
Hidden | Boolean | レポートでのカラム(列)表示有無です。 |
NumberOfDecimals | Integer | |
OutputLocation | String | |
AllowPrompt | Boolean | フィルターのみの設定です。 |
CachedValues | Boolean | フィルターのみの設定です。フィルターのキャッシュ値使用有無です。 |
FilterDisplayType | String | フィルターのみの設定です。カラム(列)がフィルタの場合のフィルター表示タイプです。 |
FilterId | String | フィルターのみの設定です。カラム(列)がフィルターの場合のフィルターIDです。 |
FilterOmittable | Boolean | フィルターのみの設定です。 |
FilterType | String | フィルターのみの設定です。フィルタータイプと、プロンプトに投入する必要のあるデータを決定します。 |
DefaultValue1 | String | フィルターのみの設定です。フィルターが設定されている場合の最初のデフォルト値です。 |
DefaultValue2 | String | フィルターのみの設定です。フィルターが設定されている場合の二番目のデフォルト値です。 |
FilterTypeCode | String | フィルターのみの設定です。 |
FilterUUID | String | フィルターのみの設定です。フィルターのUUIDです。 |
MinimumValue | BigDecimal | フィルターのみの設定です。フィルターが設定されている場合の最小値です。 |
MaximumValue | BigDecimal | フィルターのみの設定です。フィルターが設定されている場合の最大値です。 |
ParentFilterId | Integer | フィルターのみの設定です。依存フィルターが設定されている場合の親フィルターのフィルターIDです。 |
Prompt | Boolean | フィルターのみの設定です。カラム(列)がプロンプトフィルターであるかどうかです。 |
ValueUnitCode | String | フィルターのみの設定です。フィルターが設定されている場合の時間単位です。 |
応答の例
サービスは、今回のSOAPの例に基づき、以下の応答を返します。
Code Block | ||||
---|---|---|---|---|
| ||||
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/"> <return> <author>System Administrator</author> <authoringMode>JAVA</authoringMode> <averageRunTime>0</averageRunTime> <canDrill>false</canDrill> <category>Tutorial</category> <columns> <columnName>Region</columnName> <dataType>TEXT</dataType> <displayName>Athlete Region</displayName> <fieldId>1</fieldId></S:Body> </S:Envelope> |
手順
Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
Expand | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||
|
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
- コードをコピーして、「ws_commentstatus.jsp」として保存します。
- root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
- 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
- インターネットブラウザから、「http://<host>:<port>/ws_commentstatus.jsp」を実行します。
Code Block | ||||
---|---|---|---|---|
| ||||
<% /* ws_commentstatus.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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% /* Create Group Using Java generated stubs rather that using the Yellowfin webservices API.. */ ReportService rsc = new ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService"); ReportServiceRequest rsr = new ReportServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(new Integer(1)); rsr.setReportRequest("COMMENTSTATUS"); ReportComment rc=new ReportComment(); rc.setReportId(60712); rc.setCommentId(12345); rc.setStatusCode("OPEN"); rsr.setReportComment(rc); ReportServiceResponse rs=rsc.remoteReportCall(rsr); if ("SUCCESS".equals(rs.getStatusCode())) { JAXBContext context = JAXBContext.newInstance(ReportServiceResponse.class); Marshaller m <hidden>false</hidden>= context.createMarshaller(); m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, <numberOfDecimals>0</numberOfDecimals> Boolean.TRUE); // To format XML <outputLocation>COLUMN</outputLocation>JAXBElement<ReportServiceResponse> rootElement = new JAXBElement<ReportServiceResponse>(new QName("ReportServiceResponse"), ReportServiceResponse.class, rs); <prompt>false</prompt> m.marshal(rootElement,out); //out.write("Success"); <sortOrder>0</sortOrder> } else { </columns>out.write("Failure"); out.write(" Code: " <columns>+ rs.getErrorCode()); } %> |
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
DISTRIBUTEINBOXリクエストは、受信者一覧の受信トレイにレポートを配信します。 これを実行するコードは、以下の通りです。
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
GETDISPLAYEDREPORTIDリクエストは、現在表示されているレポートのレポートIDを返します。 これを実行するコードは、以下の通りです。
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。 Expand | | |||||||
|
Code Block | ||||
---|---|---|---|---|
| ||||
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("SCHEMA"); |
レポートの保存されているクライアント組織を指定する必要がある場合は、こちらのコードを追加します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setOrgRef("org1"); // search for the report in this client org |
ステータスを変更するレポートのコメントを指定することができます。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportId(70045); |
Code Block | ||
---|---|---|
| ||
ReportServiceResponse rs=rsc.remoteReportCall(rsr); |
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。
返される応答には、他のレポート固有のパラメーターとともに、StatusCodeパラメーターが含まれます。詳細は、上記応答パラメーターの表を参照してください。
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
Code Block | ||||
---|---|---|---|---|
| ||||
<% /* rsr.setLoginId(this.username); rsr.setPassword(this.password); // This is the primary organization rsr.setOrgId(new Integer(1)); rsr.setReportRequest("GETDISPLAYEDREPORTID"); rs = ReportService.remoteReportCall(rsr); |
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
応答要素 | データ型 | 説明 | 取得コード |
DisplayedReportId | Integer | 現在表示されているレポートのレポートIDです。 |
|
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
GETKPIリクエストは、特定のKPIレポートのKPIオブジェクトを返します。こちらの関数リクエストは通常、モバイルアプリケーション内で活用されます。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|
Expand | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
GETDRILLANYWHEREMENUリクエストは、選択したレポートのカラム(列)で使用可能なドリルエニウェアメニューを返します。こちらの関数リクエストは通常、モバイルアプリケーション内で活用されます。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
SUBSCRIBEDETAILSリクエストは、特定のレポートのスケジュールレコードを返します。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
SUBSCRIBEリクエストは、指定したユーザーの指定したレポートへの購読を作成、または変更します。こちらの関数リクエストは通常、現在の購読情報を取得するために、SUBSCRIBEDETAILSのあとに呼び出されます。そうでない場合、こちらの関数の呼び出しのために、ScheduleRecordオブジェクトを作成して適切なデータを投入する必要があります(ScheduleRecordを参照してください)。 これを実行するコードは、以下の通りです。
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
UNSUBSCRIBEリクエストは、指定したレポートから、指定したユーザーの購読を停止します。 これを実行するコードは、以下の通りです。
|
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
LOADDASHBOARDTABリクエストは、指定したダッシュボードタブとそのメタデータを読み込みます。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
こちらの関数は、特定のダッシュボードの親タブの定義、またはメタデータを取得します。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらのパラメーターが含まれます。
応答の例サービスは、今回にSOAPの例に基づき、以下の応答を返します。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
webサービスは、指定したレポートのフィルター値を返します。 注意:現在、このリクエストにユーザー情報を渡す方法はありません。そのため、特定の値を制限するアクセスフィルターがレポートに適用されている場合、ログインしているユーザー(このwebサービスを呼び出しているユーザー)がアクセスできるフィルター値のみが返されます。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらの主要なパラメーターが含まれます。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||
応答要素 | データ型 | 説明 | |||||||||||||||||||||||||||||||||||||||||||||||||||
StatusCode | String | Webサービスリクエストのステータスです。値の選択肢は、以下の通りです。
| |||||||||||||||||||||||||||||||||||||||||||||||||||
Results | ReportRow[] | 利用可能なフィルター値の配列です。より詳細な情報は、以下の表を参照してください。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
Author | String | レポートを作成したユーザーの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
AuthoringMode | String | ||||||||||||||||||||||||||||||||||||||||||||||||||||
AverageRunTime | Integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||
CanDrill | Boolean | レポートのドリル可否です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
Category | String | レポートが保存されているフォルダーの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
SubCategory | String | レポートが保存されているサブフォルダーの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
DashboardEnabled | Boolean | ||||||||||||||||||||||||||||||||||||||||||||||||||||
DataOutput | String | 以下のいずれかになります。
| |||||||||||||||||||||||||||||||||||||||||||||||||||
Datasource | String | このレポートに使用されているデータソースの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
FormatCode | String | 指定したレポートの書式コードです。以下のいずれかになります。
| |||||||||||||||||||||||||||||||||||||||||||||||||||
HitCount | Integer | 指定したレポートがアクセスされた回数です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
LastModifiedDate | String | レポートが最後に変更された日付です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
LastRunDuration | Integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||
PreRunFilterString | String | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Private | Boolean | レポートが非公開、または公開のどちらであるかを定義します。(レガシーサービスの場合は非公開です) | |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportDescription | String | 指定したレポートの説明です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportId | Integer | 指定したレポートのIDです。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportName | String | 指定したレポートの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportTemplate | String | レポートに適用するテンプレートです。以下のいずれかになります。
| |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportUUID | String | レポートのUUIDです。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
ReportUsage | Integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||
ViewName | String | レポートが依存するビューの名前です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
Tags | String | ||||||||||||||||||||||||||||||||||||||||||||||||||||
ErrorCode | Integer | webサービスが失敗した場合のエラーのコード番号です。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
Messages | String[] | レポートがサーバ上で実行されている場合にデバッグ情報を示す文字列の配列です。デバッグとエラーのトレーシングに使用されます。 | |||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | 以下の表2 | 以下の表2 | ReportRowオブジェクトは、以下のパラメーターを返します。
パラメーター | 型 | 説明 |
DataValue | String[] | レポート結果セット内の各カラム(列)データの文字列の配列です。 |
応答の例
サービスは、今回のSOAPの例に基づき、以下の応答を返します。
Code Block | ||||
---|---|---|---|---|
| ||||
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/"> <return> <author>System Administrator</author><portletHeight>331</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>2</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61067</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>225</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>3</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>2</columnNumber> <entityId>61035</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>373</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>2</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <endDate>9999-12-31T00:00:00+11:00</endDate> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61035</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>CHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61067</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61097</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>REPORT</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>HELPON</formatKey> <formatValue>true</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>SUBTABS</formatKey> <formatValue>OFF</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>UNITSELECTION</formatKey> <formatValue>OFF</formatValue> <groupId>61250</groupId> </filters> <groupTypeCode>ANALYTIC</groupTypeCode> <languageCode>EN</languageCode> <longDescription/> <owner>1</owner> <ownerTypeCode>ORGANISATION</ownerTypeCode> <parentGroupId>0</parentGroupId> <shortDescription>Sales Performance</shortDescription> <startDate>2017-06-26T00:00:00+10:00</startDate> <statusCode>OPEN</statusCode> <subCategoryCode>ATHLETES</subCategoryCode> <subtabs> <elements> <columnNumber>1</columnNumber> <entityId>60947</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>448</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61001</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>363</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>1</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61097</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>374</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>2</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61046</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>331</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>2</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61067</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>225</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>3</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>2</columnNumber> <entityId>61035</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>373</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>2</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <endDate>9999-12-31T00:00:00+11:00</endDate> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61035</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>CHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61067</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>61097</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>REPORT</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>HELPON</formatKey> <formatValue>true</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>SUBTABS</formatKey> <formatValue>OFF</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>UNITSELECTION</formatKey> <formatValue>OFF</formatValue> <groupId>61250</groupId> </filters> <groupTypeCode>SUBTAB</groupTypeCode> <languageCode>EN</languageCode> <owner>0</owner> <parentGroupId>0</parentGroupId> <shortDescription>New Tab</shortDescription> <startDate>2017-06-26T00:00:00+10:00</startDate> <statusCode>OPEN</statusCode> <styleCode>TWO</styleCode> <tabId>61251</tabId> </subtabs> <tabId>61250</tabId> </dashboard> <dashboardEnabled>false</dashboardEnabled> <errorCode>0</errorCode> <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages> <messages>Attempting to Load Dashboard Tab: 61251</messages> <messages>Web Service Request Complete</messages> <private>false</private> <sessionId>af433c1d0f0cffa9d3a7e1ef8c72abf6</sessionId> <statusCode>SUCCESS</statusCode> </return> </ns2:remoteReportCallResponse> </S:Body> </S:Envelope><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/"> <return> <canDrill>false</canDrill> <dashboard> <accessCode>UNSECURE</accessCode> <categoryCode>TUTORIAL</categoryCode> <elements> <columnNumber>1</columnNumber> <entityId>60947</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>448</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61001</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>363</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>1</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61097</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>374</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>2</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61046</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>331</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>2</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>1</columnNumber> <entityId>61067</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>225</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>3</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <elements> <columnNumber>2</columnNumber> <entityId>61035</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>373</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>2</rowNumber> <sequenceNumber>1</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> <tabId>61251</tabId> </elements> <endDate>9999-12-31T00:00:00+11:00</endDate> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> </filters> <filters> <componentId>0</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</formatKey> <formatValue>SUMMARYCHART</formatValue> <groupId>61250</groupId> <authoringMode>JAVA</authoringMode> <averageRunTime>0</averageRunTime></filters> <canDrill>false</canDrill><filters> <category>Tutorial</category> <componentId>61035</componentId> <dashboardEnabled>true</dashboardEnabled> <dataOutput>COLUMN<<componentTypeCode>REPORT</dataOutput>componentTypeCode> <datasource>Ski Team</datasource> <entityId>0</entityId> <errorCode>0</errorCode> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatCode>REPORTANDCHART</formatCode> <hitCount>2</hitCount> <formatKey>DEFAULTDISPLAY</formatKey> <lastModifiedDate>2018-06-18</lastModifiedDate> <formatValue>CHART</formatValue> <lastRunDuration>0</lastRunDuration> <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages> <groupId>61250</groupId> <messages>Loaded Report: 70080 Successfully</messages></filters> <messages>Retrieving<filters> Options</messages> <messages>Request Contains No ReportFilter Records.<<componentId>61067</messages>componentId> <messages>Region (FilterId: 70082 ) Requires User Prompt<<componentTypeCode>REPORT</messages>componentTypeCode> <messages>Ignoring Prompt Filter On Field: 70082<<entityId>0</messages>entityId> <messages>DEMOGRAPHIC (FilterId: 70081 ) Requires User Prompt<<entityTypeCode>REPORTGROUP</messages>entityTypeCode> <messages>Web Service Request Complete</messages> <formatKey>DEFAULTDISPLAY</formatKey> <preRunFilterString><![CDATA[<div class="rptFilterLogicText"> <span class="rptFilterLogicIdentifier">Athlete Region</span> In List <span class="rptFilterLogicIdentifier">[User Prompt]</span> </div> <div class="rptFilterLogicText"> AND <span class="rptFilterLogicIdentifier">Demographic</span> In List <span class="rptFilterLogicIdentifier">(Adventure, Relaxation, Family, Culture)</span> </div>]]></preRunFilterString> <formatValue>SUMMARYCHART</formatValue> <private>false<<groupId>61250</private>groupId> <reportDescription>Ski Team, 18</6/2018 2:49 PM</reportDescription>filters> <reportId>70066</reportId> <filters> <reportName>qwerty</reportName> <componentId>61097</componentId> <reportTemplate>REPORTANDCHART</reportTemplate> <reportUUID>c105ab26-9744-434d-9c8c-9fb9e48d80c0</reportUUID><componentTypeCode>REPORT</componentTypeCode> <reportUsage>100</reportUsage> <entityId>0</entityId> <results> <entityTypeCode>REPORTGROUP</entityTypeCode> <dataValue>Asia</dataValue> <dataValue>Asia</dataValue><formatKey>DEFAULTDISPLAY</formatKey> </results> <formatValue>REPORT</formatValue> <sessionId>eb31d9392a25c8c40995237650837cd5</sessionId> <groupId>61250</groupId> <statusCode>SUCCESS</statusCode> <subCategory>Training<</subCategory>filters> <tags>No tags</tags> <filters> <viewName>New View</viewName> <componentId>0</componentId> </return> </ns2:remoteReportCallResponse> </S:Body> </S:Envelope> |
手順
Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
Expand | ||
---|---|---|
|
Code Block | ||||
---|---|---|---|---|
| ||||
管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの呼び出しを実行するための基礎的なリクエストです。 Code Block | | |||
|
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportId(70066); |
特定のフィルターを取得する場合は、ObjectNameパラメーターにフィルターIDを提供します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setObjectName("70081"); |
Code Block | ||
---|---|---|
| ||
ReportServiceResponse rs=rsc.remoteReportCall(rsr); |
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。
返される応答には、他のレポート固有のパラメーターとともに、StatusCodeパラメーターが含まれます。詳細は、上記応答パラメーターの表を参照してください。
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
<%<entityId>61250</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>HELPON</formatKey> <formatValue>true</formatValue> <groupId>61250</groupId> /*</filters> <filters> ws_filteroptions.jsp <componentId>0</componentId> */ %> <% <entityId>61250</entityId> ReportServiceResponse rs = null; ReportServiceRequest rsr = new ReportServiceRequest(); <entityTypeCode>REPORTGROUP</entityTypeCode> ReportServiceService ts = new ReportServiceServiceLocator("localhost", 8080, "/services/ReportService", false); ReportServiceSoapBindingStub rssbs = (ReportServiceSoapBindingStub) ts.getReportService(); <formatKey>SUBTABS</formatKey> rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(1); <formatValue>OFF</formatValue> rsr.setReportRequest("FILTEROPTIONS"); rsr.setReportId(70066); rsr.setObjectName("70081");<groupId>61250</groupId> </filters> rs = rssbs.remoteReportCall(rsr); <filters> if ("SUCCESS".equals(rs.getStatusCode())) { out.write("Success </br>"); <componentId>0</componentId> <entityId>61250</entityId> ReportRow[] rows = rs.getResults(); <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>UNITSELECTION</formatKey> <formatValue>OFF</formatValue> for (ReportRow r: rows) { <groupId>61250</groupId> </filters> <groupTypeCode>ANALYTIC</groupTypeCode> //display filter values: <languageCode>EN</languageCode> <longDescription/> <owner>1</owner> <ownerTypeCode>ORGANISATION</ownerTypeCode> <parentGroupId>0</parentGroupId> <shortDescription>Sales Performance</shortDescription> <startDate>2017-06-26T00:00:00+10:00</startDate> out.write("<br>" + r.getDataValue()[0]); <statusCode>OPEN</statusCode> <subCategoryCode>ATHLETES</subCategoryCode> <subtabs> <elements> } } else { out.write(rs.getStatusCode()); <columnNumber>1</columnNumber> out.write(rs.toString()); } %> |
レポート結果セット関数
これらのwebサービスは、レポートにより生成される結果に固有のものです。
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||
こちらのwebサービスは、指定したレポートの結果データと、レポートのメタデータを取得します。レポートの結果は、書式設定されていないそのままの形式になります。この結果は、ReportRowオブジェクトの配列に保存され、このオブジェクトは、各結果ロウ(行)を表します。そのため、各ロウ(行)に対して、結果データの各カラム(列)のデータを含む文字列の配列が存在します。 注意:このデータを、文字列表現から各特定のカラム(列)のデータ型に変換するのは、webサービスクライアント次第です。各カラム(列)のデータ型は、SCHEMA関数で取得することができます。 例えば、以下は2つのカラム(列)を含み、各ユーザーロールに割り当てられたユーザー数を特定するロール集計レポートを示しています。
こちらのwebサービスは、各ユーザーロールのReportRowオブジェクトを返します。各オブジェクトは、2つのデータ文字列を含みます。ひとつはロール名であり、もうひとつはユーザー数を表示します。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらの主要なパラメーターが含まれます。(より詳細な応答パラメーターの一覧は、ReportServiceResponseオブジェクトを参照してください)
応答の例サービスは、今回のSOAPの例に基づき、以下の応答を返します。
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。 Expand | | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Code Block | ||||
---|---|---|---|---|
| ||||
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("RESULTSET"); |
結果セットを取得するレポートを指定します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportId(60712); |
レポートクライアント参照IDを指定することもできます。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportClientReferenceId("1"); |
Code Block | ||
---|---|---|
| ||
ReportServiceResponse rs=rsc.remoteReportCall(rsr); |
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。
返される応答には、他のレポート固有のパラメーターとともに、StatusCodeと結果パラメーターが含まれます。詳細は、上記応答パラメーターの表を参照してください。
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
Code Block | ||||
---|---|---|---|---|
| ||||
<% <portletHeight>331</portletHeight> <portletStatus>RESTORED</portletStatus> <rowNumber>3</rowNumber> <sequenceNumber>2</sequenceNumber> <startDate>2017-06-26T00:00:00+10:00</startDate> /*<tabId>61251</tabId> </elements> ws_resultset.jsp <elements> */ %> <%@ 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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% <columnNumber>1</columnNumber> <entityId>61067</entityId> ReportService rsc = new ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService");<entityTypeCode>REPORT</entityTypeCode> ReportServiceRequest rsr = new ReportServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); <portletHeight>225</portletHeight> rsr.setOrgId(new Integer(1)); rsr.setReportRequest("RESULTSET"); rsr.setReportId(60712); rsr.setReportClientReferenceId("1"); <portletStatus>RESTORED</portletStatus> ReportServiceResponse rs=rsc.remoteReportCall(rsr); if ("SUCCESS".equals(rs.getStatusCode())) { <rowNumber>3</rowNumber> JAXBContext context = JAXBContext.newInstance(ReportServiceResponse.class); <sequenceNumber>3</sequenceNumber> Marshaller m = context.createMarshaller(); m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE); // To format XML <startDate>2017-06-26T00:00:00+10:00</startDate> JAXBElement<ReportServiceResponse> rootElement =<tabId>61251</tabId> new JAXBElement<ReportServiceResponse>(new QName("ReportServiceResponse"), ReportServiceResponse.class, rs); m.marshal(rootElement,out); </elements> //out.write("Success"); } else { <elements> out.write("Failure"); out.write(" Code: " + rs.getErrorCode()); <columnNumber>2</columnNumber> } %> |
title | FORMATTEDRESULTSET |
---|
こちらのwebサービスは、RESULTSET関数の呼び出しに類似していますが、結果セットをレポートのフォーマッターを使用して返します。
リクエスト要素
以下の要素は、こちらのリクエストとともに渡されます。
リクエスト要素 | データ型 | 説明 |
LoginId | String | Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。 このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。 |
Password | String | 上記アカウントのパスワードです。 |
OrgId | Integer | Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。 |
ReportRequest | String | webサービス関数です。「FORMATTEDRESULTSET」に設定します。 |
OrgRef | String | クライアント組織内部参照IDです。(オプション設定) |
ReportId | Integer | 結果データを参照するレポートのIDです。 |
リクエストの例
以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
Code Block | ||
---|---|---|
| ||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/"> <soapenv:Header/> <soapenv:Body> <entityId>61035</entityId> <entityTypeCode>REPORT</entityTypeCode> <portletHeight>373</portletHeight> <web:remoteReportCall> <portletStatus>RESTORED</portletStatus> <arg0> <loginId>admin@yellowfin.com.au</loginId><rowNumber>2</rowNumber> <password>test</password><sequenceNumber>1</sequenceNumber> <orgId>1</orgId> <startDate>2017-06-26T00:00:00+10:00</startDate> <reportRequest>FORMATTEDRESULTSET</reportRequest> <reportId>58511<<tabId>61251</reportId>tabId> </arg0> </web:remoteReportCall>elements> </soapenv:Body> </soapenv:Envelope> |
応答要素
応答には、これらの主要なパラメーターが含まれます。(より詳細な応答パラメーターの一覧は、ReportServiceResponseオブジェクトを参照してください)
応答要素 | データ型 | 説明 |
StatusCode | String | Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。
|
Results | ReportRow[] | レポートのデータセットの結果を含むオブジェクトの配列です。 |
応答の例
サービスは、今回のSOAPの例に基づき、以下の応答を返します。
Code Block | ||||
---|---|---|---|---|
| ||||
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:remoteReportCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/"> <endDate>9999-12-31T00:00:00+11:00</endDate> <return> <filters> <author>System Administrator</author> <authoringMode>JAVA</authoringMode> <componentId>0</componentId> <averageRunTime>0</averageRunTime> <canDrill>false<<componentTypeCode>REPORT</canDrill>componentTypeCode> <category>Audit Reports</category> <entityId>0</entityId> <dashboardEnabled>true</dashboardEnabled> <dataOutput>COLUMN</dataOutput> <entityTypeCode>REPORTGROUP</entityTypeCode> <datasource>Yellowfin Configuration Database</datasource> <errorCode>0<<formatKey>DEFAULTDISPLAY</errorCode>formatKey> <formatCode>REPORTANDCHART</formatCode> <formatValue>SUMMARYCHART</formatValue> <hitCount>5</hitCount> <lastModifiedDate>2016-04-13</lastModifiedDate> <groupId>61250</groupId> <lastRunDuration>0</lastRunDuration> <lastRunStatus>RUN_NOERROR</lastRunStatus></filters> <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages> <filters> <messages>Loaded Report: 58511 Successfully</messages> <componentId>0</componentId> <messages>Returning RAW Resultset</messages> <messages>Request Contains No ReportFilter Records.<<componentTypeCode>REPORT</messages>componentTypeCode> <messages>Report Run Successfully</messages> <entityId>0</entityId> <messages>Web Service Request Complete</messages> <private>false<<entityTypeCode>REPORTGROUP</private>entityTypeCode> <reportDescription/> <formatKey>DEFAULTDISPLAY</formatKey> <reportId>58511</reportId> <reportName>Role Population</reportName> <formatValue>SUMMARYCHART</formatValue> <reportTemplate>REPORTANDCHART</reportTemplate> <reportUUID>00c65743-15f8-4f93-ace1-e3d4d2b956eb</reportUUID><groupId>61250</groupId> <reportUsage>9</reportUsage> </filters> <results> <filters> <dataValue>System Administrator</dataValue> <dataValue>1<<componentId>0</dataValue>componentId> </results> <componentTypeCode>REPORT</componentTypeCode> <results> <dataValue>Consumer & Collaborator<<entityId>0</dataValue>entityId> <dataValue>5</dataValue> <entityTypeCode>REPORTGROUP</entityTypeCode> </results> <sessionId>1e4f0c8ee07d24a5500f952a459b1652</sessionId> <formatKey>DEFAULTDISPLAY</formatKey> <statusCode>SUCCESS</statusCode> <formatValue>SUMMARYCHART</formatValue> <subCategory>User Access</subCategory> <tags>No tags</tags> <groupId>61250</groupId> <viewName>NEW VIEW</viewName> </return>filters> </ns2:remoteReportCallResponse> </S:Body> </S:Envelope> |
手順
Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
title | 詳細手順 |
---|
Code Block | ||||
---|---|---|---|---|
| ||||
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("FORMATTEDRESULTSET"); |
書式設定された結果セットを取得するレポートを指定します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportId(60712); |
レポートクライアント参照IDを指定することができます。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportClientReferenceId("1"); |
Code Block | ||
---|---|---|
| ||
ReportServiceResponse rs=rsc.remoteReportCall(rsr); |
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。
返される応答には、他のレポート固有のパラメーターとともに、StatusCodeと結果パラメーターが含まれます。詳細は、上記応答パラメーターの表を参照してください。
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
Code Block | ||||
---|---|---|---|---|
| ||||
<% <filters> <componentId>61035</componentId> <componentTypeCode>REPORT</componentTypeCode> <entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> <formatKey>DEFAULTDISPLAY</* formatKey> ws_resultset.jsp <formatValue>CHART</formatValue> */ %> <%@ 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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% <groupId>61250</groupId> </filters> ReportService rsc = new<filters> ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService"); ReportServiceRequest rsr = new ReportServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au");<componentId>61067</componentId> rsr.setPassword("test"); rsr.setOrgId(new Integer(1)); rsr.setReportRequest("FORMATTEDRESULTSET"); rsr.setOrgRef("1");<componentTypeCode>REPORT</componentTypeCode> rsr.setReportId(60712); rsr.setReportClientReferenceId("1"); ReportServiceResponse rs=rsc.remoteReportCall(rsr); if ("SUCCESS".equals(rs.getStatusCode())) {<entityId>0</entityId> <entityTypeCode>REPORTGROUP</entityTypeCode> JAXBContext context = JAXBContext.newInstance(ReportServiceResponse.class); Marshaller m = context.createMarshaller(); <formatKey>DEFAULTDISPLAY</formatKey> m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE); // To format XML <formatValue>SUMMARYCHART</formatValue> JAXBElement<ReportServiceResponse> rootElement = new JAXBElement<ReportServiceResponse>(new QName("ReportServiceResponse"), ReportServiceResponse.class, rs); <groupId>61250</groupId> m.marshal(rootElement,out); //out.write("Success");</filters> } else { out.write("Failure"); <filters> out.write(" Code: " + rs.getErrorCode()); } %> |
その他
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
こちらの関数は、受信者の電子メールアドレスにレポートを送信します。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
リクエストの例以下のSOAPの例は、こちらの呼び出しに渡すことのできるパラメーターを示しています。
応答要素応答には、これらのパラメーターが含まれます。
応答の例サービスは、今回のSOAPの例に基づき、以下の応答を返します。
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。 返される応答には、次のパラメーターが含まれます:StatusCode、Dashboard、Subtabs。(より詳細な情報は、上記応答パラメーターの表を参照してください)
完成例以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。
完成例以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
webサービスレポートのレポートからのインタラクションを処理します。こちらの関数は、レポートページの変更、ドリルスルー、ドリルダウン、ドリルエニウェアの実行、シリーズ選択の変更など、レポートでのインタラクションに使用します。 AlterationCommandパラメーターは、レポートに組み込まれたテキストコードであり、レポートを変更するためにwebサービスに戻すことができます。
リクエスト要素以下の要素は、こちらのリクエストとともに渡されます。
応答要素応答には、これらのパラメーターが含まれます。
手順Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。 Expand | | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Code Block | ||||
---|---|---|---|---|
| ||||
ReportServiceRequest rsr = new ReportServiceRequest();
rsr.setLoginId("admin@yellowfin.com.au");
rsr.setPassword("test");
rsr.setOrgId(new Integer(1));
rsr.setReportRequest("COMMAND"); |
レポートの保存されているクライアント組織を指定する必要がある場合は、こちらのコードを追加します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setReportClientReferenceId("1"); |
レポートに適用するコマンドを追加します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setAlterationCommand("DRILLDOWN|60712|53655|RXVyb3Bl"); |
必要に応じて、以前のリクエストからセッションIDを渡します。
Code Block | ||||
---|---|---|---|---|
| ||||
rsr.setSessionId("ce509806176f6a0563767bfb0b2bb36f"); |
Code Block | ||
---|---|---|
| ||
ReportServiceResponse rs=rsc.remoteReportCall(rsr); |
レポートwebサービスを初期化します。実行方法の詳細は、こちらを参照してください。
返される応答には、他の固有なパラメーターとともに、StatusCodeパラメーターが含まれます。詳細は、上記応答パラメーターの表を参照してください。
完成例
以下は、こちらの関数の完成例です。こちらを使用するには、以下の手順に従います。
Code Block | ||||
---|---|---|---|---|
| ||||
<%@page import="com.thoughtworks.xstream.io.xml.StaxDriver"%> <%@ 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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% ReportService rsc = new ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService"); ReportServiceRequest rsr = new ReportServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(new Integer(1)); rsr.setReportRequest("COMMAND"); rsr.setReportId(60712);ws_loadparentdashboardtab.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.*" %> <%@ page import="javax.xml.bind.JAXBContext" %> <%@ page import="javax.xml.bind.Marshaller" %> <%@ page import="java.io.StringWriter" %> <%@ page import="javax.xml.bind.JAXBElement" %> <%@ page import="javax.xml.namespace.QName" %> <% ReportService rsc = new ReportService(); //("localhost", 8080, "admin@yellowfin.com.au", "test", "/services/ReportService"); ReportServiceRequest rsr = new ReportServiceRequest(); rsr.setLoginId("admin@yellowfin.com.au"); rsr.setPassword("test"); rsr.setOrgId(new Integer(1)); rsr.setReportRequest("LOADPARENTDASHBOARDTAB"); rsr.setOrgRef("1"); rsr.setReportId(60712); rsr.setAlterationCommand("drill-down|60712"); rsr.setReportClientReferenceId("1"); rsr.setDashboardTabId(70080); ReportServiceResponse rs=rsc.remoteReportCall(rsr); if ("SUCCESS".equals(rs.getStatusCode())) { JAXBContext context = JAXBContext.newInstance(ReportServiceResponse.class); Marshaller m = context.createMarshaller(); m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE); // To format XML JAXBElement<ReportServiceResponse> rootElement = new JAXBElement<ReportServiceResponse>(new QName("ReportServiceResponse"), ReportServiceResponse.class, rs); m.marshal(rootElement,out); //out.write("Success"); } else { rsrout.setAlterationCommandwrite("DRILLDOWN|60712|53655|RXVyb3BlFailure"); rsr.setReportClientReferenceId("1"); rsr.setSessionId("ce509806176f6a0563767bfb0b2bb36f"); ReportServiceResponse rs=rsc.remoteReportCall(rsrout.write(" Code: " + rs.getErrorCode()); } %> |
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
これを実行するコードは、以下の通りです。
|
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
GETDASHBOARDREPORTFILTERVALUESリクエストは、ダッシュボードタブ上の特定のレポートのフィルターメタデータを返します。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|
Expand | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||
RUNDASHBOARDREPORTリクエストは、ダッシュボードタブ上の指定したレポートを実行し、エクスポートします。応答はグラフ、GISマップ、CSSスタイルを含む、Base64でエンコードされたHTMLを含みます。 これを実行するコードは、以下の通りです。
返されるReportServiceResponseオブジェクトの構成は、以下の通りです。
|