Variable_set - Programmschnittstelle (API)

Variable_set – Variablenmenge zur Übergabe von Parametern

int	variable_set.count()	Anzahl der Variablen

void	variable_set.merge( Variable_set )	Mischt eine andere Variablenmenge ein

String	variable_set.names()	Alle Variablennamen durch Semikolon getrennt

String	variable_set.substitute( String )	Ersetzt $-Variablen in einem String

void	variable_set.set_value( name, value )	Eine Variable
String	variable_set.value( name )

void	variable_set.set_var( name, value )	Eine Variable
String	variable_set.var( name )

void	variable_set.set_xml( String )	`Variable_set` als XML-Dokument
String	variable_set.xml()

Variablenmengen werden gebraucht für die Scheduler-weiten Variablen und Task-Parameter. Eine neue Variablenmenge wird mit Spooler.create_variable_set() angelegt.

Die Großschreibung der Variablennamen ist nicht relevant.

In COM (JavaScript, VBScript, Perl) ist ein Variablenwert ein Variant. Weil die Variablen in der Regel in die Scheduler-Datenbank geschrieben werden, sollten nur nach String konvertierbare Variant-Werte verwendet werden (d.h. es sollten keine Objekte verwendet werden).

In Java ist ein Variablenwert ein String. Wenn die Variable mit COM als Variant gesetzt worden ist, wird beim Lesen der nach String konvertierte Wert zurückgegeben. Null und Empty werden als null zurückgeliefert. Wenn ein Variant-Wert nicht konvertierbar ist, wird eine Exception ausgelöst.

Siehe auch <params> und <sos.spooler.variable_set>.

count

Anzahl der Variablen

int	variable_set.count()

merge

Mischt eine andere Variablenmenge ein

void	variable_set.merge( `Variable_set` )

Gleichnamige Variablen werden überschrieben.

Parameter

Variable_set

names

Alle Variablennamen durch Semikolon getrennt

String

variable_set.names()

Beispiel

Variable_set variable_set = spooler.create_variable_set();
spooler_log.info( "\"" + variable_set.names() + "\"" );    // ==> ""

variable_set.set_var( "variable_1", "edno" );
variable_set.set_var( "variable_2", "dwa" );

spooler_log.info( "\"" + variable_set.names() + "\"" );    // ==> "variable_1;variable_2"

java.util.StringTokenizer t = new java.util.StringTokenizer( variable_set.names(), ";" ); 
while( t.hasMoreTokens() )
{
    String name = t.nextToken();
    spooler_log.info( name + "=" + variable_set.var( name ) );
}

Rückgabe

String

Die Namen aller Variablen durch Semikolon getrennt.

substitute

Ersetzt $-Variablen in einem String

String

variable_set.substitute( String )

Beispiel in javascript

subprocess.start( subprocess.env.substitute( "${MY_HOME}/my_program" ) );

Im Beispiel wird Subprocess.env verwendet.

Referenzen der Form $name und ${name} im String werden durch Variablenwerte ersetzt, siehe auch »Einstellungen, die den Abruf von Umgebungsvariablen mit ${…} erlauben«.

Parameter

String

Rückgabe

String

Die Zeichenkette mit den ersetzten $-Variablen

value

Eine Variable

void	variable_set.set_value( String name, String value )
String	variable_set.value( String name )

Parameter

name
value	`""`, wenn die Variable nicht vorhanden ist.

Rückgabe

String

"", wenn die Variable nicht vorhanden ist.

var

Eine Variable

void	variable_set.set_var( String name, String value )
String	variable_set.var( String name )

Verwenden Sie Variable_set.value, das ist in allen Sprachen verfügbar.

Parameter

name
value	`""`, wenn die Variable nicht vorhanden ist.

Rückgabe

String

"", wenn die Variable nicht vorhanden ist.

xml

Variable_set als XML-Dokument

void	variable_set.set_xml( String )
String	variable_set.xml()

Beispiel in javascript

var variable_set = spooler.create_variable_set();
spooler_log.info( variable_set.xml );   // Liefert <?xml version='1.0'?><sos.spooler.variable_set/>

variable_set.xml= "<?xml version='1.0'?>" +
                  "<params>" +
                      "<param name='nachname' value='Meier'/>" +
                      "<param name='vorname' value='Hans'/>" + 
                  "</params>";
spooler_log.info( variable_set.xml );
spooler_log.info( "nachname=" + variable_set.value( "nachname" ) );
spooler_log.info( "vorname =" + variable_set.value( "vorname" ) );

Siehe <sos.spooler.variable_set>, <params>.

Parameter

String

XML-Dokument als String. Liefert <sos.spooler.variable_set>. Beim Setzen wird der Name des Wurzelelements nicht beachtet, <params> oder <sos.spooler.variable_set> kann übergeben werden.

Rückgabe

String

XML-Dokument als String. Liefert <sos.spooler.variable_set>. Beim Setzen wird der Name des Wurzelelements nicht beachtet, <params> oder <sos.spooler.variable_set> kann übergeben werden.

Software- und Organisations-Service GmbH

Zuletzt geändert von Joacim Zschimmer, 2008-06-03