User Management Resource Administrator
macht intensiven Gebrauch von Variablen. Variablen werden als Platzhalter
für aktuelle Werte verwendet. Eine Variable enthält zwei Items:
den
Namen der Variablen
den Wert der Variablen.
Variablennamen werden von %-Zeichen
umschlossen. Diese %-Zeichen sind Teil des Variablennamens. Beispiele
für Variablennamen sind: %FirstName%, %Domain%, %OU%. Der Wert einer Variablen
existiert nicht immer und kann sich im Lauf der Zeit ändern. Im Allgemeinen
wird in Angaben ein Variablenname verwendet, und zur Laufzeit wird der
Name der Variablen wird durch den aktuellen Wert der Variablen ersetzt..
In User Management Resource Administrator
werden Variable verwendet, um Eigenschaften
von Script-Aktionen festzulegen. Weitere Hintergrundinformationen zu Projekten,
Scripten, Aktionen und Eigenschaften finden Sie unter Allgemeines Funktionsprinzip. Hauptsächlich gibt es zwei Gründe, warum der
Wert einer Eigenschaft in einer Variablen festgelegt wird: die Verbindung der Eingabedaten
mit dem Script
und die einfachere
Konfiguration der Eigenschaften von Script-Aktionen.
Eingabedaten mit
dem Script verbinden
Wenn Sie den Wert
einer Spalte der Eingabedaten in einem Script verwenden wollen, müssen
Sie Variable verwenden. In unserem Beispiel enthält die zweite Spalte
der Eingabedaten den Nachnamen der Benutzer, deren Konten angelegt werden
sollen. Für die Script-Aktion Create
user (AD)
wird dem Wert der Eigenschaft SurName die Variable %LastName%
zugeordnet. Danach wird die zweite Spalte mit der Variablen %LastName%
verbunden.
In der abgebildeten
Figur enthalten die Eingabedaten eine Spalte, die mit der Variablen %LastName%
verbunden ist. Das Projektscript enthält die Eigenschaft SurName
in der Script-Aktion Create
user (AD).
Wenn die Variable verwendet wird, erhält die Eigenschaft einen Wert, der
dem Wert in der korrespondierenden Spalte der Eingabedaten entspricht.
Um eine Spalte
mit einer Variablen zu verbinden, clicken Sie mit der rechten Maustaste
auf den Spaltenkopf. Das Popup-Menü zeigt alle verfügbaren Variablen an.
Wählen Sie die
Variable aus. Hiermit verbinden Sie die Spalte mit dieser Variablen. Mit
dieser Methode können Sie Spalten nur mit Variablen verbinden, die von
Eigenschaften des Scriptes verwendet werden. Wenn das Projekt ausgeführt
wird, liest die Anwendung eine Zeile der Eingabedaten und ordnet dem Wert
der angegebenen Variable den Spaltenwert aus der aktuellen Eingabezeile
zu. Alternativ können Sie auch die Projekteigenschaften mit View, Properties öffnen und die Karteikarte
Variables auswählen. Wählen Sie die
betreffende Spalte aus und drücken Sie auf Edit.
Das Fenster
mit den Spalteneigenschaften wird angezeigt.
In diesem Fenster
werden der Spaltenname und die aktuell damit verbundene Variable angezeigt.
Im unteren Teil des Fensters sehen Sie alle Script-Aktionen, in denen
diese Variable verwendet wird. Für jede Aktion werden die Eigenschaft,
die die Variable enthält, und der Wert dieser Eigenschaft angezeigt. Für
die Auswahl einer anderen Variable öffnen Sie die Liste mit den Variablen
und wählen eine Variable aus. Um eine Variable auszuwählen, die nicht
in den Eigenschaften der Script-Aktionen verwendet wird, tragen Sie den
Variablennamen ein.
Konfiguration von
Eigenschaften in Script-Aktionen vereinfachen
Ein anderer Grund
für die Verwendung von Variablen liegt in der Vereinfachung der Konfiguration
von Eigenschaften, wenn der Wert für alle Eingabezeilen derselbe ist,
z.B. bei jeder Ausführung des Scriptes. Es ist gut möglich, dass mehrere
Eigenschaften von Aktionen verschiedener Scripte oder desselben Scriptes
denselben Wert erhalten sollen. Beispiel: der Domänenname kann beim Anlegen
von Benutzerkonten in mehreren Eigenschaften verwendet werden. Wenn der
Domänenname für alle Benutzerkonten auf denselben, konstanten Wert festgelegt
wird, können Sie eine Variable %Domain% verwenden, anstatt denselben
Domänennamen für jede Eigenschaft der Script-Aktion festzulegen. Diese
Variable sollte als Wert für alle Eigenschaften, die diese Angabe verwenden,
festgelegt werden. Am Anfang des Scriptes stehen die Zuordnungen
der Variablen.
Nur hier wird der echte Domänenname angegeben.
Variablen-Sortiment (erweitert)
Für erweiterte Script-Konfigurationen
ist es wichtig, zu wissen, wie und wann Variable eingerichtet und gelöscht
werden. In diesem Teil geben wir Ihnen einige Hintergrundinformationen
zu diesem Thema. In User Management Resource Administrator werden alle
Variablen gelöscht, wenn ein Script ausgeführt ist. Während der Ausführung
eines Scriptes mit mehreren Script-Aktionen existiert ein Sortiment mit Variablen. Ein Sortiment
mit Variablen
ist nichts anderes als eine Versammlung von Variablen. In einem Variablen-Sortiment hat jede Variable einen
Wert. Bevor die erste Script-Aktion ausgeführt wird, werden die Spalten
mit den Variablen verbunden, und das Variablen-Sortiment wird geladen. In einem
einfachen Script wird sich dieses Variablen-Sortiment nicht ändern.
In einer Script-Aktion
können eine oder mehrere der folgenden Änderungen an diesem Variablen-Sortiment auftreten:
Ein
neues Variable-Werte-Paar wird dem Variablen-Sortiment hinzugefügt: Dies geschieht., wenn
die Eigenschaft einer Script-Aktion als Ausgabevariable konfiguriert wird.
Beim Ausführen der Script-Aktion enthält das Variablen-Sortiment jetzt das neue Variable-Werte-Paar.
Dieser Mechanismus wird hauptsächlich dann verwendet, wenn eine Script-Aktion
von einer vorherigen Aktion abhängt. Beispiel: die Aktion Create user (AD) kann automatisch einen
eindeutigen Namen für ein Benutzerkonto erstellen. Dieser Name wird auch
verwendet, wenn ein Home-Verzeichnis für dieses Benutzerkonto
angelegt wird. Weil der Benutzername vorher nicht bekannt ist, wird er
von der Aktion Create
user (AD)
erstellt. Während der Ausführung der Aktion wir derd Wert des Benutzernamens
dem Variablen-Sortiment hinzugefügt. Nachfolgende
Aktionen können dann diese neu eingerichtete Variable verwenden. Um den
Wert einer Eigenschaft als Variable dem Variablen-Sortiment
hinzuzufügen,
öffnen Sie die Eigenschaften und wählen Sie die Karteikarte Output
aus. In User Management Resource Administrator wird dieses Prinzip bei
einer Reihe von Eigenschaften verwendet. Für diese Eigenschaften sind
die Variablen standardmäßig so konfiguriert, dass der Wert in eine Variable
ausgegeben wird.
Tip: Sie können
die Script-Aktion: Log variables (Variablen protokollieren) einfügen, um alle Variablen
eines Satzes
mit Variablen
in das Protokollfenster zu schreiben. Dies kann Ihnen beim Erstellen komplexer
Scripte helfen.