DashXML

概要

DashXMLは、Javaベースのウェブアプリケーションであり、Webサービスを介して、Yellowfinと接続します。DashXMLは、Yellowfinと同一のサーバー上にデプロイすることもできますし、別々のサーバー上にデプロイしても構いません。

DashXMLのフレームワークは、プログラミングをすることなく、Yellowfinのコンテンツとカスタマイズされたアイテムを組合せて、ダッシュボードを作成することができます。ダッシュボードは、単一のXMLファイルで構成され、各タブ上の各要素をウィジェットとして表示します。すべてのレイアウトとスタイリングはカスタマイズされたCSSを使用して、実行することができます。

技術的前提条件

DashXMLは、高度な技術を持つユーザーによって実装されることを前提に設計されています。高度な技術を持つユーザーとは、開発者か技術的背景に強みを持つユーザーを想定しています。

DashXMLソリューションを実装するためには、最低でも以下の技術が要求されます。

セキュリティ

DashXMLには、そのまま使用できるユーザーセキュリティがありません。Javaサーブレットのフィルターを使用して、サードパーティのユーザーセキュリティを実装することができます。これは、ユーザーや、与えられたダッシュボードのアクセスをテストしたり、ユーザーに適切なソースフィルターを適用したりすることができます。そして、web.xmlファイル内で定義された指名ユーザーとしてレポートを実行することができます。

特定のセッションで行レベルのセキュリティを有効にするためにソースフィルターを渡すことができます。ソースフィルターは、Yellowfinのインターフェイス上で定義する必要があり、その後、DashXML内で参照します。

制限

DashXMLは、Yellowfinインターフェイスで使用できるすべての機能を再現できるわけではありません。DashXML内で再現することのできない機能は、以下の通りです。

• • ドリルダウン（表上）とリンクされたドリルダウン
  • ドリルエニウェア（表上とグラフ上の両方）
  • ドリルスルー（表上とグラフ上の両方）
  • ブラッシングとリンクされたブラッシング
  • シリーズ選択とリンクされたシリーズ選択
  • 対話操作とマルチグラフキャンバス上でのツールチップ
  • アニメーションが適用されたグラフの読み込み
  • タイムシリーズの日付スライダーと単位選択
  • カラムの書式適用（国旗書式など）
  • マップ上でのレイヤー選択
  • コラボレーション
  • クライアント組織
  • Yellowfinダッシュボード
  • Yellowfinストーリーボード

インストール

1. 現在使用しているYellowfinが、CPUライセンスを有していることを確認してください。
   CPUライセンスが無い場合は、担当のアカウントマネージャーまでご連絡ください。
   
   
2. Yellowfinウェブサイト内のサポートセンターページより、DashXMLをダウンロードしてください。
   こちらのページへのアクセス権限が無い場合は、担当のアカウントマネージャーまでご連絡ください。
   
   
3. 現在使用しているYellowfinのバージョンに、7.1の最新パッチが適用されていることを確認してください。
   Yellowfinは毎月パッチをリリースしています、最新のパッチは、サポートセンターよりダウンロードしてください。
   注意：Yellowfin 7.1の初期のバージョン（または、7.1以前のリリース）では、DashXMLフレームワークへの互換性がありません。
   
   
4. Yellowfinインスタンスを停止します。
   Yellowfinインスタンスに関連するファイルに対して、変更を行います。適切に変更内容を更新するためには、Yellowfinを必ず停止しなくてはいけません。
   
   

5. web.xml ファイルを編集します。
   \Yellowfin\appserver\webapps\ROOT\WEB-INF\ に配置されているweb.xmlファイルを編集します。Webサービスを使用可能にするために、以下の項目のコメントアウトを解除する必要があります。

   変更前： <!-- Uncomment this section to enable JAX-WS Web Services. Java 1.6+ only <listener> <listener-class> com.sun.xml.ws.transport.http.servlet.WSServletContextListener </listener-class> </listener> <servlet> <servlet-name>WebServices</servlet-name> <servlet-class> com.sun.xml.ws.transport.http.servlet.WSServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>WebServices</servlet-name> <url-pattern>/webservices/*</url-pattern> </servlet-mapping> -->

   変更後： <!-- Uncomment this section to enable JAX-WS Web Services. Java 1.6+ only --> <listener> <listener-class> com.sun.xml.ws.transport.http.servlet.WSServletContextListener </listener-class> </listener> <servlet> <servlet-name>WebServices</servlet-name> <servlet-class> com.sun.xml.ws.transport.http.servlet.WSServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>WebServices</servlet-name> <url-pattern>/webservices/*</url-pattern> </servlet-mapping>

   変更が完了したら、ファイルを保存します。
   
   

6. DashXMLファイルを解凍します。
   DashXMLは、以下の二つの方法でインストールすることができます。 
   　a. Yellowfinのディレクトリ上にインストールすることで、同一のTomcatインスタンス上で起動します。
   　b. 必要であれば、Yellowfinとは別のサーバ上にある、まったく別のTomcatインスタンスにインストールすることもできます。

   Yellowfinと同一のTomcat	Yellowfinとは別のTomcat
   DashXMLフォルダ（ダウンロードしたzipファイルより）をコピーし、\Yellowfin\appserver\webapps\ディレクトリへ貼り付けます。これにより、webapps内に、ROOTとDashXML両方のディレクトリが存在することになります。	DashXMLフォルダ（ダウンロードしたzipファイルより）をコピーし、\Tomcat\webapps\ ディレクトリへ貼り付けます。これにより、webapps内にDashXMLのディレクトリが存在することになります。

7. DashXMLのweb.xmlファイルを編集します。
   \webapps\DashXML\WEB-INF\ に配置されているweb.xmlファイルを編集します。DashXMLをYellowfinインスタンスと接続するためには、このファイル内で以下の三箇所を変更する必要があります。
   　a. 現在使用しているYellowfinのURLを設定します。

   <init-param>
     <param-name>PathToServer</param-name>
     <param-value>http://server-name:7171</param-value> <!-- update to Yellowfin server -->
   </init-param>

   　b.  現在使用しているYellowfinのユーザー名を設定します。

   <init-param>
     <param-name>Username</param-name>
     <param-value>admin@yellowfin.com.au</param-value> <!-- update to Yellowfin username -->
   </init-param>

   　c.  現在使用しているYellowfinユーザーのパスワードを設定します。

   <init-param>
     <param-name>Password</param-name>
     <param-value>test</param-value> <!-- update to Yellowfin password -->
   </init-param>

8. Yellowfinを起動します。