À partir de la version 2.0 de Gestionnaire de compléments , vous pouvez maintenant déployer la mise à jour automatique JMP des compléments à vos utilisateurs en un seul clic. Add-In Manager vous permet de déployer sur des sites de test et de production. Le déploiement, à des fins de gestionnaire de compléments, est le processus de déplacement (ou de transmission) d'un complément vers vos utilisateurs.
Vous pouvez définir des emplacements de déploiement par défaut pour TEST et PROD avec les préférences de Add-In Manager. Vous pouvez également définir les emplacements TEST et PROD différemment pour chaque complément dans la section Emplacements des dossiers de l'onglet Informations générales.Un fichier de script "customMetadata.jsl" est créé dans votre complément avec un tableau associatif contenant plusieurs informations. Une clé du tableau associatif est appelée "état", qui contient l'emplacement de la version actuelle, soit DEV, TEST ou PROD. Vous pouvez trouver plus d'informations sur l'ajout de vos propres métadonnées personnalisées dans mon prochain article de blog, Gestionnaire de compléments, partie 3 : personnalisation avancée .
Construire le complément dans l'emplacement DEV
Un emplacement de déploiement est un chemin de dossier pointant vers une zone de transit particulière. Dans le gestionnaire de compléments, il existe trois zones intermédiaires (appelées emplacements de déploiement) : DEV, TEST et PROD. L'emplacement DEV est l'emplacement où les compléments sont initialement créés. Cet emplacement est un endroit idéal pour vous, le développeur, pour tester votre complément et l'essayer. Pour savoir comment créer un complément dans cet emplacement DEV, consultez mon blog précédent, Gestionnaire de compléments, partie 1 : Définition et création d'un complément JMP .
Déployer le complément à l'emplacement TEST
Si vous avez besoin qu'un ou plusieurs de vos utilisateurs testent une version particulière de votre complément, mais que vous n'êtes pas tout à fait prêt à le diffuser à tout le monde, vous pouvez déployer votre complément à l'emplacement de déploiement TEST et fournir le chemin d'accès pour installer ce complément pour le ou les utilisateurs.
Avant de déployer un complément dans un emplacement TEST, assurez-vous qu'un emplacement de déploiement TEST est défini dans l'onglet TEST de la section Emplacements des dossiers.
Cliquez sur le bouton déroulant Déployer et sélectionnez "Déployer TEST" pour copier le complément dans le dossier de déploiement TEST. Le complément TEST sera écrasé chaque fois qu'il est déployé dans le dossier de déploiement TEST.
Déployer le complément sur l'emplacement PROD
Une fois que tous vos tests sont terminés pour qu'une nouvelle version d'un complément soit prête à être publiée, vous pouvez déployer votre complément
Avant de déployer un complément dans un emplacement PROD, assurez-vous que vous disposez d'un emplacement de déploiement PROD défini dans l'onglet PROD de la section Emplacements des dossiers. Si vous utilisez le script de vérification des mises à jour, assurez-vous que le dossier de métadonnées PROD utilise un chemin de serveur, car les utilisateurs devront pouvoir accéder à ce chemin lors de la recherche de mises à jour.
Cliquez sur le bouton déroulant Déployer et sélectionnez "Déployer PROD" pour copier le complément dans le dossier de déploiement PROD avec un état défini sur "PROD". Le précédent complément PROD sera archivé dans le dossier PROD Archive et le nouveau complément PROD prendra sa place.
Lors du déploiement sur PROD, le script de tableau associatif "publishedAddins.jsl" dans le dossier de métadonnées PROD sera mis à jour avec la date de génération du complément déployé. Ces informations peuvent être interrogées à l'aide du script updateCheck, qui peut être activé dans les préférences de déploiement.
Vous trouverez ci-dessous un exemple de fichier de script "publishedAddins.jsl" avec deux compléments publiés. Vous ne devriez jamais avoir besoin de regarder ou de modifier ce fichier, mais il peut être bon de savoir comment il fonctionne dans les coulisses.
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 )
)
)
)
)
)
Mettre à jour le script de vérification
Pour que les compléments se mettent à jour automatiquement, vous devez activer la préférence "Inclure le script de vérification de mise à jour". Avec cette préférence activée, un script appelé "updateCheck.jsl" sera inclus dans le dossier de niveau supérieur de votre complément. Vous pouvez modifier le script par défaut en éditant le fichier "updateCheck.jsl" dans le répertoire "Template Scripts" du répertoire d'accueil de Add-In Manager. Assurez-vous de faire une copie de ce fichier avant de le modifier.
Le fichier "updateCheck.jsl" existant vérifie le tableau associatif de métadonnées PROD décrit dans la section précédente. Il utilise la clé "buildDate" du fichier de métadonnées personnalisées pour vérifier si la version installée est plus ancienne qu'une version publiée disponible. Étant donné que le script de mise à jour repose sur le fichier de métadonnées personnalisé, il est important de garder l'option "Créer un fichier de métadonnées" activée si vous utilisez les fonctionnalités de déploiement.
Vous pouvez utiliser ce script à l'aide de l'instruction Include ci-dessous. Vous devrez modifier l'ID pour qu'il corresponde à l'ID de votre complément. Vous pouvez utiliser cette vérification de mise à jour au début du script de votre commande ou dans un script ButtonBox pour rechercher une nouvelle version. Cependant, à partir de JMP 13, l'utilisation de ce script dans un script addinLoad.jsl ne fonctionnera pas.
Include( "$ADDIN_HOME(com.jmp.myaddin)\updateCheck.jsl" );
com.jmp.juchil.addinmanager:checkForUpdate();
Vous pouvez modifier le script "updateCheck.jsl" dans votre dossier source une fois qu'il a été copié, ou vous pouvez modifier la copie d'origine utilisée à partir du dossier Template Scripts dans le dossier d'accueil de Add-In Manager.
Le concept utilisant un tableau associatif pour vérifier les mises à jour a été adapté de @brady_brady utilise une table avec des dates de publication. Cette méthode est décrite dans @Jeff_Perkinson le poste Comment écrire des compléments JMP à mise à jour automatique .
Ce billet de blog est la deuxième partie d'une série en trois parties, couvrant comment définir et créer un complément , déployer un complément pour les utilisateurs et faire des personnalisations avancées disponible dans le gestionnaire de compléments.j'espère que tu trouveras mon Gestionnaire de compléments complément utile !
