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

...

Code Block
javascript
javascript
<script src="http://localhost/JsAPI" type="text/javascript"></script>
<script type="text/javascript">
if (!window.yellowfin) {
   alert('Error loading API');
}
</script>

...

サーバー情報

Styleclass
ClasstopLink

ページトップ

After loading the API, some server information is made available:APIをロードすると、一部のサーバー情報を使用できるようになります:

Expand
titleここを展開...

 

説明

yellowfin.apiVersion

...

サーバーで使用しているAPIのバージョンです。

yellowfin.baseURL

...

サーバー上のAPIに接続するために使用されるベースとなるURLです。

yellowfin.serverInfo.releaseVersion

...

The release version of Yellowfin running on the server (eg. "6.1")

サーバーで実行しているYellowfinのリリースバージョンです(例:「6.1」)。

yellowfin.serverInfo.buildVersion

...

サーバーで実行しているYellowfinのビルドバージョンです(例:「20120601」)。

yellowfin.serverInfo.javaVersion

...

サーバーにインストールされているJavaのバージョンです。

yellowfin.serverInfo.operatingSystem

...

サーバーで実行しているオペレーティングシステムです。

yellowfin.serverInfo.operatingSystemArch

...

サーバーのオペレーティングシステムアーキテクチャです。

yellowfin.serverInfo.operatingSystemVersion

...

サーバーのオペレーティングシステムバージョンです。

yellowfin.serverInfo.schemaVersion

...

The schema version of the Yellowfin configuration database

Yellowfin構成データベースのスキーマバージョンです。

Code Block
javascript
javascript
<script src="http://localhost/JsAPI" type="text/javascript"></script>
<script type="text/javascript">
if (window.yellowfin) {
   alert('Yellowfin API loaded. Version: ' + yellowfin.apiVersion);
}
</script>

...

オプションは、Javascriptオブジェクトとして関数に渡されます。ロードしているレポートのレポート識別子、レポートをロードするHTML要素のelementId(またはelementそのもの)、およびレポートの表示方法を変更するその他のオプションなどがあります。使用可能なオプションは以下のとおりです:

Expand
titleここを展開...

オプション

説明

reportUUID

...

reportUUID

...

reportId

...

wsName のいずれかが存在する必要があります。
ロードするダッシュボードを識別する固有のIDです。

reportId

...

reportUUID

...

wsName

...

Either reportUUID, reportId or wsName must be present.The Web Service name identifying the report to load. It is recommended to use the reportUUID parameter instead.

...

elementId

...

Either elementId or element must be present.The id of the html element in which to load the report.

...

element

...

Either elementId or element must be present.The html element in which to load the report.

...

showTitle

...

Default: trueSet to false to omit the title bar at the top of the report. All interactive buttons included in the title bar will also be omitted.

...

showInfo

...

Default: trueSet to false to omit the Info button in the title bar.

...

showFilters

...

Default: trueSet to false to omit the Filters button in the title bar. Any user-prompt filters will not be displayed.

...

showSections

...

Default: trueSet to false to omit the Sections button in the title bar (for reports with tabbed or multi-page sections).

...

showSeries

reportIdwsName のいずれかが存在する必要があります。
ロードするレポートを識別する数値のreportIdです。代わりに reportUUID パラメーターを使用することをお勧めします。

wsName

reportUUIDreportIdwsName のいずれかが存在する必要があります。
ロードするレポートを識別するWebサービス名です。代わりに reportUUID パラメーターを使用することをお勧めします。

elementId

elementIdelement のいずれかが存在する必要があります。
レポートをロードするHTML要素のIDです。

element

elementIdelement のいずれかが存在する必要があります。
レポートをロードするHTML要素です。

showTitle

デフォルト: true
false に設定すると、レポート上部のタイトルバーが省略されます。タイトルバーに含まれるすべての対話型ボタンも省略されます。

showInfo

デフォルト: true
false に設定すると、タイトルバーの情報ボタンが省略されます。

showFilters

デフォルト: true
false に設定すると、タイトルバーのフィルターボタンが省略されます。ユーザープロンプトフィルターは表示されません。

showSections

デフォルト: true
false に設定すると、タイトルバーのセクションボタンが省略されます(タブ形式または複数ページのセクションを使用するレポートの場合)。

showSeries

デフォルト: true
false に設定すると、タイトルバーのシリーズボタンが省略されます(シリーズ選択オプションを使用するレポートの場合)。

showPageLinks

デフォルト: true
false に設定すると、タイトルバーの前のページ/次のページボタンが省略されます(複数ページを使用するレポートの場合)。

showExport

デフォルト: true
false に設定すると、タイトルバーのエクスポートボタンが省略されます。

height

デフォルト: 囲み要素の寸法から自動的に検出します。
レポートの高さを上書きするには、数値を設定します。

width

デフォルト: 囲み要素の寸法から自動的に検出します。
レポートの幅を上書きするには、数値を設定します。

display

デフォルト: chart
table に設定すると、レポートの初期状態がテーブルで表示されます。
chart に設定すると、レポートの初期状態がグラフで表示されます。
テーブルとグラフの両方が使用可能でないレポートでは無視されます。

