Anveo EDI Connect / Config / Mappings / Lesen und Schreiben von Tabellendaten
This is an automatic translation. The original post is available in Englisch.

Lesen und Schreiben von Tabellendaten

Es ist wichtig zu beachten, dass Sie auf die Spalten dieser Tabelleninstanz nur über Mappingzeilen zugreifen können, die Kinder der Tabelleninstanz sind. Die Einrückung der Tabellenzeilen muss daher so erfolgen, dass alle Zeilen, die auf die Daten zugreifen wollen, Kinder der Tabelle sind. Zu diesem Zweck werden oft mehrere Tabellen untereinander verschachtelt, um Zugriff auf alle Felder zu erhalten.

Um in Tabellen innerhalb von Microsoft Dynamics 365 Business Central zu lesen oder zu schreiben, müssen Sie zuerst eine Instanz dieser Tabelle im Mapping deklarieren. Wählen Sie in der Mapping-Linie Type property den Wert Loop. Dadurch werden die verfügbaren Eigenschaften geändert und eine neue Eigenschaft namens Loop Type hinzugefügt. Wählen Sie als Loop Type den Wert Table.

Anschließend können Sie die anderen Eigenschaften konfigurieren. Die folgenden Eigenschaften sind verfügbar:

Loop Type

Der Typ der Schleife. Wählen Sie den Wert Table, um auf die Tabellendaten zuzugreifen.

Mode

Ob Sie Daten aus einer Tabelle lesen, Daten in eine Tabelle schreiben (einen neuen Datensatz anlegen) oder bestehende Daten aktualisieren möchten.

Read

Vorhandene Daten lesen. Die Daten können gefiltert werden. Es ist möglich, Filter anzuwenden, so dass kein Datensatz gefunden wird.

Write

Erstellen Sie einen neuen Datensatz in der Tabelle. Je nach Formattyp können ein oder mehrere Datensätze angelegt werden.

Update

Aktualisieren Sie einen bestehenden Datensatz oder erstellen Sie optional einen neuen, wenn dieser nicht vorhanden ist. Das Modul kann nur einen Datensatz auf einmal aktualisieren, also stellen Sie sicher, dass Sie Filter anwenden, so dass maximal ein Datensatz gefunden wird. Um mehrere Datensätze zu aktualisieren, müssen Sie eine Tabellenschleife erstellen, die die Daten liest, und eine zweite Instanz dieser Tabelle im Update-Modus, die auf den Primärschlüssel des aktuell gelesenen Datensatzes gefiltert wird.

Table

Wählt die Quell-/Zieltabelle aus dem Microsoft Dynamics 365 Business Central aus. Sie können entweder den Namen der Tabelle oder deren ID eingeben.

Name

Der Name dieser Tabelleninstanz im Mapping. Der Name wird verwendet, um zwischen verschiedenen Instanzen derselben Tabelle zu unterscheiden. Stellen Sie es sich vor, wie ein Variablenname.

Data View

Diese Eigenschaft ist neu in der Version 4.00 des Moduls.

All Records

Verwenden Sie keine speziellen Filter. Sie können die Daten weiterhin mit den folgenden Eigenschaften filtern.

Post Process Record

Nur verwendbar, wenn dieses Mapping als Nachbearbeitung läuft. Filtern Sie die Tabelleninstanz nach dem Datensatz, für den die Nachbearbeitung definiert wurde.

Business Transaction Data

Nur verwendbar, wenn dieses Mapping innerhalb eines Geschäftsvorfalls läuft. Filtert die Daten auf die Geschäftsvorfallsdaten (z.B. die Auftragsdaten).

Named Table View

Filtert die Daten nach einer benannten Tabellenansicht. Dies kann entweder einer der eingebauten Tabellen-View-Namen oder ein beliebiger Tabellen-View sein, der durch Programmierung definiert wird. Es wird eine neue Eigenschaft verfügbar, um den Namen auszuwählen.

Table View Name

Diese Eigenschaft ist nur verfügbar, wenn die Data View auf Named Table View eingestellt ist. Sie können jede durch Code definierte Tabellenansicht oder eine der folgenden speziellen Tabellensichten verwenden:

TRANSMISSION

Wenn es eine eingehende Übertragung gibt, können Sie mit dieser Tabellenansicht darauf zugreifen.

