WinRobots Windows-Script Online Hilfe

Mit dem Befehl "DBC\..." können Sie ein Hilfsprogramm starten, welches unabhängig vom Remote-Programm operiert und in der Lage ist, selbständig bei Auftauchen von Fenstern der Klasse "#32770" (Dialogfenster, i.d.R. Messages des Systems o.ä.) auf einen der im Fenster vorhandenen Button ("OK", "Ja", "Nein" etc.) zu klicken. Sie können dies für beliebig viele Fenster "vorprogrammieren", indem Sie im Datenteil die Fensterbeschriftung (Titelzeile) und die jeweilige Button-Beschriftung angeben, wobei die Angabe die unter "Suchbegriffe" erläuterten Regeln nutzen kann, d.h. Sie können jeweils zwei Teilstrings benutzen, um eindeutige Angaben zu realisieren.

Da es vorkommen kann, daß mehrere Fenster mit gleichem Titel existieren, die sich nur durch zusätzlichen Text in einem "static"- oder "syslink"-Anzeigefenster unterscheiden, haben Sie die optionale Möglichkeit, noch diesen Text bzw. Teile davon (siehe "Suchbegriffe") als Suchkriterium anzugeben.

Weiterhin kann es vorkommen, daß verschiedene Anwendungen die gleichen Dialogfenster erzeugen (z.B. "Datei öffnen"), aber nur das einer bestimmten Anwendung "behandelt" werden soll. Für solche Fälle können Sie noch eine weitere Präzisierung vornehmen, indem Sie

