La syntaxe ODS (Output Delivery System) de SAS fait appel à des templates pour définir la mise en forme des tableaux, graphiques à publier. Dans le cas présent, il s’agira de définir un template qui s’appliquera à tous les tableaux générés par un PROC REPORT. Les styles caractérisant les templates sont définis avec la procédure PROC TEMPLATE. Tout d’abord, il s’agit de savoir comment appliquer les styles sans template pour un seul PROC REPORT et ainsi se familiariser avec la syntaxe.
1. Le tableau par défaut
Le programme suivant créé un document RTF (CLASS_V1.RTF) contenant un tableau avec 5 colonnes. Les données proviennent du data set CLASS de la bibliothèque SAS.
ods rtf file = ‘C:/sasreference/class_v1.rtf’;
proc report data=sashelp.class nowd;
columns sex name age height weight;
define sex / display ‘Sexe’;
define name / display ‘Nom’;
define age / display ‘Age’;
define height / display ‘Taille’;
define weight / display ‘Poids’;
run;
ods rtf close;
Le tableau est quadrillé. Les lettres sont alignées à gauche et les chiffres à droite. Le nom des colonnes ont un fond grisé et sont mises en gras. Le tout a une police Times New Roman de taille 10pt.
2. Des styles pour trois destinations différentes
Dans PROC REPORT, on peut ajouter des options au niveau de l’instruction PROC REPORT pour appliquer le résultat à l’intégralité de la table ou dans une instruction DEFINE en particulier pour agir sur une colonne. Il est possible de grouper les deux méthodes. Par exemple, on peut choisir d’avoir des colonnes de trois centimètres partout sauf dans une colonne.
- STYLE(COLUMN) : pour changer les informations au niveau des colonnes, c’est-à-dire les données sans le titre, on ajoutera STYLE(COLUMN)=[…] dans l’instruction DEFINE.
- STYLE(HEADER) : pour modifier les caractéristiques des noms de colonnes, les headers, il faudra utiliser STYLE(HEADERr)=[…]
- STYLE(REPORT) : pour définir les bordures, leur position, couleur et épaisseur, et les espaces entre les cellules, STYLE(REPORT)=[…] est utilisé dans l’instruction PROC REPORT.
3. De multiples options
Les options sont listées dans les crochets, Un espace sert de séparateur entre les options. Voici un aperçu de ces options:
3.1 Agir sur le texte
- FONT_FACE= ou comment définir une police différente de Times : pour changer la police en Arial, on fait appel à FONT_FACE=’Arial’.
- FONT_SIZE= ou comment opter pour une taille de caractères différente de 10pt : pour changer la taille du texte en 12, cela donne FONT_SIZE=12pt.
- FONT_WEIGHT ou comment jongler entre gras et normal : pour mettre en gras, on utilisera FONT_WEIGHT=BOLD. Si au contraire est déjà en gras, et qu’on souhaite le remettre en normal, il faut choisir FONT_WEIGHT=MEDIUM.
- FOREGROUND= ou comment changer la couleur du texte : l’option FOREGROUND= sert à définir la couleur du texte. Ainsi FOREGROUND=DARKBLUE mettra le texte en bleu foncé.
3.2 Agir sur la position du texte
- JUST= ou comment changer l’alignement en largeur du texte dans une cellule : par défaut les lettres sont alignés à gauche et les nombres sont alignés à droite. Pour définir le même alignement partout et ensuite changer ponctuellement si besoin, il y a JUST=. Ainsi, JUST=C (center) centre, JUST=R (right) aligne à droite et JUST=L (left) aligne à gauche.
- VJUST= ou comment changer l’alignement vertical du texte dans une cellule : si le texte d’une case s’étend sur plusieurs lignes, celui des autres cellules est aligné vers le haut. Pour changer l’alignement, on utilise VJUST=BOTTOM.
3.3 Changer la couleur de fond
- STYLE(COLUMN)=[BACKGROUND=…] ou comment changer le fond des cellules contenant les observations.
- STYLE(HEADER)=[BACKGROUND=…] ou comment changer la couleur de fond des titres des colonnes.
- STYLE(REPORT)=[BACKGROUND=… ] ou comment changer l’arrière plan : défini dans STYLE(REPORT), la couleur s’applique à l’arrière du tableau. Si l’espace qui sépare les cellules n’est pas de zéro (CELLSPACING), cette couleur de fond apparaît. Par défaut la couleur noir apparaît entre les cellules. On peut soit changer la couleur pour blanc (BACKGROUND=WHITE) ou réduire l’espace entre les cellules à zéro (CELLSPACING=0).
- CELLWIDTH= ou comment définir la largeur des colonnes : la largeur de toutes les cellules d’une colonne est défini par CELLWIDTH. Cela donne CELLWIDTH=3cm.
3.4 Agir sur les bordures
- BORDERCOLOR= ou comment changer la couleur des bordures
- BORDERWIDTH= ou comment changer la largeur des bordures du cadre (frame).
- FRAME= ou comment décider quels côtés du cadre doivent apparaître : on distingue huit valeurs pour FRAME :
- BOX garde tout le cadre extérieur
- VOID enlève les bords du cadre
- HSIDES (horizontal side) garde les deux côtés horizontaux
- VSIDES (vertical side) garde les deux côtés verticaux
- ABOVE garde la ligne du dessus,
- BELOW garde la ligne du dessous
- LHS (left hand side) garde le côté gauche
- RHS (right hand side) garde le côté droite
- RULES= ou comment décider quelles lignes à l’intérieur du tableau doivent être visible : on a cinq valeurs à disposition pour RULES :
- NONE (none ou aucun) enlève toutes les lignes intérieures
- ROWS (row ou ligne) ne garde que les lignes horizontales
- COLS (column ou colonne) ne garde que les lignes verticales
- GROUP ne garde que la ligne séparant les titres de colonnes, des observations.
Voici donc un schéma récapitulalif des combinaisons de FRAME et RULES lorsque, dans STYLE(REPORT), BACKGROUND=WHITE ou CELLSPACING=0. Pour facilité la lecture, l’effet de FRAME est en noir et celui de RULES est en rouge.
*NB: Cette image contient une erreur : remplacez grps par group.
4. L’effet final avec les options de PROC REPORT
Voici un résumé de l’Exemple ci-dessous :
- Seules les bordures du haut et du bas sont gardées (FRAME=HSIDES), et épaissie (BORDERWIDTH=.2cm) après avoir mis en blanc l’arrière plan du tableau pour qu’il n’apparaisse pas entre les cellules (BACKGROUND=WHITE). On choisi de séparer les titres des valeurs par une ligne (RULES=GROUPS) et de mettre tous les trais en gris (BORDERCOLOR=GRAY).
- Au niveau des titres, la couleur de fond est enlevée (BACKGROUND=WHITE). Une police Arial de 12pt non gras est choisie.
- Enfin au niveau des données, la police est également Arial de taille 12pt. Les colonnes sont de 3 cm de largeur et le texte est aligné à droite.
ods rtf file = ‘C:/sasreference/final_v1.rtf’
style = sasref;
proc report data=sashelp.class nowd
style(report)=[rules = groups
frame = hsides
background = white
/*cellspacing = 0*/
bordercolor = gray
borderwidth = .2cm]
style(header)=[background = white
font_size = 12pt
font_face = ‘Arial’
font_weight = medium]
style(column)=[font_size = 12pt
font_face = ‘Arial‘
cellwidth = 3 cm
just = r];
columns name sex age height weight;
define name / display ‘Nom’;
define sex / display ‘Sexe’;
define age / display ‘Age’;
define height / display ‘Taille’;
define weight / display ‘Poids’;
run;
ods rtf close;
5. Obtenir le même résultat avec un proc template
A présent que vous avez vu les différentes régions sur lesquelles vous pouvez agir et une grande partie des options que vous pouvez changer, voici la syntaxe de PROC TEMPLATE.
Ici, le nouveau template s’appelle SASREF (DEFINE STYLE). Il est basé sur le style par défaut (PARENT=).
proc template;
define style styles.sasref;
parent = styles.default;
/*.à compléter..*/
end;
run;
Vous remarquerez que les informations listées dans REPLACE TABLE sont les mêmes que dans notre précédent ODS(REPORT). Celles listées dans REPLACE HEADER correspondent à celle de ODS(HEADER) et enfin celle de REPLACE DATE sont identiques à ODS(COLUMN).
proc template;
define style styles.sasref;
parent = styles.default;
replace table / rules = groups
frame = hsides
background = white
/*cellspacing = 0*/
bordercolor = gray
borderwidth = .2cm;
replace header / foreground = black
background = white
font_size = 12pt
font_face = ‘Arial’
font_weight = medium;
replace data / background = white
font_size = 12pt
font_face = ‘Arial’
cellwidth = 3 cm
just = r;
end;
run;
Vous noterez en plus l’utilisation de FOREGOUND dans REPLACE HEADER et BACKGROUND dans REPLACE DATA. En effet, si vous appelez le template sans les instructions REPLACE, SAS ajoute un font gris aux données et met les titres en bleu.
A présent, il s’agit de faire référence à ce template dans l’instruction ODS RTF.
ods rtf file = ‘C:/sasreference/class_v1.rtf’
style = sasref;
Avant de terminez, il vous faudra supprimer le template.
proc template;
delete styles.sasref;
run;