Chaque plate-forme JMP génère un affichage unique, mais il existe des fonctionnalités et des objets communs dans la mise en page du rapport. La fonction la plus connue d'un rapport JMP est la zone de contour. La plupart des utilisateurs de JMP ont probablement modifié le titre d'une zone de contour ou activé le bouton pour afficher ou masquer les graphiques et les analyses appartenant à cette zone de contour.
L'étape suivante consiste à apprendre les équivalents JSL de ces tâches d'interface utilisateur, comme changer le titre de la boîte de contour ou basculer l'icône de divulgation ◢.
Deux compétences spécifiques sont requises pour modifier la couche de rapport. L'une consiste à utiliser les messages JSL valides et la syntaxe appropriée pour la fonction d'affichage ciblée. L'autre consiste à trouver l'adresse de la fonction à modifier. Nous appelons cette dernière compétence la navigation.
Afficher l'arborescence
La navigation commence presque toujours par une carte. Exécutez le script suivant pour générer un rapport. Ensuite, faites un clic droit sur l'icône de divulgation ◢ situé à gauche de la zone de contour intitulée "Analyse à sens unique de la taille par sexe". Sélectionner Édition ► Afficher l'arborescence . (Voir Figure 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 )
);
Figure 6.5 Menu Edition—Afficher l'arborescence : (L) Rapport entier (R) Axe Y
L'arborescence s'affiche dans une nouvelle fenêtre. Il s'agit d'une liste imbriquée et hiérarchique (oui, une liste) de zones de contour, où chaque zone de contour représente une zone d'affichage JMP utilisée dans le rapport. Étant donné que le bouton de révélation le plus élevé a été sélectionné, l'arborescence de l'ensemble du rapport s'affiche. Vous devez faire défiler vers le bas pour voir l'arborescence complète. La figure 6.6 (L) affiche cette structure arborescente après un clic droit sur le bouton de révélation supérieur, en sélectionnant Tout fermer ci-dessous , puis en ouvrant sélectivement quelques éléments.
Figure 6.6 Arborescence : rapport lié avec FrameBox(1) en surbrillance
Alignez la fenêtre arborescente et le rapport à sens unique. Passez votre souris sur le bouton de révélation pour Boîte de cadre(1) et voir l'affichage correspondant mis en surbrillance dans le rapport à sens unique. Voir Figure 6.6 (R). Notez la liste des SiBox( ) éléments dans l'arborescence. Passez la souris sur chaque icône de révélation. SiBox(1) contient le contour de la partie graphique de l'affichage. SiBox(4) correspond à la Moyennes et écarts types tableau. Le SiBox container affiche ou masque son contenu en fonction des options de l'objet : si l'option booléenne est spécifiée, display ; sinon, cachez-vous.
Chaque icône de divulgation dans la fenêtre de rapport a la même interface utilisateur. Cela permet à l'utilisateur d'afficher l'arborescence pour une plus petite partie de la fenêtre de rapport. La Figure 6.5 (R) montre qu'un clic droit sur une fonctionnalité de la fenêtre de rapport comme l'axe Y affiche un menu ( Édition ► Afficher l'arborescence) . En d'autres termes, l'arborescence peut être demandée pour plus que des boîtes de contour.
Fermez l'arborescence pour l'ensemble du rapport. Faites un clic droit sur le bouton de révélation à gauche de la zone de contour intitulée "Moyennes et écarts types" et créez la structure arborescente. Répétez les mêmes étapes, mais cette fois maintenez la touche SHIFT enfoncée tout en sélectionnant Afficher l'arborescence . Voir Figure 6.7.
Figure 6.7 Arborescence des moyennes d'analyse à sens unique et des écarts types - Format interactif par défaut (L) Format classique (R)
Les deux formats d'arborescence affichent les objets utilisés pour organiser la sortie. Chaque objet a le mot « box » dans son nom (par exemple, OutlineBox, TableBox, StringColBox et NumberColBox). Pour les deux formats, la disposition des objets est une structure hiérarchique imbriquée. L'arborescence interactive par défaut (L) rappelle un contour. Le format classique (R) rappelle un organigramme (organigramme).
La mise en surbrillance interactive de l'arborescence par défaut est utile pour faire correspondre le rapport à ses boîtes d'affichage de composants. Cependant, c'est long et il peut être difficile de discerner la structure de base jusqu'à ce que les icônes de divulgation stratégiquement sélectionnées soient fermées. L'utilisation de l'arborescence de format classique peut faciliter la visualisation des relations entre les objets dans le rapport. Par exemple, la relation entre NumberColBox(6) et TableBox(1) est immédiate dans cet organigramme comme l'affichage.
Les deux formats sont informatifs. Parfois, nous regardons les deux. Quel que soit le format, l'arborescence d'une partie du rapport sera plus facile à lire que l'arborescence de l'ensemble du rapport.
Référencer la couche de rapport
Une modification de la couche d'analyse nécessite qu'un message valide soit envoyé à l'objet de plate-forme ou à l'objet de référence pour cette plate-forme. Pour l'exemple actuel, la plate-forme est Oneway et son handle est la référence de variable bigclass_ht_onew .
//Message to the Analysis Layer
bigclass_ht_onew << Points Jittered(1);
De même, pour modifier les objets d'affichage, un message valide doit être envoyé à la couche de rapport. Les deux manières d'affecter une référence de variable à la couche de rapport sont les suivantes :
//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;
Pour modifier une fonction d'affichage, le message valide doit être envoyé à l'adresse de l'objet d'affichage. Le Rapport message (ou fonction) renvoie une adresse pour l'objet d'affichage ciblé. Pour les deux exemples précédents, rpt_bc_ht_onew stocke l'adresse de l'affichage Oneway Analysis, la couche de rapport Oneway. Passez en revue les messages de la boîte de contour illustrés à la Figure 6.5 (L). En utilisant l'adresse du rapport, l'imbrication et les adresses des boîtes vues dans l'arborescence, ce prochain ensemble d'instructions devrait être apparent :
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);
Chaque objet d'affichage ( ContourBox , TableBox , ChaîneColBox ) appartient à une classification plus large appelée display box. Le nom ContourBox (ou NombreColBox , etc.) est le nom de classe d'un objet. Une compétence essentielle à apprendre consiste à parcourir l'arborescence, qui est abordée dans la section « Naviguer dans un rapport » de ce chapitre.
JMP facilite la recherche de messages valides pour la plupart des objets de zone d'affichage. Dans l'index de script JMP, sélectionnez Boîte d'affichage ► ContourBox . Tout d'abord, notez les messages qui sont communs avec la liste des options de menu illustrée à la Figure 6.5. Trouver le message Fermer . Sa description indique que ce message a un argument booléen. Regardez les exemples de scripts pour Obtenir le titre et Définir le titre, et exécutez l'instruction JSL suivante :
rpt_bc_ht_onew[OutlineBox(1)] << Set Title("Limit Mousing via JSL");Toutes nos félicitations! Vous venez d'apprendre les équivalents JSL pour révéler ou masquer, et pour changer le titre d'une boîte de contour.
Nous offrons une autre compétence utile avant de quitter cette section : la possibilité de sélectionner et de désélectionner des parties de la couche de rapport à l'aide des messages. Sélectionner et Désélectionner . Ces deux messages sont disponibles pour chaque type de boîte d'affichage et peuvent être utilisés pour mettre en évidence une partie de l'affichage. Ici, nous utilisons ces deux messages pour tester si l'adresse d'une boîte d'affichage est correcte avant de changer la boîte d'affichage. Voici un extrait de 6_ReportLayer.jsl avec des délais scénarisés pour voir le processus de sélection :
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;
La dernière paire de Sélectionner et Désélectionner relevés est un aperçu de la navigation dans le rapport, qui est décrite dans la section « Naviguer dans un rapport ». L'emplacement de la zone d'affichage à sélectionner peut être trouvé en commençant par le haut du rapport, puis en descendant jusqu'à TableBox(1) . Au sein de la TableBox(1) subordonnés, vous trouverez les NombreColBox étiqueté Dév Std .
La génération d'un rapport et la recherche de messages valides pour les objets de zone d'affichage sont simples : utilisez la Index des scripts pour Boîte d'affichage . La navigation dans un rapport simple peut également être simple. Mais il y a plus à apprendre et la navigation peut devenir délicate lorsque le rapport est plus complexe ou lorsque l'analyse implique de nombreuses colonnes Y, X et By. La section suivante, « Display Box Scripting », recommande une liste de lecture pour aborder la longue liste de boîtes d'affichage et leurs messages.
Le contenu de ce blog a été condensé à partir d'un extrait de notre livre, Compagnon JSL : Applications du langage de script JMP®, deuxième édition , où vous trouverez d'autres techniques et exemples d'utilisation du langage de script JMP.
