Le contexte de script

Le module d' modeler.script s fournit le contexte dans lequel un script s'exécute. Le module est automatiquement importé dans un script SPSS® Modeler lors de l'exécution. Le module définit quatre fonctions qui fournissent à un script un accès à son environnement d'exécution :

La fonction session() renvoie la session du script. La session définit des informations telles que l'environnement local et le système de back end SPSS Modeler (processus local ou serveur SPSS Modeler Serveren réseau) utilisé pour exécuter des flux.
La fonction « stream() » peut être utilisée avec les scripts «flow» et « SuperNode ». Cette fonction renvoie le flux qui possède soit le script de flux, soit le script d' SuperNode s en cours d'exécution.
La fonction « diagram() » peut être utilisée avec des scripts « SuperNode ». Cette fonction renvoie le diagramme dans l' SuperNode. Pour les autres types de script, cette fonction renvoie la même valeur que la fonction stream() .
La fonction « supernode() » peut être utilisée avec des scripts « SuperNode ». Cette fonction renvoie l' SuperNode e propriétaire du script en cours d'exécution.

Les quatre fonctions et leurs résultats sont résumés dans le tableau suivant.

Tableau 1. Récapitulatif des `modeler.script` fonctions
Type de script	`session()`	`stream()`	`diagram()`	`supernode()`
Autonome	Renvoie une session	Renvoie le flux géré en cours au moment où le script a été invoqué (par exemple, le flux transmis via l'option d' `-stream` s en mode batch), ou `None`.	Identique à `stream()`	Non applicable
Flux	Renvoie une session	Retourne un flux	Identique à `stream()`	Non applicable
SuperNode	Renvoie une session	Retourne un flux	Renvoie un flux d' SuperNode	Renvoie un SuperNode

Le module d' modeler.script s définit également une façon de terminer le script avec un code de sortie. La fonction « exit(exit-code) » arrête l'exécution du script et renvoie le code de sortie entier fourni.

L'une des méthodes définies pour un flux est l' runAll(List). Cette méthode exécute tous les nœuds exécutables. Tous les modèles ou résultats générés par l'exécution des nœuds sont ajoutés à la liste fournie.

Il est courant qu'un flux génère des résultats tels que des modèles, des graphiques et d'autres résultats. Pour capturer cette sortie, un script peut fournir une variable qui est initialisée à une liste. Par exemple :

stream = modeler.script.stream()
results = []
stream.runAll(results)

Lorsque l'exécution est terminée, tous les objets générés par l'exécution sont accessibles à partir de la liste d' results .