Il contesto di scripting

Il modulo modeler.script fornisce il contesto in cui viene eseguito lo script. Il modulo viene importato automaticamente in uno script SPSS® Modeler al runtime. Il modulo definisce quattro funzioni che forniscono uno script con accesso al suo ambiente di esecuzione:

La funzione " session() " restituisce la sessione per lo script. La sessione definisce informazioni quali la locale e il backend SPSS Modeler (un processo locale o un SPSS Modeler Serverin rete) utilizzato per eseguire qualsiasi flusso.
La funzione stream() può essere utilizzata con gli script di flusso e SuperNode . Questa funzione restituisce il flusso che possiede lo script del flusso o lo script del SuperNode in esecuzione.
La funzione " diagram() " può essere utilizzata con gli script " SuperNode ". Questa funzione restituisce il diagramma all'interno dell' SuperNode. Per altri tipi di script, questa funzione restituisce lo stesso della funzione " stream() ".
La funzione " supernode() " può essere utilizzata con gli script " SuperNode ". Questa funzione restituisce il SuperNode che possiede lo script in esecuzione.

Le quattro funzioni e i relativi risultati sono riassunti nella tabella seguente.

Tabella 1. Riepilogo delle `modeler.script` funzioni
Tipo di script	`session()`	`stream()`	`diagram()`	`supernode()`
Autonomo	Restituisce una sessione	Restituisce il flusso gestito corrente nel momento in cui è stato richiamato lo script (ad esempio, il flusso passato tramite l'opzione `-stream` in modalità batch) o `None`.	Come `stream()`	Non applicabile
Flusso	Restituisce una sessione	Restituisce un flusso	Come `stream()`	Non applicabile
SuperNode	Restituisce una sessione	Restituisce un flusso	Restituisce un flusso SuperNode	Restituisce un SuperNode

Il modulo " modeler.script " definisce anche un modo per terminare lo script con un codice di uscita. La funzione exit(exit-code) arresta l'esecuzione dello script e restituisce il codice di uscita intero fornito.

Uno dei metodi definiti per un flusso è runAll(List). Questo metodo esegue tutti i nodi eseguibili. Tutti i modelli o gli output generati dall'esecuzione dei nodi vengono aggiunti all'elenco fornito.

È comune per un'esecuzione di flusso generare output come modelli, grafici e altri output. Per acquisire questo output, uno script può fornire una variabile inizializzata in un elenco. Ad esempio:

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

Al termine dell'esecuzione, è possibile accedere a tutti gli oggetti generati dall'esecuzione dall'elenco " results ".