概要
JavaScript グラフは基本的に、2つのコンポーネントで構成されています。「JavaScript」と「CSSコード」です。CSSはオプション設定です。JavaScriptは、独自のライブラリーを記述することも、既存のライブラリーを活用することもできます。Yellowfinには、様々なライブラリーが事前に設定されており「/js/chartingLibraries/」フォルダーに格納されています。必要に応じて、任意のライブラリーをこちらのフォルダーに追加することをお勧めします。これは、グラフライブラリーの使用に技術的に必要なことではなく、JavaScriptとレポートデータを使用して作成することも可能です。
CSSルールを定義する場合、Yellowfinのスタイル矛盾しないように、独自の名前を付けることをお勧めします。例:mycompanyname_chart_ textcolour
グラフデータオプション
オプション | 説明 |
JavaScript コードパネル | JavaScript コードの入力に使用します。 |
CSSパネル | CSSコードの提供に使用します。 |
プレビューパネル | コーディングした内容のプレビューを生成します。 |
セキュリティ
JavaScript グラフ機能を有効にするために、管理者は二階層システムを使用しなくてはいけません。以下を実行します。
- システム構成ページで、以下の項目を有効にします(「管理コンソール」>「システム構成」>「システム」>「セキュリティ」>「JavaScript グラフ」)。
- 選択したロールで、以下の機能を有効にします(「ロール」>「レポートビルダー」>「JavaScript グラフ」)。
JavaScript グラフの作成者や編集者のために、新規ロールを設定することをお勧めします。これにより、JavaScript グラフ機能は厳重に管理され、必要の無い時には無効にすることができます。
JavaScript 機能を有効にする方法は、こちらを参照してください。
JavaScript グラフ機能を無効にした場合
システム構成レベルで、JavaScript グラフ機能を無効にした場合
- すべてのJavaScript グラフの実行が停止します。
- JavaScript グラフのためのすべてのJavaScript/CSSをプラットフォームからエクスポートすることができません。
- プラットフォームにJavaScript グラフをインポートすることができません。
JavaScript グラフ機能が有効化されたロールを付与されていないユーザーは、JavaScript グラフをインポートすることはできません。
グラフ作成者は、開発環境とテスト環境に関する適切なコンテンツ開発と移行戦略、および承認ワークフローを活用し、ガバナンスを確保することをお勧めします。
generateChart機能の使用
JavaScript グラフ作成時に唯一必要な機能は、「generateChart」です。サンプルコード内で提供されている他の機能は推奨です。Yellowfinは、JavaScript コードを実行するために、generateChartを呼び出します。
すべてのオプションとYellowfinから必要なデータは、JSONオブジェクトの一部として、generateChart機能へ送られます。
指定されたdiv (Options. divSelector)にすべてを描画し、データセットからIDを取得します。
JavaScript グラフの例
RequireとShim
JavaScript グラフに必要なライブラリーをロードするためには、「Require」を使用します。JavaScript APIを介した埋め込みや、レポートの一般公開をするのであれば、「絶対パス」を使用しなくてはいけません。それ意外の場合は、相対パスで構いません。Requireを使用するためには、下記のように、ロードに必要なパスを定義します。
非AMD JavaScript ライブラリーが使用される特定の場合では、「Shim」が必要です。Yellowfinに事前に設定されているライブラリーはShimを必要としませんが、ウェブサイトをソースとする特別なライブラリーを使用する場合に必要になる可能性があります。
Shimについてより詳細な情報は、requireJSの資料を参照してください。
Shimを使用して非AMDライブラリーであるVizJSを要求する例は、以下の通りです。
Options JSON オブジェクト
選択できるグラフのタイプは、以下の通りです。一度タイプを選択した後でも、簡単に他のタイプに切り替えることができるので、他のタイプでの見え方を確認することもできます。グラフ選択ガイド