eva/3 Application BuilderEntwicklung von eva/3 AnwendungenArbeiten mit MakrosSystembefehle 

Datenbank

Befehl Beschreibung Parameter
ExecuteSQLStatment Führt die angegebene DSQL-Anweisung aus
  • DSQL Dateipfad*: Pfad der DSQL-Anweisung welche ausgeführt werden soll
RefreshTableElement Führt eine Aktualisierung auf ein STableElement aus. Die Daten des STableElement werden neu gelesen, die verbundenen Komponenten werden aktualisiert.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, das zu aktualisieren ist.
  • Name des TableElementes*: Name des zu aktualisierenden STableElement.
NextDataRecord Verschiebt den Cursor des angegebenen STableElement um eine Position weiter. Die Funktion entspricht der Funktion "Nächster Datensatz" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, dass um einen Datensatz weitergeblättert werden soll.
  • Name des TableElementes*: Name des STableElement das einen Datensatz weitergeblättert werden soll.
PreviousDataRecord Verschiebt den Cursor des angegebenen STableElement um eine Position zurück. Die Funktion entspricht der Funktion "Vorheriger Datensatz" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, dass um einen Datensatz zurückgeblättert werden soll.
  • Name des TableElementes*: Name des STableElement das einen Datensatz zurückgeblättert werden soll.
FirstDataRecord Verschiebt den Cursor des angegebenen STableElement auf die erste Position. Die Funktion entspricht der Funktion "Erster Datensatz" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, dass auf den ersten Datensatz positioniert werden soll.
  • Name des TableElementes*: Name des STableElement das auf den ersten Datensatz positioniert werden soll.
LastDataRecord Verschiebt den Cursor des angegebenen STableElement auf die letzte Position. Die Funktion entspricht der Funktion "Letzter Datensatz" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, dass auf den letzten Datensatz positioniert werden soll.
  • Name des TableElementes*: Name des STableElement das auf den letzten Datensatz positioniert werden soll.
DeleteDataRecord Löscht den Datensatz auf den der Cursor des STableElement positioniert ist. Die Funktion entspricht der Funktion "Datensatz löschen" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, dass den zu löschenden Datensatz enthält.
  • Name des TableElementes*: Name des STableElement das den zu löschenden Datensatz enthält.
InsertNewDataRecord Fügt dem STableElement einen neuen Datensatz hinzu. Der Datensatz wird an das Ende des STableElement eingefügt. Die Funktion entspricht der Funktion "Datensatz einfügen" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält, in das der neue Datensatz eingefügt werden soll.
  • Name des TableElementes*: Name des STableElement in das der neue Datensatz eingefügt werden soll.
CommitDataRecord Schreibt Änderungen des Datensatzes fest, auf den der Cursor des STableElement positioniert wurde. Die Funktion entspricht der Funktion "Datensatz speichern" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält.
  • Name des TableElementes*: Name des STableElement in das die Änderungen des aktuellen Datensatzes festgeschrieben werden sollen.
UndoDataRecord Nimmt Änderungen, die am Datensatz vorgenommen wurde, auf den der Cursor des STableElement positioniert wurde, zurück. Die Funktion entspricht der Funktion "Änderungen rückgängig machen" des SNavigator.
  • Name des Formulars*: Name des Formulars, das das STableElement enthält.
  • Name des TableElementes*: Name des STableElement in das die Änderungen des aktuellen Datensatzes rückgängig gemacht werden sollen.
FindRecord Ermöglicht die Suche nach einem Datensatz der den angegebenen Kriterien entspricht. Der Befehl FindRecord erlaubt eine fein parametrisierbare Suche. Wird bei der Suche nur der erste gefundene Datensatz benötigt, so ist die Suchfunktion der Komponente SFormattedField mit den Eigenschaften SearchControlSource und SearchTableSource zu bevorzugen, da diese performanter arbeiten kann.
  • Zielformular*: Das Formular das das zu durchsuchende STableElement enthält.
  • STableElement*: Name des STableElement das durchsucht werden soll.
  • Spaltenname*: Name der Spalte im STableElement, die durchsucht werden soll.
  • Quellformular*: Name des Formulars das die Komponente mit dem Suchbegriff enthält.
  • Suchfeld*: Name der Komponente das den Suchbegriff enthält. Die Komponente kann eine beliebige Komponente sein, die die Methode public String getText() implementiert (Zutreffend für alle eva/3 Standard Text-Komponenten).
  • Vergleichen*: Legt fest, wie die Datensätze mit dem Suchbegriff verglichen werden.
    • Alles: Der gesamte Feldinhalt muß mit dem Suchbegriff übereinstimmen. (Standardwert)
    • Teil: Nur ein Teil des Feldinhaltes muß mit dem Suchbegriff übereinstimmen. Ein Vorkommen der Zeichenkette, auch innerhalb eines Wortes, ist ausreichend.
    • Beginn: Der Feldinhalt muß mit dem Suchbegriff beginnen.
  • Groß-/Kleinschreibung*: Beachtet die Groß-/ Kleinschreibung. Besitzt das Argument den Wert true, so muß der Suchbegriff muß mit dem Feldinhalt in Groß-/Kleinschrift übereinstimmen. Besitzt das Argument den Wert false, so wird Groß-/Kleinschrift nicht berücksichtigt (Standardwert).
  • Suchrichtung*:
    • Alle: Sucht forwärts, bis das Ende der Tabelle erreicht wurde und setzt die Suche anschließend wieder zu beginn der Tabelle fort.
    • Forwärts: Sucht forwärts bis zum Ende der Tabelle. Die Suche wird am Ende der Tabelle beendet.
    • Rückwärts: Sucht rückwärts bis zum Beginn der Tabelle. Die Suche wird am Tabellenanfang beendet.
  • Wie formatiert*: Besitzt das Argument den Wert true, so wird der Suchbegriff so verwendet, wie er in der Suchkomponente dargestellt wird. Besitzt das Argument den Wert false, so wird die mögliche Formatierung nicht berücksichtigt und der Eingabewert für die Suche verwendet (Standardwert).
  • Beginne Suche*:
    • Aktuelle Position: Beginnt mit der Suche an der aktuellen Position. (Standardwert)
    • Beginn: Beginnt mit der Suche immer zu beginn der Tabelle.
    • Ende: Beginnt mit der Suche immer am Ende der Tabelle.