PROCESSINGQUEUE

Wenn das Mapping als Error-Handler läuft, können Sie mit diesem Filter auf den Eintrag der fehlgeschlagenen Verarbeitungswarteschlange zugreifen.

POST_PROCESS_REC
DEFAULT

Diese Filternamen werden normalerweise vom Modul verwendet, um Informationen über den Postprozess-Datensatz zu speichern. Sie sollten stattdessen den Wert der Data View auf Post Process Record setzen. Aber wenn Sie Mappings von älteren Versionen des Moduls aktualisieren, finden Sie möglicherweise noch diese Werte, die noch funktionieren.

Die Namen können auch aus benutzerdefiniertem Code definiert werden und enthalten einen beliebigen Filter. Wir empfehlen nicht mehr, diese Namen von oben zu verwenden. Bitte verwenden Sie stattdessen einen sprechenden Filternamen oder CUSTOM.

Limit Count

Diese Eigenschaft ist neu in Anveo EDI Connect 4.00.

Nur im Lesemodus verfügbar. Gibt an, ob Sie die Anzahl der gefundenen Datensätze einschränken möchten. Kann verwendet werden, um nur den ersten oder letzten Datensatz in Kombination mit der Sortierfunktion auszuwählen.

True

Beschränken Sie die Datensätze auf die angegebene Anzahl.

False

Schränken Sie die zurückgegebenen Datensätze nicht ein.

Select Top

Nur verfügbar, wenn Limit Count auf True gesetzt ist. Die maximale Anzahl der zu verwendenden Datensätze.

Table View

Nur lesbar. Gruppiert andere Eigenschaften. Der Name Table View wird in der Programmierung von Microsoft Dynamics 365 Business Central verwendet, um die Kombination aus Sortier- und Konstantfilter auf einer Tabelle zu beschreiben. Wir haben diesen Namen verwendet, um es für C/AL-Programmierer einfach zu machen, das Modul zu benutzen, es als konstante Filter und Initialwert zu betrachten.

Key

Der Schlüssel, der für die Sortierung verwendet werden soll. Kann leer sein.

Order

Die Reihenfolge, in der der Schlüssel angewendet wird. Die Voreinstellung ist Ascending.

Filter

Filter, die konstant sind, d.h. nicht von Daten aus einer anderen Tabelle abhängig sind. Sie können alle Spalten aus der Tabelle filtern.

Wenn der Mode der Tabelle Write ist, werden die Filter als Initialwerte auf die Tabelle angewendet. Sie können also auch den Filter verwenden, um einige der Spaltenwerte für neue Datensätze anzugeben.

Data Item Link

Diese Eigenschaft wird verwendet, um die Beziehung zu einer anderen Tabelle zu definieren. Dies ist eine Liste von Werten. Sie wählen zuerst die Spalte aus der aktuellen Tabelleninstanz und anschließend eine weitere Tabelle und Felder aus. Mit dieser Eigenschaft wird die Fremdschlüsselbeziehung definiert.

Angenommen, Sie haben eine Tabelleninstanz der Tabelle EDI Document im Mapping und als Kind eine Instanz der Tabelle EDI Document Line. Um anzugeben, dass die Zeile zum Kopfdokument gehört, definieren Sie die Data Item Link als:

Dadurch werden die angegebenen Spalten auf den Wert des Kopfdokuments gefiltert. Im Lesemodus erhalten Sie nur die zum Dokument gehörenden Zeilen. Im Schreibmodus werden die Spalten mit den Daten aus dem Dokument gefüllt, so dass die Zeile zum Header gehört.

Wenn der Mode der Tabelle Write ist, wird der Data Item Link als Initialwert auf die Tabellenspalten angewendet. Sie können also auch den Data Item Link verwenden, um einige der Spaltenwerte für neue Datensätze anzugeben.

Temporary

Dies ist eine erweiterte Eigenschaft und normalerweise versteckt.

Gibt an, dass Sie eine temporäre Tabelle verwenden möchten. Eine temporäre Tabelle wird neuer auf die Datenbank geschrieben.

Init Function

Diese Eigenschaft ist neu in Anveo EDI Connect 4.00.

Die Eigenschaft init function ist nur verfügbar, wenn die Eigenschaft Temporary auf True gesetzt ist. Diese Funktion wird verwendet, um die temporäre Tabelle beim Initialisieren zu füllen.

