Base API

Base API リファレンス

このAPIは、「JsAPI/v3」JSファイルがページに含まれているページでのみ使用できます。以下の例を参照してください。

Base APIには、Yellowfin APIを独自のウェブページにロードするのに役立つ多くの関数が含まれています。レポートおよびダッシュボードローダーAPIをロードする関数があり、ダッシュボードおよびレポートをロードできます。

セッション管理を支援する関数もあります。

init()

リターン

Promise

説明

Base APIを初期化します。これは、APIがページに含まれている時に呼び出されます。ロードが終了した時点で、APIの使用がこのPromiseが解決するまで待機することを示すPromiseを返します。

例

Yellowfin レポートAPIをページに含め、init() promiseが解決した後でレポートをロードします。

logoff()

リターン

なし

説明

現在のユーザーセッションを終了します。

loadReport(reportOptions)（レポートのロード）

リターン

Promise

説明

init() promiseがロードするの待ち、渡されたオプションでレポートをロードします。レポートがロードされると、渡されたelement（要素）が追加され、レポートの実行が開始されます。

promiseが解決されると、レポートオブジェクトは.then()関数に渡されます。promiseは、レポートの実行が開始される直前に解決されます。

オプションオブジェクトの一部として受け入れられるオプションがいくつかあります。

reportId（レポートID） - 必須

型：String

ロードするレポートのレポートUUIDです。これは、レポートヘッダーテーブルの公開UUIDです。

element（要素） - 必須

型：DOM Element、Selector String

レポートに描画するelement（要素）です。DOM element、またはページからelementを選択するために使用されるselectorのどちらかになります。

幅や高さが渡されない場合、レポートはelementの寸法に合わせて展開されます。

width（幅）

型：Number

レポートをピクセル単位で描画する幅です。

height（高さ）

型：Number

レポートをピクセル単位で描画する高さです。

filterValues（フィルター値）

型：Array[Object]

初期フィルター値を適用するために使用されるオブジェクトの配列です。

フィルター値についての詳細は、フィルター APIを参照してください。

オブジェクトには、次の情報が含まれます。

• filterId - 設定するフィルターのUUID、または名前です。
• valueOne - フィルターの最初の値です。
• valueTwo - フィルターの二番目の値です。Between（の間）、またはNot Between（の間ではない）フィルタータイプにのみ影響します。
• valueList - フィルター一覧に適用する値の配列です。

instanceName（インスタンス名）

型：String

レポートのインスタンスの識別子です。このプロパティが定義されない場合は、ランダムなIDが生成されます。つまり、インスタンス名を定義することなく同じレポートを複数回含めた場合、そのレポートは常に別のインスタンスになります。

これを設定すると、同じインスタンスのレポートの複数のビューをロードできるようになります。

showToolbar（ツールバーの表示）

型：Boolean

レポートツールバーを表示するかどうかを定義します。

または、showToolbarプロパティをfalseに設定します。

showTitle（タイトルの表示）

型：Boolean

レポートのツールバーにレポートタイトルを表示するかどうかを定義します。デフォルト：true

showTitle オプションをfalseに設定した場合：

showInfo（詳細の表示）

型：Boolean

レポートのツールバーに詳細オプションを表示するかどうかを定義します。デフォルト：true

このオプションをfalseに設定した場合：

showFilter（フィルターの表示）

型：Boolean

レポートのツールバーにフィルターオプションを表示するかどうかを定義します。デフォルト：true

このオプションをfalseに設定した場合：

showExport（エクスポートの表示）

型：Boolean

レポートのツールバーにエクスポートオプションを表示するかどうかを定義します。エクスポートオプションを使用することで、レポートをcsv、xls、pdf、txt、docなどの外部ファイル形式にエクスポートすることができます。

showExport パラメーターをfalseに設定する場合、ツールバー内のエクスポートアイコンは削除されます。

showShare（共有の表示）

型：Boolean

レポートのツールバーに共有オプションを表示するかどうかを定義します。デフォルトはtrueに設定されています。

showDisplayToggle（表示トグルの表示）

型：Boolean

レポートのツールバーにレポートのグラフ/表オプションを表示するかどうかを定義します。デフォルトはtrueに設定されています。

このオプションをfalseに設定した場合

例

レポートをロードして、その名前を出力します。

loadDashboard(dashboardOptions)

リターン

Promise

説明

init()promiseがロードされるのを待ち、渡されたオプションでダッシュボードをロードします。ダッシュボードがロードされると、渡されたelement（要素）に追加され、ダッシュボード上のコンテンツの実行が開始されます。

dashboardOptionsオブジェクトには、いくつかのパラメーターを含めることができます。

dashboardUUI（ダッシュボードUUID） - 必須

型：String

ロードするダッシュボードの公開UUIDです。

element（要素） - 必須

型：DOM Element、Selector String

ダッシュボードに描画するelement（要素）です。DOM element、またはページからselectorの最初のインスタンスを選択するために使用されるselectorのどちらかになります。

幅や高さが渡されない場合、ダッシュボードはelement（要素）の寸法に合わせて表示されます。

filterValues（フィルター値）

型：Array[Object]

ダッシュボードの初期フィルター値を適用するために使用されるオブジェクトの配列です。

フィルター値についての詳細は、フィルター APIを参照してください。

オブジェクトには、次の情報が含まれます。

• filterId - 設定するフィルターのUUID、または名前です。
• valueOne - フィルターの最初の値です。
• valueTwo - フィルターの二番目の値です。Between（の間）、またはNot Between（の間ではない）フィルタータイプにのみ影響します。
• valueList - フィルター一覧に適用する値の配列です。

showToolbar（ツールバーの表示）

型：Boolean

ダッシュボードのツールバーを表示するかどうかを定義します。デフォルトではtrueに設定されています。

以下は、ツールバーが表示されたダッシュボードです。

しかし、showToolbar プロパティをfalseに設定した場合：

showInfo（詳細の表示）

型：Boolean

ダッシュボードのツールバーに詳細オプションを表示するかどうかを定義します。デフォルト：true

このオプションをfalseに設定した場合：

showShare（共有の表示）

型：Boolean

ダッシュボードのツールバーに共有オプションを表示するかどうかを定義します。デフォルトはtrueに設定されています。

このオプションをfalseに設定した場合：

showFilters（フィルターの表示）

型：Boolean

ダッシュボードのツールバーにフィルターオプションを表示するかどうかを定義します。デフォルトはtrueに設定されています。

このオプションをfalseに設定した場合：

scaleCanvasTabs（キャンバスタブのスケール）

型：Boolean

キャンバスタブをスケールするかどうかを定義します。デフォルトはtrueに設定されています。

これをfalseに設定した場合、キャンバスタブは作成された通りのサイズで表示されます。この設定は、キャンバスタブを含まないサブタブでは無効です。

showGlobalContentContainer（グローバルコンテンツコンテナーの表示）

ダッシュボードの描画時にグローバルコンテンツコンテナーを表示するかどうかを定義します。