fitTableWidth

デフォルト: true
true に設定すると、レポートを囲み要素の幅に合わせようとします。

canChangeDisplay

デフォルト: true
false に設定すると、ユーザーがグラフ表示とテーブル表示を切り替えできるボタンが省略されます。

filters

レポートに渡すフィルター値が格納されているオブジェクトに設定します。

username

password パラメーターと共に設定すると、レポートをロードするときに特定のユーザーとして認証されます。ユーザーは制限されているレポートを表示する前に、ログインの詳細を入力する必要がありません。

password

username パラメーターと共に設定すると、レポートをロードするときに特定のユーザーとして認証されます。

ユニバーサルIDで指定された要素にレポートをロードし、初期の表示オプションをいくつか設定する例を示します:

Code Block
javascript
javascript

var options = {};
options.reportUUID = 'e5e5aaf3-c3b8-4f9b-8280-e21e4d848e63';
options.elementId = 'myReport';
options.showFilters = 'false';
options.showSeries = 'false';
options.display = 'chart';
options.fitTableWidth = 'false';

...

Default: trueSet to false to omit the Series button in the title bar (for reports with the series selection option).

...

showPageLinks

...

Default: trueSet to false to omit the previous page/next page button in the title bar (for reports with multiple pages).

...

showExport

...

Default: trueSet to false to omit the Export button in the title bar.

...

height

...

Default: automatically detected from the dimensions of the enclosing elementSet this to a numeric value to override the report height.

...

width

...

Default: automatically detected from the dimensions of the enclosing elementSet this to a numeric value to override the report width.

...

display

...

Default: chartSet to table to display the report initially as a table.Set to chart to display the report initially as a chart.This is ignored for reports that do not have both table and chart available.

...

fitTableWidth

...

Default: trueSet to true to attempt to scale the report to the width of the enclosing element.

...

canChangeDisplay

...

Default: trueSet to false to omit the buttons that allow the user to switch between chart and table display.

...

filters

...

Set to an object containing filter values to pass to the report.

...

username

...

Set this along with the password parameter to authenticate as a particular user when loading the report. This avoids the need for users to enter their login details before viewing restricted reports.

...

password

...

Set this along with the username parameter to authenticate as a particular user when loading the report.

ユニバーサルIDで指定された要素にレポートをロードし、初期の表示オプションをいくつか設定する例を示します:

Code Block
javascriptjavascript

var options = {};
options.reportUUID = 'e5e5aaf3-c3b8-4f9b-8280-e21e4d848e63';
options.elementId = 'myReport';
options.showFilters = 'false';
options.showSeries = 'false';
options.display = 'chart';
options.fitTableWidth = 'false';
yellowfin.loadReport(options);

...

コールバック関数の1番目の引数として返されるフィルターオブジェクトは、レポートで使用されるあらゆるフィルターが格納された配列です。配列の各要素は、そのフィルターに関する情報が格納されたオブジェクトです。これらのフィルターオブジェクトには以下のプロパティがあります:

Expand
titleここを展開...

プロパティ

説明

filterUUID

...

フィルターの固有識別子です。

filterId

...

フィルターの数値識別子です。

nativeType

...

The native data type of the filter.

...

説明

...

The 説明 of the filter.

...

operator

...

The operator used with the filter.

...

display

...

The display style used by the filter.

...

dependencies

...

Set to true if other filters in the report are dependent on this one.

...

list

...

Set to true if the filter is a list style (allows multiple values).

...

between

...

Set to true if the filter is a between style (requires a start and end value).

...

listValues

フィルターのネイティブデータタイプです。

description

フィルターの説明です。

operator

フィルターで使用される演算子です。

display

フィルターで使用される表示スタイルです。

dependencies

レポートの他のフィルターがこのフィルターに従属している場合はtrueに設定します。

list

フィルターがリストスタイル(複数の値を許可する)の場合はtrueに設定します。

between

フィルターが範囲スタイル(開始値と終了値が必要)の場合はtrueに設定します。

listValues

フィルターがドロップダウンリストとして表示される場合は、このプロパティに使用可能なオプションのリストが格納されます。

...

レポートフィルターをロードしてユーザーに表示する例を示します:

...

Code Block
javascript
javascript
filterValues[filterUUID] = [500, 600];

loadReport 関数に渡される options.filters  loadReport 関数に渡される おp 要素は、 要素は、 filterUUID または filterId でキー設定された値を含む必要があります。可能な限り filterUUID を使用することをお勧めします。

...

オプションは、Javascriptオブジェクトとして関数に渡されます。ロードしているダッシュボードの識別子、ダッシュボードをロードするHTML要素のelementId(またはelementそのもの)、およびダッシュボードの表示方法を変更するその他のオプションなどがあります。使用可能なオプションは以下のとおりです:

Expand
titleここを展開...

オプション

説明

dashUUID

...

存在する必要があります。
ロードするダッシュボードの固有識別子です。

elementId

...

elementId

...

element のいずれかが存在する必要があります。
ダッシュボードをロードするHTML要素のIDです。