Object

Der Objektname, auf dem die Funktion definiert ist.

Property/Function

Der Name der Funktion. Die Funktion sollte ein Objekt vom Typ Codeunit ANVEDI Data Structure zurückgeben, das auf ein RecordRef zeigt, das die Ausgangsdaten enthält.

Company

Dies ist eine erweiterte Eigenschaft und normalerweise versteckt.

Die Firma, von der der Datensatz gelesen wird / in die geschrieben wird. Damit kann auf Daten eines anderen Unternehmens zugegriffen werden.

Ändern Sie die Firma auf Tabelleninstanzen nicht im Schreibmodus, außer Sie wissen, was Sie tun. Alle Trigger werden entsprechend den Daten der aktuellen Firma ausgeführt, so dass Sie niemals direkt in eine Standardtabelle einer anderen Firma schreiben sollten.

TotalFields

Sie können Spalten angeben, für die das Modul automatisch eine Summe berechnet. Sie können die summierten Werte aus der Tabelle lesen, indem Sie auf die Spalten nach der Tabellenschleife und nicht als Unterzeile der Tabellenschleife zugreifen.

Register Errors On Instance

Diese Eigenschaft ist neu in Anveo EDI Connect 4.00.

Dies ist eine erweiterte Eigenschaft und normalerweise versteckt. Ob Sie Fehler nach dieser Zeile automatisch in dieser Tabelleninstanz registrieren möchten.

True

Registrieren Sie Fehler auf dieser Tabelleninstanz. Dies ist bei Puffertabellen sinnvoll.

False

Registrieren Sie keine Fehler auf dieser Tabelleninstanz. Dies ist sinnvoll, wenn die Instanz auf z.B. sekundäre Tabelleninformationen zugreift.

Linked Documents

Dies ist eine schreibgeschützte Eigenschaft, um die untergeordneten Eigenschaften zu gruppieren.

Create Linked Documents

Ob Sie für diese Tabelleninstanz Einträge in der Tabelle der verknüpften Dokumente anlegen möchten. Wenn Sie diese Option auf True setzen, können Sie aus der EDI Verarbeitungswarteschlange, aus der EDI Übertragung-Übertragung (falls vorhanden) und aus der EDI Geschäftsvorfall-Geschäftsvorfall (falls vorhanden) in diese Tabelle navigieren.

Linked Tables

Diese Eigenschaft ist nur verfügbar, wenn Create Linked Documents auf True gesetzt ist. Sie können weitere Tabelleninstanzen aus diesem Mapping angeben, die mit der aktuellen Tabelleninstanz verknüpft werden sollen. So können Sie z.B. auf dem EDI Dokument-Dokument zu anderen verknüpften Dokumenten navigieren, wie z.B. zu einem angelegten Verkaufskopf.

Internal No. Display Field

Sie können die Spalte auswählen, die für die interne Nummer verwendet werden soll, wenn ein verknüpfter Dokumenteintrag für diese Tabelleninstanz angelegt wird.

External No. Display Field

Sie können die Spalte auswählen, die für die externe Nummer verwendet werden soll, wenn ein verknüpfter Dokumenteintrag für diese Tabelleninstanz angelegt wird.

Post-Processing

Ermöglicht es Ihnen, eine oder mehrere Aktionen anzugeben, die in jedem Datensatz dieser Tabelleninstanz ausgeführt werden sollen, nachdem das Mapping erfolgreich beendet wurde. Nachbearbeitungen werden nicht durchgeführt, wenn Fehler aufgetreten sind. Mehr dazu erfahren Sie im Abschnitt Nachbearbeitung.

Min. Repeat

Wenn Sie eine Zahl eingeben, löst das Mapping einen Fehler aus, wenn die angegebene minimale Wiederholung nicht erreicht wird.

Min. Repeat Error Message

Die Fehlermeldung, die ausgegeben werden sollte, wenn die minimale Anzahl von Datensätzen nicht gefunden wird.

Max. Repeat

Wenn Sie eine Zahl eingeben, löst das Mapping einen Fehler aus, wenn die angegebene maximale Wiederholung nicht erreicht wird.

Max. Repeat Error Message

Die Fehlermeldung, die ausgelöst werden sollte, wenn die maximale Anzahl der Datensätze überschritten wird.