カスタムJavaScript

Forguncy Builder Proでは、JavaScriptによるプログラミングを使用したアプリケーションのカスタマイズをサポートしています。Forguncyの標準機能にない機能を実現したり、独自の処理を追加したりできます。

JavaScriptコードの設定場所 

JavaScriptコードは、以下の3か所で設定できます。どこで記載するかによって、JavaScriptコードの実行タイミングが異なります。

・セル単位

true 
セルに対して指定できます。指定するには、セル型のコマンドの1つに[JavaScriptコードの実行]コマンドが用意されているので、ここで直接JavaScriptコードを記述します。使用方法についてはJavaScriptコードの実行を参照してください。

この方法でJavaScriptを記載すると、セルクリックや値の変更時といったコマンドの発生時にこのJavaScriptが実行されます。このため、JavaScriptコード内では、コマンド発生時にどんなコードを実行するかを記載するだけで良く、どのイベントで発生するかといったことを考える必要がないため、手軽に利用できます。
その一方で、各コマンドにJavaScriptコードが分散して記述されるため、たくさんのコマンドにJavaScriptコードを記述した際には、管理や保守が難しくなる可能性があります。そのような場合には、ページ単位の[カスタムJavaScript]を使用することを検討してください。

・ページ単位 

true 

各ページに対して指定できます。「ページ設定」タブの[カスタムJavaScript]のフォルダ型のアイコンをクリックして、JavaScriptファイル(拡張子:JS)を1つ設定できます。使用方法については、ページにカスタムJavaScriptを登録するを参照してください。

この方法でJavaScriptを記載すると、ページのロード時にこのJavaScriptが実行されます。

・アプリケーション単位

true 

アプリケーション全体(すべてのページ)で共通のJavaScriptコードを使用する必要がある場合、ライブラリJavaScriptとしてJavaScriptファイルを登録できます。使用方法については、アプリにライブラリJavaScript/CSSを登録するを参照してください。

JavaScriptで利用可能なAPI

ForguncyはJavaScriptから利用可能なAPIとして、以下の2つを提供しています。

・JavaScript API

 Forguncyが持つ3つのオブジェクト(ページ、セル、リストビュー)について、JavaScriptから操作するためのAPIを提供しています。そのほかにも、Excelの日付と同じシリアル値を取り扱うためのヘルパーメソッドを提供しています。

・Web API

Forguncyの内部データベースに対して、レコードの取得、追加、更新、削除の処理を行うためのAPIを提供しています。そのほかにも、メール送信を行うAPI、Forguncyのユーザーを追加、削除するAPI、およびロールメンバーを追加、削除するAPIを提供しています。