Con il Componente aggiuntivo Gestione componenti aggiuntivi , puoi apportare personalizzazioni aggiuntive, che in precedenza avrebbero richiesto la modifica manuale del codice XML non elaborato. Questo componente aggiuntivo ti offre anche l'accesso automatico agli attributi dei metadati personalizzati per tutti i tuoi componenti aggiuntivi.
Voci di menu personalizzate
È possibile modificare il menu principale (Componenti aggiuntivi per impostazione predefinita) facendo clic con il pulsante destro del mouse sull'elemento di livello superiore nell'albero. Puoi anche modificare la voce di menu da inserire in questo stesso menu. Ciò sarebbe utile se stai utilizzando una voce di menu principale esistente, come Analizza, e desideri posizionare la voce di menu in una posizione specifica, ad esempio dopo Adatta Y per X.
Modifica del menu principale in un menu integrato
- Fare clic con il pulsante destro del mouse sull'elemento in alto nell'albero delle voci di menu e selezionare "Cambia menu principale".
- Dalla finestra "Cambia menu principale", seleziona dal ComboBox il menu in cui desideri posizionare le voci di menu.
- Se è già impostato un valore nella proprietà "Inserisci dopo" (e il menu precedente era personalizzato), ti verrà chiesto di modificare la proprietà con un nuovo valore. L'elemento che selezioni qui determinerà dove verrà posizionato il tuo menu personalizzato all'interno della barra del menu principale.
Se non ti è stato richiesto un valore Inserisci dopo, puoi fare clic con il pulsante destro del mouse sull'elemento in alto nella struttura delle voci di menu e selezionare "Cambia Inserisci dopo" per aggiornare questo valore.
- Ricostruisci il tuo componente aggiuntivo e installa. La tua voce di menu aggiuntiva apparirà ora nel menu principale selezionato, dopo la voce di menu specificata, come mostrato di seguito.
Modifica del menu principale in un menu personalizzato
- Fare clic con il pulsante destro del mouse sull'elemento in alto nell'albero delle voci di menu e selezionare "Cambia menu principale".
- Dalla finestra "Cambia menu principale", seleziona "Personalizzato" dal ComboBox e digita il nome del menu desiderato nel TextEditBox, come mostrato di seguito.
- Se è già impostato un valore nella proprietà "Inserisci dopo" (e il menu precedente era integrato), ti verrà chiesto di modificare la proprietà con un nuovo valore. L'elemento che selezioni qui determinerà dove verrà posizionato il tuo menu personalizzato all'interno della barra del menu principale.
Se non ti è stato richiesto un valore Inserisci dopo, puoi fare clic con il pulsante destro del mouse sull'elemento in alto nella struttura delle voci di menu e selezionare "Cambia Inserisci dopo" per aggiornare questo valore.
- Ricostruisci il tuo componente aggiuntivo e installa. La voce del menu aggiuntivo apparirà ora nel menu principale personalizzato, dopo il menu principale specificato, come mostrato di seguito.
Utilizzo di più menu principali in un singolo componente aggiuntivo
Con Gestione componenti aggiuntivi, ora puoi creare un singolo componente aggiuntivo che crea più voci di menu all'interno di più menu principali diversi. Questo potrebbe essere utile se stai creando un componente aggiuntivo che esegue più attività che si adattano a diverse aree. Ad esempio, un componente aggiuntivo di utilità per tabelle dati potrebbe richiedere una voce di menu con i menu Tabelle, Righe e/o Colonne.
- Per aggiungere un menu principale aggiuntivo al tuo componente aggiuntivo, fai clic sul menu del triangolo rosso accanto alla "Struttura delle voci di menu" nella scheda delle voci di menu e seleziona Aggiungi menu principale di primo livello.
Quindi, seleziona il menu principale che desideri venga rappresentato dal nuovo menu, come mostrato nelle sezioni precedenti. Di seguito, ho aggiunto due menu principali aggiuntivi.
- Dopo aver aggiunto tutti i menu principali desiderati e le voci di menu che li contengono, crea il componente aggiuntivo e visualizza le tre voci di menu in più menu principali.
Icone JMP integrate per le voci di menu
Proprio come puoi fare in Generatore componenti aggiuntivi, in Gestione componenti aggiuntivi, puoi specificare un file icona personalizzato per una voce di menu. Tuttavia, in Gestione componenti aggiuntivi, puoi anche scegliere un'icona incorporata da visualizzare accanto alla tua voce di menu.
- Nella scheda Voci di menu, seleziona un comando e fai clic sul pulsante Seleziona all'interno della sezione Icona.
- Seleziona l'icona che desideri utilizzare e fai clic su OK.
- Vedrai un'anteprima dell'icona nell'albero delle voci di menu.
- Dopo aver creato e installato il componente aggiuntivo, vedrai l'icona integrata accanto alla tua voce di menu.
Se desideri utilizzare una di queste icone all'interno del tuo componente aggiuntivo, dai un'occhiata a my Icone JMP integrate aggiungere.
Metadati personalizzati
I metadati personalizzati possono essere inclusi nel tuo componente aggiuntivo sotto forma di array associativo. L'array associativo verrà scritto in un file "customMetadata.jsl" nella cartella di primo livello del componente aggiuntivo. Consulta l'indice degli script (Guida > Indice degli script) per esempi di utilizzo.
Metadati inclusi
Di seguito è riportato un elenco di tutte le coppie chiave/valore che vengono gestite automaticamente da Gestione componenti aggiuntivi. Non utilizzare nessuna di queste chiavi nei tuoi metadati personalizzati.
Chiave
|
Valore
|
Tipo di dati
|
addinVersion
|
%Ver
|
Numerico
|
data di costruzione
|
%Data di costruzione
|
Numerico
|
id
|
%Id
|
Carattere
|
deployedAddinsFilename
|
nome-file-tabella-depot.jmp
|
Carattere
|
deployedAddinsLoc
|
/percorso/di/addin/depot/tabella
|
Carattere
|
nome
|
%Nome
|
Carattere
|
stato
|
"DEV" o "TEST" o "PROD"
|
Carattere
|
Aggiunta di nuovi metadati personalizzati
È possibile aggiungere metadati personalizzati facendo clic sull'icona più verde accanto alla tabella nella scheda Metadati personalizzati (all'interno della scheda Informazioni generali).
Utilizzo di metadati personalizzati nel componente aggiuntivo
Di seguito è riportato un esempio di script "customMetadata.jsl", con una chiave di metadati personalizzata denominata "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" )
)
)
L'array associativo può essere importato nel componente aggiuntivo utilizzando l'istruzione include di seguito (dopo aver sostituito 'com.jmp.myaddin' con l'ID del componente aggiuntivo).
aa = Include( "$ADDIN_HOME(com.jmp.myaddin)\customMetadata.jsl" );
Dopo aver importato l'array associativo, è possibile utilizzare la seguente sintassi per fare riferimento a un valore:
aa["author"]
Questo post sul blog è la terza parte di una serie in tre parti, che spiega come farlo definire e creare un componente aggiuntivo , distribuire un componente aggiuntivo agli utenti e rendi disponibili personalizzazioni avanzate in Gestione componenti aggiuntivi.Spero che tu trovi il mio Gestore dei componenti aggiuntivi componente aggiuntivo utile!
