Auftragsübernahme aus tophandwerk
Mit dieser Funktion übertragen Sie Aufträge aus tophandwerk direkt in venabo. Der Zugriff auf die tophandwerk-Datenbank erfolgt über einen ODBC-Treiber, den Sie zunächst installieren und konfigurieren müssen.
Voraussetzungen
Bevor Sie beginnen, laden Sie den Advantage Database ODBC-Treiber herunter:
https://devzone.advantagedatabase.com/dz/content.aspx?Key=20&Release=19&Product=14&Platform=14
⚠️ Hinweis: Die Middleware benötigt zwingend die 64-bit-Version des Treibers. Während der Installation werden OEM- und ANSI-Zeichensatz abgefragt – stellen Sie beide auf GERMAN ein.
ODBC-Datenquelle einrichten
Schritt 1: ODBC-Treiber installieren
- Laden Sie den Treiber über den obigen Link herunter.
- Starten Sie die Installation und wählen Sie die 64-bit-Variante.
- Stellen Sie OEM- und ANSI-Zeichensatz jeweils auf GERMAN.
- Schließen Sie die Installation ab.
Schritt 2: Neue System-DSN anlegen
- Öffnen Sie unter Windows die ODBC-Datenquellen (64-bit).
- Wechseln Sie auf den Reiter System-DSN und klicken Sie auf Hinzufügen.
- Wählen Sie als Treiber „Advantage StreamLineSQL ODBC“ aus.
- Vergeben Sie im nachfolgenden Dialog den Namen „tkh“.
- Geben Sie den Pfad zur Datei „bss-Mandant“ des entsprechenden Mandanten an.
- Bestätigen Sie die Eingaben.
Middleware-Verbindung anlegen
- Öffnen Sie in venabo den Menüpunkt Verwaltung → Middleware → Verbindungen.
- Klicken Sie auf „Neue Verbindung“.
- Tragen Sie die Verbindungsdaten wie im folgenden Screenshot ein.
💡 Tipp: Das Passwort für die Verbindung lautet in der Regel „sysads“.
- Speichern Sie die Verbindung.
Schema anlegen und SQL-Abfrage hinterlegen
- Öffnen Sie in der Middleware den Menüpunkt „Schema“.
- Klicken Sie auf „Neues Schema“ und nehmen Sie die nachfolgenden Einstellungen vor.
- Hinterlegen Sie im Feld „Query“ die folgende SQL-Abfrage:
Select
dok.NAME AS "id",
replace(isnull(rtrim(adressen.name), 'kein Name'), 'ä', 'ä') AS "name",
replace(isnull(rtrim(BETREFF), 'kein Name'), 'ä', 'ä') AS "description",
trim(NUMMER) AS "reference",
0 AS "target_time",
CASE WHEN STATUS IN (4) THEN 9 ELSE 2 END AS "status_id",
CAST(NULL AS SQL_VARCHAR(5)) AS "parent_id",
0 AS "all_employees",
1 AS "all_activities",
1 AS "all_stamp_devices",
0.0 AS "budget",
'TIME_INPUT' AS "settlement_type"
FROM DOKUMENTE dok
LEFT JOIN adressen ON adressen.ku_nr = kunde
WHERE dok.name IS NOT NULL AND id = '2'
- Speichern Sie das Schema.
- Das Schema steht Ihnen nun für die Verwendung in der Middleware zur Verfügung.
💡 Hinweis: Weitere Informationen zur Einrichtung der Middleware finden Sie im Artikel „Hilfe-Middleware“.
Praxisbeispiel
Szenario: Ein Handwerksbetrieb verwaltet seine Aufträge in tophandwerk und möchte diese automatisch in venabo übernehmen, um Arbeitszeiten direkt den entsprechenden Aufträgen zuzuordnen.
| Schritt | Aktion | Ergebnis |
|---|---|---|
| 1 | ODBC-Treiber installiert, Zeichensatz auf GERMAN gesetzt | Verbindung zur tophandwerk-Datenbank möglich |
| 2 | System-DSN „tkh“ mit Pfad zum Mandanten angelegt | ODBC-Datenquelle steht bereit |
| 3 | Middleware-Verbindung mit Passwort „sysads“ gespeichert | venabo kann auf die Datenquelle zugreifen |
| 4 | Schema mit SQL-Abfrage angelegt | Aufträge werden strukturiert übergeben |
| ✅ Ergebnis | Alle Aufträge aus tophandwerk erscheinen in venabo und können für die Zeiterfassung genutzt werden. | |
Häufige Fragen
Welchen Zeichensatz muss ich bei der Treiberinstallation wählen?
Stellen Sie sowohl den OEM- als auch den ANSI-Zeichensatz auf GERMAN. Andernfalls werden Umlaute in Auftragsnamen und Beschreibungen fehlerhaft übertragen.
Warum muss ich die 64-bit-Version des Treibers installieren?
Die venabo-Middleware läuft als 64-bit-Anwendung und kann nur mit einem 64-bit-ODBC-Treiber kommunizieren. Eine 32-bit-Installation wird nicht erkannt.
Was bedeutet der Status-Wert in der SQL-Abfrage?
Die SQL-Abfrage übersetzt den tophandwerk-Status in venabo-Status-IDs: Status 4 in tophandwerk wird als Status 9 (z. B. abgeschlossen) in venabo übernommen, alle anderen Status erhalten den Wert 2 (z. B. aktiv).
Kann ich mehrere Mandanten aus tophandwerk einbinden?
Ja. Legen Sie für jeden Mandanten eine eigene System-DSN mit einem eindeutigen Namen sowie eine separate Middleware-Verbindung und ein eigenes Schema an.
Zusammenfassung
| Thema | Details |
|---|---|
| ODBC-Treiber | Advantage StreamLineSQL ODBC, 64-bit, Zeichensatz GERMAN |
| System-DSN Name | tkh |
| Standard-Passwort | sysads |
| Datenquelle | Datei „bss-Mandant“ des jeweiligen tophandwerk-Mandanten |
| Abzufrufende Tabelle | DOKUMENTE (JOIN adressen), gefiltert auf Dokumententyp id = ‚2‘ |
| Abschlussaktion | Schema in der Middleware aktivieren → Aufträge werden in venabo übernommen |