builtins

describeActionSet

##set_builtins

Description

L'action (issue du module ) est votre petite loupe d'inspecteur privée ! Elle permet d'afficher la description détaillée d'un (un groupe d'actions) défini par l'utilisateur, ou bien d'une action spécifique à l'intérieur de ce groupe. C'est extrêmement pratique pour se rafraîchir la mémoireGemini said

Espace de stockage temporaire (RAM) utilisé par le moteur CAS pour charger et traiter les données à haute vitesse, minimisant les accès disque pour optimiser les performances de SAS Viya.
sur la syntaxe de vos propres actions personnalisées sans avoir à fouiller dans tout votre code source.

Syntaxe Officielle
proc cas;
builtins.describeActionSet result=r status=rc /
action="nom_de_l_action_specifique" /* Optionnel */
actionSet="nom_de_l_action_set"; /* Requis */
run;
quit;

Paramètres Clés

Nom du paramètre Description
action Spécifie le nom de l'action personnalisée précise que vous souhaitez décrire au sein du groupe. Si ce paramètre est omis, SAS affichera la description de toutes les actions contenues dans l'.
actionSet Requis. Spécifie le nom de l' (le groupe d'actions défini par l'utilisateur) que vous voulez inspecter.

Préparation des données

Création d'un Action Set personnalisé pour l'exemple

Avant de pouvoir décrire un %%actionSet%% personnalisé, nous devons bien entendu en créer un ! Voici comment définir un petit groupe d'actions nommé `monSuperActionSet` contenant une seule action `direBonjour` via l'action %%defineActionSet%%.

1PROC CAS;
2 BUILTINS.defineActionSet /
3 name="monSuperActionSet"
4 actions={
5 {
6 name="direBonjour",
7 desc="Une action très polie qui dit bonjour.",
8 parms={
9 {name="prenom", type="string", required=TRUE, desc="Le prénom de la personne à saluer"}
10 },
11 definition="print 'Bonjour ' || prenom;"
12 }
13 };
14RUN;
15QUIT;

Exemples d'utilisation

Description complète de l'Action Set

Ce petit bout de code appelle %%describeActionSet%% en lui passant juste le nom de l'ensemble d'actions. Résultat ? Une radiographie complète de tout ce qu'il contient !

1PROC CAS;
2 BUILTINS.describeActionSet /
3 actionSet="monSuperActionSet";
4RUN;
5QUIT;
Résultat Attendu :
Affiche dans le journal ou les résultats la définition complète de l'Action Set `monSuperActionSet`, incluant la description globale et la liste de toutes ses actions et paramètres associés.
Description d'une action spécifique et récupération des métadonnées

Parfois, on n'a pas envie de tout lire (on vous comprend !). Vous pouvez cibler une action précise avec le paramètre %%action%%. Dans cet exemple, nous stockons également le résultat dans la variable `maDescription` via l'instruction %%result=%% pour pouvoir explorer la structure de la table renvoyée par le serveur.

1PROC CAS;
2 BUILTINS.describeActionSet RESULT=maDescription STATUS=rc /
3 actionSet="monSuperActionSet"
4 ACTION="direBonjour";
5 PRINT "--- Résultat stocké --- ";
6 PRINT maDescription;
7RUN;
8QUIT;
Résultat Attendu :
La sortie se limite strictement à la description de l'action `direBonjour` et de son paramètre `prenom`. Le dictionnaire `maDescription` capture ces métadonnées sous forme de table (dictionnaire CASL) qui peut être réutilisée programmatiquement dans d'autres étapes.