JavaScript API一覧

  • 作成者:FRInternational
  • 編集回数:6次
  • 最終更新:FRInternational 于 2022-08-22
  • 本章では、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 互換性
    servletURLservletURLを獲得サポートサポートできない。V11.0のみサポート。
    serverURLserverURLを獲得サポートできないサポートできない。V11.0のみサポート。
    serverserverを獲得サポートできないサポートできない。V11.0のみサポート。
    fineServletURLfineServletURLを獲得サポートできないサポートできない。V11.0のみサポート。
    SessionMgr.getSessionIDsessionIdサポートサポートできない。V11.0のみサポート。
    showDialog

    ダイアログを開く

    サポートできないサポート
    closeDialogダイアログを閉じるサポートできないサポート
    doHyperlinkByGetGetでページを開き、パラメータを引き渡す、Webページ属性を設定できるサポートサポート
    doHyperlinkByPostPostでページを開き、パラメータを引き渡す、Webページ属性を設定できるサポートサポート
    doURLPrint印刷ツールを呼び出し、帳票を印刷サポートできないサポート
    MsgFR 内置的统一风格的消息框,可以替代 Window 中的 alert、confirm 以及 prompt 弹窗サポートサポート
    remoteEvaluateFRビルドイン数式を実行し、計算結果を返すサポートサポート
    jsonEncode文字列を jsonEncode 形式に変換サポートできないサポート
    jsonDecode jsonEncode形式の文字列をデコードサポートできないサポート
    ajaxパーケージ済みの jQuery.ajax() 関数サポートサポート
    isEmptyオブジェクトが空白であるかを判断サポートできないサポート
    isArrayオブジェクトが配列であるかを判断サポートできないサポート

    下表はモバイル端末にだけサポートされるFRオブジェクトのメソッドです。

    API説明モバイル端末V10.0 互換性
    location測位機能を実現します。獲得した経度と緯度はhttps、WeChat企業版、DingTalkで利用できます。サポートサポート
    Mobile.getDeviceInfoデバイス情報を獲得サポートサポート

    下表はFSオブジェクトのメソッドです。

    API説明モバイル端末V10.0 互換性
    signOutFineReportポータルにログアウトします。つまり、ログイン画面に戻るサポートできないサポート
    tabPane.closeActiveTab

    FineReportポータルのラベルを閉じる

    つまり、開かれたポータルのプレビューテンプレートを自動的に閉じる

    サポートサポート
    tabPane.addItemFineReportポータルで新しいラベルを開くサポートサポート

    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は下記の表の通りです。

    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です。

    API説明モバイル端末V10.0 互換性
    setMaxAndMinDate日付ウィジェットで選択できる日付の範囲を設定サポートサポートできない。V11.0のみサポート。
    setPopupStyleポップアップのスタイルを設定します。ポップアップのあるウィジェットのみ使用可能サポートできないサポートできない。V11.0のみサポート。

    下表は「プルダウンボックス」ウィジェットの専用APIです。

    API説明モバイル端末V10.0 互換性
    doClick

    ボタンクリックのイベントを実

    ボタンをクリックすることに等しい効果行

    サポートサポートできない。V11.0のみサポート。

    下表は「プルダウンボックス」ウィジェットの専用APIです。

    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です。

    API説明モバイル端末V10.0 互換性
    setHScrollBarVisible横スクロールバー表示または非表示の設定サポートできない10.0.19 以降のバージョンでサポート
    setVScrollBarVisible縦スクロールバー表示または非表示の設定サポートできない10.0.19 以降のバージョンでサポート

    下表はセル背景変更APIです。

    API説明モバイル端末V10.0 互換性
    addEffecttype: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色サポートサポートできない。V11.0のみサポート。
    type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色サポートサポートできない。V11.0のみサポート。
    type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色サポートサポートできない。V11.0のみサポート。
    type: 'highlightRow'。マウスクリックまたはオーバ時、セルの所在行が変色サポートサポートできない。V11.0のみサポート。

    下表はセルフォント変更APIです。

    API説明モバイル端末V10.0 互換性
    addEffecttype: 'setCellFont'。マウスクリックまたはオーバ時、セルのフォントが変化サポートサポートできない。V11.0のみサポート。
    type: 'setRowFont'。マウスクリックまたはオーバ時、セルの所在行のフォントが変化サポートサポートできない。V11.0のみサポート。

    マウスクリックまたはオーバ時、セルの所在行のフォントが変化

    他の行にクリックまたはマウスオーバすると元に戻る

    サポートサポートできない。V11.0のみサポート。

    下表はセル通知設定APIです。

    API
    説明モバイル端末V10.0 互換性
    addEffecttype: 'setCellFont'。マウスオーバ時にテキストまたは画像のプロンプトボックスが表示サポートできない。サポートできない。V11.0のみサポート。

    下表はセルフォント変更APIです。

    API説明モバイル端末V10.0 互換性
    setRowHeightセルの行の高さを変更サポートできない。サポートできない。V11.0のみサポート。
    setColWidthセルの列の幅を変更サポートできない。サポートできない。V11.0のみサポート。

    下表はセルスタイル設定APIです。

    API説明モバイル端末V10.0 互換性
    getCellValue

    指定セルの値を獲得

    パラメータはセルのアドレスまたはセルの行列の番号になる

    一部サポートサポート。V10.0は書き込み時の使用だけサポート。
    setCellValue

    指定セルに値を書き込

    むパラメータはセルのアドレスまたは行列の番号になる

    一部サポートサポート。V10.0は書き込み時の使用だけサポート。

    下表はセルスタイル設定APIです。

    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です。

    API説明モバイル端末V10.0 互換性
    expandNodeLayerノードツリーをNレイヤーまで展開サポートできない。新計算エンジンv1.6.0以降をインストールしてからサポート
    collapseNodeLayerノードツリーをNレイヤーまで折りたたむサポートできない。新計算エンジンv1.6.0以降をインストールしてからサポート
    expandAllNodeLayerノードツリーの全てのノードレイヤーを展開サポートできない。新計算エンジンv1.6.0以降をインストールしてからサポート
    collapseAllNodeLayerノードツリーの全てのノードレイヤーを折りたたむサポートできない。新計算エンジンv1.6.0以降をインストールしてからサポート

    3.書き込みプレビューAPI

    下表は書き込みプレビューの専用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です

    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です。

    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ページを表示または非表示に設定サポートサポート
    getShowIndexTabブロックタイトルを表示または非表示に設定サポートサポート
    setTitleVisibleN番目のTabページを表示サポートできない。サポート


    Attachment List


    Theme: FineReport カスタム開発
    • Helpful
    • Not helpful
    • Only read