Mit dem Add-In-Manager-Add-In können Sie zusätzliche Anpassungen vornehmen, für die zuvor eine manuelle Bearbeitung des Roh-XML erforderlich gewesen wäre. Dieses Add-In bietet Ihnen außerdem automatischen Zugriff auf benutzerdefinierte Metadatenattribute für alle Ihre Add-Ins.
Benutzerdefinierte Menüelemente
Sie können das Hauptmenü (standardmäßig Add-Ins) ändern, indem Sie mit der rechten Maustaste auf das Element der obersten Ebene in der Baumstruktur klicken. Sie können auch den Menüpunkt ändern, um ihn in dasselbe Menü einzufügen. Dies wäre nützlich, wenn Sie ein vorhandenes Hauptmenüelement wie „Analysieren“ verwenden und das Menüelement an einer bestimmten Position platzieren möchten, beispielsweise nach „Y an X anpassen“.
Ändern des Hauptmenüs in ein integriertes Menü
- Klicken Sie mit der rechten Maustaste auf das oberste Element im Menüelementbaum und wählen Sie „Hauptmenü ändern“.
- Wählen Sie im Fenster „Hauptmenü ändern“ das Menü aus der ComboBox aus, in dem Ihr(e) Menüpunkt(e) platziert werden sollen.
- Wenn in der Eigenschaft „Einfügen nach“ bereits ein Wert festgelegt ist (und das vorherige Menü ein benutzerdefiniertes war), werden Sie aufgefordert, die Eigenschaft in einen neuen Wert zu ändern. Das hier ausgewählte Element bestimmt, wo Ihr benutzerdefiniertes Menü in der Hauptmenüleiste platziert wird.
Wenn Sie nicht zur Eingabe eines Werts für „Einfügen nach“ aufgefordert wurden, können Sie mit der rechten Maustaste auf das oberste Element in der Menüelementstruktur klicken und „Einfügen nach ändern“ auswählen, um diesen Wert zu aktualisieren.
- Erstellen Sie Ihr Add-In neu und installieren Sie es. Ihr Add-In-Menüelement wird nun im ausgewählten Hauptmenü nach dem angegebenen Menüelement angezeigt, wie unten gezeigt.
Ändern des Hauptmenüs in ein benutzerdefiniertes Menü
- Klicken Sie mit der rechten Maustaste auf das oberste Element im Menüelementbaum und wählen Sie „Hauptmenü ändern“.
- Wählen Sie im Fenster „Hauptmenü ändern“ in der ComboBox „Benutzerdefiniert“ aus und geben Sie den Namen Ihres gewünschten Menüs in die TextEditBox ein, wie unten gezeigt.
- Wenn in der Eigenschaft „Einfügen nach“ bereits ein Wert festgelegt ist (und das vorherige Menü ein integriertes war), werden Sie aufgefordert, die Eigenschaft in einen neuen Wert zu ändern. Das hier ausgewählte Element bestimmt, wo Ihr benutzerdefiniertes Menü in der Hauptmenüleiste platziert wird.
Wenn Sie nicht zur Eingabe eines Werts für „Einfügen nach“ aufgefordert wurden, können Sie mit der rechten Maustaste auf das oberste Element in der Menüelementstruktur klicken und „Einfügen nach ändern“ auswählen, um diesen Wert zu aktualisieren.
- Erstellen Sie Ihr Add-In neu und installieren Sie es. Ihr Add-In-Menüelement wird nun in Ihrem benutzerdefinierten Hauptmenü nach dem angegebenen Hauptmenü angezeigt, wie unten gezeigt.
Verwendung mehrerer Hauptmenüs in einem einzigen Add-In
Mit dem Add-In-Manager können Sie jetzt ein einzelnes Add-In erstellen, das mehrere Menüelemente in mehreren verschiedenen Hauptmenüs erstellt. Dies kann nützlich sein, wenn Sie ein Add-In erstellen, das mehrere Aufgaben ausführt, die in verschiedene Bereiche passen. Beispielsweise könnte ein Datentabellen-Dienstprogramm-Add-In ein Menüelement mit den Menüs „Tabellen“, „Zeilen“ und/oder „Spalten“ erfordern.
- Um Ihrem Add-In ein zusätzliches Hauptmenü hinzuzufügen, klicken Sie auf der Registerkarte „Menüelemente“ auf das rote Dreiecksmenü neben der „Menüelementstruktur“ und wählen Sie „Hauptmenü der obersten Ebene hinzufügen“ aus.
Wählen Sie als Nächstes das Hauptmenü aus, das das neue Menü darstellen soll, wie in den obigen Abschnitten gezeigt. Unten habe ich zwei zusätzliche Hauptmenüs hinzugefügt.
- Nachdem Sie alle gewünschten Hauptmenüs und die darin enthaltenen Menüelemente hinzugefügt haben, erstellen Sie das Add-In und sehen Sie die drei Menüelemente in mehreren Hauptmenüs.
Integrierte JMP-Symbole für Menüelemente
Genau wie im Add-In Builder können Sie im Add-In Manager eine benutzerdefinierte Symboldatei für ein Menüelement angeben. Im Add-In-Manager können Sie jedoch auch ein integriertes Symbol auswählen, das neben Ihrem Menüelement angezeigt wird.
- Wählen Sie auf der Registerkarte „Menüelemente“ einen Befehl aus und klicken Sie im Abschnitt „Symbol“ auf die Schaltfläche „Auswählen“.
- Wählen Sie das Symbol aus, das Sie verwenden möchten, und klicken Sie auf OK.
- Sie sehen eine Vorschau des Symbols im Menüelementbaum.
- Nachdem Sie das Add-In erstellt und installiert haben, sehen Sie das integrierte Symbol neben Ihrem Menüpunkt.
Wenn Sie eines dieser Symbole in Ihrem Add-In verwenden möchten, schauen Sie sich meine an Integrierte JMP-Symbole Add-in.
Benutzerdefinierte Metadaten
Benutzerdefinierte Metadaten können in Form eines assoziativen Arrays in Ihr Add-In eingebunden werden. Das assoziative Array wird in die Datei „customMetadata.jsl“ im Ordner der obersten Ebene Ihres Add-Ins geschrieben. Anwendungsbeispiele finden Sie im Skriptindex (Hilfe > Skriptindex).
Enthaltene Metadaten
Nachfolgend finden Sie eine Liste aller Schlüssel/Wert-Paare, die vom Add-In-Manager automatisch verwaltet werden. Verwenden Sie keinen dieser Schlüssel in Ihren eigenen benutzerdefinierten Metadaten.
Schlüssel
|
Wert
|
Datentyp
|
addinVersion
|
%Ver
|
Numerisch
|
BuildDate
|
%BuildDate
|
Numerisch
|
Ausweis
|
%Ausweis
|
Charakter
|
DeployedAddinsFilename
|
depot-tabellendateiname.jmp
|
Charakter
|
DeployedAddinsLoc
|
/path/to/addin/depot/table
|
Charakter
|
Name
|
%Name
|
Charakter
|
Zustand
|
„DEV“ oder „TEST“ oder „PROD“
|
Charakter
|
Hinzufügen neuer benutzerdefinierter Metadaten
Benutzerdefinierte Metadaten können hinzugefügt werden, indem Sie auf der Registerkarte „Benutzerdefinierte Metadaten“ (innerhalb der Registerkarte „Allgemeine Informationen“) auf das grüne Pluszeichen neben der Tabelle klicken.
Verwenden benutzerdefinierter Metadaten in Ihrem Add-In
Unten sehen Sie ein Beispielskript „customMetadata.jsl“ mit einem benutzerdefinierten Metadatenschlüssel namens „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" )
)
)
Das assoziative Array kann mit der folgenden Include-Anweisung in Ihr Add-In importiert werden (nachdem Sie „com.jmp.myaddin“ durch die ID Ihres Add-Ins ersetzt haben).
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
Nachdem Sie das assoziative Array importiert haben, können Sie die folgende Syntax verwenden, um auf einen Wert zu verweisen:
aa["author"]
Dieser Blogbeitrag ist der dritte Teil einer dreiteiligen Serie, in der es darum geht, wie das geht Definieren und erstellen Sie ein Add-In , Bereitstellen eines Add-Ins für Benutzer und stellen Sie erweiterte Anpassungen im Add-In-Manager zur Verfügung.Ich hoffe, du findest meine Add-In-Manager Add-in nützlich!
