Application note_Debug_SUD_DataPlugin_deutsch

Debuggen von DIAdem-Anwenderdialogen (SUD) und
DIAdem-DataPlugins mit dem Microsoft Scripteditor
Allgemeines
Sie können DIAdem-Anwenderdialoge und DIAdem-DataPlugins mit dem Microsoft
Scripteditor debuggen. Das vorliegende Dokument beschreibt die Einstellungen, die
Sie an Ihrem Rechner vornehmen müssen, um den Microsoft Scripteditor zu
verwenden.
Um ein Script zu debuggen, muss dieses Script unverschlüsselt vorliegen. Aus
diesem Grund können Sie beispielsweise Anwenderdialoge mit der
Dateinamenserweiterung .Suc nicht debuggen.
Hinweis:
Das Debuggen von DIAdem-Anwenderdialogen (SUD) und DIAdem-DataPlugins ist
ein „unsupported Feature“.
Sicherheits-Hinweis:
Um DIAdem-Anwenderdialoge und DIAdem-DataPlugins zu debuggen, müssen
Sie möglicherweise Änderungen in der Windows Systemregistrierung
vornehmen. Änderungen in der Windows Systemregistrierung sollten nur von
erfahrenen Anwendern durchgeführt werden, da Fehler dazu führen können,
dass Ihr System nicht mehr stabil arbeitet!
Voraussetzungen
Zum Debuggen benötigen Sie DIAdem ab Version 9.1, Microsoft Windows Script
und einen geeigneten VBS Script-Debugger.
Als VBS Script-Debugger empfehlen wir den Microsoft Scripteditor (Version 10
oder höher) aus dem Microsoft Developement Environment (Version 7.0 oder
höher). Microsoft installiert diese Komponenten normalerweise mit den Microsoft
Office-Produkten, sofern diese VBA unterstützen. Sie können dieses Feature
nachinstallieren, falls es auf Ihrem Rechner nicht vorhanden ist. Weitere
Informationen erhalten Sie in der Hilfe zu den Microsoft Office-Produkten.
Alle Abbildungen und Beschreibung in diesem Dokument wurden mit dem Microsoft
Scripteditor Version 10 (Microsoft Developement Environment 7.0) erstellt und
können in anderen Versionen abweichen.
Tipp:
Um zu prüfen ob das Microsoft Developement Environment richtig installiert wurde,
starten Sie den Microsoft Script Debugger aus Microsoft Word oder einer anderen
Office-Anwendung heraus. Fehlende Komponenten können Sie dann automatisch
nach installieren.
Tipp:
Sie finden den Microsoft Scripteditor auf Ihrer Festplatte unter dem Namen MSE.exe
oder MSE7.exe.
Einstellungen
Aktivieren des JUST IN TIME (JIT) Debuggings im Microsoft Scripteditor
Um Scripte zu debuggen, müssen Sie zuvor das JIT-Debugging aktivieren. Sie
aktivieren das JIT-Debugging im Microsoft Scripteditor, indem Sie unter
Extras»Optionen die Einstellungen Enable Attach und Enable JIT Debugging
aktivieren.
System-weites VBS-Debuggen aktivieren
Ab der Microsoft VBScript Version 5.1 wird dieses Feature standardmäßig nicht mehr
aktiviert. Weitere Informationen dazu finden Sie unter
http://support.microsoft.com/default.aspx?scid=kb;EN-US;252895).
Um dieses Feature zu aktivieren, müssen Sie die Windows Systemregistrierung
überprüfen und den Schlüssel gegebenenfalls neu anlegen.
Sie finden den Schlüssel JITDebug in der Windows Systemregistrierung unter einem
der folgenden Pfade:
HKEY_CURRENT_USER\Software\Microsoft\Windows Script\Settings
oder
HKEY_USERS\.DEFAULT\Software\Microsoft\Windows Script\Settings
Starten Sie zum Ändern der Windows Systemregistrierung den Microsoft Registry
Editor „Regedit.exe“, indem Sie in Windows Start»Ausführen wählen, Regedit.exe
eingeben und den Dialog mit OK verlassen.
Der Schlüssel JITDebug ist ein DWORD-Eintrag. Hat der Eintrag den Wert 1, ist das
JIT aktiviert, hat der Eintrag den Wert 0, ist das JIT deaktiviert. Bitte stellen Sie sicher,
dass dieser Eintrag den Wert 1 enthält. Erzeugen Sie den Pfad und den Schlüssel
manuell, falls diese noch nicht existieren.
Hinweis:
Beachten Sie bitte, dass diese Veränderung in der Windows Systemregistrierung
eine systemweite Einstellung ist. Treten in anderen Programmen, beispielsweise im
Microsoft Internet Explorer, Scriptfehler auf, erscheint automatisch die Abfrage, ob
Sie das Programm debuggen möchten. Sie deaktivieren diese Funktionalität, indem
Sie den Wert für JITDebug wieder auf 0 setzen.
Tipp:
Um zum Umschalten dieses Schalters nicht immer die Windows Systemregistrierung
starten zu müssen, können Sie den Schlüssel auch exportieren. In der Hilfe zum
Microsoft Windows Registrierungseditor erfahren Sie, wie Sie Registrierungseinträge
exportieren. Exportieren Sie den Schlüssel mit dem Wert 0 und anschließend den
Schlüssel mit dem Wert 1. Mit einem Doppelklick auf die jeweilige Datei aktivieren
oder deaktivieren Sie das Feature.
Möglichkeiten zum Debuggen
Definieren von Haltepunkten
Verwenden Sie den Befehl Stop, um ein Script an einer definierten Stelle zu
unterbrechen. Der Scripteditor wird automatisch geöffnet, und Sie können das Script
ab dieser Stelle debuggen.
Beispiel:
Sub Foo()
Dim i
Stop
i = 1+1
End Sub
Beachten Sie, dass der Befehl Stop nur dann ausgewertet wird, wenn das systemweite VBS-Debuggen aktiviert ist.
Hinweis:
Entfernen Sie alle „Stop“-Anweisungen, bevor Sie Ihren Code an Kunden
weitergeben.
Debuggen eines aktiven Scripts
Starten Sie den Microsoft Scripteditor und wählen Sie Debuggen»Prozesse. Der
folgende Dialog erscheint:
Hinweis:
Um den Dialog Prozesse zu starten, müssen Sie den Microsoft Scripteditor direkt
aus dem Explorer heraus starten. Wenn Sie den Microsoft Scripteditor aus einem
Microsoft Office Produkt heraus starten, können Sie die Option, sich an laufende
Prozesse anzuhängen, eventuell nicht verwenden.
Der Dialog Prozesse zeigt die aktiven Prozesse an. Zeigt die Spalte Typ in der Zeile
DIAdem.exe den Eintrag „Win32“ an, können Sie sich nicht an den Prozess
anhängen. Bitte überprüfen Sie dann die Einstellungen aus den obigen Abschnitten.
Wenn die Spalte Typ in der Zeile DIAdem.exe den Eintrag „Win32, Script“ anzeigt,
klicken Sie auf die Schaltfläche Anfügen, wählen im erscheinenden Dialog den
Eintrag Script und verlassen den Dialog mit OK. Schließen Sie anschließend alle
Dialoge.
Der Microsoft Scripteditor zeigt DIAdem als aktives Dokument an. Sie aktivieren das
Fenster mit den aktiven Dokumenten gegebenenfalls über die Debuggen-Toolbar.
Führen Sie nun in DIAdem ein Script in einem Anwenderdialog oder einem
DataPlugin aus, dann erscheint dieser Anwenderdialog oder das DataPlugin als
aktives Dokument unter dem DIAdem-Eintrag in dem Fenster mit den aktiven
Dokumenten.
Hinweis:
Der Microsoft Scripteditor zeigt nur DIAdem-Anwenderdialoge oder DIAdemDataPlugins an. Alle anderen DIAdem-Scripte können Sie nur mit dem DIAdeminternen Debugger debuggen. Wenn Sie doppelt auf das aktive Dokument klicken,
zeigt der Editor den Quellcode des aktiven Dokuments an. Sie können nun auch
Haltepunkte setzen.
Debuggen im Fehlerfall
Wenn Sie das JIT auf Ihrem Rechner aktiviert haben, öffnet sich bei einem Fehler im
Script automatisch ein Dialog, in dem Sie den Microsoft Scripteditor auswählen
können.