SAS/GRAPH : La Macro "Tout-Terrain" pour des Exports PDF Parfaits (Compatible V6 à Viya)

Niveau de difficulté

Débutant

Publié le : 16/12/2025

Le Conseil de l'Expert

Stéphanie
Spécialiste Machine Learning et IA.

Ce script est un modèle d'encapsulation technique pour la production graphique automatisée. L'expert remarquera immédiatement le souci de rétro-compatibilité (le test sur &sysver), prouvant que ce code est conçu pour survivre aux migrations de version. L'intérêt majeur réside dans la centralisation des contraintes physiques (pilotes DEVICE, dimensions HSIZE/VSIZE) au sein d'une macro : cela garantit une uniformité parfaite des documents produits, tout en masquant la complexité des options GOPTIONS (comme GSFMODE ou GACCESS) à l'utilisateur final.

Cette macro configure les options graphiques de SAS^©/GRAPH pour générer des fichiers au format PDF. Elle accepte comme paramètres le nom du fichier de sortie (`fn`), ainsi que la taille horizontale (`hsize`) et verticale (`vsize`) de l'image. La macro gère la détection de la version de SAS^© (`&sysver`) pour ajuster dynamiquement les paramètres `gprolog` et `gaccess`, assurant ainsi une compatibilité inter-versions. Le nom et le répertoire du fichier de sortie sont construits à l'aide des variables globales `gsasfile` et `gsasdir`, ce qui permet une personnalisation du chemin de sauvegarde. Les options graphiques (`goptions`) sont ensuite appliquées pour définir le périphérique de sortie, les modes d'accès et d'écriture, ainsi que le style de texte et les dimensions de l'output.

Analyse des données

Type : CREATION_INTERNE

Ce script est une macro de configuration et ne traite pas directement de données d'entrée pour analyse. Il manipule des paramètres macro et des options système pour préparer l'environnement de génération de sorties graphiques au format PDF. Les noms de fichiers pour la sortie sont construits dynamiquement à partir de paramètres fournis à la macro ou de variables d'environnement.

1 Bloc de code

MACRO %PDF

Explication :
Ce bloc de code définit la macro `%PDF`. Il déclare d'abord des variables macro globales (`gsasfile`, `gsasdir`, `devtyp`) utilisées pour la gestion des fichiers de sortie. À l'intérieur de la macro, le type de périphérique graphique est défini sur 'PDF'. La macro utilise la macro externe `%sasgfile` pour construire le nom de base du fichier graphique. Un chemin complet est ensuite assigné à la fileref `gsasfile`. Une logique conditionnelle basée sur la version du système SAS (`&sysver`) ajuste les paramètres `gprolog` et `gaccess` pour assurer la compatibilité. Enfin, plusieurs instructions `goptions` sont utilisées pour configurer le périphérique graphique, les dimensions de la sortie, la police de texte, le mode d'écriture du fichier et d'autres attributs de la sortie PDF.

Copié !

1	%global gsasfile gsasdir devtyp;
2
3	%macro pdf(
4	fn,
5	hsize=6in,
6	vsize=6in
7	);
8
9	%let devtyp=PDF;
10	%let dev=pdf;
11	%local gprolog gaccess;
12
13	%*-- Get the basename of the graphic file(s);
14	%sasgfile(pdf,&fn);
15
16	%put PDF: gsasfile is: "&gsasdir.&gsasfile";
17	filename gsasfile "&gsasdir.&gsasfile";
18
19	%IF &sysver < 6.08 %THEN %DO;
20	%let gprolog='2521'x;
21	%let gaccess=sasgaedt;
22	%END;
23	%ELSE %DO;
24	%let gprolog=;
25	%let gaccess=gsasfile;
26	%END;
27
28	goptions device=&dev gaccess=&gaccess gsfname=gsasfile gsflen=80
29	hpos=70 vpos=65 /* match pscolor device */
30	gsfmode=append gprolog=&gprolog;
31	goptions lfactor=3;
32	goptions ftext='helvetica';
33	goptions hsize=&hsize vsize=&vsize;
34	%mend;

L'Astuce Pro

L'option gsfmode=append utilisée dans ce code signifie que SAS ajoutera les nouveaux graphiques à la fin du fichier PDF s'il existe déjà, au lieu de l'écraser; pensez donc à inclure une instruction pour supprimer le fichier physique au début de votre programme principal si vous souhaitez générer un rapport vierge à chaque exécution.

Ce matériel est fourni "tel quel" par We Are Cas. Il n'y a aucune garantie, expresse ou implicite, quant à la qualité marchande ou à l'adéquation à un usage particulier concernant le matériel ou le code contenu dans les présentes. We Are Cas n'est pas responsable des erreurs dans ce matériel tel qu'il existe maintenant ou existera, et We Are Cas ne fournit pas de support technique pour celui-ci.

Informations de Copyright : Author: Michael Friendly <friendly@yorku.ca> Created: 5 Dec 1996 14:30:47 Revised: 5 Jan 1997 10:46:34 Version: 1.1

Documentation liée

Aucune documentation spécifique pour cette catégorie.