Wie verwendet man API Makros?
Über die SelectLine API ist es möglich, hinterlegte Makros aufzurufen und auszuführen. Innerhalb dieser Makros können SQL-Statements definiert werden, wie sie aus dem Makro-Assistenten der SelectLine Warenwirtschaft bekannt sind. Das bedeutet, dass die üblichen SQL-Befehle, wie SELECT, UPDATE, INSERT, DELETE oder JOINs verwendet werden können. Zusätzlich können die Statements bei Bedarf auch Parameter enthalten.
Der Aufruf der Makros über die SelectLine API unterliegt keiner Berechtigungsprüfung. Das bedeutet, Makros mit Änderungs- oder Löschaufrufen werden ungehindert ausgeführt. Die Überprüfung von Berechtigungen erfolgt nur bei den durch die SelectLine API bereitgestellten Ressourcen, wie Artikel, Kunde usw.
Anlegen eines Makros in der Datenbank
Zum Anlegen eines Makros muss das SQL-Statement unter einem Namen mit Hilfe eines Datenbank Management Tool (z.B. das Microsoft SQL Server Management Studio) in die Tabelle APIMACRO in der Mandantendatenbank eingepflegt werden.
Name:
SelectArticleByExplicitNumber
Text:
SELECT * FROM [ART] where [Artikelnummer] = :Artikelnummer
Aufrufen eines Makros über die SelectLine API
Der Aufruf eines Makros erfolgt über den Aufruf der Ressource „Macros“ und der Angabe des Makronamens. Bei Bedarf können die Werte für vorhandene Parameter im Body übergeben werden.
Url:
POST http://localhost/Macros/SelectArticleByExplicitNumber
Header:
AUTHORIZATION: LoginId 12345-12345-12345-12345-12345
Body:
[{
'Name': 'Artikelnummer',
'Value': '100001'
}]