Versions Compared

Key

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

...

今回は、下記の例を使用して説明します。例に使用されているデータのいくつかは、省略されていることに留意してください。

...

1. divSelector (options.divSelector)

グラフの描画をするdivのIDを使用するCSSセレクターです。これは、JQuery、D3、またはCSSスタイルセレクターを使用するすべてのセレクターで使用することができます。

...

var $chartDrawDiv = $(options.divSelector);

2. chartId (options. chartId)

現在のグラフのインターナルYellowfin IDです。

3. errorCallback (options.errorCallback)

Yellowfinのデフォルトエラーメッセージを表示するために呼び出す関数です。JavaScript グラフからのエラーメッセージを、Yellowfinのスタイリングと一貫して表示したい場合は、これを使用します。これは、発生したエラーをコンソールにも出力します。

4. dataset (options. dataset)

レポートデータや、いくつかのレンダリング情報を表す属性を持つオブジェクトです。データセットオブジェクトには、以下の属性が含まれます。

4.1 chart_information (options. dataset. chart_information)

グラフレンダリングに使用される情報を含むオブジェクトです。

  • 高さと幅:グラフがレンダリングする領域の高さと幅の属性を含みます(ダッシュボードポートレット、キャンバスウィジェット、ストーリーボード、グラフビルダーの表示、JavaScript API)。レポートの表示ページに、レポートがひとつだけの場合に、グラフに設定される高さと幅になります。これらの値がJavaScript コンテナーで使用されていることを確認し、適切なサイズに変更してください。
  • タイトル:グラフのタイトルが定義されている場合、データセットオブジェクトの一部になります。

4.2 metadata (options. dataset. metadata)

レポート内のフィールドの情報です。属性の名前は、レポート内のフィールドに基づきます(スペース付きの小文字はすべてアンダースコアに置き換えられ、重複するフィールド名は名前の末尾に数字が追加されます)。こちらで使用されるフィールド名は、データに使用されるフィールド名に対応します。メタデータ内で、下記のオブジェクトは、各フィールドにそれぞれの属性を含みます。

属性説明
data_typeフィールドのデータ型を表す文字列です(TEXT、NUMERIC、など)。
field_name書式設定されたフィールドの名前です。翻訳が有効になっている場合、ユーザーの優先言語でフィールド名の翻訳バージョンが返されます。
metric_colourオプション設定:ビューレベルで、このフィールドにメトリック(数値)色が設定されている場合は、選択された色のHEXコード(例:#FFFFFF)を含むmetric_colour属性が存在します。
org_refcode

オプション設定:データページで、フィールドに参照コードが適用されている場合、この参照コードの情報は、JavaScript グラフデータセットオブジェクトに含まれます。

これは、参照コード名を返します。上記の例では、「DEMOGRAPHIC」が該当します。

属性オブジェクトは、参照コードの実際のデータを含みます(例:並び順、表示テキスト、色、など)。下記の「orgrefcode_definitions」を参照してください。

4.3 data (options. dataset. data)

レポート内の実際のデータを含むオブジェクトです。上記で定義したメタデータの場合と同様に、属性の名前はレポート内のフィールドに基づきます(スペース付きの小文字はすべてアンダースコアに置き換えられ、重複するフィールド名は名前の末尾に数字が追加されます)。これらは、各フィールドの以下の属性を持つオブジェクトの配列を表します。

属性説明
raw_dataこのフィールドに含まれる基礎データです。
formatted_data

接頭辞、接尾辞、小数点以下桁数、などを含む、このフィールドの書式設定が適用されたデータです。

これらのデータ配列は、データがレポートに表示される順序になっています。これはつまり、「options.dataset.data.camp_region」と「options.dataset.data.camp_rating」がデータの同一のロウ(列)にあることを示してます。

4.4 attributes (options. dataset. attributes)

追加のレンダリング情報を含むオブジェクトです。これには、以下の属性が含まれます。

...

現状、JavaScriptグラフには、以下の制限事項があります。

  • JavaScriptグラフをエクスポートすることはできません。JavaScriptレポートは、他のYellowfinコンテンツと同様に共有することができますが、JavaScriptグラフを含むレポートをブロードキャストする場合、グラフではなくレポートリンクのみが共有されます。
  • JavaScriptレポートは、レポートリンクとしてのみ、共有することができます。JavaScriptグラフを含むレポートをエクスポートする場合、これらのグラフはエクスポートファイルに表示されません。