Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

 

プライマリー組織、またはクライアント組織のユーザーに属するオブジェクトを、こちらの項目に分類されるwebサービスを使用して、取得したり、操作したりすることができます。取得される情報は、オブジェクトのメタデータ(名前、説明、IDなど)に関連するものであり、実際のコンテンツではありません。レポートの実際のデータ(HTMLやPDF)を取得する場合は、Yellowfinのレポートwebサービスを使用します。

 

 

プライマリー組織(デフォルト組織)、またはクライアント組織のユーザーに属するYellowfinオブジェクトやコンテンツを、こちらの項目に分類されるwebサービスの呼び出しを使用して、取得したり、操作したりすることができます。取得される情報は、オブジェクトのメタデータ(レポートやダッシュボードの名前、説明、IDなど)に関連するものであり、実際のコンテンツではありません。レポートの実際のデータ(HTMLやPDF)を取得する場合は、Yellowfinのレポートwebサービスを使用します。

レポートオブジェクト

以下のwebサービスの呼び出しは、ユーザーのYellowfinの取得や管理に関連しています。以下のwebサービスの呼び出しは、ユーザーのYellowfinレポートの取得や管理に関連しています。

Expand
titleGETUSERREPORT

特定のユーザーにアクセス可能な、指定したレポートIDのレポートメタデータを取得します。AdministrationPersonオブジェクトを使用して、ユーザーを識別することができます。

レポートを編集する際には、レポートIDは変更されるが、レポートのUUIDは常に同一であることに注意をしてください。レポートに対応するUUIDは、GETIDFORUUIDの呼び出しを使用して、確認することができます。レポートを編集する度に、レポートIDは変更されますが、レポートのUUIDは常に同一であることに注意をしてください。現在のIDに対応するUUIDは、GETIDFORUUIDの呼び出しを使用して、確認することができます。

 


リクエストパラメーター

以下の要素は、こちらのリクエストとともに渡されます。

リクエスト要素データ型説明

LoginId

String

Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

Password

String

上記アカウントのパスワードです。

OrgId

Integer

Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

Function

String

Webサービス関数です。こちらは、「GETUSERREPORT」に設定します。

PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。
ReportIdInteger詳細を確認するレポートの一意のIDです。こちらのレポートは、既にYellowfinに存在していなくてはいけません。
 


以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

AdministrationPerson要素データ型説明
UserIdStringレポートを取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
 


リクエストの例

以下は、こちらのリクエストのSOAP XMLの例です。

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <web:remoteAdministrationCall>
         <arg0>
          <loginId>admin@yellowfin.com.au</loginId>
            <password>test</password>
            <orgId>1</orgId>
            <function>GETUSERREPORT</function>
            <reportId>56401</reportId>      
            <person>
                <userId>admin@yellowfin.com.au</userId>             
            </person>      
         </arg0>
      </web:remoteAdministrationCall>
   </soapenv:Body>
</soapenv:Envelope>
 


応答パラメーター

返される応答には、これらのパラメーターが含まれます。

応答要素データ型説明

StatusCode

String

Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

  • SUCCESS
  • FAILURE
PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
REportsReportsAdministrationReport[]指定したレポートの詳細を含む配列です。

応答の例

サービスは、今回のSOAPの例に基づき、以下の応答を返します。

Code Block
languagexml
themeEclipselanguagexml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
         <return>
            <errorCode>0</errorCode>
            <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
            <messages>Getting user information...</messages>
            <messages>Getting user information...</messages>
            <messages>Web Service Request Complete</messages>
            <person>
               <emailAddress>admin@yellowfin.com.au</emailAddress>
               <firstName>System</firstName>
               <initial/>
               <ipId>5</ipId>
               <languageCode>EN</languageCode>
               <lastName>Administrator</lastName>
               <roleCode>YFADMIN</roleCode>
               <salutationCode/>
               <status>ACTIVE</status>
               <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
               <userId>admin@yellowfin.com.au</userId>
            </person>
            <reports>
               <authoringMode>JAVA</authoringMode>
               <averageRunTime>0</averageRunTime>
               <birtData/>
               <chartTypeCode/>
               <dashboardEnabled>true</dashboardEnabled>
               <dataOutput>COLUMN</dataOutput>
               <deliveryMode/>
               <executionObject/>
               <lastModifiedDate>2016-03-29T00:00:00+11:00</lastModifiedDate>
               <lastModifierId>5</lastModifierId>
               <lastModifierName>System Administrator</lastModifierName>
               <publishDate>2016-03-23T00:00:00+11:00</publishDate>
               <reportCategory>Audit Reports</reportCategory>
               <reportDescription/>
               <reportId>56401</reportId>
               <reportName>Active Sessions</reportName>
               <reportSubCategory>Admin Reports</reportSubCategory>
               <reportTemplate>REPORTANDCHART</reportTemplate>
               <reportUUID>594d4da4-1b58-44d3-bf4f-11456a42f68c</reportUUID>
               <roleCode>OPERATIONAL</roleCode>
               <sourceName/>
               <usage>4</usage>
               <viewDescription>Yellowfin Usage Audit</viewDescription>
               <viewId>56169</viewId>
               <viewName>NEW VIEW</viewName>
            </reports>
            <sessionId>3a4f9969aa278c03fa4cb891a87d6f36</sessionId>
            <statusCode>SUCCESS</statusCode>
         </return>
      </ns2:remoteAdministrationCallResponse>
   </S:Body>
</S:Envelope>

 


手順

Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

説明


StatusCode

: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

  • SUCCESS
  • FAILURE

Person

: AdministrationPerson

ユーザーの完全な詳細です。

- ユーザーの完全詳細です。
Reports

: AdministrationReport[]

