<< Click to Display Table of Contents >> Navigation: Konfigurierung Webinterface > Individuelles Maskenlayout > SQL-API im individuellen Maskenlayout |
SQL-API-Funktionen ermöglichen einen eingeschränkten Zugriff auf die Datenbank über Javascript. Die Logik ist ähnlich wie bei "gespeicherten Prozeduren". Die definierten SQL-API-Funktionen werden vom Javascript aufgerufen. Javascript ruft diese SQL-API-Funktion von namespace "rimacon._userform._sqlapi" auf.
Es gibt fünf mögliche Rückgabewerte:
1.nichts: es wird nichts zurückgegeben
2.2D-Array: erste Dimension ist 0-basierter Index und zweite Dimension ist Spaltenname
3.1D-Array: alle Ergebnisse sind über 0-basierten Index erreichbar
4.Zeichenfolge
5.nichts – asynchron aufgerufen
Beim Nr. 5 wird die Funktion von Javascript auf dem CMDB-Core angestoßen, aber auf das Ergebnis wird nicht gewartet und die Funktion läuft auf dem CMDB-Core als separates thread. Der Rückgabewert kann in den MainForm-Funktionen „checkIsAsyncSQLApiRunning“ und „callFncOnAsyncSQLApiDone“ genutzt werden.
SQL-API können lokal oder global sein.
Die lokalen SQP-API gelten nur in der individuellen Maske.
Die globalen SQP-API werden in der Management Console unabhängig von der konkreten individuellen Maske definiert und müssen in jeder individuellen Maske, die diese nutzen soll, manuell zugeordnet werden.
Option "Verursacht Änderungen in der Datenbank"
Lassen Sie diese Option unchecked, wenn die SQL-API keine Änderungen in der Datenbank verursacht (z.B. nur select). Diese Option ist wichtig für die Performance. SQL-APIs, die evtl. Änderungen in der Datenbank verursachen können, erfordern zusätzliche Schritte.