Konfiguration von SQL-Makros (APIMacro)

In der maniacSeller Schnittstelle haben Sie die Möglichkeit, gezielte Datenbank-Aktionen direkt nach der Anlage von Kunden oder Belegen auszuführen. Diese Funktionen werden über Makros gesteuert, die in der SelectLine-Tabelle APIMacro hinterlegt sind.

1. Funktionsweise

Makros erlauben es, automatisierte SQL-Befehle (z. B. UPDATE oder SELECT) auszuführen, sobald ein bestimmtes Ereignis in der Schnittstelle abgeschlossen wurde.

• Trigger: Nach erfolgreicher Neuanlage eines Datensatzes.

• Datenquelle: Die verfügbaren Makros werden direkt aus der Tabelle APIMacro Ihrer SelectLine-Datenbank ausgelesen.

• Flexibilität: Sie können Werte in Zusatzfeldern setzen, Status ändern oder logische Prüfungen durchführen.

2. Einrichtung in der maniacSeller Oberfläche

Die Zuweisung erfolgt in den Einstellungen der Schnittstelle unter den jeweiligen Fachbereichen:

A. Makro nach Kundenanlage

Wenn ein neuer Kunde (Debitor) aus dem Webshop importiert wird, kann im Anschluss ein Makro ausgeführt werden.

• Pfad: Einstellungen > Bestands- & Neukunden

• Feld: Macro nach Kundenanlage

• Beispiel-Anwendung: Setzen einer speziellen Kundengruppe oder Preisliste basierend auf Shop-Attributen.

B. Makro nach Beleganlage

Nachdem eine Bestellung erfolgreich als Beleg (z. B. Auftrag) in SelectLine angelegt wurde, triggert dieses Makro.

• Pfad: Einstellungen > Belegoptionen

• Feld: Macro nach Beleganlage

• Beispiel-Anwendung: Schreiben eines festen Textes in das Feld FreierText1 (z. B. “Toller Makrotext”) oder Anpassung von Lieferbedingungen.

3. Technische Basis (Tabelle: APIMacro)

Damit ein Makro in der Auswahl erscheint, muss es in der SQL-Tabelle APIMacro definiert sein. Hier ein Einblick in die Struktur:

Beispiel für ein Beleg-Makro (SQL):

UPDATE [BELEG] 
SET FreierText1 = 'Importiert via maniacSeller' 
WHERE [Belegtyp]=:Belegtyp AND [Belegnummer]=:Belegnummer

Hinweis: Die Schnittstelle übergibt automatisch Parameter wie :Belegnummer oder :Nummer (bei Kunden), die im SQL-Statement verwendet werden können.

4. Wichtige Hinweise & Troubleshooting

[!CAUTION]

SQL-Kenntnisse erforderlich: Änderungen in der Tabelle APIMacro wirken sich direkt auf Ihre Datenbank aus. Testen Sie SQL-Statements immer zuerst in einer Testumgebung.

• Makro erscheint nicht? Stellen Sie sicher, dass das Makro korrekt in der Tabelle APIMacro gespeichert wurde und die Schnittstelle Zugriff auf diese Tabelle hat.

• Platzhalter: Verwenden Sie die korrekten Doppelpunkt-Parameter (z.B. :Nummer), damit das Makro den Bezug zum gerade erstellten Datensatz findet.

• Cache: Falls Sie ein neues Makro in SQL angelegt haben, laden Sie die Einstellungen in der Schnittstelle ggf. neu, um die Liste zu aktualisieren.