Datenaustauschdefinitionen

Der Datenaustausch ist in Business Central ein Standardfeature. Um mehr über den Datenaustausch und Datenaustauschdefinitionen zu erfahren, gehen Sie zu Datenaustauschdefinitionen einrichten.

Datenaustauschdefinitionen sind für den Import und die Verarbeitung von Daten in der nutzungsbasierten Abrechnung unerlässlich. Dieser Artikel fasst die wichtigsten Aspekte zusammen.

Die beispielhafte Datenaustauschdefinition in diesem Artikel bezieht sich auf eine Importdatei für Nutzungsdaten. Es handelt sich um eine CSV-Datei in UTF-8-Codierung mit Semikolons als Spaltentrennzeichen. Weitere Informationen finden Sie unter Daten in der nutzungsbasierten Abrechnung importieren.

Definitionen für den Datenimport

Für die Abrechnung müssen Sie zunächst Daten importieren und verarbeiten. Weitere Informationen finden Sie unter Importe und Verarbeitung. Damit Business Central die Daten aus der CSV-Datei extrahieren kann, benötigt es das Schema der Daten. Das Schema ist auf dem Nutzungsdatenlieferanten verfügbar.

Notiz

Die nutzungsbasierte Abrechnung stellt als Beispiel die Datenaustauschdefinition USAGEBASED zur Verfügung. Sie können die Definition verwenden, müssen sie aber an Ihre eigenen Einstellungen anpassen. Sie können Datenaustauschdefinitionen auf der Seite Datenaustauschdefinition importieren und exportieren. Verwenden Sie dazu die Aktionen Datenaustauschdefinition importieren und Datenaustauschdefinition exportieren.

Die Seite Datenaustauschdefinitionen enthält die folgenden Inforegister:

  • Allgemein
  • Zeilendefinitionen
  • Spaltendefinitionen

Notiz

Obwohl sich das Inforegister Zeilendefinitionen weiter oben auf der Seite befindet, müssen Sie die Felder im Inforegister Spaltendefinitionen ausfüllen, bevor Sie Informationen im Inforegister Zeilendefinitionen eingeben.

Einstellungen auf dem Inforegister „Allgemein“

Diese Einstellungen wirken sich auf die Importdatei aus. In der folgenden Tabelle werden die wichtigen Felder beschrieben.

Feld Description
Dateityp Für das Importieren von Nutzungsdaten wählen Unternehmen in der Regel Variablen Text aus.
Typ Für das Importieren von Nutzungsdaten wählen Unternehmen in der Regel Allgemeinen Import aus.
Dateiverschlüsselung Die Codierung von Unicode-Zeichen für die Importdatei.
Spaltentrennzeichen Gibt das Zeichen an, das die Spalten in der Importdatei trennt. Dies ist nur für den Dateityp Variabler Text relevant.
Kopfzeilen Legt fest, wie viele Kopfzeilen die Importdatei enthält. Dadurch wird sichergestellt, dass die Kopfzeilendaten nicht importiert werden.
Lesen/Schreiben von XMLport Um Nutzungsdaten zu importieren, wählen Sie 1220 aus.

Einstellungen auf dem Inforegister „Zeilendefinitionen“

Auf diesem Inforegister müssen Sie nur eine Zeile festlegen, sodass Sie mithilfe der Aktion Feldzuordnung die Zuordnung zwischen den Spalten der Importdatei und den Feldern der Zieltabelle erstellen können. Wenn Sie im Feld Zeilenart die Option Detail auswählen, werden ein eindeutiger Code und eine Beschreibung zugewiesen, und die Anzahl der Spalten, die verarbeitet (also importiert) werden sollen, unter Spaltenanzahl angegeben. Die Standardzeile mit der Zeilenart Kopfzeile wird gelöscht.

Einstellungen auf der Seite „Feldzuordnung“

Nachdem Sie die Felder im Inforegister Spaltendefinitionen ausgefüllt und im Inforegister Zeilendefinitionen eine Zeile erstellt haben, können Sie die Feldzuordnungen einrichten. Wählen Sie auf dem Inforegister Zeilendefinitionen die Aktion Feldzuordnung aus und geben Sie auf der Seite Feldzuordnung die folgenden Einstellungen ein.

