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

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Table of Contents
classcontents

概要

Styleclass
ClasstopLink

ページトップ

Javascript APIを使用することで、Yellowfinのレポートやダッシュボードを、Yellowfinとは異なるウェブサーバ上にある、外部のウェブページに埋め込むことができます。こちらを実行する唯一の要件は、エンドユーザーのブラウザが、Yellowfinサーバにアクセス可能であることです。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>

 

上記のスクリプトレットの例は、囲みページ内でレポートをレンダリングします。ユーザーが、組み込みレポートが送信されるインスタンス上に現在のセッションを持っていない場合は、ゲストユーザーログインが有効になっており、表示されているコンテンツが保護されていない限り、ユーザーはログインを求められます。より詳細な情報は、以下のユーザーアクセス項目を参照してください。

組み込みレポートが、動的ページ、またはポータルに使用されている場合、YellowfinのLOGINUSER webサービスにより、シングルサインオンを使用して、ユーザーを自動的にログインさせることができます。URLにトークンが追加されます。

組み込みウィジェットは、大幅にスタイリング、または変更をすることができません。カスタマイズ性に制限のあるJSAPIとの統合の容易さと、 カスタマイズ性に制限のないレポートサービスAPIを使用した複雑な統合を折衷しなくてはいけません。より詳細な情報は、以下の制限項目を参照してください。

サードパーティ製アプリケーション実装の中には、管理サービスwebサービスの組み合わせを使用して、ユーザーに利用可能なレポートやダッシュボードを返し、JavaScript APIを使用してこれらをユーザーにレンダリングします。

 

HTMLページは、複数のレポートを含めることができますが、個々のレポートは、各ページにひとつのみ表示することができます。

...

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

表示

Styleclass
ClasstopLink

ページトップ

レポート

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

 説明

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

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

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

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

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

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

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

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

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

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

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

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

ダッシュボード

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

...

 説明

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

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

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

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

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

使用例

Styleclass
ClasstopLink

ページトップ

レポートの埋め込み

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

...

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

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

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

...

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

ユーザーアクセス

Styleclass
ClasstopLink

ページトップ

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

 

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

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

...

ユーザーが、Javascript APIにログインするために、Yellowfinのユーザー名とパスワードを入力した場合、ブラウザにcookieが保存され、ログイン時に使用したユーザー情報が記憶されます。次回ユーザーが、Javascript APIを使用して埋め込まれたレポートやダッシュボードを含むページにアクセスした場合、同様のユーザー情報を使用して、自動的にログインします。これによりユーザーは、レポートやダッシュボードをリクエストする都度、ユーザー情報を入力する必要がなくなります。デフオルトでは、cookieはユーザーの最終ログインから7日間有効です。こちらの設定は、「管理コンソール」>「システム構成」>「電子メールシステム」で、「外部API cookieクッキー・タイムアウト」から変更することができます。こちらを「0」に設定すると、cookieは無効化されます。

...

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


制限

Styleclass
ClasstopLink

ページトップ

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

...

    • 複数のレポートを、ひとつのHTMLページに追加することができますが、個々のレポートは、ひとつのページにひとつのみ含めることができます。
    • ひとつのHTMLページでサポートされるダッシュボードは、ひとつのみです。
    • カレンダーを使用した日付フィルターは、使用することができません。
    • ドリルエニウェアを使用することはできません。
    • 保存されたフィルターのセットを使用するはできません。
    • グラフアニメーションを使用することはできません。マルチグラフキャンバスを使用することはできません。

 

horizontalrule
Styleclass
ClasstopLink

ページトップ