Comment gérer le remplacement d'un format existant avec l'action addFormat ?

Gouvernance et Sécurité en Production (replace)

Le paramètre replace, lorsqu'il est défini à TRUE (valeur par défaut), permet de remplacer un format existant portant le même nom par la nouvelle définition fournie. Si cette option est à FALSE et qu'un format du même nom existe, l'action échouera, évitant ainsi des modifications involontaires de formats déjà définis.

Exemple de Code Additionnel

proc cas;
/* Connexion à la session CAS et chargement de l'action set */
session casauto;
builtins.loadActionSet / actionSet="format";

/* Tentative d'ajout sécurisée d'un format de production */
/* Si le format NIVEAU_RISQUE existe déjà, l'action échouera proprement */
format.addFormat /
fmtLibName="FormatsEntreprise" /* Librairie globale supposée exister */
fmtName="NIVEAU_RISQUE"
replace=FALSE /* Verrou de sécurité activé */
ranges={
"1 = 'Faible'",
"2 = 'Moyen'",
"3 = 'Élevé'"
};

print "Exécution terminée. Si le format existait, une erreur a été levée pour empêcher l écrasement.";
quit;1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
proc cas;
/* Connexion à la session CAS et chargement de l'action set */
session casauto;
builtins.loadActionSet / actionSet="format";

/* Tentative d'ajout sécurisée d'un format de production */
/* Si le format NIVEAU_RISQUE existe déjà, l'action échouera proprement */
format.addFormat /
fmtLibName="FormatsEntreprise" /* Librairie globale supposée exister */
fmtName="NIVEAU_RISQUE"
replace=FALSE /* Verrou de sécurité activé */
ranges={
"1 = 'Faible'",
"2 = 'Moyen'",
"3 = 'Élevé'"
};

print "Exécution terminée. Si le format existait, une erreur a été levée pour empêcher l écrasement.";
quit;

Cette réponse vous a-t-elle aidé ?

Vos votes aident à améliorer notre base de connaissances.

Exemples pour l'action addFormat

Ajout d'un format simple VALUE

Découvrez cet exemple pour l'action CAS addFormat, qui permet d'instancier dynamiquement un format utilisateur au sein d'une bibliothèque de formats (fmtLibName) rattachée à votre session.

Création d'un format de plages avec l'option MultiLabel

Découvrez cet exemple pour l'action CAS addFormat qui illustre l'implémentation de la fonctionnalité MultiLabel, une capacité avancée du moteur CAS permettant d'assigner une valeur source à plusieurs catégories de sortie simultanément.

Conseil de l'Expert

Si vous développez des scripts de chargement de formats centraux (les formats d'entreprise stockés dans une librairie globale partagée, souvent chargée au démarrage du serveur CAS), basculez impérativement sur replace=FALSE. Cela agira comme un "verrou de sécurité". Si un développeur tente de pousser un format portant le même nom (par exemple STATUT_CLIENT) avec des règles différentes, le code génèrera une erreur au lieu de corrompre silencieusement l'historique de vos données dans SAS Visual Analytics.

Action CAS associée

sessionProp

addFormat