とともにアドインマネージャーアドインを使用すると、以前は生の XML を手動で編集する必要があった追加のカスタマイズを行うことができます。 このアドインを使用すると、すべてのアドインのカスタム メタデータ属性に自動的にアクセスできるようになります。
カスタムメニュー項目
ツリーの最上位項目を右クリックして、メイン メニュー (デフォルトではアドイン) を変更できます。 同じメニューに挿入するメニュー項目を変更することもできます。 これは、Analyze などの既存のメイン メニュー項目を使用していて、そのメニュー項目を Fit Y by X の後などの特定の位置に配置したい場合に便利です。
メインメニューを内蔵メニューに変更する
- メニュー項目ツリーの最上位項目を右クリックし、「メインメニューの変更」を選択します。
- 「メインメニューの変更」ウィンドウで、メニュー項目を配置したいメニューをコンボボックスから選択します。
- 「後に挿入」プロパティにすでに値が設定されている場合 (および前のメニューがカスタム メニューだった場合)、プロパティを新しい値に変更するように求められます。 ここで選択した項目によって、カスタム メニューがメイン メニュー バー内のどこに配置されるかが決まります。
[後に挿入] 値の入力を求められなかった場合は、メニュー項目ツリーの一番上の項目を右クリックし、[後に挿入の変更] を選択してこの値を更新できます。
- アドインを再構築してインストールします。 以下に示すように、アドイン メニュー項目が、選択したメイン メニューの指定したメニュー項目の後に表示されます。
メインメニューをカスタムメニューに変更する
- メニュー項目ツリーの一番上の項目を右クリックし、「メインメニューの変更」を選択します。
- 以下に示すように、[メイン メニューの変更] ウィンドウで、コンボ ボックスから [カスタム] を選択し、テキストエディット ボックスに希望のメニューの名前を入力します。
- 「後に挿入」プロパティにすでに値が設定されている場合 (および前のメニューが組み込みメニューだった場合)、プロパティを新しい値に変更するように求められます。 ここで選択した項目によって、カスタム メニューがメイン メニュー バー内のどこに配置されるかが決まります。
[後に挿入] 値の入力を求められなかった場合は、メニュー項目ツリーの一番上の項目を右クリックし、[後に挿入の変更] を選択してこの値を更新できます。
- アドインを再構築してインストールします。 以下に示すように、アドイン メニュー項目がカスタム メイン メニューの指定されたメイン メニューの後に表示されます。
単一のアドインで複数のメイン メニューを使用する
アドイン マネージャーを使用すると、複数の異なるメイン メニュー内に複数のメニュー項目を作成する単一のアドインを作成できるようになりました。 これは、さまざまな領域に適合する複数のタスクを実行するアドインを作成する場合に便利です。 たとえば、データ テーブル ユーティリティ アドインは、[テーブル]、[行]、または [列] メニューのメニュー項目を呼び出す場合があります。
- アドインにメイン メニューを追加するには、[メニュー項目] タブの [メニュー項目ツリー] の横にある赤い三角形のメニューをクリックし、[トップレベル メイン メニューの追加] を選択します。
次に、上のセクションで示したように、新しいメニューで表すメイン メニューを選択します。 以下に 2 つのメイン メニューを追加しました。
- 必要なメイン メニューとそれに含まれるメニュー項目をすべて追加したら、アドインを構築し、複数のメイン メニューで 3 つのメニュー項目を確認します。
メニュー項目用の組み込み JMP アイコン
アドイン ビルダーで行うのと同じように、アドイン マネージャーでもメニュー項目のカスタム アイコン ファイルを指定できます。 ただし、アドイン マネージャーでは、メニュー項目の横に表示される組み込みアイコンを選択することもできます。
- 「メニュー項目」タブでコマンドを選択し、「アイコン」セクション内の「選択」ボタンをクリックします。
- 使用するアイコンを選択し、「OK」をクリックします。
- メニュー項目ツリーにアイコンのプレビューが表示されます。
- アドインを構築してインストールすると、メニュー項目の横に組み込みアイコンが表示されます。
アドイン内でこれらのアイコンのいずれかを使用したい場合は、私のドキュメントをチェックしてください。組み込みの JMP アイコン加える。
カスタムメタデータ
カスタム メタデータは、連想配列の形式でアドインに含めることができます。 連想配列は、アドインの最上位フォルダーにある「customMetadata.jsl」ファイルに書き込まれます。 使用例については、スクリプト インデックス ([ヘルプ] > [スクリプト インデックス]) を参照してください。
含まれるメタデータ
以下は、アドイン マネージャーによって自動的に管理されるすべてのキーと値のペアのリストです。 独自のカスタム メタデータではこれらのキーを使用しないでください。
鍵
|
価値
|
データ・タイプ
|
アドインバージョン
|
%Ver
|
数値
|
建設日
|
％建設日
|
数値
|
ID
|
%ID
|
キャラクター
|
デプロイされたアドインファイル名
|
デポテーブルファイル名.jmp
|
キャラクター
|
デプロイされたAddinsLoc
|
/path/to/addin/depot/table
|
キャラクター
|
名前
|
％名前
|
キャラクター
|
州
|
「開発」または「テスト」または「製品」
|
キャラクター
|
新しいカスタムメタデータの追加
カスタム メタデータを追加するには、([一般情報] タブ内) [カスタム メタデータ] タブのテーブルの横にある緑色のプラス アイコンをクリックします。
アドインでのカスタム メタデータの使用
以下は、「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 部目であり、次の方法を説明します。アドインを定義して構築する、ユーザーにアドインを展開する、アドイン マネージャーで高度なカスタマイズが可能になります。あなたが私のものを見つけてくれることを願っていますアドインマネージャーアドイン便利！
