Mappingversionskarte

Eine Mappingversion besteht aus Datenspeichern (Repositorien) und Zeilenaktionen. Eine Zeile führt eine spezielle Aktion für einen Datenspeicher aus.

Die Seite Mappingversionskarte wird durch Auswahl der Aktion Karte öffnen auf dem Inforegister Versionen der Mappingkarte aufgerufen.

Füllen Sie bei Bedarf die Felder auf der Seite Mappingversionskarte aus. Fahren Sie über ein Feld, um eine Kurzbeschreibung zu lesen.

Datensätze lesen und schreiben

Zeilenaktionen und -unteraktionen lesen und schreiben die Datensätze. Beide Felder arbeiten dafür zusammen.

Optionen für Zeilenaktionen

Folgend werden die Optionen für die Zeilenaktionen näher beschrieben:

  • Finden – Der Datenspeicher wird gefiltert und alle Datensätze werden in einer Schleife durchlaufen. Dabei werden nach jedem gelesenen Datensatz zuerst alle eingerückten Zeilen verarbeitet.
  • Einfügen sonst alle Ändern – Der Datenspeicher wird gefiltert. Wenn Datensätze innerhalb des Filters gefunden wurden, werden diese in einer Schleife durchlaufen. Analog zu Finden werden dabei nach jedem gelesenen Datensatz zuerst alle eingerückten Zeilen verarbeitet. Wenn kein Datensatz im Filter ist, wird ein neuer angelegt. Der Datensatz wird erst nach Verarbeitung aller Mappingfelder eingefügt.
  • Einfügen sonst Überspringen – Wenn der Filter einen oder mehrere Datensätze findet, wird die Zeile und alle eingerückten Zeilen vollständig übersprungen. Andernfalls wird (analog zu Einfügen sonst alle Ändern) der Datensatz neu angelegt.
  • Ändern – Der Datenspeicher wird gefiltert, und alle Datensätze werden in einer Schleife durchlaufen. Dabei werden die im Mappingfeld definierten Änderungen am Datensatz vorgenommen und alle eingerückten Zeilen verarbeitet.
  • Löschen – Alle Datensätze innerhalb des Filters werden gelöscht. Analog zu den anderen Optionen werden nach jedem Datensatz die eingerückten Zeilen verarbeitet.
Note

Das Löschen des Datensatzes erfolgt vor der Verarbeitung der eingerückten Zeilen.

  • Umbenennen (Tabelle) – Änderungen von Primärschlüsselfeldern in Dynamics 365 Business Central müssen mit der Aktion Umbenennen durchgeführt werden. Es ist nicht möglich, die Primärschlüsselfelder mit einer Ändern-Aktion zu ändern. Die Umbenennen-Aktion ist nur für Datenspeicherart = Tabelle verfügbar. Um einen Datensatz beim Import umzubenennen, erstellen Sie eine Mappingzeile mit der Aktion Umbenennen und Mappingfiltern für den vorbenannten Wert und Mappingfeldern für die nachbenannten Primärschlüsselfelder.
Note

Fügen Sie nur die Primärschlüsselfelder innerhalb der Mappingfeld-Definition hinzu.

  • Mapping – Diese spezielle Zeilenaktion ruft ein anderes Mapping auf (Untermapping). Im Feld Untermappingcode muss das auszuführende Mapping eingetragen werden. Es wird entweder die aktuell gültige Mappingversion aufgerufen, oder bei Angabe im Feld Untermappingversion die entsprechende Version.
Note

Mapping und Untermapping nutzen dieselben Datenspeicher. D.h. wenn ein Datenspeicher im aktuellen Mapping angesprochen wird, kann es auch im Untermapping genutzt werden, und umgekehrt. Mappingvariablen werden ebenfalls geteilt, auch wenn diese im Untermapping nicht direkt konfiguriert wurden.

Optionen für Zeilenunteraktionen

Eine vollständige Schleife über alle Datensätze wird nur ausgeführt, wenn das Feld Zeilenunteraktion auf Alle gesetzt ist. Folgend werden die weiteren Optionen für die Zeilenunteraktionen näher beschrieben.

  • Aktueller Datensatz – Die Aktion wird lediglich für den aktuell im Datenspeicher geöffneten Datensatz durchgeführt.
  • Erster Datensatz – Nur für den ersten Datensatz (FINDFIRST) im Filter wird die Aktion ausgeführt. Danach wird die Schleife abgebrochen.
  • Letzter Datensatz – Nur für den letzten Datensatz (FINDLAST) im Filter wird die Aktion ausgeführt. Alle vorherigen Datensätze werden vollständig ignoriert.
  • Nicht gefunden – Die Aktionen der eingerückten Zeilen werden nur ausgeführt, wenn sich kein Datensatz innerhalb des Filters befindet.

Eine Mappingzeile verarbeiten

Die Filter, Felder, Kriterien, Codeunits und Variablen werden bei fast jeder Aktion nacheinander ausgeführt. Folgende Diagramme beschreiben die Verarbeitungsreihenfolge einer Mappingzeile näher.

Aktionsflussdiagramm

Notizen generieren (KI)

Die Aktion Notizen generieren (KI) kann verwendet werden, um eine Notiz mit einer Beschreibung der Mappingversion zu erstellen. Es wird eine Zusammenfassung mit allgemeinen Informationen über das Mapping und detaillierte Informationen über die Zeilen erstellt.

Note

Diese Funktion steht nur für COSMOnauten zur Verfügung.

Siehe auch

Datenspeicher
Mappingkriterien
Mappingfilter
Mappingfelder
Mappingvariablen
Mapping-Codeunits
Mappingkonfigurations-Assistent

Feedback

Senden Sie Feedback für diese Seite. (Beachten Sie, dass diese Umfrage auf Englisch ist.)