9994 Datenmanipulationen über STP-Dateien
Datenmanipulationen können zum einen über das infra-Installationssystem durchgeführt werden und zum anderen in diesem Programm. Vorzüge dieses Programms:
-
Einfache Auswahl der durchzuführenden Datenmanipulation über eine Auswahlliste
-
Die ausgewählte Datenmanipulation (Script-Datei) kann syntaktisch geprüft, bearbeitet oder ausgeführt werden.
-
Gewohnte infra-Umgebung
-
Eingaben in infra-Dialoge möglich
-
Aufruf von infra-Programmen aus dem Script
-
Protokollierung im Protokollfenster
-
Häufig benötigte Datenmanipulationen können durch Erweiterung des Administrationsskripts (im Standard "I06-START.STP") in die Auswahlliste für die Script-Dateien aufgenommen werden.Die Erweiterung kann direkt im Programm erfolgen, indem das Administrationsskript ausgewählt und mit der Schaltfläche [ Skript bearbeiten ] geöffnet wird und weitere "IpsGui_AddScriptFile"-Befehle hinzugefügt werden.Nur selten benutzte Datenmanipulationen können auch über die Schaltfläche [ Suchen ] in die Auswahlliste aufgenommen werden und dann ausgeführt werden.
-
Auswertung von XML-Dateien, zum Beispiel für den Import von Daten (siehe Beispielscript "I06-XML.STP", das aus der XML-Datei "I06-XML.XML" in demselben Verzeichnis Teiledaten ausliest). Im Script muss vor dem Einsatz die Pfadangabe für die XML-Datei überprüft und angepasst werden.
Befehlsvorrat
Es stehen alle Befehle des infra-Installationssystems mit folgenden Ausnahmen zur Verfügung:
-
Die Funktionsart "infraSetupFunktionen" steht hier nicht zur Verfügung.
-
Die Funktionsart "STPFunktionen" muss wie im Header-Script "I06-Header.STP" beschrieben, per Script-Befehl zugänglich gemacht werden.Im Standard ist dies durch Benutzung des Standard-Header-Scripts gewährleistet (siehe Auswahlliste «Header»), ebenso wie die Nutzung der Funktionsart "XML-Funktionen".Damit muss die Funktionalität nicht jedes Mal mühsam in den jeweiligen Scripts verfügbar gemacht werden und auch die Protokolldatei, die Protokollebene usw. wird im Header-Script festgelegt.Das Header-Script wird vor der eigentlichen Datenmanipulation ausgeführt (siehe aber Markierungsfeld «Header benutzen»).
Nachfolgende Befehle sind nur in diesem Programm nutzbar und dienen vor allem der Ausgabe im Protokollbereich. Eine ausführliche Beschreibung steht im Installationshandbuch.
Kurzbeschreibung:
-
IpsGui_WriteProtDer Befehl löscht das Protokollfenster und schreibt einen neuen Text ins Protokollfenster.
-
IpsGui_AppendProtDer Befehl gibt einen weiteren Text ins Protokollfenster aus.
-
IpsGui_RunInfraApplDieser Befehl ruft andere infra-Programme auf.
-
IpsGui_AddScriptFileDie angegebene Script-Datei wird in die Auswahlliste «Aktion» neu aufgenommen.Der Befehl wird im Administrationsskript benutzt, um beim Programmstart die Auswahlliste zu füllen.Zu beachten ist, dass das als letztes im Administrationsskript aufgeführte Script beim Aufruf als erstes in der Auswahlliste angezeigt wird.
-
IpsGui_AddHeaderScriptFileDie angegebene Script-Datei wird in die Auswahlliste «Header» neu aufgenommen.Der Befehl wird im Administrationsskript benutzt, um beim Programmstart die Auswahlliste zu füllen.Zu beachten ist, dass das als letztes im Administrationsskript aufgeführte Script beim Aufruf als erstes in der Auswahlliste angezeigt wird.
-
IpsGui_Dialog.....Befehle zum Starten eines Dialogs und zum Vorbelegen und Auslesen der Dialogfelder.
-
IpsGui_GuiMsgBox, IpsGui_GuiMsgBox_1, IpsGui_GuiMsgBox_2Diese Befehle geben eine Fehlermeldung aus der Meldungsdatei ohne Parameter bzw. mit einem oder zwei Parametern aus.
Hinweise
-
Aufgrund des unterschiedlichen Befehlsvorrats können somit nicht immer dieselben Steuerdateien für das Installationssystem und dieses Programm verwendet werden.Unter anderem können einige Variable, die im infra-Installationssystem vom Basis-Scriptsystem zur Verfügung gestellt werden, nicht genutzt werden, zum Beispiel nlRc oder g_str_Sub_ErrorExit. Auch Variablen, die im Header-Script definiert sind, können im auszuführenden Script nicht benutzt werden.
-
Damit der gewohnte Befehlsvorrat innerhalb der Script-Dateien (Funktionsart "STPFunktionen") zur Verfügung steht, müssen einige Voraussetzungen erfüllt sein, für die nur der geschulte Anwender sorgen kann. Die wesentlichen Befehle stehen im Standard-Header-Script "I06-HEADER.STP".AchtungDas Verzeichnis für die LOG-Datei (Protokolldatei) muss angepasst werden. Bitte in "I06-HEADER.STP" nach "StpPrepareForLog" suchen.
-
Nach Änderungen an der Datenbankbeschreibung (DataDictionary) muss infra:NET im Allgemeinen neu gestartet werden
-
Für die Bearbeitung von Script-Dateien über die Schaltfläche [ Skript bearbeiten ] ist im Standard das Programm "NOTEPAD.EXE" vorgesehen.Bei Bedarf kann diese Einstellung geändert werden, indem das Administrationsskript geändert wird (nach "Notepad" suchen).
|
Beschreibung der Bildschirmfelder
|
Aktion Auswahlliste
Auswahl des Scripts, das ausgeführt, bearbeitet oder syntaktisch geprüft werden soll.
Häufig benötigte Datenmanipulationen können durch Erweiterung des Administrationsskripts (im Standard "I06-START.STP") in die Auswahlliste für die Script-Dateien aufgenommen werden. Die Erweiterung kann direkt im Programm erfolgen, indem das Administrationsskript ausgewählt und mit der Schaltfläche [ Skript bearbeiten ] geöffnet wird und weitere "IpsGui_AddScriptFile"-Befehle hinzugefügt werden.
Nur selten benutzte Datenmanipulationen können temporär über die Schaltfläche [ Suchen ] in die Auswahlliste aufgenommen werden.
Header Auswahlliste
Auswahl des Scripts, das vor dem eigentlichen über die Auswahlliste «Aktion» ausgewählten Script abläuft. Damit wird die Funktionen der Funktionsart "STPFunktionen" verfügbar und die LOG-Datei sowie die Protokollebene usw. werden festgelegt.
Auch die hier ausgewählte Datei kann bearbeitet oder syntaktisch geprüft werden.
Falls für unterschiedliche Aufgaben auch unterschiedliche Header-Scripts benötigt werden, können diese durch die Erweiterung des Administrationsskripts (im Standard "I06-START.STP") in die Auswahlliste für die Script-Dateien aufgenommen werden. Die Erweiterung kann direkt im Programm erfolgen, indem das Administrationsskript ausgewählt und mit der Schaltfläche [ Skript bearbeiten ] geöffnet wird und weitere "IpsGui_AddHeaderScriptFile"-Befehle hinzugefügt werden.
Nur selten benutzte Datenmanipulationen können temporär über die Schaltfläche [ Suchen ] in die Auswahlliste aufgenommen werden.
Header benutzen Markierung
Die Markierung entscheidet darüber, ob das ausgewählte Header-Script aus der Auswahlliste «Header» vor dem eigentlichen über die Auswahlliste «Aktion» ausgewählten Script abläuft. Wird das Feld nicht markiert, so muss gewährleistet sein, dass das auszuführende Script die üblicherweise im Header hinterlegten Vorarbeiten nicht benötigt oder aber selbst erledigt, zum Beispiel die Nutzung von Funktionsart "STPFunktionen" oder die Protokollierung.
Hinweis
Variable, die im Header-Script definiert sind, können im auszuführenden Script nicht benutzt werden.
Protokoll Anzeigebereich
In diesem Bereich werden Texte angezeigt, die beim Ausführen der Script-Dateien mit den Befehlen "IpsGui_WriteProt” und "IpsGui_AppendProt” ausgegeben werden.
|
Beschreibung der Schaltflächen
|
Suchen
Verzeichnis und Script-Datei suchen. Bei Übernahme des Dateinamens aus dem "Öffnen"-Fenster wird die Script-Datei in die Auswahlliste «Aktion» oder «Header» aufgenommen. Der neue Eintrag gilt allerdings nur für die laufende Sitzung. Nach einer Neuanwahl des Programms fehlt der neue Eintrag wieder in der Auswahlliste.
OK
Die ausgewählte Script-Datei wird ausgeführt.
Abbrechen
Das Programm wird beendet.
Syntaxprüfung
Die Syntax der ausgewählten Script-Datei wird geprüft und Fehler werden in einem Meldungsfenster ausgegeben.
Script bearbeiten
Es wird ein Texteditor gestartet und die ausgewählte Script-Datei kann bearbeitet werden. Im Standard ist das Programm "NOTEPAD.EXE" als Texteditor hinterlegt. Bei Bedarf kann diese Einstellung geändert werden, indem das Administrationsskript geändert wird (nach "Notepad" suchen).