- 指定したレポートの詳細を含む配列です。


  •  レポートを取得します。 


  • Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERREPORT");


    • レポートを取得するユーザーを指定します。


      Code Block
       code
      language
      java
      themeEclipse
      languagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • 特定のクライアント組織を識別することもできます。 


      code
      Code Block
      language
      java
      themeEclipselanguagejava
      rsr.setOrgRef("org1");


    • レポートIDを提供します。これは、既存のレポートのIDでなければいけません。 


      code
      Code Block
      language
      java
      themeEclipse
      languagejava
      rsr.setReportId(70292);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、これらのパラメーターが含まれます。

    応答要素データ型
    Code Block
    レポートを取得します。code
    language

     

    java
    themeEclipse
    languagejava
    AdministrationReport[] rpts = rs.getReports();
    AdministrationReport report = rpts[0];          // getting the metadata of the first report

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserreport.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserreport.jsp」を実行します。

    Code Block
    languagejava
    themeEclipselanguagejava
    <%           
    /*              ws_getuserreport.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERREPORT");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    rsr.setReportId(70297);                             //existing report id. ReportId field of ReportHeader table (Yellowifn database)
     
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>");
     
        // get the report details:
        AdministrationReport[] rpts = rs.getReports();
        for (AdministrationReport r: rpts){
            out.write("<br>Report Name: " + r.getReportName());
            out.write("<br>Description: " + r.getReportDescription());
            out.write("<br>Category: " + r.getReportCategory());
            out.write("<br>Subcategory: " + r.getReportSubCategory());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETALLUSERREPORTS

    こちらの関数は、特定のユーザーにアクセス可能な、すべてのレポートのメタデータを取得します。AdministrationPersonオブジェクトを使用して、ユーザーを識別することができます。

    クライアント組織を指定する場合は、その組織内のすべてのレポートを取得します。それ以外の場合は、デフォルト組織のすべてのレポートが取得されます。 


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETALLUSERREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。

     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringレポートを取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETALLUSERREPORTS</function>
                <person>
                    <userId>binish.sheikh@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>

     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationReport[]すべてのレポートの詳細を含む配列です。指定されたレポートの詳細を含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipselanguagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>binish.sheikh@yellowfin.com.au</emailAddress>
                   <firstName>Binish</firstName>
                   <ipId>13000</ipId>
                   <lastName>Sheikh</lastName>
                   <roleCode>YFREPORTCONSUMER</roleCode>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/BRISBANE</timeZoneCode>
                   <userId>binish.sheikh@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-03-29T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-03-23T00:00:00+11:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>56401</reportId>
                   <reportName>Active Sessions</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>594d4da4-1b58-44d3-bf4f-11456a42f68c</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>4</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>ROW</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-03-29T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-03-23T00:00:00+11:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>56398</reportId>
                   <reportName>System Startup</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>0866847b-03cc-43ef-9612-2f52467cac8c</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>4</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>9</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-04-13T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-04-13T00:00:00+10:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>57703</reportId>
                   <reportName>Top N Data Sources by Report Usage</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>e0669303-77ab-459e-bb98-d2fa73851b83</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-04-13T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-04-13T00:00:00+10:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>57911</reportId>
                   <reportName>Top N Longest Avg Report Rows</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>f75a2389-39d8-497b-8fb2-5d1a3fc6d605</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <sessionId>c4919cd467b887a60fd4449eaa3ab9a1</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>
     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    説明


    StatusCode

    : String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE

    Person

    : AdministrationPerson

    ユーザーの完全な詳細です。

    - ユーザーの完全詳細です。
    Reports

    : AdministrationReport[]

    - すべてのレポートの詳細を含む配列です。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETALLUSERREPORTS");


    • レポートを取得するユーザーを指定します。 


      code
      Code Block
      language
      java
      themeEclipse
      languagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • その組織のレポートのみを検索するために、特定のクライアント組織を識別することもできます。


      Code Block
       code
      language
      java
      themeEclipse
      languagejava
      rsr.setOrgRef("org1");


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、これらのパラメーターが含まれます。

    応答要素データ型
     


    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getalluserreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getalluserreports.jsp」を実行します。

    Code Block
    language
    languagejava
    themeEclipsejava
    <%           
    /*              ws_getalluserreports.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETALLUSERREPORTS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReports().length + " reports retrieved");
         
        // get the report details:
        AdministrationReport[] rpts = rs.getReports();
        for (AdministrationReport r: rpts){
            out.write("<br><br>Report Name: " + r.getReportName());
            out.write("<br>Description: " + r.getReportDescription());
            out.write("<br>Category: " + r.getReportCategory());
            out.write("<br>Subcategory: " + r.getReportSubCategory());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETREPORTSWITHCOMMENTS

    こちらの関数は、指定したユーザーにアクセス可能なすべてのレポートを、コメントとともに返します。AdministrationPersonオブジェクトを使用して、ユーザーを指定することができます。こちらの関数は、指定したユーザーにアクセス可能なすべてのコメント付きレポートを返します。AdministrationPersonオブジェクトを使用して、ユーザーを指定することができます。

    クライアント組織を指定する場合は、その組織内のすべてのコメント付きレポートを取得します。それ以外の場合は、デフォルト組織のレポートが取得されます。 


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETREPORTSWITHCOMMENTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。
     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringレポートを取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。

     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETREPORTSWITHCOMMENTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>
     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationReport[]すべてのコメント付きレポートの詳細を含む配列です。コメント付きレポートの詳細を含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    languagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <lastRunTime>0</lastRunTime>
                   <publishDate>2014-08-20T00:00:00+10:00</publishDate>
                   <reportCategory>Tutorial</reportCategory>
                   <reportDescription>Drill Anywhere report to compare invoicing figures by different categories.</reportDescription>
                   <reportId>61025</reportId>
                   <reportName>Invoice vs. Estimate</reportName>
                   <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>879d3175-1d40-4495-a4d4-45a24e781e53</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>1</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <sessionId>5504cc102037ca2193083902900abf75</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>

     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    StatusCode

    : String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

    - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE

    Person

    : AdministrationPerson

    ユーザーの完全な詳細です。

    - ユーザーの完全詳細です。
    Reports

    : AdministrationReport[]

    - コメント付きレポートの詳細を含む配列です。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETREPORTSWITHCOMMENTS");


    • レポートを取得するユーザーを指定します。


      Code Block
       code
      language
      java
      themeEclipse
      languagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、これらのパラメーターが含まれます。

      応答要素


    データ型説明

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getreportswithcomments.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getreportswithcomments.jsp」を実行します。

    Code Block
    languagejava
    themeEclipselanguagejava
    <%           
    /*              ws_getreportswithcomments.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETREPORTSWITHCOMMENTS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReports().length + " reports retrieved");
         
        // get the report details:
        AdministrationReport[] rpts = rs.getReports();
        for (AdministrationReport r: rpts){
            out.write("<br><br>Report Name: " + r.getReportName());
            out.write("<br>Description: " + r.getReportDescription());
            out.write("<br>Category: " + r.getReportCategory());
            out.write("<br>Subcategory: " + r.getReportSubCategory());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETUSERREPORTS

    指定したユーザーからアクセス可能であり、webサービス名とともに保存されたレポートのメタデータのみを取得します。この名前は、以下に示すように、レポートがYellowfinに保存される際に提供されます。

     


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。
     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringwebサービスレポートを取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。

     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERREPORTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>
     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationReport[]webサービスレポートの詳細を含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    languagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject>monitor</executionObject>
                   <lastModifiedDate>2018-03-07T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <lastRunTime>0</lastRunTime>
                   <publishDate>2018-03-07T00:00:00+11:00</publishDate>
                   <reportCategory>Tutorial</reportCategory>
                   <reportDescription>This report provides a high level summary of campaigns</reportDescription>
                   <reportId>70012</reportId>
                   <reportName>Campaign Summary</reportName>
                   <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                   <reportTemplate>CHART</reportTemplate>
                   <reportUUID>3e842fae-02f7-4ad3-a632-ca267e0078da</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>100</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>60543</viewId>
                   <viewName>New View</viewName>
                </reports>
                <sessionId>f491846df1520c32d27451e5b5529ac9</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>

     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERREPORTS");


    • レポートを取得するユーザーを指定します。


      Code Block
       code
      language
      language
      java
      themeEclipsejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、StatusCode、Person、Reportsパラメーターが含まれます。より詳細な情報は、上記応答の表を参照してください。

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    languagejava
    <%          
    /*              ws_getuserreports.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 webservices admin account
    rsr.setPassword("test");                                                      // change to be the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERREPORTS");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");      
      
    rsr.setPerson(ap);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("Success<br>" + rs.getReports().length + " reports retrieved");
                    // get the report details:
                    AdministrationReport[] rpts = rs.getReports();
                    for (AdministrationReport r: rpts){
                                        out.write("<br><br>Report Name: " + r.getReportName());
                                        out.write("<br>Description: " + r.getReportDescription());
                                        out.write("<br>Category: " + r.getReportCategory());
                                        out.write("<br>Subcategory: " + r.getReportSubCategory());
                    }
    } else {
                    out.write("Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETUSERDRAFTREPORTS

    この関数は、指定されたユーザーにアクセス可能なドラフト(編集中)レポート(変更を保存していない、または有効化されていないレポート)を返します。AdministrationPersonオブジェクトを使用して、ユーザーを識別することができます。

     


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERDRAFTREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。
     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringドラフト(下書き中)レポートを取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERDRAFTREPORTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>
     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationReport[]ドラフト(編集中)レポートの詳細を含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipselanguagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-16T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 16/2/2018 12:09 PM</reportDescription>
                   <reportId>70079</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>df0be222-2819-466c-9118-203f9d75acb9</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-19T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 19/2/2018 5:37 PM</reportDescription>
                   <reportId>70284</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>2fe4814b-98da-4c35-ab65-43c0916449fa</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>40</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-20T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 20/2/2018 10:56 AM</reportDescription>
                   <reportId>70299</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>1180e1db-a01c-478e-9d32-55276000abcc</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>100</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-22T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 22/2/2018 5:19 PM</reportDescription>
                   <reportId>70336</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>52da336a-b35b-42a6-be64-8e53d598fbe4</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <sessionId>da91fe1685c8cb4496d8c8374c57035b</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>
     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

    StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE

    Person

    : AdministrationPerson

    ユーザーの完全な詳細です。

    - ユーザーの完全詳細です。
    Reports

    : AdministrationReport[]

    - ドラフト(編集中)レポートの詳細を含む配列です。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERDRAFTREPORTS");


    • レポートを取得するユーザーを指定します。


      Code Block
       code
      language
      java
      themeEclipselanguagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、これらのパラメーターが含まれます。 

    応答要素データ型説明

    StatusCode

    String

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getdraftreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getdraftreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipselanguagejava
    <%           
    /*              ws_getdraftreports.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERDRAFTREPORTS");
    //rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReports().length + " reports retrieved");
         
        // get the report details:
        AdministrationReport[] rpts = rs.getReports();
        for (AdministrationReport r: rpts){
            out.write("<br><br>Report Name: " + r.getReportName());
            out.write("<br>Description: " + r.getReportDescription());
            out.write("<br>Category: " + r.getReportCategory());
            out.write("<br>Subcategory: " + r.getReportSubCategory());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleDELETEREPORT

    この関数は、指定されたユーザーのレポートを削除します。レポートは、レポートID、またはレポートUUIDのいずれかで識別することができます。AdministrationPersonオブジェクトを使用してユーザーを指定します。 


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「DELETEREPORT」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringクライアント組織の参照IDです。こちらのパラメーターは必須ではありません。
    ReportIdInteger削除するレポートの一意のIDです。これは、システム内に既に存在するものでなくてはいけません。
    ParametersString[]または、ReportIdパラメーターの代わりに、こちらを使用してレポートUUIDとともに要素を渡します。
     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringレポートを削除するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>DELETEREPORT</function>
                <reportId>56398</reportId>
                <person>
                    <userId>binish.sheikh@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>

     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipselanguagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>61860d8760ecb216bdf3f455f66c3b14</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>
     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    説明

    StatusCode

    : String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("DELETEREPORT");


    • レポートを削除するユーザーを指定します。 


      code
      Code Block
      language
      language
      java
      themeEclipsejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • 削除するレポートを指定します。IDの提供、IDを提供することで、削除するレポートを指定します。


      Code Block
       code
      language
      java
      themeEclipse
      rsr.setReportId(71081);


    • または、レポートUUIDを渡します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(71081setParameters(new String[] {"0ac13905-aa14-4887-9718-44c29b11311b"});


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、これらのパラメーターが含まれます。

       

    応答要素データ型
     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_deletereport.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_deletereport.jsp」を実行します。

    Code Block
    language
    languagejava
    themeEclipsejava
    <%           
    /*              ws_deletereport.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("DELETEREPORT");
    //rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    //pass the report ID:
    rsr.setReportId(71081);
     
    //or the report UUID:
    rsr.setParameters(new String[] {"0ac13905-aa14-4887-9718-44c29b11311b"});
     
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("<br>Report has been deleted.");
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETINBOX

    これは、指定されたユーザーの受信箱のレポートを返します。これらは、ユーザーに配信されたレポートです。 


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    StringWebサービス関数です。こちらは、「GETINBOX」に設定します。

    Webサービス関数です。こちらは、「GETINBOX」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdString受信箱のレポートを取得するユーザーのIDです。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETINBOX</function>        
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>  
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>
     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationreports[]ユーザーの受信箱のレポートの配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    languagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode>DISTRIBUTE</deliveryMode>
                   <executionObject/>
                   <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <lastRunTime>0</lastRunTime>
                   <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                   <reportCategory>Tutorial</reportCategory>
                   <reportDescription>Look at the number of athletes by age, region, and average camp rating.</reportDescription>
                   <reportId>61053</reportId>
                   <reportName>Profitability by Customer Age &amp; Location Breakdown</reportName>
                   <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                   <reportTemplate>CHART</reportTemplate>
                   <reportUUID>c554165d-7c85-4d19-b19a-61ce5919dc5b</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>25</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode>DISTRIBUTE</deliveryMode>
                   <executionObject/>
                   <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <lastRunTime>0</lastRunTime>
                   <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                   <reportCategory>Tutorial</reportCategory>
                   <reportDescription>Look at the number of athletes by age, region, and average camp rating.</reportDescription>
                   <reportId>61053</reportId>
                   <reportName>Profitability by Customer Age &amp; Location Breakdown</reportName>
                   <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                   <reportTemplate>CHART</reportTemplate>
                   <reportUUID>c554165d-7c85-4d19-b19a-61ce5919dc5b</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>25</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <sessionId>76a9a9f93246f29678744bf60727943f</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>
     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETINBOX");


    • 受信箱のレポートを取得するユーザーを指定します。


      Code Block
       code
      language
      java
      themeEclipselanguagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("test.user@yellowfin.com.au");
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、StatusCode、Person、Reportsパラメーターが含まれます。より詳細な情報は、上記の応答パラメーターの表を参照してください。

       

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getinbox.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getinbox.jsp」を実行します。

    Code Block
    languagejava
    themeEclipselanguagejava
    <%          
    /*              ws_getinbox.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETINBOX");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");
      
    rsr.setPerson(ap);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("<br>Success");
        AdministrationReport[] reports = rs.getReports();
        if (reports != null)
            for(AdministrationReport r: reports){
                out.write("<br>Report Name: " + r.getReportName());
            }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>


    ...

    Expand
    titleGETFAVOURITES

    こちらのwebサービスの呼び出しは、指定したユーザーによりお気に入りに登録されたすべてのレポートを返します。

     


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETFAVOURITEGETFAVOURITES」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。

     


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringお気に入りに登録したレポートを取得するユーザーのIDです。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。
     


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETFAVOURITES</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>  
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>
     


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonAdministrationPersonユーザーの完全な詳細です。ユーザーの完全詳細です。
    ReportsAdministrationreports[]ユーザーのお気に入りレポートの配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipselanguagexml
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-03-29T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-03-23T00:00:00+11:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>56401</reportId>
                   <reportName>Active Sessions</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>594d4da4-1b58-44d3-bf4f-11456a42f68c</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>24</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2016-03-29T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <publishDate>2016-03-23T00:00:00+11:00</publishDate>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription/>
                   <reportId>56401</reportId>
                   <reportName>Active Sessions</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>594d4da4-1b58-44d3-bf4f-11456a42f68c</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>24</usage>
                   <viewDescription>Yellowfin Usage Audit</viewDescription>
                   <viewId>56169</viewId>
                   <viewName>NEW VIEW</viewName>
                </reports>
                <sessionId>dffb6a0f4f155d46c73d1e77dffbd81c</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>
     


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipselanguagejava
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETFAVOURITES");


    • お気に入りレポートを取得するユーザーを指定します。


      Code Block
       code
      language
      java
      themeEclipse
      languagejava
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("test.user@yellowfin.com.au");
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理サービスを初期化します。実行方法の詳細は、管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。

     


    • 返される応答には、StatusCode、Person、Reportsパラメーターが含まれます。より詳細な情報は、上記の応答パラメーターの表を参照してください。

       

     



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getfavourites.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getinboxgetfavourites.jsp」を実行します。

    Code Block
    languagejava
    themeEclipselanguagejava
    <%          
    /*              ws_getinboxgetfavourites.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 account
    rsr.setOrgId(1);
    rsr.setFunction("GETINBOXGETFAVOURITES");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");
      
    rsr.setPerson(ap);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("<br>Success");
        AdministrationReport[] reports = rs.getReports();
        if (reports != null)
            for(AdministrationReport r: reports){
                out.write("<br>Report Name: " + r.getReportName());
            }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>

     

     

    ...



    Expand
    titleISREPORTFAVOURITE

    こちらのwebサービスの呼び出しは、特定のレポートが指定したユーザーのお気に入りに登録されているかどうかを確認します。ユーザーとレポートの両方を指定しなくてはいけません。レポートは、レポートIDを提供することで指定します。このIDは、Yellowfinデータベースのレポートヘッダーテーブルから取得することができます。また、GETIDFORUUID webサービスの呼び出しを使用することで、レポートIDを取得することもできます。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「ISREPORTFAVOURITE」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    ReportIdIntegerユーザーのお気に入りに登録されているかを確認するレポートのレポートIDです。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringお気に入りに登録したレポートを取得するユーザーのIDです。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>ISREPORTFAVOURITE</function>
                <reportId>56401</reportId>
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>  
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS:指定したレポートが、ユーザーのお気に入りに登録されている場合。
    • FAILURE:レポートが、ユーザーのお気に入りに登録されていない場合。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>ca75c7ebef710e4fc7c6ca6137baa784</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("ISREPORTFAVOURITE");


    • レポートのお気に入り登録状況を確認するユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("test.user@yellowfin.com.au");
      rsr.setPerson(ap);


    • お気に入り登録状況を確認するレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(61131);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeが含まれます。より詳細な情報は、上記の応答パラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_isreportfavourite.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_isreportfavourite.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_isreportfavourite.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("ISREPORTFAVOURITE");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");
      
    rsr.setPerson(ap);
      
    rsr.setReportId(61131);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                                         
    } else {
                    out.write("Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleADDTOFAVOURITES

    こちらのwebサービスの呼び出しは、特定のレポートを指定したユーザーのお気に入りに登録します。ユーザーとレポートの両方を指定しなくてはいけません。レポートは、レポートIDを提供することで指定します。レポートIDは、GETIDFORUUIS webサービスの呼び出しを使用するか、データベース(値は、レポートヘッダーテーブルに保存されています)から取得します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「ADDTOFAVOURITES」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    ReportIdIntegerユーザーのお気に入りとして登録するレポートのレポートIDです。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringレポートをお気に入りに登録するユーザーのIDです。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>ADDTOFAVOURITES</function>
                <reportId>56401</reportId>
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>  
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS:レポートが、ユーザーのお気に入りに登録される場合。
    • FAILURE:レポートが、ユーザーのお気に入りに登録されない場合。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>cf897244c65ceecd6c4c39e8ab8c4fcb</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("ADDTOFAVOURITES");


    • レポートのお気に入り登録状況を確認するユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("test.user@yellowfin.com.au");
      rsr.setPerson(ap);


    • お気に入り登録状況を確認するレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(61131);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeが含まれます。より詳細な情報は、上記の応答パラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_addtofavourites.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_addtofavourites.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    /*              ws_addtofavourites.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 webservices admin account
    rsr.setPassword("test");                                                      // change to be the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("ADDTOFAVORITES");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");
      
    rsr.setPerson(ap);
      
    rsr.setReportId(56361);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("<br>Success");
                                         
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleREMOVEFAVOURITE

    こちらのwebサービスの呼び出しは、特定のレポートを指定したユーザーのお気に入り登録から削除します。ユーザーとレポートの両方を指定しなくてはいけません。レポートは、レポートIDを提供することで指定します。レポートIDは、GETIDFORUUIS webサービスの呼び出しを使用するか、データベース(値は、レポートヘッダーテーブルに保存されています)から取得します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「REMOVEFAVOURITE」、または「REMOVEFAVORITE」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    ReportIdIntegerユーザーのお気に入り登録から削除するレポートのレポートIDです。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringレポートをお気に入り登録から削除するユーザーのIDです。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>REMOVEFAVOURITE</function>
                <reportId>56401</reportId>
                <person>
                    <userId>admin@yellowfin.com.au</userId>
                </person>  
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS:レポートが、ユーザーのお気に入り登録から削除される場合。
    • FAILURE:レポートが、ユーザーのお気に入り登録から削除されない場合。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>1be6b980918323dab6f41fec3c040c56</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("REMOVEFAVOURITE");


    • レポートのお気に入り登録状況を確認するユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("test.user@yellowfin.com.au");
      rsr.setPerson(ap);


    • お気に入り登録状況を確認するレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(61131);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeが含まれます。より詳細な情報は、上記の応答パラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_removefavourite.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_removefavourite.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    /*              ws_removefavourite.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("REMOVEFAVOURITE");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");
      
    rsr.setPerson(ap);
      
    rsr.setReportId(56361);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                                         
    } else {
                    out.write("Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleAPPROVEREPORT

    こちらのwebサービスは、レポートを承認するために使用します。レポート承認者は、(このアカウントが承認者として一覧化されていないとしても)LonginIdパラメーターを使用して指定されたアカウントのユーザーです。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスに接続する管理者アカウントです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「APPROVEREPORT」に設定します。

    ReportIdInteger承認が必要なレポートのIDです。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    themeEclipse
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
        <web:remoteAdministrationCall>
            <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>APPROVEREPORT</function>
                <reportId>73740</reportId>
            </arg0>
        </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
        <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
            <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>4e375028ec457bba4985965d5d71e64e</sessionId>
                <statusCode>SUCCESS</statusCode>
            </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数のリクエストを定義します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
        
      rsr.setLoginId("admin@yellowfin.com.au");      
      rsr.setPassword("test");          
      rsr.setOrgId(1);
      rsr.setFunction("APPROVEREPORT");


    • そのIDを提供することで、承認が必要なレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(73740);


    • リクエストを構成したら、呼び出しを実行してサーバをテストします。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • webサービスの応答であるStatusCodeを取得します。


      Code Block
      languagejava
      themeEclipse
      if ("SUCCESS".equals(rs.getStatusCode()) ) {
                      out.write("<br>Success");
                       
      }
      else {
                      out.write("<br>Failure");
                      out.write(" Code: " + rs.getErrorCode());
      }



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_approvereport.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_approvereport.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_approvereport.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 webservices admin account
    rsr.setPassword("test");                        // change to the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("APPROVEREPORT");
    rsr.setReportId(73740);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                     
    }
    else {
                    out.write("<br>Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }              
    %>



    Expand
    titleREJECTREPORT

    こちらのwebサービスは、ドラフト(編集中)モードに変更することで、レポートを却下します。レポート承認者は、(このアカウントが承認者として一覧化されていないとしても)LonginIdパラメーターを使用して指定されたアカウントのユーザーです。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスに接続する管理者アカウントです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「REJECTREPORT」に設定します。

    ReportIdInteger却下が必要なレポートのIDです。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    themeEclipse
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
        <web:remoteAdministrationCall>
            <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>REJECTREPORT</function>
                <reportId>73740</reportId>
            </arg0>
        </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
        <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
            <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>4e375028ec457bba4985965d5d71e64e</sessionId>
                <statusCode>SUCCESS</statusCode>
            </return>
        </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数のリクエストを定義します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
        
      rsr.setLoginId("admin@yellowfin.com.au");      
      rsr.setPassword("test");          
      rsr.setOrgId(1);
      rsr.setFunction("REJECTREPORT");


    • そのIDを提供することで、却下するレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      rsr.setReportId(73740);


    • リクエストを構成したら、呼び出しを実行してサーバをテストします。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • webサービスの応答であるStatusCodeを取得します。


      Code Block
      languagejava
      themeEclipse
      if ("SUCCESS".equals(rs.getStatusCode()) ) {
                      out.write("<br>Success");
                       
      }
      else {
                      out.write("<br>Failure");
                      out.write(" Code: " + rs.getErrorCode());
      }



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_rejectreport.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_rejectreport.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_rejectreport.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 webservices admin account
    rsr.setPassword("test");                        // change to the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("REJECTREPORT");
    rsr.setReportId(73740);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                     
    }
    else {
                    out.write("<br>Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }              
    %>



    Expand
    titleCOPYREPORT

    こちらのwebサービスは、すべての依存関係(関連レポート、など)を含めて、定義されたカテゴリー・サブカテゴリー(フォルダー・サブフォルダ―)にレポートをコピーします。コピー先のフォルダーは、目標とするクライアント組織に存在するものでなくてはいけません。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスに接続する管理者アカウントです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「COPYREPORT」に設定します。

    ReportAdministrationReportコピーされるレポートの詳細です。以下の表を参照してください。
    OrgRefStringレポートのコピー先となるクライアント組織です。こちらが指定されない場合、レポートはデフォルト組織にコピーされます。


    以下のパラメーターは、AdministrationReportオブジェクトに設定されます。

    リクエスト要素データ型説明

    ReportUUID

    String

    コピーするレポートのUUIDを提供します。
    ReportIdIntegerまたは、レポートIDを指定します。

    ReportCategory

    String

    必須パラメーターです。レポートをコピーするカテゴリー(フォルダー)を指定します。

    ReportSubCategory

    String

    必須パラメーターです。レポートをコピーするサブカテゴリー(サブフォルダー)を指定します。


    Note

    ReportCategory、およびReportSubCategoryはリソースコードの形式にする必要があります。リソースコードは、GETCATEGORIES webサービスを使用するか、RefTypeCode IN(「RPTCATEGORY」、「RPTSUBCATEGORY」)によりフィルターが適用されたYellowfinのデータベース(orgReferenceCodeDescテーブル内)に直接移動することで確認できます。ここでは、リソースコードはRefCodeです。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    themeEclipse
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
        <web:remoteAdministrationCall>
            <arg0>
             <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>COPYREPORT</function>
                <report>
                    <reportId>73753</reportId>
                    <reportUUID>4cd72d5e-68bb-4bb5-98e2-6562e7f228c5</reportUUID>
                    <reportCategory>TUTORIAL</reportCategory>
                    <reportSubCategory>TRAINING</reportSubCategory>
                </report>
            </arg0>
        </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、以下のパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportAdministrationReportコピーされるレポートの詳細です。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
        <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
            <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <report>
                   <authoringMode>JAVA</authoringMode>
                <birtData/>
                <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                <deliveryMode/>
                <executionObject/>
                   <lastModifiedDate>2018-06-04T00:00:00+10:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                <lastModifierName>System Administrator</lastModifierName>
                <reportCategory/>
                <reportDescription>A drill through report displaying revenue by camp region and year, allowing to drill through to a detail report.</reportDescription>
                   <reportId>73773</reportId>
                <reportName>Sales Report</reportName>
                <reportSubCategory/>
                   <reportTemplate>REPORT</reportTemplate>
                <reportUUID>687a5403-dd4c-44c8-a30b-7c9668305c46</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                <sourceName/>
                <usage>0</usage>
                <viewDescription>Ski Team</viewDescription>
                <viewId>60543</viewId>
                <viewName>New View</viewName>
                </report>
                <sessionId>b9b1774145c8d3f2a1555e8eb9daf92a</sessionId>
                <statusCode>SUCCESS</statusCode>
            </return>
        </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数のリクエストを定義します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
        
      rsr.setLoginId("admin@yellowfin.com.au");      
      rsr.setPassword("test");          
      rsr.setOrgId(1);
      rsr.setFunction("COPYREPORT");


    • コピーするレポートを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport rpt = new AdministrationReport();
      rpt.setReportId(73753);


    • レポートをコピーするフォルダー、サブフォルダ―も指定します。


      Code Block
      languagejava
      themeEclipse
      rpt.setReportCategory("TUTORIAL");
      rpt.setReportSubCategory("TRAINING");
        
      rsr.setReport(rpt);


    • リクエストを構成したら、呼び出しを実行してサーバをテストします。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • webサービスの応答であるStatusCodeを取得します。


      Code Block
      languagejava
      themeEclipse
      if ("SUCCESS".equals(rs.getStatusCode()) ) {
                      out.write("<br>Success");
                       
      }
      else {
                      out.write("<br>Failure");
                      out.write(" Code: " + rs.getErrorCode());
      }



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_copyreport.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_copyreport.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_copyreport.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 webservices admin account
    rsr.setPassword("test");                        // change to the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("COPYREPORT");
      
    AdministrationReport rpt = new AdministrationReport();
    rpt.setReportId(73753);
    rpt.setReportCategory("TUTORIAL");
    rpt.setReportSubCategory("TRAINING");
      
    rsr.setReport(rpt);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                     
    }
    else {
                    out.write("<br>Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }              
    %>



    ダッシュボードオブジェクト

    以下のwebサービスの呼び出しは、ユーザーのダッシュボードタブの取得や管理に関連しています。

    Expand
    titleGETUSERTABS

    こちらのwebサービスの呼び出しは、指定したユーザーの公開したすべてのダッシュボードのメタデータを返します。また、ダッシュボード内の各タブを、個別のタブとして扱います。そのため、ダッシュボードに2つのタブがある場合は、2つの異なるダッシュボードのAdministrationReportGroupオブジェクトを取得します。親ダッシュボードの詳細だけ必要な場合は、GETUSERPARENTTABSの呼び出しを使用します。そのIDを渡すことで、特定のダッシュボードタブの詳細を取得することができます。

    こちらのサービスは、ダッシュボードのレポートのメタデータは取得しないことに注意してください。これを取得するためには、GETUSERTABSWITHREPORTSの呼び出しを使用します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERTABS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringデフォルト組織に代わり、特定のクライアント組織内のタブを検索するためのクライアント組織参照IDです。こちらのパラメーターは必須ではありません。
    DashboardTabIdInteger詳細を取得するダッシュボードタブの一意のIDを提供する場合は、こちらのオプションパラメーターを使用します。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードタブの所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERTABS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]ダッシュボードのメタデータを含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <publishUUID>02fec2d8-6b09-48a1-8c6a-54adbb2eb9b6</publishUUID>
                   <reportGroupId>61251</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>2e2fb9f6-d43e-4de2-977e-a646b01abc4b</publishUUID>
                   <reportGroupId>61210</reportGroupId>
                   <reportGroupName>Campaign Analysis (Campaigns)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>1a387957-564b-40ad-9fc1-4167ddd61f33</publishUUID>
                   <reportGroupId>61243</reportGroupId>
                   <reportGroupName>Campaign Analysis (Marketing)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>0ad8c1b60e3fb4b013055ee6da9ff867</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERTABS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • ダッシュボードタブの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - ダッシュボードのメタデータを含む配列です。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getusertabs.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getusertabs.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserreport.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERTABS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
     
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
     
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br>Dashboard Name: " + tab.getReportGroupName());
            out.write("<br>UUID: " + tab.getPublishUUID());
            out.write("<br>Id: " + tab.getReportGroupId());
            out.write("<br>Group Type: " + tab.getReportGroupType());
            out.write("<br>InternalReference: " + tab.getReportGroupInternalReference());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERPARENTTABS

    こちらの呼び出しは、ユーザーの公開した親ダッシュボードのメタデータを返します。ダッシュボードに複数のタブが含まれている場合でも、親ダッシュボードの詳細のみが返されます。タブの詳細を取得するためには、TABSFROMPARENTGROUPIDの呼び出しを使用します。親ダッシュボードのレポートのメタデータは表示されないことに注意をしてください。これは、GETUSERPARENTTABSWITHREPOTSの呼び出しを使用することで、取得することができます。そのIDを提供することで、特定の親タブの詳細を取得することもできます。AdministrationPersonオブジェクトを使用して、ユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERPARENTTABS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringデフォルト組織に代わり、特定のクライアント組織内のタブを検索するためのクライアント組織参照IDです。こちらのパラメーターは必須ではありません。
    DashboardTabIdInteger詳細を取得するダッシュボードタブの一意のIDを提供する場合は、こちらのオプションパラメーターを使用します。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdString親タブの所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERPARENTTABS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]親タブのメタデータを含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <publishUUID>02fec2d8-6b09-48a1-8c6a-54adbb2eb9b6</publishUUID>
                   <reportGroupId>61251</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>2e2fb9f6-d43e-4de2-977e-a646b01abc4b</publishUUID>
                   <reportGroupId>61210</reportGroupId>
                   <reportGroupName>Campaign Analysis (Campaigns)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>1a387957-564b-40ad-9fc1-4167ddd61f33</publishUUID>
                   <reportGroupId>61243</reportGroupId>
                   <reportGroupName>Campaign Analysis (Marketing)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>0ad8c1b60e3fb4b013055ee6da9ff867</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERPARENTTABS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • 親タブの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - 親タブのメタデータを含む配列です。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserparenttabs.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserparenttabs.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserparenttabs.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERPARENTTABS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
     
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
     
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br>Dashboard Name: " + tab.getReportGroupName());
            out.write("<br>UUID: " + tab.getPublishUUID());
            out.write("<br>Id: " + tab.getReportGroupId());
            out.write("<br>Group Type: " + tab.getReportGroupType());
            out.write("<br>InternalReference: " + tab.getReportGroupInternalReference());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERDRAFTTABS

    公開、有効化されたダッシュボードではなく、ドラフト(編集中)モードのダッシュボードのメタデータを取得する場合は、こちらの呼び出しを使用します。IDを提供することで、特定のドラフト(編集中)のダッシュボードの詳細を取得することができます。

    こちらの呼び出しは、ダッシュボードのレポートのメタデータは取得しないことに注意してください。これを取得するには、GETUSERDRAFTTABSWITHREPORTSの呼び出しを使用します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERDARTTABS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringデフォルト組織に代わり、特定のクライアント組織内のタブを検索するためのクライアント組織参照IDです。こちらのパラメーターは必須ではありません。
    DashboardTabIdInteger詳細を取得するドラフト(編集中)ダッシュボードの一意のIDを提供する場合は、こちらのオプションパラメーターを使用します。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードタブが所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERDRAFTTABS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]ドラフト(編集中)ダッシュボードのメタデータを含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-16T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 16/2/2018 12:09 PM</reportDescription>
                   <reportId>70079</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>df0be222-2819-466c-9118-203f9d75acb9</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-19T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 19/2/2018 5:37 PM</reportDescription>
                   <reportId>70284</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>2fe4814b-98da-4c35-ab65-43c0916449fa</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>40</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-20T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 20/2/2018 10:56 AM</reportDescription>
                   <reportId>70299</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORTANDCHART</reportTemplate>
                   <reportUUID>1180e1db-a01c-478e-9d32-55276000abcc</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>100</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <reports>
                   <authoringMode>JAVA</authoringMode>
                   <averageRunTime>0</averageRunTime>
                   <birtData/>
                   <chartTypeCode/>
                   <dashboardEnabled>true</dashboardEnabled>
                   <dataOutput>COLUMN</dataOutput>
                   <deliveryMode/>
                   <executionObject/>
                   <lastModifiedDate>2018-02-22T00:00:00+11:00</lastModifiedDate>
                   <lastModifierId>5</lastModifierId>
                   <lastModifierName>System Administrator</lastModifierName>
                   <reportCategory>Audit Reports</reportCategory>
                   <reportDescription>Ski Team, 22/2/2018 5:19 PM</reportDescription>
                   <reportId>70336</reportId>
                   <reportName>Draft Report</reportName>
                   <reportSubCategory>Admin Reports</reportSubCategory>
                   <reportTemplate>REPORT</reportTemplate>
                   <reportUUID>52da336a-b35b-42a6-be64-8e53d598fbe4</reportUUID>
                   <roleCode>OPERATIONAL</roleCode>
                   <sourceName/>
                   <usage>0</usage>
                   <viewDescription>Ski Team</viewDescription>
                   <viewId>70103</viewId>
                   <viewName>New View</viewName>
                </reports>
                <sessionId>da91fe1685c8cb4496d8c8374c57035b</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERDRAFTTABS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • ダッシュボードタブの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - ドラフト(編集中)ダッシュボードのメタデータを含む配列です。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getdrafttabs.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getdrafttabs.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getdrafttabs.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERDRAFTTABS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
     
        // get the tab details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
     
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br>Dashboard Name: " + tab.getReportGroupName());
            out.write("<br>UUID: " + tab.getPublishUUID());
            out.write("<br>Id: " + tab.getReportGroupId());
            out.write("<br>Status: " + tab.getReportGroupStatus());
            out.write("<br>InternalReference: " + tab.getReportGroupInternalReference());
    }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERDRAFTPARENTTABS

    公開、有効化されたダッシュボードではなく、ドラフト(編集中)モードのダッシュボードから親タブのみのメタデータを取得する場合は、こちらの呼び出しを使用します。ダッシュボードタブのIDを提供することで、特定の親タブの詳細を取得することができます。

    こちらの呼び出しは、ダッシュボードのレポートのメタデータを取得しないことに注意してください。これを取得するためには、GETUSERDRAFTPARENTTABSWITHREPOTSの呼び出しを使用します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERDARTPARENTTABS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefStringデフォルト組織に代わり、特定のクライアント組織内のタブを検索するためのクライアント組織参照IDです。こちらのパラメーターは必須ではありません。
    DashboardTabIdInteger詳細を取得するドラフト(編集中)ダッシュボードの一意のIDを提供する場合は、こちらのオプションパラメーターを使用します。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードタブが所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERDRAFTPARENTTABS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    ドラフト(編集中)ダッシュボードの親タブのメタデータを含む配列です。

    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <publishUUID>e7409ff2-f846-44e1-a603-b78ec51b20b9</publishUUID>
                   <reportGroupId>61250</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>1e68d9cc-fa5a-44e2-816d-782aa40ceeae</publishUUID>
                   <reportGroupId>61209</reportGroupId>
                   <reportGroupName>Campaign Analysis</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>bcca7768fd5b49e3358b7fb48489f117</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERDRAFTPARENTTABS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • ダッシュボードタブの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - ドラフト(編集中)ダッシュボードの親タブのメタデータを含む配列です。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getdraftparenttabs.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getdraftparenttabs.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getdraftparenttabs.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 above account
    rsr.setOrgId(1);
    rsr.setFunction("GETUSERDRAFTPARENTTABS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
     
        // get the tab details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
     
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br>Dashboard Name: " + tab.getReportGroupName());
            out.write("<br>UUID: " + tab.getPublishUUID());
            out.write("<br>Id: " + tab.getReportGroupId());
            out.write("<br>Status: " + tab.getReportGroupStatus());
            out.write("<br>InternalReference: " + tab.getReportGroupInternalReference());
        }
    } else {
        out.write("Failure");
        out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERTABSWITHREPORTS

    ユーザーの公開したダッシュボードと、そのレポートのメタデータを取得します。これは、各ダッシュボードタブの詳細を、個別のAdministrationReportGroupオブジェクトに返します。そのID番号を提供することで、特定のダッシュボードやタブの詳細を取得します。AdministrationPersonオブジェクトを使用して、ユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERTABSWITHREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のタブを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdIntegerこちらのオプションパラメーターは、特定のダッシュボードタブとそのレポートの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するものでなくてはいけない点に注意してください。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードが所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERTABSWITHREPORTS</function>
                <dashboardTabId>61251</dashboardTabId>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    以下の表に一覧化されている要素とともに、ダッシュボードのメタデータを含む配列オブジェクトです。


    ReportGroupsの各要素は、以下の要素を含みます。

    応答要素データ型説明
    GroupReportsAdministrationReport[]すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-24T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete invoicing summaries by gender, demographic, and cost comparison over time.</reportDescription>
                      <reportId>61001</reportId>
                      <reportName>Invoice Summary</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>d0f213a1-25ea-4ee6-8d5a-52a0a3cdcf49</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>29</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>A drill through report displaying revenue by camp region and year, allowing to drill through to a detail report.</reportDescription>
                      <reportId>61097</reportId>
                      <reportName>Region Revenue by Year</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>486d19ee-7976-450e-93cd-f475ae486fa0</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>28</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>1</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-21T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View invoicing and camp rating figures by athlete location on this GIS map.</reportDescription>
                      <reportId>60947</reportId>
                      <reportName>Customer Sales by Location Map</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>64470d8f-f0a9-4d31-bcda-28f26356034c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>28</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>1</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This shows profit over time...</reportDescription>
                      <reportId>61046</reportId>
                      <reportName>Profit Trends &amp; Forecast</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>39a5a365-4f26-4767-a723-a804de1babe9</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>29</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>1</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete profit summaries by gender, demographic, and invoiced comparison over time.</reportDescription>
                      <reportId>61067</reportId>
                      <reportName>Region Profit Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>01c73f85-2da8-401c-8e1d-167a0a6b5b5c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>29</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Examine invoicing figures by Camp Location hierarchy.</reportDescription>
                      <reportId>61035</reportId>
                      <reportName>Performance by Region</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>80162f66-b23e-4a2b-b209-497a960d96d5</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>32</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>02fec2d8-6b09-48a1-8c6a-54adbb2eb9b6</publishUUID>
                   <reportGroupId>61251</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>4d9033f74b43feb65204865fde9ff023</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERTABSWITHREPORTS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - 以下の表に一覧化されている要素とともに、ダッシュボードのメタデータを含む配列オブジェクトです。


      ReportGroupsの各要素は、以下の要素を含みます。
      GroupReports: AdministrationReport[] - すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    • 最初のダッシュボードタブのレポートを取得します。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] rpts =  response.getReportGroups()[0].getGroupReports();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getusertabswithreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getusertabswithreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getusertabswithreports.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERTABSWITHREPORTS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
         
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br><h1>Dashboard Name: " + tab.getReportGroupName() + "</h1>");
            AdministrationReport[] rpts = tab.getGroupReports();
            if (rpts != null)
                for (AdministrationReport r: rpts){
                    out.write("Report Name: " + r.getReportName());
                    out.write("<br>Description: " + r.getReportDescription());
                    out.write("<br>ReportId: " + r.getReportId());
                    out.write("<br>ReportUUID: " + r.getReportUUID());
                    out.write("<br>ExecutionObject: " + r.getExecutionObject());
                    out.write("<br>ReportCategory: " + r.getReportCategory());
                    out.write("<br>SubCategory: " + r.getReportSubCategory());
                    out.write("<br>BirtData: " + r.getBirtData());
                    out.write("<br>SourceName: " + r.getSourceName());
                    out.write("<br>SourceId: " + r.getSourceId());
                    out.write("<br>AuthoringMode: " + r.getAuthoringMode());
                    out.write("<br>ReportTemplate: " + r.getReportTemplate());
                    out.write("<br>DataOutput: " + r.getDataOutput());
                    out.write("<br>DashboardEnabled: " + r.isDashboardEnabled());
                    out.write("<br>ViewId: " + r.getViewId());
                    out.write("<br>ViewName: " + r.getViewName());
                    out.write("<br>ViewDescription: " + r.getViewDescription());
                    out.write("<br>LastModifierName: " + r.getLastModifierName());
                    out.write("<br>LastModifierId: " + r.getLastModifierId());
                    out.write("<br>LastModifiedDate: " + r.getLastModifiedDate());
                    out.write("<br>PublishDate: " + r.getPublishDate());
                    out.write("<br>DeliveryMode: " + r.getDeliveryMode());
                    out.write("<br>LastRunTime: " + r.getLastRunTime());
                    out.write("<br>AverageRunTime: " + r.getAverageRunTime());
                    out.write("<br>RoleCode: " + r.getRoleCode());
                    out.write("<br>ChartTypeCode: " + r.getChartTypeCode());
                    out.write("<br>Usage: " + r.getUsage());
                    out.write("<br><br>");
                }
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERPARENTTABSWITHREPORTS

    ダッシュボードレポートの詳細とともに、すべての公開されたダッシュボードの親タブのメタデータを返します。ダッシュボードに複数のサブタブが含まれている場合は、親タブの詳細のみが取得されますが、こちらの呼び出しは、サブタブのレポートを含むダッシュボードレポート全体のメタデータを返します。AdministrationPersonオブジェクトを使用して、こちらの呼び出しのユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERPARENTTABSWITHREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織のダッシュボードを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdIntegerこちらのオプションパラメーターは、特定のダッシュボードの親タブとそのレポートの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するものでなくてはいけない点に注意してください。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードの親タブが所属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
            <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERPARENTTABSWITHREPORTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービスの呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    以下の表に一覧化されている要素とともに、ダッシュボードの親タブのメタデータを含む配列オブジェクトです。


    ReportGroupsの各要素は、以下の要素を含みます。

    応答要素データ型説明
    GroupReportsAdministrationReport[]すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-24T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete invoicing summaries by gender, demographic, and cost comparison over time.</reportDescription>
                      <reportId>61001</reportId>
                      <reportName>Invoice Summary</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>d0f213a1-25ea-4ee6-8d5a-52a0a3cdcf49</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-24T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete invoicing summaries by gender, demographic, and cost comparison over time.</reportDescription>
                      <reportId>61001</reportId>
                      <reportName>Invoice Summary</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>d0f213a1-25ea-4ee6-8d5a-52a0a3cdcf49</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>2</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>A drill through report displaying revenue by camp region and year, allowing to drill through to a detail report.</reportDescription>
                      <reportId>61097</reportId>
                      <reportName>Region Revenue by Year</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>486d19ee-7976-450e-93cd-f475ae486fa0</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>2</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>A drill through report displaying revenue by camp region and year, allowing to drill through to a detail report.</reportDescription>
                      <reportId>61097</reportId>
                      <reportName>Region Revenue by Year</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>486d19ee-7976-450e-93cd-f475ae486fa0</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>5</lastRunTime>
                      <publishDate>2017-06-21T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View invoicing and camp rating figures by athlete location on this GIS map.</reportDescription>
                      <reportId>60947</reportId>
                      <reportName>Customer Sales by Location Map</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>64470d8f-f0a9-4d31-bcda-28f26356034c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>5</lastRunTime>
                      <publishDate>2017-06-21T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View invoicing and camp rating figures by athlete location on this GIS map.</reportDescription>
                      <reportId>60947</reportId>
                      <reportName>Customer Sales by Location Map</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>64470d8f-f0a9-4d31-bcda-28f26356034c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This shows profit over time...</reportDescription>
                      <reportId>61046</reportId>
                      <reportName>Profit Trends &amp; Forecast</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>39a5a365-4f26-4767-a723-a804de1babe9</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This shows profit over time...</reportDescription>
                      <reportId>61046</reportId>
                      <reportName>Profit Trends &amp; Forecast</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>39a5a365-4f26-4767-a723-a804de1babe9</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete profit summaries by gender, demographic, and invoiced comparison over time.</reportDescription>
                      <reportId>61067</reportId>
                      <reportName>Region Profit Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>01c73f85-2da8-401c-8e1d-167a0a6b5b5c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete profit summaries by gender, demographic, and invoiced comparison over time.</reportDescription>
                      <reportId>61067</reportId>
                      <reportName>Region Profit Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>01c73f85-2da8-401c-8e1d-167a0a6b5b5c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Examine invoicing figures by Camp Location hierarchy.</reportDescription>
                      <reportId>61035</reportId>
                      <reportName>Performance by Region</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>80162f66-b23e-4a2b-b209-497a960d96d5</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>43</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Examine invoicing figures by Camp Location hierarchy.</reportDescription>
                      <reportId>61035</reportId>
                      <reportName>Performance by Region</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>80162f66-b23e-4a2b-b209-497a960d96d5</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>43</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>e7409ff2-f846-44e1-a603-b78ec51b20b9</publishUUID>
                   <reportGroupId>61250</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This report provides a high level summary of campaigns</reportDescription>
                      <reportId>60901</reportId>
                      <reportName>Campaign Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>3e842fae-02f7-4ad3-a632-ca267e0078da</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Revenue by media category pie chart</reportDescription>
                      <reportId>61131</reportId>
                      <reportName>Revenue by Media Category</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>32384c5a-7892-4ecb-93be-dc1efbdb7edd</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Look at the number of athletes by age, region, and average camp rating.</reportDescription>
                      <reportId>61053</reportId>
                      <reportName>Profitability by Customer Age &amp; Location Breakdown</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>c554165d-7c85-4d19-b19a-61ce5919dc5b</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Revenue treemap for campaigns by athlete demographic</reportDescription>
                      <reportId>61119</reportId>
                      <reportName>Revenue by Campaign and Demographic</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>ce3c4461-ea36-427d-bcd4-72448ec2722c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>An analysis of the agency sales and their ranked profitability</reportDescription>
                      <reportId>60724</reportId>
                      <reportName>Agency Sales by Profitability</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>876c7d79-21a9-4561-ada7-f97eaffe1186</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-18T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>An example of using canvas and set analysis from a single data set to create an infographic report.</reportDescription>
                      <reportId>60957</reportId>
                      <reportName>Infographic</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>00fd9f26-05a7-47b6-b87f-8270ca648f5d</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>1</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>1e68d9cc-fa5a-44e2-816d-782aa40ceeae</publishUUID>
                   <reportGroupId>61209</reportGroupId>
                   <reportGroupName>Campaign Analysis</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>3749079ce15768d94c1750cfd01d54ad</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERPARENTTABSWITHREPORTS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - 以下の表に一覧化されている要素とともに、ダッシュボードの親タブのメタデータを含む配列オブジェクトです。


      ReportGroupsの各要素は、以下の要素を含みます。
      GroupReports: AdministrationReport[] - すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    • 最初のダッシュボードタブのレポートを取得することができます。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] rpts =  response.getReportGroups()[0].getGroupReports();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserparenttabswithreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserparenttabswithreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserparenttabswithreports.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERPARENTTABSWITHREPORTS");
    //rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
         
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br><h1>Dashboard Name: " + tab.getReportGroupName() + "</h1>");
            AdministrationReport[] rpts = tab.getGroupReports();
            if (rpts != null)
                for (AdministrationReport r: rpts){
                    out.write("Report Name: " + r.getReportName());
                    out.write("<br>Description: " + r.getReportDescription());
                    out.write("<br>ReportId: " + r.getReportId());
                    out.write("<br>ReportUUID: " + r.getReportUUID());
                    out.write("<br>ExecutionObject: " + r.getExecutionObject());
                    out.write("<br>ReportCategory: " + r.getReportCategory());
                    out.write("<br>SubCategory: " + r.getReportSubCategory());
                    out.write("<br>BirtData: " + r.getBirtData());
                    out.write("<br>SourceName: " + r.getSourceName());
                    out.write("<br>SourceId: " + r.getSourceId());
                    out.write("<br>AuthoringMode: " + r.getAuthoringMode());
                    out.write("<br>ReportTemplate: " + r.getReportTemplate());
                    out.write("<br>DataOutput: " + r.getDataOutput());
                    out.write("<br>DashboardEnabled: " + r.isDashboardEnabled());
                    out.write("<br>ViewId: " + r.getViewId());
                    out.write("<br>ViewName: " + r.getViewName());
                    out.write("<br>ViewDescription: " + r.getViewDescription());
                    out.write("<br>LastModifierName: " + r.getLastModifierName());
                    out.write("<br>LastModifierId: " + r.getLastModifierId());
                    out.write("<br>LastModifiedDate: " + r.getLastModifiedDate());
                    out.write("<br>PublishDate: " + r.getPublishDate());
                    out.write("<br>DeliveryMode: " + r.getDeliveryMode());
                    out.write("<br>LastRunTime: " + r.getLastRunTime());
                    out.write("<br>AverageRunTime: " + r.getAverageRunTime());
                    out.write("<br>RoleCode: " + r.getRoleCode());
                    out.write("<br>ChartTypeCode: " + r.getChartTypeCode());
                    out.write("<br>Usage: " + r.getUsage());
                    out.write("<br><br>");
                }
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERDRAFTTABSWITHREPORTS

    こちらの呼び出しは、GETUSERTABSWITHREPORTSと類似していますが、ドラフト(編集中)モードのダッシュボード(公開、有効化されていない)の詳細を返します。そのID番号を提供することで、特定のダッシュボードやタブの詳細を取得します。AdministrationPersonオブジェクトを使用して、ユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERDRAFTTABSWITHREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織のダッシュボードを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdIntegerこちらのオプションパラメーターは、特定のドラフト(編集中)ダッシュボードとそのレポートの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するものでなくてはいけない点に注意してください。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードの取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERDRAFTTABSWITHREPORTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    以下の表に一覧化されている要素とともに、ドラフト(編集中)のダッシュボードのメタデータを含む配列オブジェクトです。


    ReportGroupsの各要素は、以下の要素を含みます。

    応答要素データ型説明
    GroupReportsAdministrationReport[]すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-24T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete invoicing summaries by gender, demographic, and cost comparison over time.</reportDescription>
                      <reportId>61001</reportId>
                      <reportName>Invoice Summary</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>d0f213a1-25ea-4ee6-8d5a-52a0a3cdcf49</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>2</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>A drill through report displaying revenue by camp region and year, allowing to drill through to a detail report.</reportDescription>
                      <reportId>61097</reportId>
                      <reportName>Region Revenue by Year</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>486d19ee-7976-450e-93cd-f475ae486fa0</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>5</lastRunTime>
                      <publishDate>2017-06-21T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View invoicing and camp rating figures by athlete location on this GIS map.</reportDescription>
                      <reportId>60947</reportId>
                      <reportName>Customer Sales by Location Map</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>64470d8f-f0a9-4d31-bcda-28f26356034c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>38</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This shows profit over time...</reportDescription>
                      <reportId>61046</reportId>
                      <reportName>Profit Trends &amp; Forecast</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>39a5a365-4f26-4767-a723-a804de1babe9</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>2</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>6</lastRunTime>
                      <publishDate>2017-06-20T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>View athlete profit summaries by gender, demographic, and invoiced comparison over time.</reportDescription>
                      <reportId>61067</reportId>
                      <reportName>Region Profit Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>01c73f85-2da8-401c-8e1d-167a0a6b5b5c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>39</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>1</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Examine invoicing figures by Camp Location hierarchy.</reportDescription>
                      <reportId>61035</reportId>
                      <reportName>Performance by Region</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>80162f66-b23e-4a2b-b209-497a960d96d5</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>43</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>02fec2d8-6b09-48a1-8c6a-54adbb2eb9b6</publishUUID>
                   <reportGroupId>61251</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-22T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>This report provides a high level summary of campaigns</reportDescription>
                      <reportId>60901</reportId>
                      <reportName>Campaign Summary</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>3e842fae-02f7-4ad3-a632-ca267e0078da</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Revenue by media category pie chart</reportDescription>
                      <reportId>61131</reportId>
                      <reportName>Revenue by Media Category</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>32384c5a-7892-4ecb-93be-dc1efbdb7edd</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Look at the number of athletes by age, region, and average camp rating.</reportDescription>
                      <reportId>61053</reportId>
                      <reportName>Profitability by Customer Age &amp; Location Breakdown</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>c554165d-7c85-4d19-b19a-61ce5919dc5b</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2017-06-19T00:00:00+10:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>Revenue treemap for campaigns by athlete demographic</reportDescription>
                      <reportId>61119</reportId>
                      <reportName>Revenue by Campaign and Demographic</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>REPORTANDCHART</reportTemplate>
                      <reportUUID>ce3c4461-ea36-427d-bcd4-72448ec2722c</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-17T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>An analysis of the agency sales and their ranked profitability</reportDescription>
                      <reportId>60724</reportId>
                      <reportName>Agency Sales by Profitability</reportName>
                      <reportSubCategory>Athletes</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>876c7d79-21a9-4561-ada7-f97eaffe1186</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>16</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>2e2fb9f6-d43e-4de2-977e-a646b01abc4b</publishUUID>
                   <reportGroupId>61210</reportGroupId>
                   <reportGroupName>Campaign Analysis (Campaigns)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <groupReports>
                      <authoringMode>JAVA</authoringMode>
                      <averageRunTime>0</averageRunTime>
                      <birtData/>
                      <chartTypeCode/>
                      <dashboardEnabled>true</dashboardEnabled>
                      <dataOutput>COLUMN</dataOutput>
                      <deliveryMode/>
                      <executionObject/>
                      <lastModifiedDate>2017-06-26T00:00:00+10:00</lastModifiedDate>
                      <lastModifierId>5</lastModifierId>
                      <lastModifierName>System Administrator</lastModifierName>
                      <lastRunTime>0</lastRunTime>
                      <publishDate>2016-11-18T00:00:00+11:00</publishDate>
                      <reportCategory>Tutorial</reportCategory>
                      <reportDescription>An example of using canvas and set analysis from a single data set to create an infographic report.</reportDescription>
                      <reportId>60957</reportId>
                      <reportName>Infographic</reportName>
                      <reportSubCategory>Marketing &amp; Booking</reportSubCategory>
                      <reportTemplate>CHART</reportTemplate>
                      <reportUUID>00fd9f26-05a7-47b6-b87f-8270ca648f5d</reportUUID>
                      <roleCode>OPERATIONAL</roleCode>
                      <sourceName/>
                      <usage>1</usage>
                      <viewDescription>Ski Team</viewDescription>
                      <viewId>70103</viewId>
                      <viewName>New View</viewName>
                   </groupReports>
                   <publishUUID>1a387957-564b-40ad-9fc1-4167ddd61f33</publishUUID>
                   <reportGroupId>61243</reportGroupId>
                   <reportGroupName>Campaign Analysis (Marketing)</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>da0e674bf04a010c4aed08fa1f009752</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERDRAFTTABSWITHREPORTS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - 以下の表に一覧化されている要素とともに、ドラフト(編集中)のダッシュボードのメタデータを含む配列オブジェクトです。


      ReportGroupsの各要素は、以下の要素を含みます。
      GroupReports: AdministrationReport[] - すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    • 最初のダッシュボードタブのレポートを取得することができます。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] rpts =  response.getReportGroups()[0].getGroupReports();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserdrafttabswithreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserdrafttabswithreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserdrafttabswithreports.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERDRAFTTABSWITHREPORTS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
         
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br><h1>Dashboard Name: " + tab.getReportGroupName() + "</h1>");
            out.write("<br>Dashboard tab Status: " + tab.getReportGroupStatus() + "<br>");
            AdministrationReport[] rpts = tab.getGroupReports();
            if (rpts != null)
                for (AdministrationReport r: rpts){
                    out.write("Report Name: " + r.getReportName());
                    out.write("<br>Description: " + r.getReportDescription());
                    out.write("<br>ReportId: " + r.getReportId());
                    out.write("<br>ReportUUID: " + r.getReportUUID());
                    out.write("<br>ExecutionObject: " + r.getExecutionObject());
                    out.write("<br>ReportCategory: " + r.getReportCategory());
                    out.write("<br>SubCategory: " + r.getReportSubCategory());
                    out.write("<br>BirtData: " + r.getBirtData());
                    out.write("<br>SourceName: " + r.getSourceName());
                    out.write("<br>SourceId: " + r.getSourceId());
                    out.write("<br>AuthoringMode: " + r.getAuthoringMode());
                    out.write("<br>ReportTemplate: " + r.getReportTemplate());
                    out.write("<br>DataOutput: " + r.getDataOutput());
                    out.write("<br>DashboardEnabled: " + r.isDashboardEnabled());
                    out.write("<br>ViewId: " + r.getViewId());
                    out.write("<br>ViewName: " + r.getViewName());
                    out.write("<br>ViewDescription: " + r.getViewDescription());
                    out.write("<br>LastModifierName: " + r.getLastModifierName());
                    out.write("<br>LastModifierId: " + r.getLastModifierId());
                    out.write("<br>LastModifiedDate: " + r.getLastModifiedDate());
                    out.write("<br>PublishDate: " + r.getPublishDate());
                    out.write("<br>DeliveryMode: " + r.getDeliveryMode());
                    out.write("<br>LastRunTime: " + r.getLastRunTime());
                    out.write("<br>AverageRunTime: " + r.getAverageRunTime());
                    out.write("<br>RoleCode: " + r.getRoleCode());
                    out.write("<br>ChartTypeCode: " + r.getChartTypeCode());
                    out.write("<br>Usage: " + r.getUsage());
                    out.write("<br><br>");
                }
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERDRAFTPARENTTABSWITHREPORTS

    ドラフト(編集中)モード(有効化、公開されていない)のダッシュボードの親タブのメタデータを返します。ダッシュボードに複数のサブタブを含む場合は、親タブの詳細のみが取得されますが、こちらの呼び出しはサブタブ内のドラフト(編集中)のダッシュボードのレポート全体のメタデータを返します。AdministrationPersonオブジェクトを使用して、ユーザーを指定します。そのIDを提供することで、特定のダッシュボードタブを指定し、その詳細を取得することができます。   


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERDRAFTPARENTTABSWITHREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のダッシュボードを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdInteger

    こちらのオプションパラメーターは、特定のドラフト(編集中)ダッシュボードの親タブとそのレポートの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するものでなくてはいけない点に注意してください。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringドラフト(編集中)ダッシュボードの親タブの詳細を取得するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERDRAFTPARENTTABSWITHREPORTS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    以下の表に一覧化されている要素とともに、ダッシュボードのメタデータを含む配列オブジェクトです。


    ReportGroupsの各要素は、以下の要素を含みます。

    応答要素データ型説明
    GroupReportsAdministrationReport[]すべてのダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <reportGroups>
                   <publishUUID>e7409ff2-f846-44e1-a603-b78ec51b20b9</publishUUID>
                   <reportGroupId>61250</reportGroupId>
                   <reportGroupName>Sales Performance</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <reportGroups>
                   <publishUUID>1e68d9cc-fa5a-44e2-816d-782aa40ceeae</publishUUID>
                   <reportGroupId>61209</reportGroupId>
                   <reportGroupName>Campaign Analysis</reportGroupName>
                   <reportGroupStatus>OPEN</reportGroupStatus>
                   <reportGroupType>ANALYTIC</reportGroupType>
                </reportGroups>
                <sessionId>42075cc6bc5723e6daf997796aa00a57</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERDRAFTPARENTTABSWITHREPORTS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます。
      StatusCode: String - Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

      • SUCCESS
      • FAILURE

      ReportGroups: AdministrationReportGroup[] - 以下の表に一覧化されている要素とともに、ドラフト(編集中)ダッシュボードの親タブのメタデータを含む配列オブジェクトです。


      ReportGroupsの各要素は、以下の要素を含みます。
      GroupReports: AdministrationReport[] - すべてのドラフト(編集中)ダッシュボードのレポートのメタデータを含む配列オブジェクトです。


    • 最初のダッシュボードタブのレポートを取得することができます。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] rpts =  response.getReportGroups()[0].getGroupReports();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserdraftparenttabswithreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserdraftparenttabswithreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserdraftparenttabswithreports.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERDRAFTPARENTTABSWITHREPORTS");
    //rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
         
        // get the tabs details:
        AdministrationReportGroup[] tabs = rs.getReportGroups();
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br><h1>Dashboard Name: " + tab.getReportGroupName() + "</h1>");
            out.write("<br>Dashboard tab Status: " + tab.getReportGroupStatus() + "<br>");
            AdministrationReport[] rpts = tab.getGroupReports();
            if (rpts != null)
                for (AdministrationReport r: rpts){
                    out.write("Report Name: " + r.getReportName());
                    out.write("<br>Description: " + r.getReportDescription());
                    out.write("<br>ReportId: " + r.getReportId());
                    out.write("<br>ReportUUID: " + r.getReportUUID());
                    out.write("<br>ExecutionObject: " + r.getExecutionObject());
                    out.write("<br>ReportCategory: " + r.getReportCategory());
                    out.write("<br>SubCategory: " + r.getReportSubCategory());
                    out.write("<br>BirtData: " + r.getBirtData());
                    out.write("<br>SourceName: " + r.getSourceName());
                    out.write("<br>SourceId: " + r.getSourceId());
                    out.write("<br>AuthoringMode: " + r.getAuthoringMode());
                    out.write("<br>ReportTemplate: " + r.getReportTemplate());
                    out.write("<br>DataOutput: " + r.getDataOutput());
                    out.write("<br>DashboardEnabled: " + r.isDashboardEnabled());
                    out.write("<br>ViewId: " + r.getViewId());
                    out.write("<br>ViewName: " + r.getViewName());
                    out.write("<br>ViewDescription: " + r.getViewDescription());
                    out.write("<br>LastModifierName: " + r.getLastModifierName());
                    out.write("<br>LastModifierId: " + r.getLastModifierId());
                    out.write("<br>LastModifiedDate: " + r.getLastModifiedDate());
                    out.write("<br>PublishDate: " + r.getPublishDate());
                    out.write("<br>DeliveryMode: " + r.getDeliveryMode());
                    out.write("<br>LastRunTime: " + r.getLastRunTime());
                    out.write("<br>AverageRunTime: " + r.getAverageRunTime());
                    out.write("<br>RoleCode: " + r.getRoleCode());
                    out.write("<br>ChartTypeCode: " + r.getChartTypeCode());
                    out.write("<br>Usage: " + r.getUsage());
                    out.write("<br><br>");
                }
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleGETUSERPARENTREPORTGROUPS

    こちらのwebサービスの呼び出しは、指定したユーザーにアクセス可能なすべてのダッシュボードの親タブと、そのサブタブのメタデータを取得します。ユーザーは、AdministrationPersonオブジェクトを使用して指定します。返されるデータを制限するために、特定のダッシュボードやサブタブのIDを渡すこともできます。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETUSERPARENTREPORTGROUPS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のダッシュボードを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdInteger

    こちらのオプションパラメーターは、特定のダッシュボードタブやサブタブの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するタブでなくてはいけません。こちらが指定されない場合は、すべてのダッシュボードタブとサブタブの詳細が返されます。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードの帰属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETUSERPARENTREPORTGROUPS</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    parentReportGroupsParentReportGroup[]

    サブタブを含むダッシュボードタブの配列です。以下の表を参照してください。

    PersonAdministrationPersonユーザーの完全詳細です。


    ParentReportGroupsの各要素は、以下の要素を含みます。

    要素データ型説明
    reportGroupIntegerダッシュボードタブのIDです。
    reportGroupUUIDStringダッシュボードタブの公開UUIDです。
    displayOrderIntegerユーザーダッシュボード内でのダッシュボードタブの表示順です。
    reportGroupAdministrationReportGroupダッシュボードタブです。
    reportGroupsSubTabsAdministrationReportGroup[]ダッシュボードのサブタブです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <parentReportGroups>
                   <reportGroup>
                      <publishUUID>e7409ff2-f846-44e1-a603-b78ec51b20b9</publishUUID>
                      <reportGroupId>61250</reportGroupId>
                      <reportGroupName>Sales Performance</reportGroupName>
                      <reportGroupStatus>OPEN</reportGroupStatus>
                      <reportGroupType>ANALYTIC</reportGroupType>
                   </reportGroup>
                   <reportGroupId>61250</reportGroupId>
                   <reportGroupSubTabs>
                      <publishUUID>02fec2d8-6b09-48a1-8c6a-54adbb2eb9b6</publishUUID>
                      <reportGroupId>61251</reportGroupId>
                      <reportGroupName>New Tab</reportGroupName>
                      <reportGroupStatus>OPEN</reportGroupStatus>
                      <reportGroupType>SUBTAB</reportGroupType>
                   </reportGroupSubTabs>
                </parentReportGroups>
                <parentReportGroups>
                   <reportGroup>
                      <publishUUID>1e68d9cc-fa5a-44e2-816d-782aa40ceeae</publishUUID>
                      <reportGroupId>61209</reportGroupId>
                      <reportGroupName>Campaign Analysis</reportGroupName>
                      <reportGroupStatus>OPEN</reportGroupStatus>
                      <reportGroupType>ANALYTIC</reportGroupType>
                   </reportGroup>
                   <reportGroupId>61209</reportGroupId>
                   <reportGroupSubTabs>
                      <publishUUID>2e2fb9f6-d43e-4de2-977e-a646b01abc4b</publishUUID>
                      <reportGroupId>61210</reportGroupId>
                      <reportGroupName>Campaigns</reportGroupName>
                      <reportGroupStatus>OPEN</reportGroupStatus>
                      <reportGroupType>SUBTAB</reportGroupType>
                   </reportGroupSubTabs>
                   <reportGroupSubTabs>
                      <publishUUID>1a387957-564b-40ad-9fc1-4167ddd61f33</publishUUID>
                      <reportGroupId>61243</reportGroupId>
                      <reportGroupName>Marketing</reportGroupName>
                      <reportGroupStatus>OPEN</reportGroupStatus>
                      <reportGroupType>SUBTAB</reportGroupType>
                   </reportGroupSubTabs>
                </parentReportGroups>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <sessionId>59ff828c9f26cbe0fdfd281a951d3ec9</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("GETUSERPARENTREPORTGROUPS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートの所属するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • 必要に応じて、ダッシュボードやサブタブのIDを提供します。


      Code Block
      languagejava
      themeEclipse
      rsr.setDashboardTabId(61210);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます:StatusCode、ReportGroups、GroupReports(より詳細な情報は、上記応答パラメーターの表を参照してください)


    • 返される最初のダッシュボードのサブタブの詳細を取得するには、以下を使用します。


      Code Block
      languagejava
      themeEclipse
      AdministrationReportGroup[] subtabs = response.getParentReportGroups()[0].getReportGroupSubTabs();


    • 最初のダッシュボードの親ダッシュボードタブの詳細を取得するには、以下を使用します。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] rpts =  response.getReportGroups()[0].getGroupReports();


    • ダッシュボードタブのID番号を取得するには、こちらを使用します。


      Code Block
      languagejava
      themeEclipse
      Integer tabId= response.getParentReportGroups()[0].getReportGroupId();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_getuserparentreportgroups.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_getuserparentreportgroups.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_getuserparentreportgroups.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("GETUSERPARENTREPORTGROUPS");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    rsr.setDashboardTabId(61210);                       // provide this dashboard sub tab id to get its parent dashboard tab details (optional)
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
     
        ParentReportGroups[] tabs = rs.getParentReportGroups();
     
        if (tabs != null)
        for (AdministrationReportGroup tab: tabs){
            out.write("<br><br>Tab Name: " + tab.getReportGroupName());
            out.write("<br>Number of subtabs: " + tab.getReportGroup().length));
            AdministrationReportGroup[] groups = tab.getReportGroup();
            for (AdministrationReportGroup gr: groups){
                out.write("<br>Subtab Name: " + gr.getReportGroupName());
            }
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleTABSFROMPARENTGROUPID

    ユーザーのダッシュボードタブのメタデータを、サブタブのIDとともに返します。IDを提供することで、特定のタブやサブタブの詳細を取得します。AdministrationPersonオブジェクトを使用してユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「TABSFROMPARENTGROUPID」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のダッシュボードを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdInteger

    こちらのオプションパラメーターは、特定のダッシュボードタブの詳細を取得するために使用することができます。しかし、これは既にYellowfinに存在するものでなくてはいけません。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードタブの帰属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>TABSFROMPARENTGROUPID</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>      
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ParentDashboardsParentDashboard[]

    以下の表に一覧化された要素を含むダッシュボードのメタデータを含む配列オブジェクトです。


    ParentDashboardの各要素は、以下の要素を含みます。

    応答要素データ型説明
    DashboardNameStringダッシュボードの名前です。
    DashboardGroupIdInteger
    TabIdsString[]サブタブのIDの配列です。
    TabNamesString[]サブタブの名前の配列です。
    statusCodesString[]サブタブのステータスの配列です。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Getting user information...</messages>
                <messages>Getting user information...</messages>
                <messages>Web Service Request Complete</messages>
                <parentDashboards>
                   <dashboardGroupId>61250</dashboardGroupId>
                   <dashboardName>Sales Performance</dashboardName>
                   <statusCodes>OPEN</statusCodes>
                   <tabIds>61251</tabIds>
                   <tabNames>New Tab</tabNames>
                </parentDashboards>
                <parentDashboards>
                   <dashboardGroupId>61209</dashboardGroupId>
                   <dashboardName>Campaign Analysis</dashboardName>
                   <statusCodes>OPEN</statusCodes>
                   <statusCodes>OPEN</statusCodes>
                   <tabIds>61210</tabIds>
                   <tabIds>61243</tabIds>
                   <tabNames>Campaigns</tabNames>
                   <tabNames>Marketing</tabNames>
                </parentDashboards>
                <person>
                   <emailAddress>admin@yellowfin.com.au</emailAddress>
                   <firstName>System</firstName>
                   <initial/>
                   <ipId>5</ipId>
                   <languageCode>EN</languageCode>
                   <lastName>Administrator</lastName>
                   <roleCode>YFADMIN</roleCode>
                   <salutationCode/>
                   <status>ACTIVE</status>
                   <timeZoneCode>AUSTRALIA/SYDNEY</timeZoneCode>
                   <userId>admin@yellowfin.com.au</userId>
                </person>
                <sessionId>1b1898c42b69302ce9b3426b5a17e5a0</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("TABSFROMPARENTGROUPID");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • ダッシュボードを取得するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • 特定のダッシュボードの詳細のみを表示する場合は、ダッシュボードIDを提供します。


      Code Block
      languagejava
      themeEclipse
      rsr.setDashboardTabId(61209);               // dashboard Id (ReportGroup.GroupId field of Yellowfin's database)


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます:StatusCode、ParentDashboard配列。より詳細な情報は、上記応答パラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_tabsfromparentgroupid.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_tabsfromparentgroupid.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_tabsfromparentgroupid.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("TABSFROMPARENTGROUPID");
     
    //rsr.setDashboardTabId(61209);                     // add this to get subtabs for a particular dashboard tab.
     
     
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
         
        //out.write("Success<br>" + rs.getReportGroups().length + " tabs retrieved");
        // get the tabs details:
        ParentDashboard[] tabs = rs.getParentDashboards();
        if (tabs != null)
        for (ParentDashboard tab: tabs){
            out.write("<br><br>Dashboard Name: " + tab.getDashboardName());
            out.write("<br>DashboardId: " + tab.getDashboardGroupId());
            out.write("<br>tabIds (N): " + tab.getTabIds().length);
        }
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleLOADTABREPORTS

    こちらの呼び出しは、特定のユーザーにアクセス可能なダッシュボードタブレポートのメタデータを読み込むために使用します。ユーザーは、AdministrationPersonオブジェクトを通して指定します。特定のタブのレポートの詳細を取得する場合は、AdministrationReportGroupオブジェクトを介してダッシュボードタブのIDを提供します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「LOADTABREPORTS」に設定します。

    PersonAdministrationPersonユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のダッシュボードタブを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    ReportGroupAdministrationReportGroup

    こちらのオプションパラメーターは、特定のダッシュボードタブのレポートの詳細を取得するために使用することができます。以下の表を参照してください。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdStringダッシュボードの帰属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    以下は、こちらのwebサービスの呼び出しのAdministrationReportGroupオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationReportGroup要素データ型説明
    ReportGroupIdIntegerダッシュボードタブのIDです。


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    ReportGroupsAdministrationReportGroup[]

    こちらの配列オブジェクトは、ダッシュボードのレポートのメタデータを含みます。こちらは、ひとつの項目のみを含みます。


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("LOADTABREPORTS");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートを取得するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • 必要に応じて、ダッシュボードタブやサブタブのIDを提供します。


      Code Block
      languagejava
      themeEclipse
      rsr.setDashboardTabId(61209);               // dashboard Id (ReportGroup.GroupId field of Yellowfin's database)


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、これらのパラメーターが含まれます:StatusCode、ReportGroups。(より詳細な情報は、上記応答パラメーターの項目を参照してください。)


    • レポートの詳細を取得するには、以下を使用します。


      Code Block
      languagejava
      themeEclipse
      AdministrationReport[] reports = response.getReportGroups[0].getGroupReports();



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_loadtabreports.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_loadtabreports.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_loadtabreports.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 the password of the above account
    rsr.setOrgId(1);
    rsr.setFunction("LOADTABREPORTS");
      
    rsr.setOrgRef("org1");
      
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("test.user@yellowfin.com.au");      
      
    rsr.setPerson(ap);
      
    AdministrationReportGroup rg = new AdministrationReportGroup();
    rg.setReportGroupId(61210);
      
    rsr.setReportGroup(rg);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                     
                    AdministrationReportGroup[] tabs = rs.getReportGroups();
                     
                    if (tabs != null)
                    for (AdministrationReportGroup tab: tabs){
                                        out.write("<br>Tab Name: " + tab.getReportGroupName());
                                        out.write(tab.getGroupReports().length);
                                        AdministrationReport[] reports = tab.getGroupReports();
                                        for (AdministrationReport r: reports){
                                                        out.write("<br><br>Report Name: " + r.getReportName());
                                                        out.write("<br>Report Id: " + r.getReportId());
                                        }
                    }
                     
    } else {
                    out.write("Failure");
                    out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleDELETETAB

    こちらのwebサービスは、ユーザーのダッシュボードタブやサブタブを削除する場合に使用します。ダッシュボードタブ、またはサブタブは、ID番号かUUIDのいずれかを提供することで、指定しなくてはいけません。AdministrationPersonオブジェクトを使用して、ユーザーを指定します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「DELETETAB」に設定します。

    PersonAdministrationPersonダッシュボードタブを削除するユーザーの詳細を含むオブジェクトです。以下の表を参照してください。
    OrgRefString

    デフォルト組織に代わり、特定のクライアント組織内のダッシュボードタブを検索するためのクライアント組織参照IDを指定するオプションパラメーターです。

    DashboardTabIdInteger

    削除するタブのダッシュボードタブIDを提供します。または、以下のパラメーターを使用します。

    ParameterString[]こちらのパラメーターは、上記のパラメーターに代わり、削除するダッシュボードタブのUUIDを渡すために使用します。


    以下は、こちらのwebサービスの呼び出しのAdministrationPersonオブジェクトに設定しなくてはいけない主要なパラメーターです。

    AdministrationPerson要素データ型説明
    UserIdString削除するダッシュボードタブの帰属するユーザーを識別します。これは、ログイン方法に応じて、ユーザーID、または電子メールアドレスになります。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>DELETETAB</function>
                <person>
                    <userId>admin@yellowfin.com.au</userId>             
                </person>
                <dashboardTabId>61243</dashboardTabId>
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>df716bf8bf6d71bd586da445e02b348e</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("DELETETAB");


    • 特定のクライアント組織を識別することもできます。


      Code Block
      languagejava
      themeEclipse
      rsr.setOrgRef("org1");


    • レポートを取得するユーザーを指定します。


      Code Block
      languagejava
      themeEclipse
      AdministrationPerson ap = new AdministrationPerson();
      ap.setUserId("admin@yellowfin.com.au");
       
      rsr.setPerson(ap);


    • ダッシュボードタブ、またはサブタブいずれかのIDを提供します。


      Code Block
      languagejava
      themeEclipse
      rsr.setDashboardTabId(71081);


    • または、ダッシュボードタブやサブタブのUUIDを渡します。


      Code Block
      languagexml
      themeEclipse
      rsr.setParameters(new String[] {"0ac13905-aa14-4887-9718-44c29b11311b"});


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeパラメーターが含まれます。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_deletedashboard.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_deletedashboard.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%           
    /*              ws_deletedashboard.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 above account
    rsr.setOrgId(1);
     
    rsr.setFunction("DELETETAB");
    rsr.setOrgRef("org1");
    AdministrationPerson ap = new AdministrationPerson();
    ap.setUserId("admin@yellowfin.com.au");          
    rsr.setPerson(ap);
     
    // pass the dashboard tab/subtab Id:
    //rsr.setDashboardTabtId(71081);
     
    // or dashboard tab/subtab UUID:
    rsr.setParameters(new String[] {"0ac13905-aa14-4887-9718-44c29b11311b"});
     
     
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
     
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
        out.write("<br>Dashboard tab has been deleted.");
    } else {
            out.write("Failure");
            out.write(" Code: " + rs.getErrorCode());
    }
    %>



    その他のオブジェクトの操作

    以下のwebサービスの呼び出しは、レポート、ダッシュボード、ビューなどを含む、異なるタイプのオブジェクトの操作に使用します。

    Expand
    titleLISTPERSONFAVOURITES

    こちらのwebサービスの呼び出しは、レポート、ストーリーボード、ビュー、ダッシュボード、配信されたコンテンツ、ディスカッション、フラグ付きコメント含む、特定のユーザーのお気に入りに登録された項目を返します。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「LISTPERSONTFAVOURITES」に設定します。

    FavouritePersonFavouriteこちらのオブジェクトは、取得するお気に入りに登録されたアイテムを指定するために使用します。ユーザーは、こちらで指定されなくてはいけませんが、その他のパラメーターはオプションです。より詳細な情報は、以下の表を参照してください。
    Retospective DaysIntegerこちらのパラメーターはオプションです。


    以下は、こちらのwebサービスの呼び出しのPersonFavouriteオブジェクトに設定しなくてはいけない主要なパラメーターです。

    PersonFavourite要素データ型説明
    PersonIdInteger必須パラメーターです。お気に入り項目を操作するユーザーのYellowfin内部ID(または、IP ID)です。この値は、YellowfinのデータベースのPerson.IpIdフィールドに対応するか、AdministrationPerson.getIpId()を使用して取得しなくてはいけません。
    ContentTypeString

    こちらのオプションパラメーターは、特定のコンテンツタイプにより、結果にフィルターを適用するために使用することができます。値の選択肢は、以下の通りです。

    • REPORT
    • REPORTGROUP
    • DISCUSSIONGROUP
    • REPORTVIEW
    • STORYBOARD
    • IMAGE
    ContentIdIntegerこちらのオプションパラメーターは、レポートやダッシュボード、ストーリーボードなど、その内部IDを提供することで、結果を特定のコンテンツに制限する場合に使用することができます。
    FavouriteTypeStringオプションです。お気に入りのタイプを指定するために使用します。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>LISTPERSONFAVOURITES</function>
                <favourite>
                    <personId>5</personId>
                </favourite>    
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    PersonfavouritesPersonfavourite[]ユーザーのお気に入りオブジェクトを含む配列です。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <personfavourites>
                   <contentId>61209</contentId>
                   <contentType>REPORTGROUP</contentType>
                   <creationCode/>
                   <creationDate>2017-06-26</creationDate>
                   <creatorId>0</creatorId>
                   <favouriteType>REPORTDASHBOARD</favouriteType>
                   <message/>
                   <personId>5</personId>
                   <textEntityId>0</textEntityId>
                </personfavourites>
                <personfavourites>
                   <contentId>61250</contentId>
                   <contentType>REPORTGROUP</contentType>
                   <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>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
      
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
      
      rsr.setFunction("LISTPERSONFAVOURITES");


    • PersonFavouriteオブジェクトを使用して、ユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      PersonFavourite pf = new PersonFavourite();
      pf.setPersonId(13073);


    • 以下の手順はオプションであり、こちらの呼び出しの応答にフィルターを適用するために含めることができます。

      • ユーザーのお気に入りレポートを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("REPORT");       
        pf.setFavouriteType("FAVOURITE");


      • ユーザーのダッシュボードすべてを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("REPORTGROUP");
        pf.setFavouriteType("REPORTDASHBOARD");


      • ユーザーに配信されたレポートやダッシュボードを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("REPORTGROUP");           // use this for dashboards, or pf.setContentType("REPORT") to get distributed reports
        pf.setFavouriteType("INBOX");


      • ユーザーがメンバーであるディスカッションを取得する場合

        Code Block
        languagejfx
        themeEclipse
        pf.setContentType("DISCUSSIONGROUP");
        pf.setFavouriteType("DISCUSSIONMEMBER");


      • ユーザーのお気に入りビューを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("REPORTVIEW");


      • ユーザーのお気に入りストーリーボードを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("STORYBOARD");
        pf.setFavouriteType("FAVOURITE");


      • ユーザーのプロフィールイメージを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("IMAGE");
        pf.setFavouriteType("PROFILE");


      • ユーザーがフラグ付けをしたコメント付きレポートを取得する場合

        Code Block
        languagejava
        themeEclipse
        pf.setContentType("COMMENT");
        pf.setFavouriteType("FLAGGED");


    • リクエストにこちらのオブジェクトを追加します。


      Code Block
      languagexml
      themeEclipse
      rsr.setFavourite(pf);


      • リクエストを構成したら、呼び出しを実行します。

        Code Block
        languagejava
        AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

        管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeとPersonFavouritesパラメーターが含まれます。より詳細な情報は、上記応答のパラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_listpersonfavourites.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_listpersonfavourites.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_listpersonfavourites.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 webservices admin account
    rsr.setPassword("test");                                                      // change to be the password of the account above
    rsr.setOrgId(1);
    rsr.setFunction("LISTPERSONFAVOURITES");
      
    PersonFavourite pf = new PersonFavourite();
    pf.setPersonId(13073);
    pf.setContentType("REPORT");
      
    rsr.setFavourite(pf);
      
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
               out.write("<br>Success");
               if (rs.getPersonfavourites() != null)
               for (PersonFavourite f: pf){
                    out.write("<br><br>contentId: " + f.getContentId());
                    out.write("<br>ContentType: " + f.getContentType());
                    out.write("<br>CreationCode: " + f.getCreationCode());
                    out.write("<br>CreationDate: " + f.getCreationDate());
                    out.write("<br>CreatorId: " + f.getCreatorId());
                    out.write("<br>FavouriteType: " + f.getFavouriteType());
                    out.write("<br>Message: " + f.getMessage());
                    out.write("<br>PersonId: " + f.getPersonId());
                    out.write("<br>textEntityId: " + f.getTextEntityId());
               }
    } else {
                out.write("Failure");
                out.write(" Code: " + rs.getErrorCode());
    }
    %>



    Expand
    titleSAVEPERSONFAVOURITE

    こちらのwebサービスの呼び出しは、レポート、ストーリーボード、ビューなどの項目を、ユーザのお気に入り一覧に追加します。また、ダッシュボードタブをユーザーのダッシュボードに追加し、コメントにフラグ付けをすることもできます。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「SAVEPERSONFAVOURITE」に設定します。

    FavouritePersonFavourite

    こちらのオブジェクトは、ユーザーのお気に入りに登録された項目を指定するために使用します。こちらで、ユーザーも指定します。より詳細な情報は、以下の表を参照してください。


    以下は、こちらのwebサービスの呼び出しのPersonFavouriteオブジェクトに設定しなくてはいけない主要なパラメーターです。

    PersonFavourite要素データ型説明
    PersonIdInteger内部ID(IP ID)とともにユーザーを識別するために必須のパラメーターです。この値は、YellowfinのデータベースのPerson.IpIdフィールドに対応するか、AdministrationPerson.getIpId()を使用して取得しなくてはいけません。選択された項目は、こちらのユーザーのお気に入りに追加されます。
    ContentTypeString

    こちらの必須パラメーターは、お気に入りに追加する項目のコンテンツタイプを指定するために使用します。値の選択肢は、以下の通りです。

    • REPORT
    • REPORTGROUP
    • DISCUSSIONGROUP
    • REPORTVIEW
    • STORYBOARD
    • IMAGE
    ContentIdIntegerこちらの必須パラメーターは、その内部IDを提供することで、ユーザーのお気に入りに登録する項目(レポート、ダッシュボード、ストーリーボードなど)を定義するために使用します。
    FavouriteTypeStringオプションです。お気に入りのタイプを指定します。
    CreationCodeString
    TextEntityIdIntegerこちらのパラメーターは、コメントにフラグ付けをする場合に必要です。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
     <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>SAVEPERSONFAVOURITE</function>
                <favourite>
                    <personId>13000</personId>
                    <contentType>REPORTGROUP</contentType>
                    <contentId>61209</contentId>
                </favourite>    
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>6eb0b81605d3b355cf4a43ae608ab274</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("SAVEPERSONFAVOURITE");


    • PersonFavouriteオブジェクトを使用して、ユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      PersonFavourite pf = new PersonFavourite();
      pf.setPersonId(13073);


    • オブジェクト内でお気に入りに登録されるコンテンツを指定します。


      Code Block
      languagejava
      themeEclipse
      pf.setContentId(61252);
      pf.setContentType("REPORTVIEW");


    • リクエストにこちらのオブジェクトを追加します。


      Code Block
      languagejava
      themeEclipse
      rsr.setFavourite(pf);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeパラメーターが含まれます。より詳細な情報は、上記応答のパラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_savepersonfavourite.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_savepersonfavourite.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              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());
    }
    %>



    Expand
    titleREMOVEPERSONFAVOURITE

    こちらのwebサービスの呼び出しは、特定のユーザーのお気に入り一覧から、レポート、ストーリーボード、ビューなどの項目やオブジェクトを削除します。また、ユーザーのダッシュボードからダッシュボードタブを削除し、ユーザーによりフラグ付けされたコメントのフラグを外すこともできます。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスの管理者ユーザーIDです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「REMOVEPERSONFAVOURITE」に設定します。

    FavouritePersonFavouriteこちらのオブジェクトは、ユーザーのお気に入り登録から削除する項目を指定するために使用します。こちらでユーザーも指定します。より詳細な情報は、以下の表を参照してください。


    以下は、こちらのwebサービスの呼び出しのPersonFavouriteオブジェクトに設定しなくてはいけない主要なパラメーターです。

    PersonFavourite要素データ型説明
    PersonIdInteger内部ID(IP ID)とともにユーザーを識別するために必須のパラメーターです。この値は、YellowfinのデータベースのPerson.IpIdフィールドに対応するか、AdministrationPerson.getIpId()を使用して取得しなくてはいけません。選択された項目は、ユーザーのお気に入りから削除されます。
    ContentTypeString

    こちらの必須パラメーターは、お気に入りから削除する項目のコンテンツタイプを指定するために使用します。値の選択肢は、以下の通りです。

    • REPORT
    • REPORTGROUP
    • DISCUSSIONGROUP
    • REPORTVIEW
    • STORYBOARD
    • IMAGE
    ContentIdIntegerこちらの必須パラメーターは、内部IDを提供することで、ユーザーのお気に入りに登録された項目を定義するために使用します。
    FavouriteTypeStringこちらは、ユーザーのお気に入りからレポートやダッシュボードを削除するために必要です。 
    CreationCodeString
    TextEntityIdIntegerこちらのパラメーターは、コメントのフラグ付けを外すために必要です。


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
                <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>REMOVEPERSONFAVOURITE</function>
                <favourite>
                    <personId>13000</personId>
                    <contentType>REPORTGROUP</contentType>
                    <contentId>61209</contentId>
                </favourite>    
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>0cc3673ed857e1e28fb0e326b8f3b24e</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数の基礎的なリクエストから開始します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
       
      rsr.setLoginId("admin@yellowfin.com.au");
      rsr.setPassword("test");
      rsr.setOrgId(1);
       
      rsr.setFunction("REMOVEPERSONFAVOURITE");


    • PersonFavouriteオブジェクトを使用して、ユーザーを識別します。


      Code Block
      languagejava
      themeEclipse
      PersonFavourite pf = new PersonFavourite();
      pf.setPersonId(13073);


    • こちらのオブジェクト内でお気に入りから削除されるオブジェクトを指定します。


      Code Block
      languagejava
      themeEclipse
      pf.setContentId(61252);
      pf.setContentType("REPORTVIEW");


    • リクエストにこちらのオブジェクトを追加します。


      Code Block
      languagejava
      themeEclipse
      rsr.setFavourite(pf);


    • リクエストを構成したら、呼び出しを実行します。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 返される応答には、StatusCodeパラメーターが含まれます。より詳細な情報は、上記応答のパラメーターの表を参照してください。



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_removepersonfavourite.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_removepersonfavourite.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_removepersonfavourite.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("REMOVEPERSONFAVOURITE");
      
    PersonFavourite pf = new PersonFavourite();
    pf.setPersonId(13073);
    pf.setContentId(70270);
    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());
    }
    %>



    Expand
    titleGETIDFORUUID

    こちらの関数は、UUIDを渡すことでYellowfinコンテンツの内部IDを取得します。対象のコンテンツはビュー、レポート、ダッシュボード、データトランスフォーメーションです。


    リクエストパラメーター

    以下の要素は、こちらのリクエストとともに渡されます。

    リクエスト要素データ型説明

    LoginId

    String

    Yellowfin Webサービスに接続する管理者アカウントです。これは、ログインIDの方法に応じて、ユーザーID、または電子メールアドレスになります。

    このYellowfinアカウントは、「Yellowfin Webサービス使用権」が有効化されたロールを持ち、デフォルト(プライマリー)組織に所属していなくてはいけません。

    Password

    String

    上記アカウントのパスワードです。

    OrgId

    Integer

    Yellowfin内のデフォルト(プライマリー)組織IDです。常に、「1」に設定します。

    Function

    String

    Webサービス関数です。こちらは、「GETIDFORUUID」に設定します。

    ParametersString[]

    文字列値の配列です。最初の文字列はUUIDを含む必要があります。二番目のパラメーターを使用して、コンテンツのタイプを指定することができます。以下のコンテンツタイプがサポートされています。

    • VIEW
    • REPORT
    • DASHBOARD
    • ETLPROCESS(データトランスフォーメーションフロー)


    リクエストの例

    以下は、こちらのリクエストのSOAP XMLの例です。

    Code Block
    languagexml
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservices.web.mi.hof.com/">
       <soapenv:Header/>
       <soapenv:Body>
          <web:remoteAdministrationCall>
             <arg0>
              <loginId>admin@yellowfin.com.au</loginId>
                <password>test</password>
                <orgId>1</orgId>
                <function>GETIDFORUUID</function>
                <parameters>594d4da4-1b58-44d3-bf4f-11456a42f68c</parameters>
                <parameters>report</parameters>     
             </arg0>
          </web:remoteAdministrationCall>
       </soapenv:Body>
    </soapenv:Envelope>


    応答パラメーター

    返される応答には、これらのパラメーターが含まれます。

    応答要素データ型説明

    StatusCode

    String

    Webサービス呼び出しのステータスです。値の選択肢は、以下の通りです。

    • SUCCESS
    • FAILURE
    EntityIdInteger指定したコンテンツの内部IDです。


    応答の例

    サービスは、今回のSOAPの例に基づき、以下の応答を返します。

    Code Block
    languagexml
    themeEclipse
    <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
       <S:Body>
          <ns2:remoteAdministrationCallResponse xmlns:ns2="http://webservices.web.mi.hof.com/">
             <return>
                <entityId>56401</entityId>
                <errorCode>0</errorCode>
                <messages>Successfully Authenticated User: admin@yellowfin.com.au</messages>
                <messages>Web Service Request Complete</messages>
                <sessionId>806c38d4e47a8d7d4ccaff1360602693</sessionId>
                <statusCode>SUCCESS</statusCode>
             </return>
          </ns2:remoteAdministrationCallResponse>
       </S:Body>
    </S:Envelope>


    手順

    Javaの例を使用して、こちらの呼び出しを実行するための詳細な手順は、以下を参照してください。

    Expand
    title詳細手順
    • 管理ユーザーとしてのログインと、実行するwebサービスの呼び出しの指定を含む、こちらの関数のリクエストを定義します。

      Code Block
      languagejava
      themeEclipse
      AdministrationServiceRequest rsr = new AdministrationServiceRequest();
        
      rsr.setLoginId("admin@yellowfin.com.au");      
      rsr.setPassword("test");          
      rsr.setOrgId(1);
      rsr.setFunction("GETIDFORUUID");


    • IDが必要なYellowfinコンテンツのUUIDとタイプを渡します。


      Code Block
      languagejava
      themeEclipse
      rsr.setParameters(new String[]{"fb6416c4-441e-42b3-a442-e7426f25f6b4","VIEW"});


    • リクエストを構成したら、呼び出しを実行してサーバをテストします。

      Code Block
      languagejava
      AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);

      管理webサービスを初期化します。実行方法の詳細は、こちらを参照してください。


    • 応答を取得するために、以下のコードを追加します。成功すると、エンティティID(コンテンツのID)が表示されます。


      Code Block
      languagejava
      themeEclipse
      if ("SUCCESS".equals(rs.getStatusCode()) ) {
                      out.write("<br>Success");
                      out.write("<br>ID: " + rs.getEntityId());
                      }
                      else {
                      out.write("<br>Failure");
                      out.write(" Code: " + rs.getErrorCode());
                      }



    完成例

    以下は、こちらのwebサービスの呼び出しの完成例です。こちらを使用するには、以下の手順に従います。

    1. コードをコピーして、「ws_idforuuid.jsp」として保存します。
    2. root(Yellowfin/appserver/webapps/ROOT)フォルダーにファイルを配置します。
    3. 環境に応じて、ホスト、ポート番号、管理ユーザーの詳細を調整します。
    4. インターネットブラウザから、「http://<host>:<port>/ws_idforuuid.jsp」を実行します。

    Code Block
    languagejava
    themeEclipse
    <%          
    /*              ws_idforuuid.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("GETIDFORUUID");
      
    rsr.setParameters(new String[]{"fb6416c4-441e-42b3-a442-e7426f25f6b4","VIEW"});
    AdministrationServiceResponse rs = adminService.remoteAdministrationCall(rsr);
      
    if ("SUCCESS".equals(rs.getStatusCode()) ) {
                    out.write("<br>Success");
                    out.write("<br>ID: " + rs.getEntityId());
                    }
                    else {
                    out.write("<br>Failure");
                    out.write(" Code: " + rs.getErrorCode());
                    }              
    %>