sessionProp

fmtLibCntlIn

Description

Cette action permet de créer une bibliothèque de formats dans la session CAS active à partir d'une table de contrôle. Cette table doit contenir les informations définissant les formats (noms, plages de valeurs, étiquettes), similaire à la table générée par l'option CNTLOUT de la procédure PROC FORMAT en SAS Base. C'est l'étape clé pour rendre disponibles vos formats personnalisés dans l'environnement distribué CAS.

sessionProp.fmtLibCntlIn / fmtLibName="chaine_de_caracteres" table={name="nom_table", caslib="nom_caslib", where="clause_where"};
Paramètres
ParamètreDescription
fmtLibNameSpécifie le nom de la bibliothèque de formats qui sera créée en mémoire.
tableSpécifie la table d'entrée (table de contrôle) contenant les définitions des formats. Elle supporte les paramètres standards de table CAS (name, caslib, where, etc.).
Préparation des Données Voir la fiche de ce code dataprep
Préparation des données de contrôle

Création d'un format local, exportation vers une table CNTLOUT, puis chargement de cette table dans CAS.

Copié !
1PROC FORMAT;
2 value $pays_fmt 'FR'='France' 'US'='États-Unis' 'DE'='Allemagne';
3 value note_fmt low-<10='Insuffisant' 10-15='Moyen' 15-high='Bon';
4RUN;
5 
6/* Exportation vers une table de contrôle */
7PROC FORMAT cntlout=work.fmt_cntl;
8RUN;
9 
10/* Chargement dans la CASLIB 'casuser' */
11PROC CASUTIL;
12 load DATA=work.fmt_cntl casout="table_formats" outcaslib="casuser" replace;
13RUN;

Exemples

Importe les formats depuis la table CAS 'table_formats' vers une nouvelle bibliothèque 'BiblioPays'.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS;
2 sessionProp.fmtLibCntlIn /
3 fmtLibName="BiblioPays"
4 TABLE={name="table_formats", caslib="casuser"};
5RUN;
Résultat :
La bibliothèque 'BiblioPays' est créée et contient les formats $pays_fmt et note_fmt.

Crée une bibliothèque en ne chargeant que les formats numériques (type 'N') et l'ajoute au chemin de recherche de la session.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS;
2 /* Importation avec filtre WHERE sur la table de contrôle */
3 sessionProp.fmtLibCntlIn /
4 fmtLibName="BiblioNotes"
5 TABLE={name="table_formats", caslib="casuser", where="type='N'"};
6 
7 /* Ajout de la bibliothèque au chemin de recherche pour utilisation immédiate */
8 sessionProp.setFmtSearch /
9 fmtSearch={"BiblioNotes"};
10
11 /* Vérification du contenu */
12 sessionProp.listFmtLibs;
13RUN;
Résultat :
Seule la bibliothèque 'BiblioNotes' contenant le format 'note_fmt' est créée et active pour la session.

FAQ

Quelle est la fonction principale de l'action fmtLibCntlIn ?
Quel paramètre est requis pour nommer la bibliothèque de formats ?
Existe-t-il une restriction concernant les formats PICTURE ?
Comment définit-on la table d'entrée contenant les informations de format ?
À quel ensemble d'actions (Action Set) appartient l'action fmtLibCntlIn ?