DataFileExport Exportiert die Daten eines STableElement in eine Datei.

Hinweis: Dieser Vorgang kann je nach Datenmenge eine großen Zeitraum in Anspruch nehmen. Die Anwendung ist für den Exportzeitraum blockiert. Durch den Einsatz des Befehls SetCursor mit der Parameter Warten kann dem Benutzer der Wartezustand signalisiert werden. Besonders gut eignet sich hierfür die Verwendung eines Makros, in dem zunächst der Befehl SetCursor aufgerufen wird um ascnhließend des Export mit dem Befehl DataFileExport zu starten. Um den Mauzeiger anschließend wieder freizugeben, ist abschließend der Befehl SetCursor erneut auszuführen.
  • Formularname*: Name des Formulars das das STableElement mit den zu exportierenden Daten enthält.
  • STableElement*: Name des STableElement das die zu exportierenden Daten enthält.
  • Exportformat*: Format in dem die Exportdatei geschrieben werden soll. Unterstützt werden derzeit die folgenden Formate:
    • CSV: Das CSV-Format (Comma Separated Values) gilt als universelles Austauschformat für Datenbestände.
    • Festes CSV: Das Feste CSV-Format entspricht dem CSV-Format mit dem Unterschied, dass anstelle eines Trennzeichens, die Spaltenkennzeichnung durch ein Auffüllen der Datensätze durch Leerezeichen auf eine feste Breite erfolgt.
    • SYLK: Das SYLK-Format (Symbolic Link) eignet sich besonders für den Export zu Tabellenkalkulationen wie Microsoft Excel.
    • HTML: Erstellt eine Webseite, die die Daten in einer HTML-Tabelle darstellt.
    • Static table: Schreibt die Daten im XML-Format für statische Tabellen.
    • OpenXML: Schreibt die Daten im Microsoft® OpenXML-Format für Tabellen.
    • DIF: Schreibt die Daten im Data Interchange Format.
  • Dateiname*: Name inklusive vollständiger Pfadangabe Wohin die Exportdatei geschrieben werden soll. Bestehende Dateien werden überschrieben.
  • Spaltennamen?*: Besitzt diese Eigenschaft den Wert true, so enthält die Exportdatei in der ersten Zeile die Spaltennamen.
  • CSV Trennzeichen: Wird nur verwendet, wenn das Exportformat den Wert CSV enthält. Das eingegebene Zeichen wird als Spaltentrennzeichen verwendet. Wird diesem Parameter kein Zeichen zugewiesen wird das Komma als Trennzeichen verwendet.
  • HTML- od. Worksheetname: Wird nur verwendet, wenn das Exportformat den Wert HTML oder OpenXML enthält. Der Tabellenname definiert den Worksheetnamen oder den Titel der Webseite und wird außerdem als Tabellenüberschrift in Caption-Tags verwendet. Wird dieses Argument nicht gesetzt, so wird der Dateiname der in der Eigenschaft RecordSource des STableElements verwendet.
  • Codepage: Verwendeter Zeichencode für den HTML-Export.
DataFileImport Importiert die Daten aus einer Datei in die Tabelle eines STableElement.
  • Formularname*: Name des Formulars das das STableElement enthält, in das die Daten importiert werden sollen.
  • STableElement*: Name des STableElement in das die Daten importiert werden sollen.
  • Importformat*: Format in dem die zu importierende Datei vorliegt.
    • CSV: Das CSV-Format (Comma Separated Values) gilt als universelles Austauschformat für Datenbestände.
    • Static table: Schreibt die Daten im XML-Format für statische Tabellen.
    • OpenXML: Schreibt die Daten im Microsoft® OpenXML-Format für Tabellen.
  • Dateiname/URL*: Dateiname oder URL zu der zu importierenden Datei.
  • Import ab Zeile: Zeilennummer ab der die Daten importiert werden sollen. Enthält die Importdatei in der ersten Zeile die Spaltennamen, ist der Wert 1 einzutragen.
  • CSV Trennzeichen: Wird nur benötigt, wenn das Exportformat den Wert CSV enthält. Das eingegebene Zeichen wird als Spaltentrennzeichen verwendet. Wird diesem Parameter kein Zeichen zugewiesen wird das Komma als Trennzeichen verwendet.
  • Tabellenname: Enthält eine OpenXML mehrere Worksheets, so ist hier der Name des zu importierenden Worksheets einzutragen.
  • Codepage: Verwendeter Zeichencode für die Import-Datei.
  • Überschreiben: Aktiviert werden vorhandene Datensätze mit denen aus dem Importfile überschrieben. Whichtig hierbei ist eine PrimaryKey-Spalte, da die zu überschreibenden Datensätze sonst nicht eindeutig identifiziert werden können. Neue Datensätze werden an die Tabelle angehängt.
  • Entleere Tabelle: Aktiviert werden vor dem Datenimport zuvor alle Daten aus der Tabelle des STableElement gelöscht.

Mit * gekennzeichnete Parameter sind Pflichtangaben. Alle weiteren Angaben sind optional. Optionale Felder können leer bleiben.