ExecSQL

<< Hilfenavigation einblenden

Home > Handbuch > Entwicklerhilfe > Makro-Referenz OmAPI > ExecSQL

ExecSQL

Verfügbar in diesen Editionen

Makro-Prozedur 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.

Parameter

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.

Rückgabewert

Keiner, die Anweisung wird nach Ausführung durch einen Leerstring ersetzt.

Einschränkung

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

Makro-Referenz

ExecSQLScalar

DBCheckFieldValue

DocumentSearch

DBSearch

DBLocate