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 auch automatisierten Zugriff auf benutzerdefinierte Metadatenattribute für alle Ihre Add-Ins.
Benutzerdefinierte Menüpunkte
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, z. B. nach Y nach 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 Ihre Menüelemente 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 auf einen neuen Wert zu ändern. Das Element, das Sie hier auswählen, 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“ „Benutzerdefiniert“ aus der ComboBox 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 auf einen neuen Wert zu ändern. Das Element, das Sie hier auswählen, 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.
Verwenden 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 kann ein Add-In für Datentabellen-Dienstprogramme ein Menüelement mit den Menüs „Tabellen“, „Zeilen“ und/oder „Spalten“ aufrufen.
- Um Ihrem Add-In ein zusätzliches Hauptmenü hinzuzufügen, klicken Sie auf der Registerkarte „Menüelemente“ neben dem „Menüelementbaum“ auf das Menü „Rotes Dreieck“ 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 sich die drei Menüelemente in mehreren Hauptmenüs an.
Integrierte JMP-Symbole für Menüelemente
Genau wie im Add-In-Generator 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üeintragsbaum.
- Nach dem Erstellen und Installieren des Add-Ins sehen Sie das integrierte Symbol neben Ihrem Menüpunkt.
Wenn Sie eines dieser Symbole in Ihrem Add-In verwenden möchten, besuchen Sie my Integrierte JMP-Symbole Zusatz.
Benutzerdefinierte Metadaten
Benutzerdefinierte Metadaten können in Form eines assoziativen Arrays in Ihr Add-In aufgenommen werden. Das assoziative Array wird in eine Datei „customMetadata.jsl“ im Ordner der obersten Ebene Ihres Add-Ins geschrieben. Sehen Sie sich den Skripting-Index (Hilfe > Skripting-Index) für Anwendungsbeispiele an.
Enthaltene Metadaten
Nachfolgend finden Sie eine Liste aller Schlüssel/Wert-Paare, die automatisch vom Add-In-Manager verwaltet werden. Verwenden Sie keinen dieser Schlüssel in Ihren eigenen benutzerdefinierten Metadaten.
Taste
|
Wert
|
Datentyp
|
addinVersion
|
%Ver
|
Numerisch
|
Baudatum
|
%BuildDate
|
Numerisch
|
Ich würde
|
%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 das grüne Plus-Symbol neben der Tabelle auf der Registerkarte „Benutzerdefinierte Metadaten“ (auf der Registerkarte „Allgemeine Informationen“) klicken.
Verwenden von benutzerdefinierten 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 mithilfe der folgenden Include-Anweisung in Ihr Add-In importiert werden (nachdem „com.jmp.myaddin“ durch die ID Ihres Add-Ins ersetzt wurde).
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 um die Vorgehensweise geht Definieren und Erstellen eines Add-Ins , Bereitstellen eines Add-Ins für Benutzer , und stellen Sie erweiterte Anpassungen im Add-In-Manager zur Verfügung.Ich hoffe, Sie finden meine Add-In-Manager Ergänzung sinnvoll!
