Skip to main content

Datenaustauschdefinitionen

Hierbei handelt es sich um eine Standard-Funktionalität von Business Central, welche in diesem Teil der Microsoft Dokumentation erläutert wird. Da sie grundlegend für den Import und die anschließende Weiterverarbeitung der Nutzungsdaten ist, werden hier zumindest die für DYCE Usage Base Billing relevante Aspekte noch einmal zusammengefasst.

Beispiel

Die hier beispielhaft beschriebene Datenaustauschdefinition bezieht sich auf eine Importdatei für Nutzungsdaten, die als CSV-Datei in UTF-8 Kodierung mit Spaltentrennzeichen als Semikolon vorliegt.
Die Datenaustauschdefinitionen bieten darüber hinaus aber noch deutlich mehr Funktionalität, wie bspw. den Export von Daten.

Definition für Datenimport​

Für die Abrechnung von Nutzungsdaten müssen diese zunächst importiert und anschließend weiterverarbeitet werden. Damit das System die Daten aus der Abstimmungsdatei richtig extrahieren kann, benötigt es ein Schema, wie genau die Daten vorliegen. Dieses Schema wird am Nutzungsdaten Lieferant hinterlegt.

Hinweis

Mit der Installation von DYCE Usage Based Billing wird die Datenaustauschdefinition DYCE-UBB als Vorlage mitgeliefert. Diese muss allerdings auf die eigenen Gegebenheiten angepasst werden. Datenaustauschdefinitionen können über die jeweiligen Aktionen exportiert und importiert werden.

Die Datenaustauschdefinitionen lassen sich über das Menü bzw. die Suche (Alt+Q) aufrufen.
Die Seite besteht aus drei Teilen:

  • Allgemein
    In diesem Teil werden Einstellungen vorgenommen, die die Importdatei an sich betreffen. Die wichtigsten Felder sind:
    • Dateityp
      Für den Import von Nutzungsdaten wird hier i.d.R. Variabler Text ausgewählt.
    • Art
      Für den Import von Nutzungsdaten wird hier i.d.R. Generischer Import ausgewählt.
    • Dateiverschlüsselung
      Hier wird die Kodierung der Unicode-Zeichen für die Importdatei ausgewählt.
    • Spaltentrennzeichen
      Hier wird das Trennzeichen angegeben, anhand dessen die Spalten in der Importdatei getrennt werden. Dies ist nur für den Dateityp Variabler Text relevant.
    • Kopfzeilen
      Hier wird eingestellt, wie viele Kopfzeilen die Importdatei enthält. Dadurch wird sichergestellt, dass die Kopfdaten nicht importiert werden.
  • Spaltendefinitionen
    Für ungeübte Anwender der Datenaustauschdefinitionen mag es verwirrend sein, dass dieses Inforegister unten auf der Seite angezeigt wird, da dies vor der zugehörigen Zeilendefinitionen gefüllt werden muss.
    Hier werden die zu importierenden Spalten definiert:
    • Im Feld Spaltennr. wird die Nummer der Spalte in der Importdatei angegeben.
    • Das Feld Name gibt den Namen der Spalte an. Hier bietet es sich aus Gründen der Übersichtlichkeit an, den gleichen Namen wie in der Kopfzeile der Importdatei zu verwenden.
    • Im Datentyp wird angegeben, ob die zu importierenden Daten vom Typ Text, Datum oder Dezimal sind.
    • Das Datenformat bezieht sich in erster Linie auf Daten vom Typ=Datum. Hier wird angegeben, in welcher Formatierung das Datum in dem zugehörigen Feld vorliegt. Für ein Datum im deutschen Datumsformat muss hier der Wert dd.MM.yyyy angegeben werden.
    • Im Feld Datenformatierungskultur wird die Kultur des Datenformats angegeben, sofern nötig. So gibt bspw. de-DE für den Datentyp Dezimal an, dass das Komma gemäß deutschem Format als Dezimaltrennzeichen verwendet wird.
    • Das Feld Länge ist nur dann relevant, wenn als Dateityp Fester Text eingestellt ist.
    • Die übrigen Felder werden für den hier beschriebenen Import nicht benötigt.
  • Zeilendefinitionen
    In diesem Inforegister muss lediglich eine Zeile definiert werden, damit anschließend über die Feldzuordnung das Mapping zwischen den Spalten der Importdatei und den Feldern der Zieltabelle erfolgen kann. Als Zeilenart wird Detail gewählt, ein eindeutiger Code und eine Beschreibung vergeben und die Anzahl der zu verarbeitenden (importierenden) Spalten angegeben. Die automatisch erstellte Zeile der Zeilenart=Kopfzeile wird gelöscht.
    Anschließend müssen über die Aktion Feldzuordnung zu folgenden Einstellungen getroffen werden:
    • Zunächst muss über das PLUS-Symbol eine neue Zuordnung erstellt werden.
    • Als Tabellen-ID wird die Nummer 70921110 eingetragen. Hierbei handelt es sich um die Importierten Zeilen für den Generischen Import.
    • Im Feld Name sollte ein sprechender Name vergeben werden.
    • Als Zuordnungs-Codeunit wird die Nummer 70921104 eingetragen. Die Codeunit wird bei der Erzeugung der Importierten Zeilen für den Generischen Import verwendet.
    • Im Feld Spaltennr. kann eine über die Spaltendefinitionen festgelegte Spalte ausgewählt und über die Feld-ID einem Ziel-Feld (in der über Tabellen-ID festgelegten Tabelle) zugeordnet werden.
    • Das Feld Wert überschreiben gibt an, dass Feldinhalte in der Zieltabelle ggf. überschrieben werden können. Es wird empfohlen, dies für die Felder Subscription ID, Produkt ID, Produktname und Menge zu setzen.
    • Die übrigen Felder werden für den hier beschriebenen Import nicht benötigt.