Praxiswissen für Einsteiger und Entwickler
Wie gelangen Kreditoren aus Excel zuverlässig nach Microsoft Dynamics 365 Business Central? Dieser Leitfaden erklärt zuerst Datenmigration, Schlüssel und APIs und führt anschließend durch einen SSIS-Datenfluss mit KingswaySoft.
1. Was ist eine Datenmigration?
Bei einer Datenmigration werden nicht nur Spalten kopiert. Quelldaten und Zielsystem verwenden häufig unterschiedliche Feldnamen, Datentypen und Geschäftsregeln. Ein Excel-Feld VendorNo kann im Ziel number heißen; Zahlungsbedingungen können als Code vorliegen, während die jeweilige API eine technische ID erwartet. Eine stabile Migration muss die Datensätze bereinigen, referenzieren, übertragen und anschließend fachlich abstimmen.
2. Was sind SSIS und KingswaySoft?
SQL Server Integration Services (SSIS) ist eine Plattform für ETL-Prozesse: Extract, Transform, Load. Die Quelle kann Excel oder SQL sein, Transformationen bereinigen die Daten und ein Ziel-Adapter schreibt sie weiter. KingswaySoft stellt spezialisierte Konnektoren bereit. Welche Aktionen wie Upsert angeboten werden, hängt von Produktversion, Lizenz und Ziel-Endpunkt ab; prüfe daher die konkrete Komponentendokumentation.
3. Voraussetzungen und Zielsystem prüfen
Benötigt werden Visual Studio mit passender SSIS-Erweiterung, eine kompatible KingswaySoft-Version, eine Business-Central-Testumgebung und eine sicher konfigurierte OAuth-Anbindung. Prüfe außerdem Berechtigungen der Identität auf die Zieltabellen und ob die API-Entität vendors die benötigten Felder anbietet. Die Standard-API kann durch kundenspezifische Erweiterungen ergänzt werden; nicht jedes interne Vendor-Feld ist über die Standard-API verfügbar.
4. Beispiel für die Excel-Tabelle
Beginne mit einer kleinen, kontrollierbaren Testdatei. Wichtig: Postleitzahlen, Telefonnummern und Kreditorennummern sind Zeichenfolgen und dürfen nicht versehentlich als Zahlen eingelesen werden.
VendorNo,Name,PostCode,CountryCode,Email,PaymentTermsCode
V0001,Example Supplies,01234,DE,office@example.test,14D
V0002,Sample Vendor,54321,DE,info@example.test,30D5. Den Datenfluss in Visual Studio aufbauen
Lege ein SSIS-Projekt an und füge im Data Flow eine Excel Source hinzu. Danach folgen Data Conversion für korrekte Typen, Derived Column für normalisierte Werte und gegebenenfalls Lookup-Schritte für Referenzen wie Zahlungsbedingungen. Am Ende steht die KingswaySoft-Business-Central-Destination. Verbinde Fehlerausgänge mit einer Staging-Tabelle oder Fehlerdatei statt fehlerhafte Zeilen still zu überspringen.
6. Stammdaten vor dem Import validieren
Entferne unerlaubte Leerzeichen, prüfe E-Mail-Adressen und Ländercodes, und verhindere leere Pflichtfelder. Verwende nicht einfach einen Platzhalter wie „N/A“ für unbekannte Ländercodes. Entscheide fachlich, ob fehlende Zahlungsbedingungen einen Fehler auslösen oder einen freigegebenen Standardwert bekommen sollen. Halte die originale Kreditorennummer und die bereinigte Nummer getrennt im Fehlerprotokoll fest.
7. Was bedeutet Upsert?
Upsert kombiniert fachlich „Update falls vorhanden“ mit „Insert falls nicht vorhanden“. Dafür brauchst du einen stabilen Schlüssel und eine eindeutige Regel. Die Kreditorennummer ist nur geeignet, wenn ihre Eindeutigkeit über Mandanten und Quelldaten hinweg gesichert ist. Prüfe insbesondere, ob der eingesetzte BC-Endpunkt Updates über die technische Datensatz-ID und ETag erwartet: Ein Upsert anhand eines Geschäftszeichens ist eine Eigenschaft des Integrationswerkzeugs und nicht automatisch eine Standardfunktion jedes REST-Endpunkts.
8. Ein konkretes Mapping
Die Tabelle ordnet Excel-Spalten zu möglichen API-Feldern zu. Die endgültigen Feldnamen musst du gegen das Metadatenschema der tatsächlich verwendeten BC-API prüfen.
| Excel | Business Central API |
|---|---|
| VendorNo | number |
| Name | displayName |
| PaymentTermsCode | paymentTermsId (lookup where supported) |
9. Fehler sauber erfassen
Pro abgewiesener Zeile gehören mindestens Quellzeilennummer, Quelldatei, Kreditorennummer, Fehlerkategorie und eine verständliche Meldung ins Protokoll. Technische 429- oder zeitweilige 5xx-Fehler dürfen begrenzt wiederholt werden; falsche Ländercodes oder ungültige Feldlängen erfordern Datenkorrektur. Wiederholungen dürfen keinen zweiten Kreditor erzeugen.
10. Testlauf und Abgleich
Führe einen ersten Import mit fünf Datensätzen durch: zwei gültige, einen bereits vorhandenen, einen fehlerhaften und einen mit fehlender Referenz. Vergleiche danach die Excel-Anzahl mit erfolgreich neu angelegten, aktualisierten und abgelehnten Datensätzen. Führe dasselbe Paket erneut aus und kontrolliere, dass keine unerwarteten Doppelanlagen entstehen. Teste anschließend größere Batches, API-Drosselung und Neustart nach Teilausfällen.
11. Go-live und Sicherheit
Verwende nach Möglichkeit OAuth mit einer dafür eingerichteten Anwendung und möglichst wenigen Rechten. Client-Secrets gehören nicht in SSIS-Pakete oder Git. Schütze Fehlerdateien, weil sie personenbezogene Kontaktdaten enthalten können. Plane eine Daten-Freeze-Phase, Delta-Übertragung, fachliche Abnahme und einen Rückfallplan. Eine produktive Migration ist erst fertig, wenn die importierten Datensätze korrekt verwendet werden können.
12. Fazit und Lernpfad
Eine gute Migration ist wiederholbar, messbar und fachlich überprüfbar. Danach lohnt sich der nächste Schritt: eine eigene API in Business Central bereitstellen oder die Datenübertragung über einen .NET-Dienst automatisieren.
Kommentare (0)
Noch keine Kommentare. Schreibe den ersten Beitrag zur Diskussion.