Ciascuna piattaforma JMP genera una visualizzazione univoca, ma esistono funzioni e oggetti comuni nel layout del report. La funzione più familiare in un report JMP è la casella di riepilogo. La maggior parte degli utenti di JMP ha probabilmente modificato il titolo di una casella di riepilogo o ha attivato o disattivato il pulsante per mostrare o nascondere i grafici e le analisi appartenenti a tale casella di riepilogo.
Il passaggio successivo consiste nell'apprendere gli equivalenti JSL di queste attività dell'interfaccia utente, come la modifica del titolo della casella di riepilogo o l'attivazione dell'icona di divulgazione ◢.
Sono necessarie due competenze specifiche per modificare il livello del report. Uno utilizza i messaggi JSL validi e la sintassi appropriata per la funzione di visualizzazione mirata. L'altro è trovare l'indirizzo dell'elemento da modificare. Chiamiamo quest'ultima abilità di navigazione.
Mostra struttura ad albero
La navigazione inizia quasi sempre con una mappa. Eseguire lo script seguente per generare un report. Quindi, fai clic con il pulsante destro del mouse sull'icona di divulgazione ◢ situato a sinistra della casella di contorno intitolata "Analisi a senso unico dell'altezza per sesso". Selezionare Modifica ► Mostra struttura ad albero . (Vedi Figura 6.5.)
bigclass_dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
bigclass_ht_onew = bigclass_dt << Oneway(
Y( :height ), X( :sex ), Ignore Platform Preferences( 1 ),
Box Plots( 1 ), Means and Std Dev( 1 ), X Axis Proportional( 0 ),
Mean Error Bars( 0 ), Std Dev Lines( 0 )
);
Figura 6.5 Menu Modifica—Mostra struttura ad albero: (L) Intero report (R) Asse Y
La struttura ad albero viene visualizzata in una nuova finestra. Si tratta di un elenco nidificato e gerarchico (sì, un elenco) di caselle di contorno, in cui ogni casella di contorno rappresenta una casella di visualizzazione JMP utilizzata nel report. Poiché è stato selezionato il pulsante di rivelazione più in alto, viene mostrata la struttura ad albero dell'intero report. Devi scorrere verso il basso per vedere la struttura ad albero completa. La Figura 6.6 (L) visualizza questa struttura ad albero dopo aver fatto clic con il pulsante destro del mouse sul pulsante di rivelazione in alto, selezionando Chiudi tutto sotto , quindi aprendo in modo selettivo alcuni elementi.
Figura 6.6 Struttura ad albero: report collegato con FrameBox(1) evidenziato
Allineare la finestra della struttura ad albero e il rapporto unidirezionale. Passa il mouse sul pulsante di rivelazione per FrameBox(1) e vedere la visualizzazione corrispondente evidenziata nel rapporto di sola andata. Vedere Figura 6.6 (R). Nota l'elenco di IfBox( ) elementi nell'albero. Passa il mouse su ciascuna icona di rivelazione. IfBox(1) contiene il contorno per la parte grafica del display. IfBox(4) corrisponde al Medie e deviazioni standard tavolo. IL IfBox contenitore mostra o nasconde il suo contenuto in base alle opzioni dell'oggetto: se è specificata l'opzione booleana, visualizza; se no, nasconditi.
Ogni icona di divulgazione nella finestra del rapporto ha la stessa interfaccia utente. Ciò consente all'utente di visualizzare la struttura ad albero per una parte più piccola della finestra del report. La Figura 6.5 (R) mostra che facendo clic con il pulsante destro del mouse su una funzione della finestra di report come l'asse Y viene visualizzato un menu ( Modifica ► Mostra struttura ad albero) . In altre parole, la struttura ad albero può essere richiesta per più di outline box.
Chiudere la struttura ad albero per l'intero report. Fare clic con il pulsante destro del mouse sul pulsante di rivelazione a sinistra della casella di contorno intitolata "Means and Std Deviations" e creare la struttura ad albero. Ripeti gli stessi passaggi, ma questa volta tieni premuto il tasto MAIUSC mentre selezioni Mostra struttura ad albero . Vedere Figura 6.7.
Figura 6.7 Analisi a una via Medie e deviazioni standard Struttura ad albero – Formato predefinito interattivo (L) Formato classico (R)
Entrambi i formati di struttura ad albero visualizzano gli oggetti utilizzati per organizzare l'output. Ogni oggetto contiene la parola "scatola" nel nome (ad esempio, OutlineBox, TableBox, StringColBox e NumberColBox). Per entrambi i formati, la disposizione degli oggetti è una struttura nidificata e gerarchica. La struttura ad albero predefinita interattiva (L) ricorda un contorno. Il formato classico (R) ricorda un organigramma (organigramma).
L'evidenziazione interattiva della struttura ad albero predefinita è utile per abbinare il report alle caselle di visualizzazione dei suoi componenti. Tuttavia, è lungo e può essere difficile discernere la struttura di base fino a quando le icone di divulgazione strategicamente selezionate non vengono chiuse. L'utilizzo della struttura ad albero del formato classico può semplificare la visualizzazione delle relazioni tra gli oggetti nel report. Ad esempio, la relazione tra NumberColBox(6) e TableBox(1) è immediata in questo organigramma come display.
Entrambi i formati sono informativi. A volte guardiamo entrambi. Per entrambi i formati, la struttura ad albero per una parte del report sarà più facile da leggere rispetto alla struttura ad albero per l'intero report.
Fare riferimento al livello del report
Una modifica al livello di analisi richiede che venga inviato un messaggio valido all'oggetto piattaforma o all'oggetto di riferimento per quella piattaforma. Per l'esempio corrente, la piattaforma è Oneway e l'handle è il riferimento alla variabile bigclass_ht_onew .
//Message to the Analysis Layer
bigclass_ht_onew << Points Jittered(1);
Analogamente, per modificare gli oggetti di visualizzazione, è necessario inviare un messaggio valido al Report Layer. I due modi per assegnare un riferimento variabile al Report Layer sono i seguenti:
//These two lines assign a variable name to the report,
//either syntax is acceptable
rpt_bc_ht_onew = Report( bigclass_ht_onew );
rpt_bc_ht_onew = bigclass_ht_onew << Report;
Per modificare una funzione di visualizzazione, il messaggio valido deve essere inviato all'indirizzo dell'oggetto di visualizzazione. IL Rapporto messaggio (o funzione) restituisce un indirizzo per l'oggetto di visualizzazione di destinazione. Per entrambi gli esempi precedenti, rpt_bc_ht_onew memorizza l'indirizzo per la visualizzazione Oneway Analysis, il livello di report Oneway. Esaminare i messaggi della casella di contorno mostrati nella Figura 6.5 (L). Utilizzando l'indirizzo del rapporto, l'annidamento e gli indirizzi delle caselle visualizzate nella struttura ad albero, dovrebbe essere evidente questo prossimo insieme di istruzioni:
bigclass_ht_onew << Bring Window to Front;
//line up this script and this window, run 1 line at a time
rpt_bc_ht_onew[OutlineBox(1)] << Close;
rpt_bc_ht_onew[OutlineBox(1)] << Open All Below;
rpt_bc_ht_onew[OutlineBox(1)] << Close(1);
rpt_bc_ht_onew[OutlineBox(1)] << Close(0);
Ogni oggetto di visualizzazione ( OutlineBox , TableBox , StringColBox ) appartiene a una classificazione più ampia chiamata display box. Il nome OutlineBox (O NumberColBox , ecc.) è il nome della classe di un oggetto. Un'abilità fondamentale da apprendere è l'attraversamento della struttura ad albero, discussa nella sezione "Esplorazione di un report" in questo capitolo.
JMP semplifica la ricerca di messaggi validi per la maggior parte degli oggetti della casella di visualizzazione. Da JMP Scripting Index, selezionare Casella di visualizzazione ► OutlineBox . Per prima cosa, notate i messaggi che sono comuni con l'elenco delle opzioni di menu mostrate nella Figura 6.5. Trova il messaggio Vicino . La sua descrizione afferma che questo messaggio ha un argomento booleano. Guarda gli script di esempio per Ottieni titolo E Imposta titolo, ed eseguire la seguente istruzione JSL:
rpt_bc_ht_onew[OutlineBox(1)] << Set Title("Limit Mousing via JSL");Congratulazioni! Hai appena imparato gli equivalenti JSL per rivelare o nascondere e per cambiare il titolo di una casella di contorno.
Offriamo un'altra abilità utile prima di lasciare questa sezione: la possibilità di selezionare e deselezionare parti del livello report utilizzando i messaggi Selezionare E Deseleziona . Questi due messaggi sono disponibili per ogni tipo di display e possono essere utilizzati per evidenziare una porzione del display. Qui usiamo questi due messaggi per verificare se l'indirizzo di una casella di visualizzazione è corretto prima di cambiare la casella di visualizzazione. Ecco uno snippet da 6_ReportLayer.jsl con ritardi programmati per vedere il processo di selezione:
rpt_bc_ht_onew[TableBox(1)] << Select;
wait(2);
rpt_bc_ht_onew[TableBox(1)] << Deselect;
rpt_bc_ht_onew[TableBox(1)][NumberColBox("Std Dev")] << Select;
wait(2);
rpt_bc_ht_onew[TableBox(1)][NumberColBox("Std Dev")] << Deselect;
L'ultimo paio di Selezionare E Deseleziona dichiarazioni è un'anteprima della navigazione nei report, descritta nella sezione "Navigazione in un report". La posizione della casella di visualizzazione da selezionare può essere individuata iniziando dalla parte superiore del report e quindi spostandosi verso il basso TabellaBox(1) . All'interno del TabellaBox(1) subordinati, troverete il NumberColBox etichettato Sviluppo standard .
La generazione di un report e la ricerca di messaggi validi per gli oggetti della casella di visualizzazione è semplice: utilizzare il file Indice degli script per Casella di visualizzazione . Anche la navigazione in un semplice report può essere semplice. Tuttavia, c'è altro da imparare e la navigazione può diventare complicata quando il report è più complesso o quando l'analisi coinvolge molte colonne Y, X e By. La sezione successiva, "Scripting delle finestre di visualizzazione", consiglia un elenco di letture per affrontare il lungo elenco di finestre di visualizzazione e dei relativi messaggi.
Il contenuto di questo blog è stato condensato da un estratto del nostro libro, JSL Companion: applicazioni del linguaggio di scripting JMP®, seconda edizione , dove troverai ulteriori tecniche ed esempi di utilizzo del linguaggio di scripting JMP.
