Description
L'action `addFmtLib` est une action de la catégorie 'Session Properties' dans SAS Viya. Elle permet d'ajouter une bibliothèque de formats définie par l'utilisateur à la session CAS active. Cette bibliothèque peut être vide et créée à la volée, ou provenir d'une table de contrôle de formats (créée par PROC FORMAT) préalablement chargée dans CAS. Une fois ajoutée, les formats de cette bibliothèque peuvent être utilisés pour formater les valeurs des variables dans les tables CAS lors des analyses et des affichages de résultats.
| Paramètre | Description |
|---|---|
| caslib | Spécifie la caslib où réside la table de contrôle de la bibliothèque de formats. |
| fmtLibName | Spécifie le nom à donner à la bibliothèque de formats dans la session CAS. Ce nom ne doit pas dépasser 63 caractères. |
| fmtSearch | Définit comment la nouvelle bibliothèque de formats est ajoutée à la liste de recherche de formats de la session (APPEND, INSERT, NONE, REPLACE). La valeur par défaut est APPEND. |
| name | Spécifie le nom de la table de contrôle de formats (avec ou without l'extension .sashdat) au sein de la caslib spécifiée. |
| path | Spécifie le chemin d'accès complet à un fichier de bibliothèque de formats (par exemple, un fichier .sashdat) sur le nœud de contrôle du serveur CAS. |
| promote | Si défini sur TRUE, la bibliothèque de formats est promue à une portée globale, la rendant accessible à toutes les sessions CAS. Une autorisation d'administrateur peut être requise. |
| replace | Si défini sur TRUE, une bibliothèque de formats existante portant le même nom est remplacée par la nouvelle. |
Création d'une table de contrôle de formats
Avant d'utiliser `addFmtLib` avec des formats existants, il faut d'abord créer une bibliothèque de formats avec `PROC FORMAT` et la sauvegarder dans une table de contrôle. Cette table sera ensuite chargée dans CAS.
| 1 | LIBNAME mycas cas; |
| 2 | PROC FORMAT cntlout=work.myformatcontrol; |
| 3 | value $gender 'M'='Masculin' 'F'='Féminin'; |
| 4 | value agefmt 1-25='Jeune' 26-50='Adulte' 51-100='Senior'; |
| 5 | RUN; |
| 6 | PROC CASUTIL; |
| 7 | load DATA=work.myformatcontrol casout={name='myformatcontrol', caslib='casuser', replace=true}; |
| 8 | RUN; |
Exemples
Cet exemple montre comment ajouter une nouvelle bibliothèque de formats vide nommée 'MaNouvelleFmtLib' à la session CAS. Cela peut être utile pour y ajouter des formats individuellement par la suite.
| 1 | |
| 2 | PROC CAS; |
| 3 | sessionprop.addFmtLib / fmtLibName='MaNouvelleFmtLib'; |
| 4 | |
| 5 | RUN; |
| 6 |
L'action ajoute une bibliothèque de formats vide nommée 'MaNouvelleFmtLib' à la session CAS. Une note dans le journal confirmera le succès de l'opération, et la nouvelle bibliothèque sera visible en utilisant l'action `listFmtLibs`.
Cet exemple complet montre comment utiliser la table de contrôle de formats 'myformatcontrol' (créée dans la section 'Création de données') pour ajouter une bibliothèque de formats nommée 'MesFormatsGlobaux' à la session CAS. L'option `replace=true` assure que toute bibliothèque existante du même nom est écrasée, et `promote=true` la rend disponible pour toutes les sessions.
| 1 | |
| 2 | PROC CAS; |
| 3 | sessionprop.addFmtLib / caslib='casuser' name='myformatcontrol' fmtLibName='MesFormatsGlobaux' replace=true promote=true; |
| 4 | |
| 5 | RUN; |
| 6 |
La bibliothèque de formats 'MesFormatsGlobaux' est ajoutée à la session CAS et promue en portée globale. Les formats '$gender.' et 'agefmt.' sont maintenant disponibles pour être utilisés dans les analyses sur le serveur CAS. Le journal affichera une confirmation du succès de l'action.
FAQ
Scénarios associés
Cas d'usage
Scénario Standard : Segmentation Client pour une Campagne Marketing
Une équipe marketing souhaite analyser la démographie de ses clients pour une nouvelle campagne. Ils doivent appliquer des formats standards (groupes d'âge, régions, etc.) à leu...
Cas d'usage
Scénario Performance : Gestion d'une Bibliothèque de Formats Globale et Volumineuse
Un laboratoire de recherche doit gérer une bibliothèque de formats très volumineuse contenant des milliers de références croisées. Cette bibliothèque doit être mise à jour régul...
Cas d'usage
Scénario Cas Limite : Gestion des Conflits de Noms et Erreurs Attendues
Dans une grande organisation, plusieurs départements peuvent définir des logiques métier différentes pour les mêmes codes. Ce scénario teste la robustesse de l'action `addFmtLib...