Avec le Complément Gestionnaire de compléments , vous pouvez effectuer des personnalisations supplémentaires, ce qui aurait auparavant nécessité la modification manuelle du XML brut. Ce complément vous donne également un accès automatisé aux attributs de métadonnées personnalisés pour tous vos compléments.
Éléments de menu personnalisés
Vous pouvez modifier le menu principal (compléments par défaut) en cliquant avec le bouton droit sur l'élément de niveau supérieur dans l'arborescence. Vous pouvez également modifier l'élément de menu pour l'insérer dans ce même menu. Cela serait utile si vous utilisez un élément de menu principal existant, comme Analyser, et que vous souhaitez placer l'élément de menu dans une position spécifique, par exemple après Ajuster Y par X.
Changer le menu principal en menu intégré
- Cliquez avec le bouton droit sur l'élément supérieur de l'arborescence des éléments de menu et sélectionnez "Modifier le menu principal".
- Dans la fenêtre « Modifier le menu principal », sélectionnez le menu dans la ComboBox dans lequel vous souhaitez que vos éléments de menu soient placés.
- S'il existe une valeur déjà définie dans la propriété "Insérer après" (et que le menu précédent était personnalisé), vous serez invité à modifier la propriété avec une nouvelle valeur. L'élément que vous sélectionnez ici déterminera l'emplacement de votre menu personnalisé dans la barre de menu principal.
Si vous n'avez pas été invité à saisir une valeur Insérer après, vous pouvez cliquer avec le bouton droit sur l'élément supérieur dans l'arborescence des éléments de menu et sélectionner « Modifier l'insertion après » pour mettre à jour cette valeur.
- Reconstruisez votre complément et installez-le. Votre élément de menu complémentaire apparaîtra désormais dans le menu principal sélectionné, après l’élément de menu spécifié, comme indiqué ci-dessous.
Changer le menu principal en menu personnalisé
- Faites un clic droit sur l'élément supérieur de l'arborescence des éléments de menu et sélectionnez « Modifier le menu principal ».
- Dans la fenêtre "Modifier le menu principal", sélectionnez "Personnalisé" dans la ComboBox et tapez le nom du menu souhaité dans la TextEditBox, comme indiqué ci-dessous.
- S'il existe une valeur déjà définie dans la propriété "Insérer après" (et que le menu précédent était intégré), vous serez invité à modifier la propriété avec une nouvelle valeur. L'élément que vous sélectionnez ici déterminera l'emplacement de votre menu personnalisé dans la barre de menu principal.
Si vous n'avez pas été invité à saisir une valeur Insérer après, vous pouvez cliquer avec le bouton droit sur l'élément supérieur dans l'arborescence des éléments de menu et sélectionner « Modifier l'insertion après » pour mettre à jour cette valeur.
- Reconstruisez votre complément et installez-le. Votre élément de menu de complément apparaîtra désormais dans votre menu principal personnalisé, après le menu principal spécifié, comme indiqué ci-dessous.
Utilisation de plusieurs menus principaux dans un seul complément
Avec Add-In Manager, vous pouvez désormais créer un seul complément qui crée plusieurs éléments de menu dans plusieurs menus principaux différents. Cela peut être utile si vous créez un complément qui exécute plusieurs tâches correspondant à différents domaines. Par exemple, un complément d’utilitaires de table de données peut appeler un élément de menu avec les menus Tableaux, Lignes et/ou Cols.
- Pour ajouter un menu principal supplémentaire à votre complément, cliquez sur le menu Triangle rouge à côté de « l'arborescence des éléments de menu » dans l'onglet Éléments de menu et sélectionnez Ajouter un menu principal de niveau supérieur.
Ensuite, sélectionnez le menu principal que vous souhaitez que le nouveau menu représente, comme indiqué dans les sections ci-dessus. Ci-dessous, j'ai ajouté deux menus principaux supplémentaires.
- Une fois que vous avez ajouté tous les menus principaux souhaités et les éléments de menu qui les contiennent, créez le complément et affichez les trois éléments de menu dans plusieurs menus principaux.
Icônes JMP intégrées pour les éléments de menu
Tout comme vous pouvez le faire dans Add-In Builder, dans Add-In Manager, vous pouvez spécifier un fichier d'icône personnalisé pour un élément de menu. Cependant, dans Add-In Manager, vous pouvez également choisir une icône intégrée à afficher à côté de votre élément de menu.
- Dans l'onglet Éléments de menu, sélectionnez une commande et cliquez sur le bouton Sélectionner dans la section Icône.
- Sélectionnez l'icône que vous souhaitez utiliser et cliquez sur OK.
- Vous verrez un aperçu de l'icône dans l'arborescence des éléments de menu.
- Après avoir créé et installé le complément, vous verrez l'icône intégrée à côté de votre élément de menu.
Si vous souhaitez utiliser l'une de ces icônes dans votre complément, consultez mon Icônes JMP intégrées ajouter à.
Métadonnées personnalisées
Les métadonnées personnalisées peuvent être incluses dans votre complément sous la forme d'un tableau associatif. Le tableau associatif sera écrit dans un fichier « customMetadata.jsl » dans le dossier de niveau supérieur de votre complément. Consultez l'index des scripts (Aide > Index des scripts) pour des exemples d'utilisation.
Métadonnées incluses
Vous trouverez ci-dessous une liste de toutes les paires clé/valeur automatiquement gérées par Add-In Manager. N'utilisez aucune de ces clés dans vos propres métadonnées personnalisées.
Clé
|
Valeur
|
Type de données
|
Version du module complémentaire
|
%Ver
|
Numérique
|
date de construction
|
%Date de construction
|
Numérique
|
identifiant
|
%Identifiant
|
Personnage
|
déployéAddinsFilename
|
dépôt-table-filename.jmp
|
Personnage
|
déployéAddinsLoc
|
/chemin/vers/complément/dépôt/table
|
Personnage
|
nom
|
%Nom
|
Personnage
|
État
|
"DEV" ou "TEST" ou "PROD"
|
Personnage
|
Ajout de nouvelles métadonnées personnalisées
Des métadonnées personnalisées peuvent être ajoutées en cliquant sur l'icône plus verte à côté du tableau dans l'onglet Métadonnées personnalisées (dans l'onglet Informations générales).
Utilisation de métadonnées personnalisées dans votre complément
Vous trouverez ci-dessous un exemple de script « customMetadata.jsl », avec une clé de métadonnées personnalisée nommée « auteur ».
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" )
)
)
Le tableau associatif peut être importé dans votre complément à l'aide de l'instruction include ci-dessous (après avoir remplacé « com.jmp.myaddin » par l'ID de votre complément).
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
Une fois que vous avez importé le tableau associatif, vous pouvez utiliser la syntaxe suivante pour référencer une valeur :
aa["author"]
Cet article de blog est la troisième partie d'une série de trois, expliquant comment définir et créer un complément , déployer un complément pour les utilisateurs et rendez les personnalisations avancées disponibles dans Add-In Manager.J'espère que tu trouveras mon Gestionnaire de compléments complément utile !
