XMLports entwerfen
Das Entwerfen eines XMLport erstellt die Struktur der externen Datei, unabhängig davon, ob es sich um ein XML-Dokument oder eine Textdatei handelt. Dieser Entwurfsprozess beinhaltet hauptsächlich das Festlegen verschiedener Eigenschaften in den XMLport-Objekten wie XMLport‑ und Knoteneigenschaften.
Ein XML-Dokument ist eine gut strukturierte Hierarchie von Knoten, die gleichzeitig die Daten enthalten und die Art der Daten im Dokument beschreiben.
Geben Sie alle XML-Knoten (geben Sie die Knotennamen an) und deren Typ an, unabhängig davon, ob es sich um ein Element oder ein Attribut handelt, um einen XMLport zu erstellen und so Daten aus einem XML-Dokument zu importieren. Ordnen Sie diese Knoten entsprechenden Datenstrukturen (Tabellen oder Feldern) in der Business Central-Datenbank oder Variablen zu. Wenn ein XMLport-Objekt aufgerufen wird, um ein eingehendes XML-Dokument zu verarbeiten, liest es den eingehenden Datenstrom (z. B. eine Datei) und führt die Verarbeitungs‑ und Datenbankaktionen aus.
Erstellen Sie die Knotenstruktur des XML-Dokuments und ordnen Sie die Daten zu, um einen XMLport zu erstellen, um Daten in ein XML-Dokument zu exportieren.
Wenn ein XMLport-Objekt aufgerufen wird, um Daten zu exportieren, liest es die erforderlichen Daten aus der Datenbank oder den Variablen, fügt die erforderlichen XML-Knoten aus dem XML-Dokument hinzu und schreibt das Dokument in einen Datenstrom (z. B. eine Datei).
Verwenden Sie für eingehende Dokumente dieser Art AL-Code, um die erforderliche Datenbankmanipulation durchzuführen und das gewünschte Ergebnis zu erzielen.
Datenmodell
Das Datenmodell ordnet die Daten zwischen dem externen Dokument sowie den Tabellen und Feldern in der Datenbank zu. Das Datenmodell besteht aus Knoten, die normalerweise Tabellen und Felder darstellen.
Knoten vom Tabellentyp geben die Tabellen an, aus denen oder in die Daten exportiert oder importiert werden, einschließlich aller erforderlichen Beziehungen zwischen Tabellen. Knoten vom Feldtyp geben an, welche Felder aus der übergeordneten Tabelle in den Import oder Export einbezogen werden.
Jeder Tabellenknoten wird im XMLport für alle Datensätze in der zugrunde liegenden Tabelle iteriert, wenn ein XMLport zum Exportieren von Daten verwendet wird. Sortierreihenfolge, Schlüssel und Tabellenansichten können festgelegt werden, um die exportierten Daten in einer bestimmten Reihenfolge zu sortieren oder die resultierenden Sätze nach vordefinierten Kriterien zu filtern.
Wenn ein XMLport zum Importieren von Daten verwendet wird, werden Datensätze, die aus dem externen Stream gelesen werden, in die Tabelle eingefügt, die dem Tabellenknoten im XMLport zugeordnet ist.
Sie können die Datensätze vor dem Einfügen überprüfen, angeben, ob Datensätze automatisch eingefügt werden, und entscheiden, ob bereits in der Datenbank vorhandene Datensätze überschrieben oder aktualisiert werden, wenn ein Datensatz mit demselben Primärschlüssel aus der externen Datei gelesen wird. Sie können auch festlegen, dass Datensätze beim Import vollständig übersprungen werden.
Externe Datei
Das Layout der externen Datei wird durch Festlegen von Eigenschaften definiert, einschließlich dem Festlegen von XMLport-Eigenschaften und XMLport-Knoteneigenschaften.
Externe Dateien, die über XMLports verarbeitet werden, können im XML‑ oder Nur-Text-Format vorliegen. In beiden Fällen muss die Definition der Knoten im XMLport-Designer mit der Struktur der externen Datei übereinstimmen, die exportiert oder importiert wird.
Wenn ein XMLport zum Exportieren von Daten verwendet wird, beschreibt die XMLport-Definition, wie die Felder und Datensätze der Struktur der externen Datei zugeordnet werden, und führt dazu, dass die externe Datei die genaue Struktur enthält, die im XMLport definiert ist. Ein XMLport kann nicht mehr Felder oder Informationen exportieren, als im Feld XMLport-Definition angegeben.
Wenn ein XMLport verwendet wird, um Daten zu importieren, beschreibt die XMLport-Definition die Mindestanzahl von Feldern und hängt vom Format des XMLport und der Struktur der Datei ab. Die externe Datei kann mehr Felder enthalten als durch die XMLport-Definition festgelegt.