|
Über den Scripteditor können neue Scripte erstellt oder bestehende SQL-Scripte bearbeitet werden. Um ihn zu starten, legen Sie entweder ein neues SQL-Script für ein Projekt an oder wählen Sie ein bestehendes und klicken Sie dann unter Projektaktionen auf den Schalter Script. Ebenso ist es möglich, auf das SQL-Script doppelzuklicken.
Der Editor besteht aus drei Hauptbereichen: Der Menüleiste mit den verfügbaren Scriptaktionen ganz oben, den Script-Einstellungen darunter und dem Eingabebereich für das Projekt-Script sowie ein optionales Check-Script und allgemeinen Informationen zum Script darunter.
Folgende Funktionen stehen im Scripteditor zur Verfügung:
| • | Anlegen - Anlegen eines neuen SQL-Scripts. |
| • | Löschen - Löscht das aktuelle SQL-Script und setzt alle Eingabefelder zurück. |
| • | Kopieren - Kopiert das ausgewählte SQL-Script |
| • | Aus Datei laden - Lädt ein SQL-Script aus einer beliebigen Textdatei. |
| • | In Datei speichern - Speichert das aktuelle SQL-Script als Textdatei. |
| • | Erstes - Wechselt zum ersten Script des Projektes. |
| • | Voriges - Wechselt zum vorigen Script des Projektes. |
| • | Nächstes - Wechselt zum nächsten Script des Projektes. |
| • | Letztes - Wechselt zum letzten Script des Projektes. |
| • | Bearbeiten - Wechselt in den Bearbeiten-Modus. Nur im Bearbeiten-Modus können Änderungen am geöffneten Script vorgenommen werden. |
| • | Abbrechen - Verwirft im Bearbeiten-Modus alle seit dem letzten Speichern gemachten Änderungen. |
| • | Speichern - Speichert im Bearbeiten-Modus alle gemachten Änderungen. |
| • | Speichern und Schließen - Schließt den Scripteditor und speichert dabei alle gemachten Änderungen. |
| • | Schließen - Schließt den Scripteditor ohne vorheriges Abspeichern. |
| • | Script-Name - Anzeigename des Scripts. Dieser Name wird in der Script-Liste des Projektes sowie während der Ausführung im Universal Converter angezeigt. |
| • | Gruppe - Die Gruppe, zu der das Script gehört. Gruppen dienen der Übersichtlichkeit innerhalb eines Projektes, damit beispielsweise schnell erkennbar ist, in welcher Phase der Übertragung das jeweilige Script ausgeführt wird. Über das Kontextmenü ist es möglich komplette Projektgruppen zu aktivieren oder zu deaktivieren. |
| • | Reihenfolge - Die Nummer im Feld Reihenfolge gibt an, an welcher Stelle das jeweilige Script ausgeführt wird. Die Scripte in einem Projekt werden, beginnend mit der kleinsten Reihenfolge-Nummer, aufsteigend nach Ihrer Reihenfolge-Nummer ausgeführt. Das Script mit der Reihenfolge 201 wird also z.B. vor dem Script mit der Reihenfolge 2000 ausgeführt. |
| • | Aktiviert - Diese Option legt fest, ob das Script aktiviert ist oder nicht. Nicht aktivierte Scripte werden bei der Ausführung des Projektes nicht verwendet. |
| • | Im Fehlerfall Projekt abbrechen - Dieser Schalter legt fest, ob das komplette Projekt abgebrochen werden soll, wenn bei der Ausführung des Scripts ein Fehler auftritt. Ist die Option deaktiviert, dann wird trotz Fehler mit dem nächsten Script im Projekt fortgefahren. |
| • | Fehler auf Zeilenebene ignorieren - Dieser Schalter legt fest, ob im Script nur der fehlerhafte Eintrag übersprungen werden soll und das Projekt weiter durchläuft. |
| • | Quelldatenbank - Datenbank, auf der das Script ausgeführt werden soll. |
| • | Zieldatenbank - Datenbank, in die die Daten transferiert werden. |
| • | Zieltabelle - Tabelle der Zieldatenbank, in die das Script Daten transferiert, sofern vorhanden. Wird nur verwendet, wenn die Option Transfer der Ergebnismenge in Zieltabelle aktiviert ist. |
| • | Transfer der Ergebnismenge in Zieltabelle - Ist diese Option aktiviert, dann werden die über das SQL-Script eingelesenen Daten in die unter Zieltabelle angegebenen Tabelle der Zieldatenbank eingetragen. Nach jeder einzelnen Übertragung eines Datensatzes der Ergebnismenge wird ggf. eine Check-Feld/Check-Wert Eintragung vorgenommen und eventuell das Check-Script ausgeführt. Nur über diese Aktivierung werden auch die Felder Check-Feld und Check-Wert aktiviert. |
| • | Check-Feld - Für jeden erfolgreich gelesenen Datensatz kann ein Eintrag in ein bestimmtes Feld der Quelltabelle eingetragen werden. Das Check-Feld gibt an, um welches Feld es sich hierbei handelt. Die Verwendung des Check-Felds macht nur Sinn in Kombination mit einem angegeben Check-Wert und aktivierter Option Check-Feld verwenden. |
| • | Check-Wert - Der Wert, der in das Check-Feld eingetragen werden soll. |
| • | Check-Feld verwenden - Diese Option legt fest, ob das Check-Feld verwendet werden soll oder nicht. Ist sie aktiv, dann wird für jeden erfolgreich gelesenen Datensatz der Wert aus Check-Wert in das unter Check-Feld angegebene Feld der Quelltabelle eingetragen. Dabei kann es sich beispielsweise um einen Flag für die erfolgreiche Übertragung des jeweiligen Datensatzes handeln.
Verwenden Sie Check-Feld und Check-Wert nur dann, wenn es sich
a. um ISAM-basierte Datenbank handelt oder
b. der verwendete Alias-Feldname des Check-Felds mit dem nativen Feldnamen übereinstimmt und die Quelldatenmenge einen Live-Cursor liefert.
In den meisten Fällen sollte daher ein Check-Script verwendet werden, welches eine entsprechende Update-Anweisung auf den Datensatz ausführt. |
| • | Check-Script verwenden - Das Check-Script hat den selben Zweck wie das Check-Feld, nur dass nicht nur ein einzelner Wert in ein bestimmtes Feld eingetragen wird, sondern für jeden erfolgreich gelesenen Datensatz ein komplettes SQL-Script ausgeführt werden kann. Ist diese Option aktiv, kann das gewünschte Check-Script über den Reiter Check-Script eingegeben werden.
Die Verwendung des Check-Feldes ist gegenüber dem Check-Script eine Vereinfachung für simple Operationen. Insbesondere jedoch, wenn eine oder mehrere der folgenden Bedingungen zutreffen, ist ein Check-Script erforderlich :
a) Die Übergabeoperation erfolgt aus einer mengenorientierten Datenbank heraus und soll dort quittiert werden (in der Regel nur in Verbindung mit Bedingung b).
b) Es wird für das zu aktualisierende Feld ein Alias-Feldname verwendet, der vom originären Feldnamen abweicht.
c) Es ist in der Quelldatenmenge mehr als ein Feld zu aktualisieren
d) Die Quittierung erfolgt in einer anderen Datenmenge als der, die gelesenen wird (z.B. weil die Datenmenge ein View und/oder Read-Only gestellt ist) |
| • | Projekt-Script - Das eigentliche SQL-Script, das ausgeführt werden soll. |
| • | Check-Script - Optionales Check-Feld, siehe Check-Script verwenden. |
| • | Info - Allgemeine Informationen zum Script. Diese dienen interner Zwecke und werden nur im Universal Converter Setup angezeigt. Hier können beispielsweise genauere Information zu Arbeitsweise oder Zweck des Scripts eingegeben werden. |
|