<update-variable>

Semantik

Das <update-variable>-Element ermöglicht es, Variablen anzulegen und zu ändern. Variablen sind Objekte im Speicher, die einen Namen und einen zugehörigen Wert haben. Existiert bereits eine Variable mit dem angegebenen Namen wird ihr Wert auf den neuen Wert geändert, existiert die Variable noch nicht, wird sie neu angelegt. Mit <update-variable> können auch bestimmte RCML-Variablen, die durch das System angelegt wurden, geändert werden (z.B. "return-code"). Mit <update-variable> deklarierte Variablen sind außerdem im Auftrags-System verfügbar, weshalb sich <update-variable> auch zum Informations- und Variablenaustausch mit dem Auftrags-System einsetzen lässt (siehe auch How-To - Variablenaustausch mit Auftrags-Systemen). Es besteht allerdings keine Garantie dafür, dass das Auftrags-System die Variablen nicht verwirft.

Attribute

Attributname	Datentyp	Beschreibung	Mögliche Werte	Standardwert	Obligatorisch?
name	STRING	Der Name der Variable, die geändert oder neu angelegt werden soll.	beliebige, regelkonforme Zeichenkette.	—
value	STRING	Der (neue) Wert der Variable.	beliebige, regelkonforme Zeichenkette.	—

Subelemente / Inhalt

Das <update-variable>-Element besitzt keine Subelemente und kann keinen Inhalt enthalten.

Variablenbindungen

Das <update-variable>-Element besitzt keine Variablenbindungen.

Beispiel

Im folgenden Beispiel wird per <update-variable> eine Variable "myvar" mit dem Inhalt "hello!" angelegt. Der Inhalt der Variable soll nun in <commandline> verwendet werden. Dazu muss sie zuvor mit <param> verfügbar gemacht werden (dies gilt nur für <exec>-Container). Deshalb wird in Zeile 11 dem Parameter "myparam" der Wert von myvar zugewiesen und in Zeile 13 per Befehl ausgegeben. Das Beispiel verwendet außerdem das <workdir>-Element.

<rcml>	
	<process id="ExampleProcess" name="example process">
 
		<workdir id="workdir" home="./WORK" />
 
		<!-- Variable mit Wert "hello!" anlegen -->
		<update-variable name="myvar" value="hello!" />
 
		<exec id="ExampleExec" workdir="workdir">
			<!-- Parameter mit Wert von myvar anlegen -->
			<param name="myparam" value="${myvar}" />
			<!-- Ausgeben. -->
			<commandline processor="velocity">cmd echo $myparam</commandline>
		</exec>
 
	</process>
</rcml>