本章では、JS API のすべてのインターフェイスをまとめており、各APIの機能やモバイル端末で使用できるかどうかを確認できます。
注意:JS APIの名称の大文字と小文字は区別されます。必ずこのドキュメントと同じようにしてください。
一.公有モジュール
一般帳票、ダッシュボード両方ともに使用可能。作用するエレメントによって、グローバルAPI、パラメータAPI、ウィジェットAPI、データベースAPI、ツールバーAPI、帳票改ページAPI、帳票出力APIに分けられています。
1.グローバルAPI
グローバルAPIが基本的に帳票の主体に作用します。_g()(帳票オブジェクトを獲得)を除き、FRオブジェクト及びFRオブジェクトのメソッドを含みます。
g() を通して帳票オブジェクトを獲得する方法は以下のようになります。
| API | 説明 | モバイル端末互換性 | V10.0 互換性 |
|---|---|---|---|
| _g() | 帳票オブジェクトを獲得 | サポート | サポート、V11.0は新しいメソッドを追加しました。 |
| getParameterContainer | 帳票のパラメータパネルオブジェクトを獲得 | サポート | サポートできない。V11.0のみサポート。 |
| parameterCommit | 提交参数后重新查询,刷新报表 | サポート | サポート |
| loadContentPane | リロードして帳票をリフレッシュ | サポート | サポート |
| getPreviewType | 現在帳票のプレビューモードを獲得 | サポート | サポートできない。V11.0のみサポート。 |
FR オブジェクトのメソッドは以下のようになります。
| API | 説明 | モバイル端末互換性 | V10.0 互換性 |
|---|---|---|---|
| servletURL | servletURLを獲得 | サポート | サポートできない。V11.0のみサポート。 |
| serverURL | serverURLを獲得 | サポートできない | サポートできない。V11.0のみサポート。 |
| server | serverを獲得 | サポートできない | サポートできない。V11.0のみサポート。 |
| fineServletURL | fineServletURLを獲得 | サポートできない | サポートできない。V11.0のみサポート。 |
| SessionMgr.getSessionID | sessionId | サポート | サポートできない。V11.0のみサポート。 |
| showDialog | ダイアログを開く | サポートできない | サポート |
| closeDialog | ダイアログを閉じる | サポートできない | サポート |
| doHyperlinkByGet | Getでページを開き、パラメータを引き渡す、Webページ属性を設定できる | サポート | サポート |
| doHyperlinkByPost | Postでページを開き、パラメータを引き渡す、Webページ属性を設定できる | サポート | サポート |
| doURLPrint | 印刷ツールを呼び出し、帳票を印刷 | サポートできない | サポート |
| Msg | FR 内置的统一风格的消息框,可以替代 Window 中的 alert、confirm 以及 prompt 弹窗 | サポート | サポート |
| remoteEvaluate | FRビルドイン数式を実行し、計算結果を返す | サポート | サポート |
| jsonEncode | 文字列を jsonEncode 形式に変換 | サポートできない | サポート |
| jsonDecode | jsonEncode形式の文字列をデコード | サポートできない | サポート |
| ajax | パーケージ済みの jQuery.ajax() 関数 | サポート | サポート |
| isEmpty | オブジェクトが空白であるかを判断 | サポートできない | サポート |
| isArray | オブジェクトが配列であるかを判断 | サポートできない | サポート |
下表はモバイル端末にだけサポートされるFRオブジェクトのメソッドです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| location | 測位機能を実現します。獲得した経度と緯度はhttps、WeChat企業版、DingTalkで利用できます。 | サポート | サポート |
| Mobile.getDeviceInfo | デバイス情報を獲得 | サポート | サポート |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| signOut | FineReportポータルにログアウトします。つまり、ログイン画面に戻る | サポートできない | サポート |
| tabPane.closeActiveTab | FineReportポータルのラベルを閉じる つまり、開かれたポータルのプレビューテンプレートを自動的に閉じる | サポート | サポート |
| tabPane.addItem | FineReportポータルで新しいラベルを開く | サポート | サポート |
2.パラメータパネルAPI
下表のパラメータパネルのAPIを通して、パラメータパネルの一部の属性を調整できます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getWidgetByName | パラメータパネルのウィジェットを獲得した上で、そのメソッドを使用 | サポート | サポート。使用の際、パラメータパネルのAPIの変化に注意する必要がある。 |
| collapse | パラメータパネルを折りたたむ | サポート | サポートできない。V11.0のみサポート。 |
| expand | パラメータパネルを展開 | サポート | サポートできない。V11.0のみサポート。 |
| submit | 自動的にサブミットしてクエリ | サポート | サポートできない。V11.0のみサポート。 |
3.ウィジェットAPI
ウィジェットAPIは主にパラメータパネルの中のウィジェットの変更、セルの中のウィジェットの書込み、ダッシュボードbodyの中のウィジェットの属性の書込みに使用されます。ウィジェットのAPIは通用と専用の2種類に分けられ、通用APIは特殊ウィジェットを除いて全てのウィジェットで利用することができますが、専用ウィジェットは指定のウィジェットしか使用できません。
獲得したウィジェットAPIはウィジェットの「イベント」にしか使用できません。具体的には下記の表の通りです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| this | 全てのウィジェットイベントに通用 現在のウィジェット対象を獲得し、そのメソッドと属性は使用可能 | サポート | サポート |
| this.options.form | ウィジェットのイベントで呼び出す パラメータパネルAPIの全てのメソッドが利用可能 | サポート | サポート |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getValue | ウィジェットの実際値を獲得 | サポート | サポート |
| getText | ウィジェットの表示値を獲得 | サポート | サポート |
| setValue | ウィジェットの値を設定 | サポート | サポート |
| visible | ウィジェットを表示に設定 | サポート | サポート |
| invisible | ウィジェットを非表示に設定 | サポート | サポート |
| setVisible | ウィジェットの表示または非表示に設定 | サポート | サポート |
| isVisible | ウィジェットの表示状態を確認 | サポート | サポート |
| setEnable | ウィジェットを使用可能または使用不可に設定 | サポート | サポート |
| isEnabled | ウィジェットの使用可能性を確認 | サポート | サポート |
| reset | ウィジェットをリセットし、その内容をクリア | サポート | サポート |
| getType | ウィジェットの種類を獲得 | サポート | サポートできない。V11.0のみサポート。 |
| setWaterMark | 透かし文字を追加 入力ボックスのあるウィジェットのみ使用可能 | サポート | サポートできない。V11.0のみサポート。 |
| fireEvent | ウィジェットイベントを呼び出す | サポート | サポート |
| setPopupStyle | ウィジェットのプルダウンボックスのスタイルを設定 オプションボックスのあるウィジェットのみ使用可能 | サポートできない | サポートできない。V11.0のみサポート。 |
| return false | ウィジェットの特定イベントにreturn falseを追加 その過程で連動とクエリが実行されない | サポートできない | サポート |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| setMaxAndMinDate | 日付ウィジェットで選択できる日付の範囲を設定 | サポート | サポートできない。V11.0のみサポート。 |
| setPopupStyle | ポップアップのスタイルを設定します。ポップアップのあるウィジェットのみ使用可能 | サポートできない | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| doClick | ボタンクリックのイベントを実 ボタンをクリックすることに等しい効果行 | サポート | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| setName4Empty | プルダウンウィジェットを開く際のデフォルト文字「選択しない」を変更 | サポートできない | サポートできない。V11.0のみサポート。 |
4.テーブルAPI
テーブルAPIは主に、帳票の中のテーブルの内容の変更に使用されます。応用シーンによって、テキストスクロールAPI、スクロールバー非表示API、セル背景変更API、セルフォルト変更API、行列サイズ変更APIス、セル値の獲得と設定API、及びセル通知設定、セルスタイル設定APIに分けられます。
下表はテキストスクロールAPIです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| startMarquee | テキストスクロール効果をオン | サポートできない | サポートできない。V11.0のみサポート。 |
| stopMarquee | テキストスクロールをオフに | サポートできない | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| setHScrollBarVisible | 横スクロールバー表示または非表示の設定 | サポートできない | 10.0.19 以降のバージョンでサポート |
| setVScrollBarVisible | 縦スクロールバー表示または非表示の設定 | サポートできない | 10.0.19 以降のバージョンでサポート |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| addEffect | type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色 | サポート | サポートできない。V11.0のみサポート。 |
| type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色 | サポート | サポートできない。V11.0のみサポート。 | |
| type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色 | サポート | サポートできない。V11.0のみサポート。 | |
| type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色 | サポート | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| addEffect | type: 'setCellFont'。マウスクリックまたはオーバ時、セルのフォントが変化 | サポート | サポートできない。V11.0のみサポート。 |
| type: 'setRowFont'。マウスクリックまたはオーバ時、セルの所在行のフォントが変化 | サポート | サポートできない。V11.0のみサポート。 | |
マウスクリックまたはオーバ時、セルの所在行のフォントが変化 他の行にクリックまたはマウスオーバすると元に戻る | サポート | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| addEffect | type: 'setCellFont'。マウスオーバ時にテキストまたは画像のプロンプトボックスが表示 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| setRowHeight | セルの行の高さを変更 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| setColWidth | セルの列の幅を変更 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getCellValue | 指定セルの値を獲得 パラメータはセルのアドレスまたはセルの行列の番号になる | 一部サポート | サポート。V10.0は書き込み時の使用だけサポート。 |
| setCellValue | 指定セルに値を書き込 むパラメータはセルのアドレスまたは行列の番号になる | 一部サポート | サポート。V10.0は書き込み時の使用だけサポート。 |
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| setCellRadius | 帳票内の全てのセルを角丸枠に設定 セルは背景色が必要、背景色がない場合、角丸枠の効果が出てこない | サポートできない。 | サポートできない。V11.0のみサポート。 |
5.ツールバーAPI
ツールバーAPIは主にツールバー及びその中のボタンの属性の変更に使用されます。ツールバーAPI、ツールバーボタンの通用API、ツールバーボタンの専用APIに分けられます。
下表はツールバーAPIです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getWidgetByName | 帳票のツールバーのボタンを獲得、ボタンのメソッドを使用可能 | サポートできない。 | サポート |
| toolBarFloat | ツールバーの表示位置を設定 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| setStyle | ツールバーのサイズを変更 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| setVisible | ツールバーを表示または非表示に設定 | サポート | サポートできない。V11.0のみサポート。 |
下表のツールバーボタンの通用APIは、特殊タイプ以外のすべてのツールバーボタンに通用します。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| visible | ツールバーのある一つのボタンを表示に設定 | サポートできない。 | サポート |
| invisible | ツールバーのある一つのボタンを非表示に設定 | サポートできない。 | サポート |
| setVisible | ツールバーのある一つのボタンを表示または非表示に設定 | サポートできない。 | サポート |
| isVisible | ツールバーのある一つのボタンの表示または非表示の状態を確認 | サポートできない。 | サポート |
| setEnable | ツールバーのある一つのボタンをオンまたはオフに設定 | サポートできない。 | サポート |
| isEnabled | ツールバーのある一つのボタンのオンまたはオフの状態を確認 | サポートできない。 | サポート |
下表のメールボタンの専用APIはメールボタンだけ使用できます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| changeFormat | メールがサポートする書式を再選択 | サポートできない。 | サポートできない。V11.0のみサポート。 |
6.帳票改ページAPI
下表の帳票改ページAPIは主に帳票の改ページに使用されます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| gotoPreviousPage | 前のページに移動 | サポート | サポート |
| gotoNextPage | 次のページに移動 | サポート | サポート |
| gotoLastPage | 最後のページに移動 | サポート | サポート |
| gotoFirstPage | 最初のページに移動 | サポート | サポート |
| gotoPage | 指定のページに移動 | サポート | サポート |
| getCurrentPageIndex | 現在のページ番号を獲得 | サポート | サポートできない。V11.0のみサポート。 |
| getReportTotalPage | 総ページ数を獲得 | サポート | サポートできない。V11.0のみサポート。 |
| currentPageIndex | 帳票の現在のページの番号 | サポート | サポート |
| reportTotalPage | 帳票の総ページ数 | サポート | サポート |
7.帳票エクスポートAPI
下表のエクスポートAPIは主に帳票のエクスポートに使用されます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| exportReportToExcel | 帳票をExcelファイルにエクスポート | 一部サポート | サポート |
| exportReportToImage | 帳票を画像にエクスポート | 一部サポート | サポート |
| exportReportToPDF | 帳票をPDFファイルにエクスポート | 一部サポート | サポート |
| exportReportToWord | 帳票をWordファイルにエクスポート | 一部サポート | サポート |
二.一般帳票モジュール
一般帳票APIは一般帳票cptだけが使用できるもので、パブリック部分とプライベート部分に分けられます。パブリック部分は全てのプレビューモードで使用できる一方、プライベート部分は特定のプレビューモードでしか使用できません。
1.汎用API
下表は汎用APIです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getToolbar | ツールバーオブジェクトを獲得 | サポート | サポートできない。V11.0のみサポート。 |
2.改ページプレビューAPI
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| expandNodeLayer | ノードツリーをNレイヤーまで展開 | サポートできない。 | 新計算エンジンv1.6.0以降をインストールしてからサポート |
| collapseNodeLayer | ノードツリーをNレイヤーまで折りたたむ | サポートできない。 | 新計算エンジンv1.6.0以降をインストールしてからサポート |
| expandAllNodeLayer | ノードツリーの全てのノードレイヤーを展開 | サポートできない。 | 新計算エンジンv1.6.0以降をインストールしてからサポート |
| collapseAllNodeLayer | ノードツリーの全てのノードレイヤーを折りたたむ | サポートできない。 | 新計算エンジンv1.6.0以降をインストールしてからサポート |
3.書き込みプレビューAPI
API | 説明 | モバイル端末 | V10.0 互換性 |
getWidgetByName | ウィジェット名でセルに書き込まれたウィジェットを獲得 | サポート | サポート |
getWidgetByCell | セルアドレスでセルに書き込まれたウィジェットを獲得 | サポート | サポート |
getWidgetsByName | ウィジェット名でセルに書き込まれた同じ名称の複数のウィジェットを獲得 | サポート | サポート |
appendReportRC | 指定の位置に行を挿入 | サポートできない。 | サポート |
appendReportRow | 行を挿入 | サポート | サポート |
deleteReportRC | 行を削除 | サポートできない。 | サポート |
deleteRows | 行を削除 | サポートできない。 | サポート |
refreshAllSheets | 再検索し、全てのsheetをリフレッシュ リフレッシュの後は前回閲覧したsheetに戻る | サポート | サポート |
loadSheetByIndex | 指定のsheetに移動し、パラメータはsheet番号 | サポートできない。 | サポート |
loadSheetByName | 指定のsheetに移動し、パラメータはsheet名 | サポートできない。 | サポート |
isDirtyPage | ページが編集されたことがあるか判断 | サポートできない。 | サポート |
isAutoStash | 自動一時保存がオンになっているかを判断 | サポートできない。 | サポート |
writeReport | 検証せずに書き込む | サポート | サポート |
verifyAndWriteReport | 検証してから帳票を書き込む | サポート | サポート |
verifyReport | データ検証 | サポートします | サポート |
importExcel | Excelをインポート | サポートできない。 | サポート |
importExcel_Append | 「差分インポート」の形でExcelをインポート | サポートできない。 | サポート |
importExcel_Clean | 「クリアしてインポート」の形でExcelをインポート | サポートできない。 | サポート |
importExcel_Cover | 「上書きインポート」の形でExcelをインポート | サポートできない。 | サポート |
stash | 一時保存 | サポートできない。 | サポート |
clear | クリアして一時保存 | サポートできない。 | サポート |
4.データ分析プレビューAPI
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| centerReport | 「データ分析」プレビューの時、帳票の表示を中央揃えに設定 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| expandNodeLayer | 「データ分析」プレビューの時、ノードツリーをNレイヤーまで展開 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| collapseNodeLayer | 「データ分析」ブレビューの時、ノードツリーをNレイヤーまで折りたたむ | サポートできない。 | サポートできない。V11.0のみサポート。 |
| expandAllNodeLayer | 「データ分析」プレビューの時、ノードツリーの全てのノードを展開 | サポートできない。 | サポートできない。V11.0のみサポート。 |
| collapseAllNodeLayer | 「データ分析」プレビューの時、ノードツリーの全てのノードを折りたたむ | サポートできない。 | サポートできない。V11.0のみサポート。 |
三.ダッシュボードAPI
ダッシュボードAPIはダッシュボードfrmだけ使用できるもので、コンポーネント獲得API、コンポーネント通用API、コンポーネントTabAPIの三つに分けられます。
1.コンポーネント獲得API
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getAllWidgets | 帳票オブジェクトの中の全てのコンポーネント情報を獲得 | サポート | サポートできない。V11.0のみサポート。 |
| getWidgetByName | 帳票オブジェクトの中からあるコンポーネントを獲得、Bodyの中のコンポーネントとパラメータパネルの中のウィジェットを獲得できる | サポート | サポート |
2.コンポーネント汎用API
下表のコンポーネント通用APIはダッシュボードの全てのコンポーネントが使用できるものです。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| visible | コンポーネント表示に設定 | サポート | サポート |
| invisible | コンポーネント非表示に設定 | サポート | サポート |
| setVisible | コンポーネントの表示または非表示に設定 | サポート | サポート |
| isVisible | コンポーネント表示または非表示の状況を返す | サポート | サポート |
3.帳票ブロックAPI
下表の帳票ブロックAPIは帳票ブロックのコンポーネントの属性変更に使用されます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| getToolbar(index) | 帳票ブロックのツールバーを獲得し、ツールバージョンが開いた状況で使用 | サポート | サポートできない。V11.0のみサポート。 |
4.TabコンポーネントAPI
下表のコンポーネントTabAPIはコンポーネントTabの属性変更に使用されます。
| API | 説明 | モバイル端末 | V10.0 互換性 |
|---|---|---|---|
| showCardByIndex | 表示中のTabページのロケーションインデックスを獲得 | サポート | サポート |
| setTabVisible | あるTabページを表示または非表示に設定 | サポート | サポート |
| getShowIndex | Tabブロックタイトルを表示または非表示に設定 | サポート | サポート |
| setTitleVisible | N番目のTabページを表示 | サポートできない。 | サポート |