30日間の無料評価版をお試しいただけます。

Versions Compared

Key

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

...

Table of Contents
classcontents

概要

Styleclass
ClasstopLink

ページトップ

Javascript APIを使用することで、Yellowfinのレポートやダッシュボードを、Yellowfinとは異なるウェブサーバ上にある、外部のウェブページに埋め込むことができます。こちらを実行する唯一の要件は、エンドユーザーのブラウザが、Yellowfinサーバにアクセス可能であることです。これは、HTMLコードにスクリプトレットを配置することで実現できます。以下は、JavaScript のスクリプトレットの例です。

 

Code Block
languagejs
<script src="http://reporting.example.com/JsAPI?reportUUID=e5e5aaf3-c3b8-4f9b-8280-e21e4d848e63&width=500&height=500" type="text/javascript"></script>

...

ドリルスルー、ドリルダウン、ユーザープロンプトフィルター、シリーズ選択、PDF形式のエクスポートのような、インタラクション要素を使用することもできます。

表示

Styleclass
ClasstopLink

ページトップ

レポート

埋め込まれたレポートには、タイトルバーと、レポートそのものが含まれます。タイトルバーには、レポート名と、レポート上で使用されるすべてのインタラクション要素のボタンが含まれます。使用されるインタラクション機能は、以下の通りです。

 説明

基本的な「レポート情報(名前、説明、最終変更日、フォルダー、サブフォルダー、現在のユーザー、など)を表示します。

レポートの埋め込みに使用する「JavaScriptを表示します。

テーブル表示とグラフ表示が使用されている場合、ユーザーは「グラフ表示に切り替えることができます。

テーブル表示とグラフ表示が使用されている場合、ユーザーは「テーブル表示に切り替えることができます。

レポートで有効になっている「ユーザープロンプトフィルターのパネルを開きます。

シリーズ選択を表示オプションが有効化されている場合、「シリーズ選択」パネルを開きます。

単位選択を表示オプションが有効化されている場合、「単位選択」パネルを開きます。

レポートに複数のページが含まれている場合、「ページナビゲーションパネルを開きます。

レポートにセクションが含まれている場合、「セクションナビゲーションパネルを開きます。

マップでHoverナビゲーションが有効化されている場合、「GISマップナビゲーションパネルを開きます。

エクスポート」パネルを開きます。こちらから、レポートを以下のような様々な形式でエクスポートすることができます。

  • CSVにエクスポート
  • DOCにエクスポート
  • PDFにエクスポート
  • リッチテキスト形式にエクスポート
  • テキストにエクスポート
  • XLSにエクスポート

ダッシュボード

埋め込まれたダッシュボードには、ダッシュボード全体のタイトルバーと、それぞれのダッシュボードのレポート(埋め込まれたレポートと、同様に表示されます)があり、Yellowfinのフロントエンドから見た時と、同じように配置されます。

...

 説明

基本的な「ダッシュボード情報(名前、説明、最終変更日、現在のユーザー、など)を表示します。

ダッシュボードの埋め込みに使用する「Javascriptを表示します。

ダッシュボードで有効になっている「ユーザープロンプトフィルターのパネルを開きます。

エクスポート」パネルを開きます。こちらから、ダッシュボードを以下のような様々な形式でエクスポートすることができます。

  • CSVにエクスポート
  • DOCにエクスポート
  • PDFにエクスポート
  • リッチテキスト形式にエクスポート
  • XLSにエクスポート

使用例

Styleclass
ClasstopLink

ページトップ

レポートの埋め込み

共有メニューを使用して、HTMLページ、wiki、またはブログで使用するためにロードするレポートを識別する埋め込み JavaScriptをコピーします。これは、以下のような形式になります。

...

より詳細な情報は、基本的な使用を参照してください。

ダッシュボードの埋め込み

配信メニューを使用して、HTMLページ、wiki、またはブログで使用するためにロードするダッシュボードを識別する埋め込み Javascriptをコピーします。これは、以下のような形式になります。

...

より詳細な情報は、基本的な使用を参照してください。

ユーザーアクセス

Styleclass
ClasstopLink

ページトップ

ユーザーは、レポートやダッシュボードにアクセスする際に、Javascript APIを通して認証されます。ユーザーがログインをしていない場合は、ゲストユーザーとしてコンテンツを参照することができます。(ゲストユーザーとしてコンテンツを参照する方法は、こちらを参照してください)レポートやダッシュボードをゲストユーザーとして実行するかどうか、認証されていないユーザーはログインをする必要があるかどうかを判断するために、様々な要因が使用されます。

 

認証の詳細情報は、ダッシュボードやレポートがロードされる際にAPIに渡すことができます。そのためには、ユーザー名とパスワードを渡すか、webサービスを介して認証し、APIにログイントークンを渡すか、の2つの方法があります。これにより、ユーザーがログイン情報を入力するのではなく、コンテンツのロードに特定のユーザーを使用することができます。

...

注意:ブラウザに保存されるcookieの値は暗号化されます。Yellowfinを再起動すると、 cookieは無効になります(例:Yellowfinを再起動した場合、すべてのユーザーに再ログインが要求されます)。


制限

Styleclass
ClasstopLink

ページトップ

現時点でのJavascript APIの制限は、以下の通りです。

...