Indenter ses titres et pieds-de-page dans un fichier PDF

Comment couper ses titres et ajouter des indentations dans un fichier PDF avec SAS ? La solution deux petits mots-clés -2n et m précédés d’un symbole défini par vous-même auparavant.

Notez que cette syntaxe fonctionne aussi pour les pieds-de-page.

Si le passage à la ligne fonction avec ODS RTF, l’indentation par contre n’est pas prise en compte.

1. Par défaut un titre est sur une seule ligne

Dans l’exemple qui suit, un titre est donné dans une instruction TITLE.

Ce titre est aligné à gauche (J=L entendez par là justify=left).

Pour faciliter la lecture du programme, le titre est écrit sur plusieurs lignes. Mais au final, tout le texte apparaît sans passage à la ligne.

ods listing close;
title j=l
‘SASHELP.CLASS:’
‘Première Variable: Nom’
‘Seconde Variable: Sex’
‘Troisième Variable: Age’;
ods pdf file=‘C:/sasref/indent_title.pdf’;
proc print data=sashelp.class noobs;
run;
ods pdf close;
ods listing;

2. Passer à la ligne avec ODS ESCAPECHAR et ^-2n

A présent, un passage à la ligne est créé avec le mot -2n.

Pour que SAS n’utilise par ce mot comme un texte devant apparaître dans le titre, ce mot est précédent d’un symbole de son choix (ici un chapeau) défini précédemment avec l’instruction ODS ESCAPECHAR.

ods escapechar=‘^’;
ods listing close;
title j=l
‘SASHELP.CLASS:’
‘^-2nPremière Variable: Nom’
‘^-2nSeconde Variable: Sex’
‘^-2nTroisième Variable: Age’;
ods pdf file=‘C:/sasref/indent_title.pdf’;
proc print data=sashelp.class noobs;
run;
ods pdf close;
ods listing;

3. Passer à la ligne et indenter le titre avec ODS ESCAPECHAR, ^-2n et ^m

A présent, l’encre ^m est ajoutée en4ème position dans la première ligne. Cela veut dire que tout le texte qui suit est indenté et débutera en position 4 sous la lettre H de SASHELP.CLASS.

ods escapechar=‘^’;
ods listing close;
title j=l
‘SAS^mHELP.CLASS:’
‘^-2nPremière Variable: Nom’
‘^-2nSeconde Variable: Sex’
‘^-2nTroisième Variable: Age’;
ods pdf file=‘C:/sasref/indent_title.pdf’;
proc print data=sashelp.class noobs;
run;
ods pdf close;
ods listing;

Lectures complémentaires

• PDF can be Pretty Darn Fancy (SUGI .pdf)
• 9 points pour personnaliser ses titres

Gérer les longs titres (et pieds-de-p4age) insérés dans une feuille de calcul (ODS TAGSETS.EXCELXP)

Aujourd’hui je vous propose quelques options pour travailler l’affichage de longs titres et pieds-de-pages qui sont insérés dans une feuille de calcul. Cela complètera les articles Ajouter les titres et pieds-de-page dans une feuille de calcul (EMBEDDED_TITLES=, EMBEDDED_FOOTNOTES= et l’option ajoutée lors de la mise à jour de l’article SKIP_SPACE=) et Personnaliser l’apparence des titres et des pieds-de-page dans un fichier .xls (ODS TAGSETS.EXCELXP et PROC TEMPLATE).

Je vais continuer à utiliser le style XLS_TITL pour les couleurs, polices, etc. proposé dans le précédent article pour mes captures d’écran.

1. Par défaut, un titre partiellement visible

Lorsqu’un titre est plus long que la largeur fournie par les colonnes du tableau affiché, seule une partie du titre est visible.

2. Une solution valable seulement sur les anciennes versions de TAGSETS.EXCELXP

Une solution est d’utiliser la place disponible par les autres cellules. L’instruction global OPTIONS NOCENTER suffira. Mais cette fonctionnalité ne fonctionne pas avec les dernières mises à jour de TAGSETS.EXCELXP.

3. Agrandir la hauteur de la ligne

Pour agrandir la hauteur de la ligne, il vous faudra utiliser l’option ROWS_HEIGHTS= composée de 7 nombres. Les quatrième et cinquième nombres font respectivement référence à la hauteur des lignes pour les titres et la hauteur des lignes pour les pieds-de-page.

Par défaut, on a: ROWS_HEIGHTS=’0,0,0,0,0,0,0′.

En appliquant cette option à notre exemple, cela donne : ROW_HEIGHTS=’0,0,0,45,40,0,0′.

4. Le code pour l’exemple