- entweder eine Prozeß-ID (siehe auch "IEP\", "GPI\") oder

- den Namen einer Exe-Datei bzw. DLL (ohne Pfad, aber mit Endung) angeben.

Dann werden nur diejenigen Fenster "behandelt", deren Prozeß-ID bzw. Erzeugerdatei mit de Vorgaben übereinstimmt. Wenn Sie erreichen wollen, daß die so gekennzeichneten Fenster nicht behandelt werden, setzen Sie ein "!" (Ausrufezeichen) vor die Angabe.

Titelbeschriftung, Buttonbeschriftung, (optional) Static-Beschriftung und (optional) Präzisierung der Prozeßzugehörigkeit werden jeweils durch einen Backslash ("\") getrennt; wenn Sie keine Static-Präzisierung, jedoch eine Prozeß- Präzisierung vornehmen wollen, müssen vor der Prozeß-Präzisierung zwei Backslashs stehen. Die Angaben für die einzelnen Fensterparameter sind durch die Zeichenfolge "<>" zu trennen.

Die Prüfung der Fenster erfolgt in der im Datenteil angegeben Reihenfolge von links nach rechts, und wenn eine Beschreibung zutrifft, wird der Klick ausgeführt und die Suchschleife verlassen. Sie sollten also die Angabe der zu "behandelnden" Fenster nach absteigender Präzisierung sortieren.

Es kann im Zusammenhang mit der Ablaufsteuerung interessant sein zu wissen, wann, wie oft und welches Fenster "behandelt" wurde. Zu diesem Zweck stehen verschiedene Variable zur Verfügung, auf die Sie wie folgt zugreifen können:

$dbw$ = Titel des letzten Fensters,

$dbb$ = Beschriftung des letzten Buttons,

$dbs$ = Beschriftung des letzten Statics/Syslink,

$dbt$ = Zeitpunkt des letzten Klicks (kompatibel mit "GTD\"),

$dbc$ = Zählvariable, die größer 0 (Null) ist, wenn mehrmals hintereinander das gleiche Fenster und der gleiche Button geklickt wurde, ansonsten 0 (Null).

Sie können diese Werte benutzerdefinierten Variablen zur Weiterverarbeitung zuweisen:

VAR\$$bc1=$dbw$

IVV\$$bc1=remote

'...

EVV\

Mit "DBC\vc" können Sie die gespeicherten Werte löschen.

Das Hilfsprogramm läßt sich nur einmal starten. Wenn Sie die Parameter ändern wollen, müssen Sie zuerst mittels "DBC\" das Hilfsprogramm schließen. Ohne diese Maßnahme bleibt das Hilfsprogramm bis zum Ende der Remote-Sitzung aktiv und wird beim Beenden des Remote-Programms ebenfalls beendet.

Sie können aber während des Laufs mit der gleichen Befehlssyntax ein zusätzliches Suchfenster angeben. Dieses wird dann mit in die Liste der "Suchfenster" aufgenommen und als erstes abgeprüft. Bei mehrmaligem Aufruf wird jeweils das vorhergehende überschrieben. Mit "DBC\DT" oder "DBC\dt" löschen Sie das temporäre Fenster wieder.

Mit "DBC\" beenden Sie das Hilfsprogramm gezielt. Beim Beenden des Remote- Programms wird es automatisch beendet.

Beispiele:

DBC\Remote||remedit\ok||Ja<>assist\next||weiter\\!iexplore.exe

DBC\Remote||remedit\ok||Ja\Bitte||Please<>assist\next||weiter\treiber||driver

Der Befehl "WBC\" ist prinzipiell identisch mit "DBC\", erfordert jedoch im Unterschied dazu als ersten Parameter in einer Fensterbeschreibung die Fensterklasse in der bei Suchbefehlen üblichen Form (siehe "Suchbegriffe"). Danach folgen dann - ggf. optional - die weiteren präzisierenden Parameter wie bei "DBC\" beschrieben. Auf diese Weise können auch Button in beliebigen Anwendungen "behandelt" werden.

"WBC\" wertet den Datenteil in gleicher Weise aus wie "DBC\", und auch bei diesem Befehl werden die bei "DBC\" angegebenen Werte in programminternen Variablen gespeichert; der Variablenname unterscheidet sich gegenüber "DBC\" dadurch, daß das "d" nach dem ersten "$"-Zeichen durch ein "w" zu ersetzen ist: $dbw$ -> $wbw$ = Titel des letzten Fensters etc.

Mit "WBC\" beenden Sie das Hilfsprogramm gezielt. Beim Beenden des Remote- Programms wird es automatisch beendet.

Beispiele:

WBC\thunder&&form\Adressen\Beenden

WBC\thunder&&form\adressen\beenden<>#32770\system\cancel

"DBC\" und "WBC\" arbeiten unabhängig voneinander und können parallel eingesetzt werden.

In seltenen Fällen kann es vorkommen, daß ein einzelner Buttonclick aufgrund der aktuellen Konstellation nicht ausreicht, um das gewünschte Ergebnis hervorzurufen, was sich dann auf den Programmablauf negativ auswirkt. Um solche Fälle abzufangen, wurde der Befehl "BCS\" implementiert. Er gestattet es, eine Mausaktivität (Klick) auf das aktuell lokalisierte Kindfenster (i.d.R. ein Button) so lange zu wiederholen, bis entweder das gewünschte Ereignis eingetreten oder eine TimeOut-Zeit abgelaufen ist. Danach wird das Programm fortgesetzt. Dabei kann der Wiederholabstand eingestellt werden:

BCS\Click (Zahl)|Interval (ms)|Bedingung (Zahl)|Timeoutzeit (s)

Click:

1 = "MEL"

2 = "MER"

3 = "MED"

4 = "MLC"

5 = "MRC"

6 = "MDC"

7 = "MLI"

8 = "MRI"

9 = "MDI"

Defaultwert bei fehlender Angabe = 1.

Interval:

Zeitabstand zwischen den Wiederholungen in ms; bei fehlender Angabe greift der Defaultwert von 250 ms; Werte < 100 ms sind nicht zulässig.

Bedingung:

Das Programm wird immer fortgesetzt, wenn das aktuelle Topfenster oder das aktuelle Kindfenster nicht mehr existieren. Darüber hinaus können Sie folgende Bedingungen festlegen:

1 = Kindfenster muß unsichtbar werden,

2 = Kindfenster muß disabled werden oder

4 = Kindfensterbeschriftung muß sich ändern.

Der Wert für "Bedingung" kann eine beliebige Kombination dieser Werte sein; sie gilt dann als erfüllt, wenn eine der angegebenen Änderungen eingetreten ist. Wurde die Bedingung erfüllt, läuft das Programm weiter.

Wenn der Datenteil leer ist oder keine Angabe zur Bedingung vorliegt, gilt diese als erfüllt, wenn eine der o.g. Veränderungen eingetreten ist (Default = 7).

Timeoutzeit:

Zeit in Sekunden, für die maximal die Wiederholung des Mausklicks erfolgt (Defaultwert bei fehlender Angabe = 15). Nach Ablauf dieser Zeit wird das TimeOut-Flag gesetzt, und das Programm läuft weiter. Mit "ITO\" können Sie abfragen, ob ein TimeOut vorlag.

HINWEIS:

Wenn Sie nur einen bestimmten Wert setzen wollen, müssen zumindest alle vorhergehenden Trennzeichen ("|") eingetragen sein. Für die restlichen Werte wird dann die Default-Einstellung wirksam.

Mit dem Befehl "WDC\" können Sie beliebige (Top)Fenster bei ihrem Erscheinen behandeln. Im Datenteil haben Sie die Möglichkeit, sowohl die zu überwachenden Fenster als auch die Art der Behandlung wie folgt zu präzisieren:

Für jedes Fenster müssen Sie Klasse und Beschriftung getrennt durch Backslash angeben wie bei den Suchbefehlen (siehe "Suchbegriffe"). Danach und abgetrennt durch einen Senkrechtstrich können Sie

- ein Kind- oder Enkelfenster angeben, welches im gesuchten Fenster vorhanden und sichtbar sein muß (die Beschreibung erfolgt wieder mittels Klasse und Beschriftung). Anschließend und wiederum abgetrennt durch einen Senkrechtstrich können Sie

- ein Kind- oder Enkelfenster angeben, welches im gesuchten Fenster nicht vorhanden oder zumindest nicht sichtbar sein darf (die Beschreibung erfolgt wieder mittels Klasse und Beschriftung). Schließlich müssen Sie noch - abgetrennt durch Senkrechtstrich

- die Art der Behandlung angeben. Dafür existieren folgende Möglichkeiten:

"c": Fenster schließen (Anwendung beenden),

"h": Fenster verstecken (unsichtbar machen),

"m": Fenster minimieren,

"r": Fenster restaurieren (minimiertes wieder anzeigen),

"s": Fenster wieder anzeigen, wenn unsichtbar,

"n": Fenster wieder anzeigen, aber nicht aktivieren.

Wenn Sie ein Kindfenster nicht angeben wollen oder müssen, tragen Sie nur einen Backslash an der entsprechenden Stelle ein; es müssen aber immer alle Trennzeichen (Senkrechtstriche) vorhanden sein. Es können beliebig viele Fenster angegeben werden; die einzelnen Einträge sind wie bei "DBC\" mittels der Zeichenfolge "<>" zu trennen.

Wie bei "DBC\" werden auch hier bei jeder Aktion bestimmte Parameter zwischengespeichert, auf die Sie wie folgt Zugriff haben:

$wcw$ = Beschreibung des letzten Fenster,

$wcy$ = Beschreibung des "muß"-Kindfensters vom letzten Fenster,

$wcn$ = Beschreibung des "darf nicht"-Kindfensters vom letzten Fenster,

$wct$ = Zeitpunkt des letzten Klicks (kompatibel mit "GTD\").

Mit "WDC\vc" können Sie die gespeicherten Werte löschen.

HINWEIS:

Manchmal werden Kindfenstereigenschaften erst während des Erstellungsprozesses des Elternfensters präzisiert oder geändert. Deshalb kann es notwendig sein, nach der Erkennung eines der Vorgabe entsprechenden Topfensters die Prüfung der Kindfenster zu verzögern, um sicherzustellen, daß diese auch ihre endgültigen Eigenschaften angenommen haben. Das ist möglich, indem Sie am Ende des Datenteils und abgetrennt durch das Zeichen ("^") eine Verzögerungszeit in Millisekunden angeben.

Beispiel:

DVV\1

WDC\notepad\*|edit\*|\|c<>thunder&&form\analyzer!&&process|\|\|c

CAS\1

EXS\notepad

CAS\1

VAR\$$aaa=$wcw$

VAR\$$bbb=$wcy$

VAR\$$ccc=$wcn$

VAR\$$ddd=$wct$

WDC\vc

Mit "WDC\" beenden Sie das Hilfsprogramm gezielt. Beim Beenden des Remote- Programms wird es automatisch beendet.