Con il Componente aggiuntivo Gestione componenti aggiuntivi , è possibile apportare ulteriori personalizzazioni, che in precedenza avrebbero richiesto la modifica manuale dell'XML non elaborato. Questo componente aggiuntivo ti offre inoltre l'accesso automatizzato 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 nella struttura. Puoi anche cambiare 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
- Fai clic con il pulsante destro del mouse sulla voce in alto nell'albero delle voci di menu e seleziona "Cambia menu principale".
- Dalla finestra "Cambia menu principale", seleziona il menu dal ComboBox in cui desideri inserire le voci del menu.
- Se è già impostato un valore nella proprietà "Inserisci dopo" (e il menu precedente era personalizzato), ti verrà richiesto di modificare la proprietà con un nuovo valore. L'elemento selezionato qui determinerà dove verrà posizionato il 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 sulla voce in alto nella struttura delle voci di menu e selezionare "Cambia Inserisci dopo" per aggiornare questo valore.
- Ricostruisci il tuo componente aggiuntivo e installalo. La voce di menu del componente aggiuntivo verrà ora visualizzata 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 tasto destro sulla voce 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à richiesto di modificare la proprietà con un nuovo valore. L'elemento selezionato qui determinerà dove verrà posizionato il 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 sulla voce in alto nella struttura delle voci di menu e selezionare "Cambia Inserisci dopo" per aggiornare questo valore.
- Ricostruisci il tuo componente aggiuntivo e installalo. La voce del menu del componente aggiuntivo verrà ora visualizzata 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 possibile creare un singolo componente aggiuntivo che crea più voci di menu all'interno di più menu principali diversi. Ciò potrebbe essere utile se stai creando un componente aggiuntivo che esegue più attività adatte ad aree diverse. Ad esempio, un componente aggiuntivo delle utilità della tabella dati potrebbe richiedere una voce di menu con i menu Tabelle, Righe e/o Col.
- Per aggiungere un ulteriore menu principale al tuo componente aggiuntivo, fai clic sul menu del triangolo rosso accanto alla "struttura delle voci di menu" nella scheda Voci di menu e seleziona Aggiungi menu principale di primo livello.
Successivamente, 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 nel Generatore di componenti aggiuntivi, in Gestione componenti aggiuntivi puoi specificare un file di icone personalizzato per una voce di menu. Tuttavia, in Gestione componenti aggiuntivi, puoi anche scegliere un'icona incorporata da visualizzare accanto alla voce di menu.
- Nella scheda Voci di menu, selezionare un comando e fare clic sul pulsante Seleziona nella 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 voce di menu.
Se desideri utilizzare una di queste icone nel tuo componente aggiuntivo, consulta il mio Icone JMP integrate aggiungere.
Metadati personalizzati
I metadati personalizzati possono essere inclusi nel componente aggiuntivo sotto forma di array associativo. L'array associativo verrà scritto in un file "customMetadata.jsl" nella cartella di livello superiore del componente aggiuntivo. Consulta l'indice degli script (Aiuto > Indice degli script) per esempi di utilizzo.
Metadati inclusi
Di seguito è riportato un elenco di tutte le coppie chiave/valore 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
|
nomefile-tabella-depot.jmp
|
Carattere
|
deployedAddinsLoc
|
/percorso/del/addin/deposito/tabella
|
Carattere
|
nome
|
%Nome
|
Carattere
|
stato
|
"DEV" o "TEST" o "PROD"
|
Carattere
|
Aggiunta di nuovi metadati personalizzati
I metadati personalizzati possono essere aggiunti facendo clic sull'icona verde più 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 "autore".
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 riportata 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, puoi utilizzare la seguente sintassi per fare riferimento a un valore:
aa["author"]
Questo post del 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 rendere disponibili le personalizzazioni avanzate in Gestione componenti aggiuntivi.Spero che troverai il mio Gestione componenti aggiuntivi componente aggiuntivo utile!
