JMPアプリケーションのメッセージ
この節では、JMPアプリケーションビルダーとJMPダッシュボードビルダーに使用できるJSLメッセージをご紹介します。これら2つの機能は、アプリケーションやダッシュボードの設計および実行に同じ基礎構造を使用しています。ダッシュボードは、アプリケーションの一形態です。そこで、この節では、ダッシュボードもアプリケーションと呼ぶことにします。
アプリケーションビルダーの詳細については、『スクリプトガイド』のアプリケーションの作成を参照してください。
例については、［ヘルプ］メニューの［スクリプトの索引］を参照してください。
JMP Appのメッセージ
JMP Appオブジェクトは、アプリケーションビルダーまたはダッシュボードビルダーによって作成されるJMPアプリケーションの主なコントローラです。JMPアプリケーションの中のスクリプトでも外のスクリプトでも、JMP Appオブジェクトを使用できます。
JMPアプリケーションには、初期（エディタがなく、アプリケーションが実行されていない）、実行中、編集中の3つの状態があります。JMP Appオブジェクトは、一度に1つの状態でしか存在しません。あるJMPアプリケーションを編集していて、それを実行することを選択した場合、実行前にそのJMPアプリケーションのコピーが作成されます。
app<<Combine Windows({reports or data tables})
説明
指定のプラットフォームレポートまたはデータテーブルのリストを新しいモジュールにまとめる。このメッセージを送信するときは、アプリケーションが初期状態になければなりません。
app<<Debug
JMPアプリケーションに対してJSLデバッガを呼び出す。アプリケーションスクリプトが先に実行されます。その後、モジュールが作成されるたびにデバッガが中断し、モジュールスクリプトを呼び出します。デバッガにおいて、アプリケーションやモジュールと関連付けられたスクリプトをデバッグするためには、ブレークポイントを設定してください。
app<<Edit
初期状態にあるJMPアプリケーションに対してアプリケーションビルダーを開始する。エディタはなく、アプリケーションは実行されていません。
app<<Get Modules
アプリケーションに関連付けられているモジュールのリストを取得する。アプリケーションビルダーでは、ワークスペースにおける1つのタブが各モジュールに対応しています。モジュールごとに、アプリケーション内にあるウィンドウについて、レイアウトや動作を記述します。
app<<Get Namespace
JMP App()オブジェクトは、アプリケーションスクリプト内で作成された変数に対し、自動的に匿名名前空間を作成します。このメッセージを使うと、この名前空間へのハンドルを取得して変数を確認または変更することができます。この名前空間には、thisApplicationというデフォルトの記号があり、アプリケーション自体への参照を含みます。
app<<Get Windows
JMPアプリケーションモジュールのインスタンスとして作成されたすべてのウィンドウのリストを取得する。モジュールの中には、2つ以上のインスタンスを作成するものもあります。すべてのウィンドウが同時に存在するわけではないので、ウィンドウの数は一定でない可能性があり、また、モジュールの数とは異なる場合もあります。
app<<Open File(path)
.jmpappファイルまたは.jmappsourceファイルから既存のアプリケーションの状態をリセットする。pathは引用符付きです。
app<<Relaunch Analysis
実行中のアプリケーションの新しいコピーを作成し、新しいインスタンスを実行する。
app<<Run
アプリケーションを実行する。アプリケーションスクリプトが先に実行され、設定によっては、1つまたは複数のJMPアプリケーションモジュールンのインスタンスオブジェクトが自動的に作成される場合があります。
app<<Save Script to Add-In
app<<Save Script to Data Table
app<<Save Script to Journal
app<<Save Script to Script Window
アプリケーションのスクリプトを指定の場所に保存する。アプリケーションスクリプトは、アプリケーションの定義を含むJMP App()オブジェクトで構成されます。アドインやデータテーブル、ジャーナルに保存されるスクリプトには、アプリケーションを実行するRunメッセージが含まれます。スクリプトウィンドウに保存されるスクリプトには、アプリケーションビルダーを開くためのEditメッセージが含まれます。
JMP App Moduleのメッセージ
JMPアプリケーションモジュールとは、JMPアプリケーションまたはダッシュボード内の1つのコンポーネントについて、ディスプレイボックスのレイアウトと動作を定義したものです。モジュールの種類によって、コンポーネントは、アプリケーション内のウィンドウであったり、ウィンドウの一部であったりします。
module<<Create Instance
JMPアプリケーションモジュールのインスタンスを作成するには、JMP App()スクリプトまたはJMP App Module()スクリプトの中でCreate Instanceを使用します。デフォルトでは、JMPアプリケーションを実行するたびに各アプリケーションモジュールのインスタンスが1つ作成されます。起動ウィンドウやレポートウィンドウなど、複数のウィンドウを使用する複雑なアプリケーションの場合は、デフォルトの設定に変更を加え、モジュールインスタンスの作成を制御する必要があります。
module<<Get Instance
モジュールが属するアプリケーションへのハンドルを戻す。
JMP App Module Instanceのメッセージ
JMPアプリケーションモジュールインスタンスとは、JMPアプリケーションモジュール、画面上のウィンドウ、または別のウィンドウに挿入できるディスプレイボックス要素一式を具現化したものです。
inst<<Create Objects
このメッセージは、JMP Appのモジュールスクリプトにおいて、デフォルトで指定されます。このメッセージは、ディスプレイボックスやウィンドウのオブジェクトをどの時点で作成するかを指定するときに使用します。スクリプトの作成者は、オブジェクトが作成される前に特定の設定を行って、その後にこのメッセージを使用できます。たとえば、アプリケーションのパラメータを特定の値に設定した後に、このメッセージを使用してください。
inst<<Get Box
モジュールインスタンスに関連付けられている最上位のディスプレイボックスへのハンドルを戻す。これは、Save to PDFメッセージやClose Windowメッセージなど、表示コマンドまたはウィンドウコマンドを実行する際に便利です。
inst<<Get Namespace
JMP App()と同様に、各JMPアプリケーションモジュールインスタンスは、モジュールスクリプト内で作成されるすべての変数に対して匿名名前空間を作成します。名前空間には、モジュール内のディスプレイボックスを表す変数もすべて含まれます。この名前空間に含まれるthisModuleInstanceという名前のデフォルトの記号は、自身を参照します。
inst<<Get User Data
inst<<Set User Data
JMPアプリケーションモジュールインスタンスでJSL値を保存し、取得する。値は、数値、引用符付き文字列、リスト、連想配列、およびType()関数で戻されるJSLのタイプのいずれかです。