Avec le Complément Gestionnaire de compléments , vous pouvez effectuer des personnalisations supplémentaires, qui auraient auparavant nécessité de modifier manuellement le code 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 à 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 dans 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 de 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é pour une nouvelle valeur. L'élément que vous sélectionnez ici déterminera où votre menu personnalisé sera placé dans la barre du 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 maintenant dans le menu principal sélectionné, après l'élément de menu spécifié, comme indiqué ci-dessous.
Modification du menu principal en menu personnalisé
- Cliquez avec le bouton droit sur l'élément supérieur dans 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 de votre 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é pour une nouvelle valeur. L'élément que vous sélectionnez ici déterminera où votre menu personnalisé sera placé dans la barre du 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 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 le gestionnaire de compléments, 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 qui correspondent à 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 Tables, 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 le gestionnaire de compléments, 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
Des 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 gérées automatiquement par le gestionnaire de compléments. N'utilisez aucune de ces clés dans vos propres métadonnées personnalisées.
Clé
|
Évaluer
|
Type de données
|
addinVersion
|
% Ver
|
Numérique
|
date de construction
|
%Date de construction
|
Numérique
|
identifiant
|
%Identifiant
|
Personnage
|
nom_fichier_addins_déployé
|
depot-table-filename.jmp
|
Personnage
|
deployAddinsLoc
|
/chemin/vers/addin/dépôt/table
|
Personnage
|
Nom
|
%Nom
|
Personnage
|
Etat
|
"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 verte plus à 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 "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" )
)
)
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"]
Ce billet de blog est la troisiè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 rendre les personnalisations avancées disponibles dans le gestionnaire de compléments.j'espère que tu trouveras mon Gestionnaire de compléments complément utile !
