# Konnektoren

> Die unterstützten Quell- und Zielsysteme: Dynamics 365, Dataverse, NAV und SQL-Datenbanken.

---

Site [llms.txt](/llms.txt)

---

Jedes Quell- oder Zielsystem wird über einen **Konnektor** angebunden. Ein Konnektor
übernimmt die systemspezifische Kommunikation: Authentifizierung, Datenabfrage,
Änderungserkennung und das Schreiben von Datensätzen.

## Unterstützte Konnektoren

| Konnektor | Beschreibung | Lesen | Job-Filter | Schreiben | Status |
|---|---|:---:|:---:|:---:|---|
| [D365BC](d365bc/) | Dynamics 365 Business Central | ✅ | ✅ | ✅ | Freigegeben |
| [D365CE](d365ce/) | Dynamics 365 / Dataverse | ✅ | ✅ | ✅ | Freigegeben |
| [D365NAV](d365nav/) | Microsoft Dynamics NAV | ✅ | ✅ | ✅ | Freigegeben |
| [MSSQL](mssql/) | Microsoft SQL Server | ⚠️ Preview | ✅ | — | Preview |
| [MySQL](mysql/) | MySQL / MariaDB | ⚠️ Preview | — | — | Preview, nicht produktionsreif |
| [Oracle](oracle/) | Oracle Database | ⚠️ Preview | — | — | Preview, nicht produktionsreif |
| [PostgreSQL](pgsql/) | PostgreSQL | ⚠️ Preview | — | — | Preview |
| [OpenAPI](openapi/) | Generische REST-API über OpenAPI-Spezifikation | ✅ | ⚠️ API-abhängig | ✅ (inkl. Löschen) | In Entwicklung |

Die Konnektoren D365BC, D365CE und D365NAV kommunizieren über HTTP/OData-APIs.
MSSQL, MySQL, Oracle und PostgreSQL verwenden direkte Datenbankverbindungen (ADO.NET).
Der OpenAPI-Konnektor kommuniziert ebenfalls über HTTP, leitet Pfade, Wrapper-Schlüssel und
Feldtypen jedoch aus einer OpenAPI-Spezifikation ab, statt sie fest zu verdrahten.

> **Zur Spalte Job-Filter**
>
> Die Spalte gibt an, ob das Feld `Filter` des Jobs vom Konnektor tatsächlich ausgewertet
> wird. Bei **MySQL, Oracle und PostgreSQL** wird der Filter **ignoriert** — diese
> Konnektoren lesen bei jedem Lauf den vollständigen Tabelleninhalt, unabhängig davon, was
> im Job eingetragen ist.
> 
> Bei D365CE erfolgt die Auswertung nicht im Quellsystem, sondern clientseitig nach dem
> Abruf. Siehe [Jobs → Filter-Syntax](../konfiguration/jobs/).



---

## Schreiben in SQL-Systeme

Keiner der vier SQL-Konnektoren unterstützt das Schreiben. Ein SQL-System als
`TargetConnection` führt zur Laufzeit zu einem Abbruch. Die SQL-Konnektoren sind derzeit
ausschließlich als Quellsystem einsetzbar.

---

## Der OpenAPI-Konnektor

Der [OpenAPI-Konnektor](openapi/) unterscheidet sich grundlegend von den übrigen HTTP-
Konnektoren: Er ist nicht auf ein bestimmtes System zugeschnitten, sondern bindet
**beliebige REST-APIs** an, für die eine OpenAPI-Spezifikation vorliegt. Pfade,
Wrapper-Schlüssel und Feldtypen werden zur Laufzeit aus der Spezifikation aufgelöst, statt
je System hartcodiert zu sein. Er befindet sich aktuell noch in Entwicklung.

---

## Versionsangaben

Die auf den Konnektor-Seiten genannten Mindestversionen sind **getestete Versionsstände**.
Die DataBridge prüft die Version des angebundenen Systems **nicht** — ältere Stände können
funktionieren, sind aber nicht abgesichert. Bei Fragen zu einer konkreten Version bitte
WYSA kontaktieren.

---

Section pages:

- [D365BC — Business Central](/docs/konnektoren/d365bc/): Konnektor für Microsoft Dynamics 365 Business Central. Unterstützt Lesen und Schreiben über OData v4.
- [D365CE — Dataverse / Customer Engagement](/docs/konnektoren/d365ce/): Konnektor für Microsoft Dataverse und Dynamics 365 Customer Engagement. Unterstützt Lesen und Schreiben.
- [D365NAV — Microsoft Dynamics NAV](/docs/konnektoren/d365nav/): Konnektor für Microsoft Dynamics NAV. Unterstützt Lesen und Schreiben über OData.
- [MSSQL — Microsoft SQL Server](/docs/konnektoren/mssql/): Konnektor für Microsoft SQL Server. Lesen wird unterstützt — Schreiben nicht.
- [MySQL — MySQL / MariaDB](/docs/konnektoren/mysql/): Konnektor für MySQL und MariaDB. Preview — derzeit nicht für den produktiven Einsatz geeignet.
- [Oracle — Oracle Database](/docs/konnektoren/oracle/): Konnektor für Oracle Database. Preview — derzeit nicht für den produktiven Einsatz geeignet.
- [PostgreSQL](/docs/konnektoren/pgsql/): Konnektor für PostgreSQL. Preview — Lesen mit Filterunterstützung, Schreiben nicht unterstützt.
- [OpenAPI — generischer REST-Konnektor](/docs/konnektoren/openapi/): Generischer REST-Konnektor, der Endpunkte, Wrapper-Schlüssel und Datentypen direkt aus einer OpenAPI-Spezifikation ableitet.