Füllen Sie die Felder im Inforegister Allgemein wie folgt aus:

  • Das Feld Tabellen-ID sollte 8018 enthalten. Dies ist die Tabelle Allgemeiner Nutzungsdatenimport.
  • Das Feld Name sollte einen Namen enthalten.
  • Das Feld Zuordnungs-Codeunit sollte den Wert 8030 enthalten. Dies ist die Codeunit Allgemeine Importzuordnungen, die beim Generieren importierter Zeilen für den allgemeinen Importtyp verwendet werden sollte.

Füllen Sie die Felder im Inforegister Fedzuordnungen wie folgt aus:

  • Das Feld Spaltennr. legt eine Spaltendefinition fest und das Feld Feld-ID ein Zielfeld aus der im Feld Tabellen-ID angegebenen Tabelle.
  • Das Kontrollkästchen Wert überschreiben gibt an, dass Feldinhalte in der Zieltabelle bei Bedarf überschrieben werden können. Es wird empfohlen, dieses Kontrollkästchen wie in der folgenden Tabelle beschrieben für die Felder Abonnement-ID, Produkt-ID, Produktname und Menge auszuwählen.

Die folgende Tabelle enthält ein vollständiges Beispiel für eine Einrichtung des Inforegisters Feldzuordnung auf der Seite Feldzuordnung.

Spaltennr. Spaltenbezeichnung Feld-ID Feldbeschriftung Optional Transformationsregel Wert überschreiben Priorität
2 Debitoren-ID 7 Debitoren-ID Nr. Nr. 0
3 Kundenname 8 Kundenname Nr. Nr. 0
7 Abonnement-ID 10 Abonnement-ID Nr. Ja 0
8 Produkt-ID 17 Produkt-ID Nr. Ja 0
10 Produktname 18 Produktname Nr. Ja 0
11 Startdatum des Abonnements 13 Startdatum des Abonnements Nr. Nr. 0
12 Enddatum des Abonnements 14 Enddatum des Abonnements Nr. Nr. 0
13 Startdatum des Abrechnungszeitraums 15 Startdatum des Abrechnungszeitraums Nr. Nr. 0
14 Enddatum des Abrechnungszeitraums 16 Enddatum des Abrechnungszeitraums Nr. Nr. 0
16 Einstandspreis 19 EP Nr. Nr. 0
17 Menge 21 Menge Nr. Ja 0
18 Preis 20 VK-Preis Nr. Nr. 0
19 Betrag 24 Betrag Nr. Nr. 0
22 Einstandsbetrag 27 Einstandsbetrag Nr. Nr. 0
23 Währung 25 Währung Nr. Nr. 0
24 Text 1 50 Text 1 Nr. Nr. 0

Einstellungen auf dem Inforegister „Spaltendefinitionen“

In der folgenden Tabelle werden die Einstellungen beschrieben, welche die zu importierenden Spalten festlegen.

Feld Description
Spaltennr. Gibt den Nummer der Spalte in der Importdatei an.
Name Gibt den Namen der Spalte an. Der Einfachheit halber empfehlen wir, den Namen aus der Kopfzeile der Importdatei zu verwenden.
Datentyp Legt fest, ob es sich bei den zu importierenden Daten um einen Text, ein Datum oder eine Dezimalzahl handelt.
Datenformat Bezieht sich in erster Linie auf Daten vom Typ Datum. Das Feld gibt an, wie Daten formatiert werden sollen. Für ein Datum im US-Format sollte der Wert z. B. MM-TT-JJJJ lauten.
Datenformatierungskultur Gibt ggf. die Kultur des Datenformats an. Zum Beispiel bedeutet en-US für den Datentyp Dezimal, dass gemäss dem amerikanischen Format ein Punkt als Dezimaltrennzeichen verwendet wird.
Länge Dies ist nur relevant, wenn der Dateityp auf Fester Text festgelegt ist.

Importe und Verarbeitung