Create Folderメッセージを使って、JMP Liveで新しいフォルダを作成できます。Create Folderメッセージは、JMP Live接続とJMP Liveフォルダの両方のスクリプト可能なオブジェクトに対して使用でき、構文も似ています。
フォルダを作成する際は、フォルダを作成する場所(親フォルダ)、フォルダのタイトル、説明(オプション)を指定します。また、作成対象のフォルダがすでに存在した場合の処理も指定できます。
JMP Live接続オブジェクトに対するCreate Folderメッセージの構文は次のとおりです。
liveresult = liveconnection << Create Folder( Title( "title" ),
Parent Folder( "id" | "path" | JMP Live Folder ), < Description( "description" ),
If Exists( "use" | "fail" | "default" ) > );
If Existsオプションで、作成対象のフォルダがすでに存在した場合の処理を指定します。
• useを指定すると、既存のフォルダが戻されます。
• failを指定すると、フォルダがすでに存在する場合は、処理が失敗します。
• defaultを指定すると(または、If Existsオプションを省略すると)、フォルダが新しく作成されます。フォルダ名を一意にするために、フォルダ名の末尾に(2)が適宜付与されます。
この例では、新しいフォルダを作成します。ここでは、JMP LiveにFabというスペースがあると仮定しています。
Names Default To Here( 1 );
// JMP Liveサーバーに接続する。
liveconnection = New JMP Live();
/* 上記で作成した接続を使って、Fabスペースにフォルダを作成し、タイトルと説明を指定する。 */
jmpliveresult = liveconnection << Create Folder( Parent Folder( "/Fab" ), Title( "Create Folder Example" ), Description( "自分用の新規フォルダ"), If Exists( "use" ) );
// JMP Live結果から、JMP Liveフォルダオブジェクトを取得する。
folder = jmpliveresult << As Scriptable;
// 新しいフォルダのパスを取得する。
path = folder << Get Path();
// フォルダのパスをJMPのログに出力する。
Write( "パス: ", path );
// JMPのログの出力は次のようになる: "パス: /Fab/Create Folder Example"