ods listing close;
ods tagsets.excelxp file=‘C:/sasref/class.xls’ /*style=xls_titl*/
options(embedded_titles=‘yes’
embedded_footnotes=‘yes’
row_heights=’0,0,0,45,40,0,0′);

title ‘Titre sur 2 lignes’;
footnote ‘Pied-de-page sur 2 lignes’;
ods tagsets.excelxp;

proc report data=sashelp.class nowd;
columns name age;
define name/display ‘Nom’;
define age /display ‘Age’;
run;

ods tagsets.excelxp close;
ods listing;

Lectures complémentaires

• Personnaliser l’apparence des titres et pieds-de-page dans un fichier .xls (ODS TAGSETS.EXCELXP et PROC TEMPLATE)
• Choisir ses couleurs sous SAS
• Ajouter les titres et pieds-de-page dans un fichier .xls
• 9 points pour personnaliser ses titres
• En-tête et pied-de-page avec TAGSETX.EXCELXP (print_header et print_footer)
• Mes premiers pas avec ODS TAGSETX.EXCELXP (1/3)
• Mes premiers pas avec ODS TAGSETX.EXCELXP (2/3)
• Mes premiers pas avec ODS TAGSETS.EXCELXP (3/3)
• Mettre à jour ses TAGSETS pour EXCELXP

Ajouter les titres et pieds-de-page dans la feuille de calcul du fichier .xls

Lors de la création d’un fichier .xls au moyen de la syntaxe ODS TAGSETS.EXCELXP sous SAS, le contenu des instructions TITLE et FOOTNOTE est envoyé respectivement dans l’entête et pied-de-page du fichier. Ils ne sont donc visibles qu’à l’impression.

Pour insérer le contenu des instructions TITLE et FOOTNOTE dans la feuille de calcul, il faudra ajouter deux options dans l’instruction ODS TAGSETX.EXCELXP : EMBEDDED_TITLES etEMBEDDED_FOOTNOTES.

1. Le code

Voici le code pour l’exemple. Vous noterez que j’ai rajouté une instruction ODS… juste après les instructions TITLE et FOOTNOTE. Cela permet à SAS de mettre à jour les titres et pieds-de-page qu’il a en mémoire. Cela sera pratique lorsque vous aurez plusieurs feuilles de calculs avec des titres différents. Autrement, vous pouvez ajouter les instructions TITLE et FOOTNOTES avant la première instruction ODS TAGSETS.EXCELXP.

ods listing close;
ods tagsets.excelxp file=‘C:/sasref/class.xls’
options(embedded_titles=‘yes’
embedded_footnotes=‘yes’);

title ‘Titre’;
footnote ‘Pied’;
ods tagsets.excelxp;

proc report data=sashelp.class nowd;
columns name age;
define name/display ‘Nom’;
define age /display ‘Age’;
run;

ods tagsets.excelxp close;
ods listing;

L’option NOWD est propre à un environnement Windows. Cela évite l’ouverture de la fenêtre REPORT

2. Voir le résultat

3. Enlever les lignes blanches entre les titres/pieds-de-page et la table

Pour empêcher l’insertion d’une ligne entre le(s) titre(s) et la table, le(s) pied(s)-de-page et la table, il faut faire appel à l’option SKIP_SPACE=.

Avant d’aller plus loin, il faut noter que

• la ligne d’espace entre le titre est la table est lié au TITRE et
• la ligne entre la table et le pied-de-page est lié à la TABLE et non au pied-de-page.

Cette option de l’instruction ODS TAGSETS.EXCELXP est composée de 5 nombres.

• Le premier nombre fait référence à la TABLE
• Le 3ème nombre est lié au TITRE
• Le 4ème nombre fait référence au PIED-DE-PAGE.

Par défaut SKIP_SPACE=’1,0,1,1,1′.

Pour ôter les lignes séparant la table des titres et pieds-de-page, on aura : SKIP_SPACE=’0,0,0,1,1′. On enlevera la ligne après la table avec le premier zéro et la ligne après le titre avec le troisième zéro.

A venir

Je vous propose de découvrir dans les deux articles à venir des compléments sur les titres et pieds-de-page avec ODS TAGSETS.EXCELXP :

• Créer un style pour personnaliser les couleurs, polices des titres/pieds-de-page avec un PROC TEMPLATE.
• Utiliser un titre plus grand que la largeur donnée par les colonnes du tableau

Lectures complémentaires

• 9 points pour personnaliser ses titres
• En-tête et pied-de-page avec TAGSETX.EXCELXP (print_header et print_footer)
• Mes premiers pas avec ODS TAGSETX.EXCELXP (1/3)
• Mes premiers pas avec ODS TAGSETX.EXCELXP (2/3)
• Mes premiers pas avec ODS TAGSETS.EXCELXP (3/3)
• Mettre à jour ses TAGSETS pour EXCELXP