隨著加載項管理器加載項,您可以進行其他自訂,而以前需要手動編輯原始 XML。 此加載項還允許您自動存取所有加載項的自訂元資料屬性。
自訂選單項
您可以透過右鍵單擊樹中的頂級項目來更改主選單(預設為加載項)。 您也可以變更要插入到同一選單中的選單項目。 如果您正在使用現有的主選單項目(例如「分析」),並且希望將選單項目放置在特定位置(例如「Fit Y by X」之後),這將非常有用。

將主選單更改為內建選單
- 右鍵點選選單項目樹中的頂部項目,然後選擇“變更主選單”。
- 在「變更主選單」視窗中,從組合方塊中選擇您想要放置選單項目的選單。

- 如果「Insert After」屬性中已設定值(並且上一個選單是自訂選單),系統將提示您將該屬性變更為新值。 您在此處選擇的項目將決定您的自訂選單在主選單列中的放置位置。

如果系統未提示您輸入「插入後」值,則可以右鍵點選選單項目樹中的頂部項目,然後選擇「變更插入後」以更新此值。
- 重建您的加載項並安裝。 您的加載項選單項目現在將顯示在選定的主選單中指定的選單項目之後,如下所示。

將主選單變更為自訂選單
- 右鍵點選選單項目樹中的頂部項目,然後選擇“變更主選單”。
- 在“變更主選單”視窗中,從組合方塊中選擇“自訂”,然後在文字編輯方塊中鍵入所需選單的名稱,如下所示。

- 如果「Insert After」屬性中已經設定了一個值(並且上一個選單是內建選單),系統將提示您將該屬性變更為新值。 您在此處選擇的項目將決定您的自訂選單在主選單列中的放置位置。
如果系統未提示您輸入「插入後」值,則可以右鍵點選選單項目樹中的頂部項目,然後選擇「變更插入後」以更新此值。
- 重建您的加載項並安裝。 您的加載項選單項目現在將顯示在自訂主選單中指定的主選單之後,如下所示。

在單一加載項中使用多個主選單
使用加載項管理器,您現在可以建立一個加載項,在多個不同的主選單中建立多個選單項目。 如果您要建立一個執行適合不同區域的多個任務的加載項,這可能會很有用。 例如,資料表實用程式加載項可能會呼叫帶有「表」、「行」和/或「列」功能表的選單項目。
- 若要將附加主選單新增至加載項,請按一下「選單項目」標籤上「選單項目樹」旁的紅色三角形選單,然後選擇「新增頂級主選單」。

接下來,選擇您希望新選單代表的主選單,如以上部分所示。 下面,我新增了兩個額外的主選單。
- 新增所有所需的主選單及其包含的選單項目後,建立加載項並在多個主選單中查看三個選單項目。

選單項目的內建 JMP 圖標
就像在加載項產生器中所做的那樣,在加載項管理員中,您可以為選單項目指定自訂圖示檔案。 但是,在加載項管理員中,您也可以選擇一個內建圖示顯示在選單項目旁邊。
- 在「選單項目」標籤上,選擇一個命令,然後按一下「圖示」部分中的「選擇」按鈕。
- 選擇您想要使用的圖標,然後按一下「確定」。

- 您將在選單項目樹中看到圖示的預覽。

- 建置並安裝加載項後,您將在選單項目旁邊看到內建圖示。

如果您想在加載項中使用這些圖示中的任何一個,請查看我的內建 JMP 圖標加入。
自訂元數據
自訂元資料可以以關聯數組的形式包含在您的外接程式中。 關聯數組將寫入加載項頂級資料夾中的“customMetadata.jsl”檔案。 查看腳本索引(說明 > 腳本索引)以取得使用範例。
包含的元數據
下面是由加載項管理器自動管理的所有鍵/值對的清單。 不要在您自己的自訂元資料中使用任何這些鍵。
鑰匙
|
價值
|
資料類型
|
插件版本
|
%版本
|
數位
|
建置日期
|
%建構日期
|
數位
|
ID
|
%ID
|
特點
|
已部署的插件檔名
|
倉庫表檔名.jmp
|
特點
|
已部署的AddinsLoc
|
/路徑/到/addin/depot/表
|
特點
|
姓名
|
%姓名
|
特點
|
狀態
|
“開發”或“測試”或“產品”
|
特點
|
新增的自訂元數據
可以透過點擊「自訂元資料」標籤(在「常規資訊」標籤中)上表格旁邊的綠色加號圖示來新增自訂元資料。
在加載項中使用自訂元數據
下面是一個範例「customMetadata.jsl」腳本,其中包含名為「author」的自訂元資料鍵。
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"]
這篇部落格文章是由三部分組成的系列文章中的第三部分,介紹如何定義並建立加載項,向使用者部署加載項,並在加載項管理器中進行進階自訂。我希望你能找到我的外掛程式管理器插件很有用!