Home > Handbuch > Entwicklerhilfe > Makro-Referenz OmAPI > ExecSQL ExecSQL |
SQL-Anweisung ausführen.
Syntax
{ExecSQL:Connection,SQL}
Verwenden Sie ExecSQL mit besonderer Vorsicht. Falsche Anweisungen können ganze Tabellen zerstören! Führen Sie umfangreiche Testläufe mit Kopien der Datenbank durch.
Connection gibt die Datenverbindung an. Verwenden Sie "DocDB" für das Dokumentenarchiv, "CRMDB" für die Kontakt- oder "ApplDB" für die Anwendungsdatenbank.
SQL: auszuführende SQL-Anweisung.
Keiner, die Anweisung wird nach Ausführung durch einen Leerstring ersetzt.
Diese potenziell gefährliche Funktion ist standardmäßig gesperrt.
Beschreibung
Mit der Methode ExecSQL wird eine SQL-Anweisung in der angegebenen Datenbankverbindung ausgeführt.
Sie können Daten editieren (UPDATE), die Tabellenstruktur ändern (ALTER TABLE) und andere SQL-Anweisungen ausführen. Wenn Sie Jokerzeichen verwenden, achten Sie bitte auf den SQL-Standard % und _.
Für SELECT-Anweisungen (Datenabfrage) ist diese Methode nicht vorgesehen. Prüfen Sie, ob alternativ DocumentSearch oder DBSearch genutzt werden kann. Einige systemkritische Funktionen werden abgelehnt, beispielsweise die Bearbeitung archivierter Dokumente.
Beispiele:
Feldwerte ändern:
{ExecSQL:DocDB,UPDATE document SET name="Neuer Name" WHERE name="Alter Name"}
Datensatz hinzufügen:
{ExecSQL:DocDB,INSERT INTO document (name,project) VALUES ("MeinName","MeinProjekt")}
Hinweis: ExecSQL kann Makrovariablen in eine Tabelle schreiben. Die Variablen werden nicht ausgeführt, wenn die Klammern mit Chr definiert sind.
Siehe auch