O contexto de script

O módulo modeler.script fornece o contexto no qual um script é executado. O módulo é importado automaticamente para um SPSS® Modeler script em tempo de execução. O módulo define quatro funções que fornecem um script com acesso ao seu ambiente de execução.

A função session() retorna a sessão para o script. A sessão define informações como a localidade e o SPSS Modeler backend (um processo local ou em rede SPSS Modeler Server ) que está sendo usado para executar quaisquer fluxos.
A função stream() pode ser usada com scripts de fluxo e Supernó. Essa função retorna o fluxo que possui o script de fluxo ou o script de Supernó que está sendo executado.
A função diagram() pode ser usada com scripts de Supernó. Esta função retorna o diagrama no SuperNode. Para outros tipos de script, essa função retorna o mesmo que a função stream().
A função supernode() pode ser usada com scripts de Supernó. Essa função retorna o Supernó que possui o script que está sendo executado.

As quatro funções e suas saídas são resumidas na tabela a seguir.

Tabela 1. Resumo das `modeler.script` funções
Tipo de script	`session()`	`stream()`	`diagram()`	`supernode()`
Autônomo	Retorna uma sessão	Retorna o fluxo gerenciado atual no momento em que o script foi chamado (por exemplo, o fluxo passou via opção de modo em lote `-stream`) ou `None`.	Mesmo que para `stream()`	Não Aplicável
Fluxo	Retorna uma sessão	Retorna um fluxo	Mesmo que para `stream()`	Não Aplicável
SuperNode	Retorna uma sessão	Retorna um fluxo	Retorna um fluxo de Supernó	Retorna um SuperNode

O módulo modeler.script também define uma maneira de finalizar o script com um código de saída. A função exit(exit-code) impede o script de executar e retorna o código de saída de número inteiro fornecido.

Um dos métodos que é definido para um fluxo é runAll(List). Este método executa todos os nós executáveis. Quaisquer modelos ou saídas que são gerados executando os nós são incluídos na lista fornecida.

É comum que um fluxo seja executado para gerar saídas como modelos, gráficos e outras saídas. Para capturar essa saída, um script pode fornecer uma variável que é inicializada para uma lista. Por Exemplo:

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

Quando a execução está completa, quaisquer objetos gerados pela execução podem ser acessados pela lista results.