とともにアドイン マネージャー アドイン、以前は未加工の XML を手動で編集する必要があった追加のカスタマイズを行うことができます。 このアドインは、すべてのアドインのカスタム メタデータ属性への自動アクセスも提供します。
カスタム メニュー項目
ツリーの最上位項目を右クリックすると、メイン メニュー (既定ではアドイン) を変更できます。 この同じメニューに挿入するメニュー項目を変更することもできます。 これは、Analyze などの既存のメイン メニュー項目を使用していて、そのメニュー項目を特定の位置 (Fit Y by X の後など) に配置する場合に便利です。
メイン メニューをビルトイン メニューに変更する
- メニュー項目ツリーの一番上の項目を右クリックし、[メイン メニューの変更] を選択します。
- [メイン メニューの変更] ウィンドウで、メニュー項目を配置する ComboBox からメニューを選択します。
- [Insert After] プロパティにすでに値が設定されている場合 (および前のメニューがカスタム メニューであった場合)、プロパティを新しい値に変更するように求められます。 ここで選択した項目によって、カスタム メニューがメイン メニュー バー内のどこに配置されるかが決まります。
Insert After 値の入力を求められなかった場合は、メニュー項目ツリーの一番上の項目を右クリックし、[Change Insert After] を選択してこの値を更新できます。
- アドインを再構築してインストールします。 以下に示すように、アドイン メニュー項目は、指定したメニュー項目の後に、選択したメイン メニューに表示されます。
メイン メニューをカスタム メニューに変更する
- メニュー項目ツリーの一番上の項目を右クリックし、[メイン メニューの変更] を選択します。
- [メイン メニューの変更] ウィンドウで、ComboBox から [カスタム] を選択し、以下に示すように、目的のメニューの名前を TextEditBox に入力します。
- 「Insert After」プロパティにすでに値が設定されている場合 (および以前のメニューが組み込みメニューであった場合)、プロパティを新しい値に変更するように求められます。 ここで選択した項目によって、カスタム メニューがメイン メニュー バー内のどこに配置されるかが決まります。
Insert After 値の入力を求められなかった場合は、メニュー項目ツリーの一番上の項目を右クリックし、[Change Insert After] を選択してこの値を更新できます。
- アドインを再構築してインストールします。 以下に示すように、指定したメイン メニューの後に、アドイン メニュー項目がカスタム メイン メニューに表示されます。
1 つのアドインで複数のメイン メニューを使用する
アドイン マネージャーを使用すると、複数の異なるメイン メニュー内に複数のメニュー項目を作成する単一のアドインを作成できるようになりました。 これは、さまざまな領域に適合する複数のタスクを実行するアドインを作成する場合に役立ちます。 たとえば、データ テーブル ユーティリティ アドインは、Tables、Rows、および/または Cols メニューを含むメニュー項目を呼び出す場合があります。
- 追加のメイン メニューをアドインに追加するには、[メニュー項目] タブの [メニュー項目ツリー] の横にある赤い三角形のメニューをクリックし、[最上位のメイン メニューを追加] を選択します。
次に、上記のセクションで示したように、新しいメニューで表示するメイン メニューを選択します。 以下に、2 つの追加のメイン メニューを追加しました。
- 目的のメイン メニューとそれに含まれるメニュー項目をすべて追加したら、アドインをビルドし、複数のメイン メニューに 3 つのメニュー項目を表示します。
メニュー項目用のビルトイン JMP アイコン
アドイン ビルダーでできるのと同じように、アドイン マネージャーでも、メニュー項目のカスタム アイコン ファイルを指定できます。 ただし、アドイン マネージャーでは、組み込みのアイコンを選択して、メニュー項目の横に表示することもできます。
- [メニュー項目] タブでコマンドを選択し、[アイコン] セクション内の [選択] ボタンをクリックします。
- 使用するアイコンを選択し、[OK] をクリックします。
- メニュー項目ツリーにアイコンのプレビューが表示されます。
- アドインをビルドしてインストールすると、メニュー項目の横にビルトイン アイコンが表示されます。
これらのアイコンをアドイン内で使用したい場合は、私の組み込みの JMP アイコン加える。
カスタム メタデータ
カスタム メタデータは、連想配列の形式でアドインに含めることができます。 連想配列は、アドインの最上位フォルダーにある "customMetadata.jsl" ファイルに書き出されます。 使用例については、スクリプト インデックス ([ヘルプ] > [スクリプト インデックス]) を参照してください。
含まれるメタデータ
以下は、アドイン マネージャーによって自動的に管理されるすべてのキーと値のペアの一覧です。 これらのキーを独自のカスタム メタデータで使用しないでください。
鍵
|
価値
|
データ・タイプ
|
アドインバージョン
|
%Ver
|
数値
|
建設日
|
％建設日
|
数値
|
ID
|
%ID
|
キャラクター
|
展開されたAddinsFilename
|
デポテーブルファイル名.jmp
|
キャラクター
|
展開されたAddinsLoc
|
/path/to/addin/デポ/テーブル
|
キャラクター
|
名前
|
％名前
|
キャラクター
|
州
|
「DEV」または「TEST」または「PROD」
|
キャラクター
|
新しいカスタム メタデータの追加
[カスタム メタデータ] タブ ([一般情報] タブ内) のテーブルの横にある緑色のプラス アイコンをクリックすると、カスタム メタデータを追加できます。
アドインでのカスタム メタデータの使用
以下は、「author」という名前のカスタム メタデータ キーを含む「customMetadata.jsl」スクリプトの例です。
Associative Array(
List(
List( "addinVersion", 2 ),
List( "author", "Justin Chilton" ),
List( "buildDate", 3594195289 ),
List( "deployedAddinsFilename", "publishedAddins.jsl" ),
List( "deployedAddinsLoc", "\\server\share\Add-In Depot\Meta\" ),
List( "id", "com.jmp.juchil.myjmpaddin" ),
List( "name", "My JMP Add-In" ),
List( "state", "DEV" )
)
)
連想配列は、次の include ステートメントを使用してアドインにインポートできます (「com.jmp.myaddin」をアドインの ID に置き換えた後)。
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
連想配列をインポートしたら、次の構文を使用して値を参照できます。
aa["author"]
このブログ投稿は、3 部構成のシリーズの第 3 部であり、アドインを定義して構築する、アドインをユーザーに展開する、アドイン マネージャーで高度なカスタマイズを利用できるようにします。あなたが私のものを見つけてくれることを願っていますアドイン マネージャーアドイン便利！