element

...

elementId

...

showTitle

...

Default: trueSet to false to omit the title bar at the top of the dashboard. All interactive buttons included in the title bar will also be omitted.

...

showInfo

...

Default: trueSet to false to omit the Info button in the title bar.

...

showFilters

...

Default: trueSet to false to omit the Filters button in the title bar. Any analytical filters will not be displayed.

...

showExport

...

Default: trueSet to false to omit the Export button in the title bar.

...

height

...

Default: automatically set from the dimensions of the reports in the dashboard.Set this to a numeric value to override the dashboard height. If the reports in the dashboard require more space, a vertical scrollbar will be added.

...

width

...

Default: automatically set from the logged-in user's preferences or the system configuration settingSet this to a numeric value to override the dashboard width.Set this to auto to use the full width of the enclosing element.

...

filters

...

Set to an object containing filter values to pass to the dashboard.

...

username

...

Set this along with the password parameter to authenticate as a particular user when loading the dashboard. This avoids the need for users to enter their login details before viewing restricted dashboards.

...

password

element のいずれかが存在する必要があります。
ダッシュボードをロードするHTML要素です。

showTitle

デフォルト: true
false に設定すると、ダッシュボード上部のタイトルバーが省略されます。タイトルバーに含まれるすべての対話型ボタンも省略されます。

showInfo

デフォルト: true
false に設定すると、タイトルバーの情報ボタンが省略されます。

showFilters

デフォルト: true
false に設定すると、タイトルバーのフィルターボタンが省略されます。分析フィルターは表示されません。

showExport

デフォルト: true
false に設定すると、タイトルバーのエクスポートボタンが省略されます。

height

デフォルト: ダッシュボード内のレポートの寸法から自動的に設定します。
ダッシュボードの高さを上書きするには、数値を設定します。ダッシュボードのレポートが多くのスペースを必要とする場合は、縦方向のスクロールバーが追加されます。

width

デフォルト: ログインユーザーの設定またはシステム設定から自動的に設定されます。
ダッシュボードの幅を上書きするには、数値を設定します。
auto に設定すると、囲み要素の幅全体を使用します。

filters

ダッシュボードに渡すフィルター値が格納されているオブジェクトに設定します。

username

これを password パラメーターと共に設定すると、ダッシュボードをロードするときに特定のユーザーとして認証されます。ユーザーは制限されているダッシュボードを表示する前に、ログインの詳細を入力する必要がありません。

password

これを username パラメーターと共に設定すると、ダッシュボードをロードするときに特定のユーザーとして認証されます。

...

IDで指定された要素にダッシュボードをロードし、初期の表示オプションをいくつか設定する例を示します。

...

コールバック関数の1番目の引数として返されるフィルターオブジェクトは、ダッシュボードで使用されるあらゆる分析フィルターと、フィルターグループ区切り文字が格納された配列です。配列の各要素は、そのフィルターまたはフィルターグループに関する情報が格納されたオブジェクトです。これらのオブジェクトには以下のプロパティがあります:

Expand
titleここを展開...

プロパティ

説明

key

...

このフィルターまたはフィルターグループの固有キーです。

type

...

Set to FILTERGROUP if this object represents a filter group. Other values indicate a type of analytic filter.

...

説明

...

The 説明 of the filter or filter group.

...

groupId

...

For filter groups: a numeric identifier for the group.

...

state

...

For filter groups: set to OPEN if the group is currently opened.

...

display

...

For filters: the display style used by the filter.

...

dependencies

...

For filters: set to true if other filters in the dashboard are dependent on this one.

...

list

...

For filters: set to true if the filter is a list style (allows multiple values).

...

between

...

For filters: set to true if the filter is a between style (requires a start and end value).

...

listValues

このオブジェクトがフィルターグループを表す場合は FILTERGROUP に設定します。その他の値は、分析フィルターの種類を示します。

description

フィルターまたはフィルターグループの説明です。

groupId

フィルターグループの場合:グループの数値識別子です。

state

フィルターグループの場合:グループが現在オープンの場合は OPEN に設定します。

display

フィルターの場合:フィルターで使用される表示スタイルです。

dependencies

フィルターの場合:ダッシュボードの他のフィルターがこのフィルターに従属している場合は true に設定します。

list

フィルターの場合:フィルターがリストスタイル(複数の値を許可する)の場合は true に設定します。

between

フィルターの場合:フィルターが範囲スタイル(開始値と終了値が必要)の場合は true に設定します。

listValues

フィルターの場合:フィルターがドロップダウンリストとして表示される場合は、このプロパティに使用可能なオプションのリストが格納されます。

...

ダッシュボードフィルターをロードしてユーザーに表示する例を示します:

...

Code Block
javascript
javascript
filterValues[key] = [500, 600];

loadDash 関数に渡される options.filters  loadDash 関数に渡される OP 要素は、 ldfl 要素は、 loadDashFilters 関数から返される keys でキー設定された値を含む必要があります。 loadDashFilters



horizontalrule
Styleclass
ClasstopLink

ページトップ