Beginnend mit Version 2.0 von Add-In-Manager , können Sie jetzt die automatische Aktualisierung bereitstellen JMP Fügen Sie Ihren Benutzern mit einem einzigen Klick Add-Ins hinzu. Mit dem Add-In-Manager können Sie die Bereitstellung an Test- und Produktionsstandorten durchführen. Für die Zwecke des Add-In-Managers ist die Bereitstellung der Prozess des Verschiebens (oder Pushens) eines Add-Ins an Ihre Benutzer.
Sie können mit den Einstellungen des Add-In-Managers Standardbereitstellungsorte für TEST und PROD definieren. Sie können die TEST- und PROD-Speicherorte auch für jedes Add-In im Abschnitt „Ordnerspeicherorte“ auf der Registerkarte „Allgemeine Informationen“ unterschiedlich festlegen.In Ihrem Add-In wird eine Skriptdatei „customMetadata.jsl“ mit einem assoziativen Array erstellt, das mehrere Informationseinheiten enthält. Ein Schlüssel im assoziativen Array heißt „state“ und enthält den Speicherort des aktuellen Builds, entweder DEV, TEST oder PROD. Weitere Informationen zum Hinzufügen eigener benutzerdefinierter Metadaten finden Sie in meinem nächsten Blogbeitrag. Add-In-Manager, Teil 3: Erweiterte Anpassung .
Erstellen Sie das Add-In am DEV-Standort
Ein Bereitstellungsort ist ein Ordnerpfad, der auf einen bestimmten Staging-Bereich verweist. Im Add-In-Manager gibt es drei Staging-Bereiche (als Bereitstellungsorte bezeichnet): DEV, TEST und PROD. Der DEV-Speicherort ist der Speicherort, an dem Add-Ins ursprünglich erstellt werden. Dieser Ort ist ein großartiger Ort für Sie als Entwickler, um Ihr Add-In zu testen und auszuprobieren. Informationen zum Erstellen eines Add-Ins an diesem DEV-Speicherort finden Sie in meinem vorherigen Blog. Add-In-Manager, Teil 1: Definieren und Erstellen eines JMP-Add-Ins .
Stellen Sie das Add-In am TEST-Standort bereit
Wenn Sie möchten, dass einer oder mehrere Ihrer Benutzer einen bestimmten Build Ihres Add-Ins testen, Sie aber noch nicht ganz bereit sind, ihn an alle weiterzugeben, können Sie Ihr Add-In am Bereitstellungsort TEST bereitstellen und bereitstellen Pfad zur Installation dieses Add-Ins für den/die Benutzer.
Bevor Sie ein Add-In an einem TEST-Speicherort bereitstellen, stellen Sie sicher, dass auf der Registerkarte TEST im Abschnitt „Ordnerspeicherorte“ ein TEST-Bereitstellungsspeicherort definiert ist.
Klicken Sie auf die Dropdown-Schaltfläche „Bereitstellen“ und wählen Sie „TEST bereitstellen“, um das Add-In in den TEST-Bereitstellungsordner zu kopieren. Das TEST-Add-In wird jedes Mal überschrieben, wenn es im TEST-Bereitstellungsordner bereitgestellt wird.
Stellen Sie das Add-In am PROD-Standort bereit
Sobald alle Tests abgeschlossen sind, damit eine neue Version eines Add-Ins veröffentlicht werden kann, können Sie Ihr Add-In bereitstellen
Bevor Sie ein Add-In an einem PROD-Standort bereitstellen, stellen Sie sicher, dass auf der Registerkarte „PROD“ im Abschnitt „Ordnerstandorte“ ein PROD-Bereitstellungsstandort definiert ist. Wenn Sie das Update-Prüfskript verwenden, stellen Sie sicher, dass der PROD-Metadatenordner einen Serverpfad verwendet, da Benutzer bei der Suche nach Updates auf diesen Pfad zugreifen können müssen.
Klicken Sie auf die Dropdown-Schaltfläche „Bereitstellen“ und wählen Sie „PROD bereitstellen“, um das Add-In in den PROD-Bereitstellungsordner mit dem Status „PROD“ zu kopieren. Das vorherige PROD-Add-In wird im PROD-Archivordner archiviert und das neue PROD-Add-In nimmt seinen Platz ein.
Bei der Bereitstellung auf PROD wird das assoziative Array-Skript „publishedAddins.jsl“ im PROD-Metadatenordner mit dem Erstellungsdatum des bereitgestellten Add-Ins aktualisiert. Diese Informationen können mit dem updateCheck-Skript abgefragt werden, das in den Bereitstellungseinstellungen aktiviert werden kann.
Unten finden Sie eine Beispielskriptdatei „publishedAddins.jsl“ mit zwei veröffentlichten Add-Ins. Sie sollten diese Datei nie ansehen oder bearbeiten müssen, aber es kann hilfreich sein zu wissen, wie sie hinter den Kulissen funktioniert.
Associative Array(
List(
List( "com.jmp.juchil.myjmpaddin1",
Associative Array(
List(
List( "filename", "My First JMP Add-In.jmpaddin" ),
List( "folder", "\\server\share\Add-In Depot\Production\" ),
List( "pubDate", 3594027166 )
)
)
),
List( "com.jmp.juchil.myjmpaddin2",
Associative Array(
List(
List( "filename", "My Second JMP Add-In.jmpaddin" ),
List( "folder", "\\server\share\Add-In Depot\Production\" ),
List( "pubDate", 3594026242 )
)
)
)
)
)
Prüfskript aktualisieren
Damit Add-Ins automatisch aktualisiert werden, muss die Einstellung „Aktualisierungsprüfungsskript einschließen“ aktiviert sein. Wenn diese Einstellung aktiviert ist, wird ein Skript namens „updateCheck.jsl“ in den Ordner der obersten Ebene Ihres Add-Ins eingefügt. Sie können das Standardskript ändern, indem Sie die Datei „updateCheck.jsl“ im Verzeichnis „Template Scripts“ im Home-Verzeichnis des Add-In-Managers bearbeiten. Erstellen Sie unbedingt eine Kopie dieser Datei, bevor Sie sie bearbeiten.
Die vorhandene Datei „updateCheck.jsl“ überprüft das im vorherigen Abschnitt besprochene assoziative Array von PROD-Metadaten. Es verwendet den „buildDate“-Schlüssel der benutzerdefinierten Metadatendatei, um zu prüfen, ob die installierte Version älter als eine verfügbare veröffentlichte Version ist. Da das Aktualisierungsskript auf der benutzerdefinierten Metadatendatei basiert, ist es wichtig, die Option „Metadatendatei erstellen“ aktiviert zu lassen, wenn Sie die Bereitstellungsfunktionen verwenden.
Sie können dieses Skript mit der folgenden Include-Anweisung verwenden. Sie müssen die ID ändern, damit sie mit der ID Ihres Add-Ins übereinstimmt. Sie können diese Aktualisierungsprüfung am Anfang Ihres Befehlsskripts oder in einem ButtonBox-Skript verwenden, um nach einer neuen Version zu suchen. Ab JMP 13 funktioniert die Verwendung dieses Skripts innerhalb eines addinLoad.jsl-Skripts jedoch nicht mehr.
Include( "$ADDIN_HOME(com.jmp.myaddin)\updateCheck.jsl" );
com.jmp.juchil.addinmanager:checkForUpdate();
Sie können das Skript „updateCheck.jsl“ in Ihrem Quellordner bearbeiten, nachdem es kopiert wurde, oder Sie können die verwendete Originalkopie aus dem Ordner „Template Scripts“ im Home-Ordner des Add-In-Managers bearbeiten.
Das Konzept, ein assoziatives Array zur Suche nach Updates zu verwenden, wurde von übernommen @brady_brady ist die Methode, eine Tabelle mit Veröffentlichungsdaten zu verwenden. Diese Methode ist in beschrieben @Jeff_Perkinson 's Beitrag So schreiben Sie selbstaktualisierende JMP-Add-Ins .
Dieser Blogbeitrag ist der zweite Teil einer dreiteiligen Serie, in der es darum geht, wie das geht Definieren und erstellen Sie ein Add-In , ein Add-In für Benutzer bereitstellen und Nehmen Sie erweiterte Anpassungen vor verfügbar im Add-In-Manager.Ich hoffe, du findest meine Add-In-Manager Add-in nützlich!
