Unterschiedliche XMLport-Eigenschaften konfigurieren
XMLport-Eigenschaften definieren die grundlegenden Eigenschaften der Eingabe‑ oder Ausgabedateien, auf die XMLport zugreift. Die Eigenschaften der XMLport-Knoten beschreiben die Datenquelle und definieren das Verhalten von XMLport während Import‑ und Exportvorgängen.
Eigenschaften
Allgemein beschreiben XMLport-Eigenschaften XMLport. Mehrere Eigenschaften, wie Direction und FileName können dynamisch eingestellt und zurückgesetzt werden. Zum Beispiel können Entwickler eine XMLport erstellen, bei der der Benutzer eine der folgenden Aktionen ausführen kann:
Wählen Sie aus, ob Sie importieren oder exportieren möchten.
Wählen Sie die externe Quelle aus, von der gelesen oder geschrieben werden soll.
Generieren Sie automatisch einen Dateinamen, wenn die XMLport ausgeführt wird.
Die Eigenschaft FileName kann nur in einer lokalen Umgebung verwendet werden, da Sie in einer Software-as-a-Service-Umgebung (SaaS) nicht auf lokale Dateien zugreifen können.
Eigenschaft „Direction“
Die Eigenschaft Direction definiert, ob die XMLport Import, Export oder beides verarbeiten kann. Die folgenden Eigenschaftsoptionen sind verfügbar:
Importieren
Exportieren
Beides
Die Standardeinstellung für die Eigenschaft Direction lautet Beide.
Die Eigenschaft Direction definiert streng, wie eine XMLport verwendet werden kann. Wenn die Richtung explizit auf Importieren oder Exportieren eingestellt ist, dann kann die XMLport nicht verwendet werden, um Dokumente in die andere Richtung zu verarbeiten. Wenn Sie möchten, dass eine XMLport das Importieren und Exportieren von Dokumenten verarbeitet, stellen Sie sicher, dass diese Eigenschaft die Richtung mit Both angibt.
DefaultFieldsValidation-Eigenschaft
Die DefaultFieldsValidation-Eigenschaft legt fest, ob Felder beim Import überprüft oder zugewiesen werden. Diese Einstellung kann für ein bestimmtes Feld durch Angabe der Eigenschaft FieldValidate im Feld überschrieben werden.
UseRequestPage-Eigenschaft
Die UseRequestPage-Eigenschaft gibt an, ob die XMLport eine Anforderungsseite mit Optionen und Filtern anzeigt. Wenn diese Eigenschaft auf false gesetzt ist, setzt die XMLport das Importieren oder Exportieren je nach Wert der Eigenschaft Direction fort. Wenn diese Eigenschaft auf Both gesetzt ist, zeigt die Anforderungsseite die Auswahl Importieren oder Exportierenan, wobei die Standardeinstellung Importieren lautet.
Trigger
Trigger sind vordefinierte Funktionen, die ausgeführt werden, wenn bestimmte Ereignisse auftreten. Die Textkörper dieser Funktionen sind zunächst leer und können von einem Entwickler definiert werden. Durch das Schreiben von AL-Code in Triggern können Entwickler das Standardverhalten des Systems ändern.
Die folgenden Arten von Triggern sind spezifisch für XMLports:
XMLport
Knoten
Anforderungsseite
Format
In Bezug auf den Datenaustausch zwischen Anwendungen bietet XML viele Vorteile gegenüber dem Textformat. XML-strukturierte Daten bedeuten Integrität, erhöhte Flexibilität und bessere Lesbarkeit für Benutzer. Das XML-Format bietet auch Erweiterbarkeit, z. B. das Anhängen von Schemas zur Datenüberprüfung oder das Anwenden von Stylesheets, um die Daten in eine völlig andere XML-Struktur umzuwandeln.
Trotz dieser leistungsstarken Funktionen können Situationen auftreten, in denen Daten im Nur-Text-Format ausgetauscht werden müssen. Einige Legacysysteme unterstützen XML nicht oder können Daten im XML-Format nicht einfach verarbeiten. Darüber hinaus können viele externe Anwendungen, wie Microsoft Excel, Daten im Textformat erzeugen oder lesen. Um diesen Austausch zu vereinfachen, kann XMLports neben dem XML-Format auch Daten im Textformat exportieren und importieren.
Obwohl die Regeln für die Textformatierung nicht so streng sind wie die vom XML-Format vorgegebenen, müssen Daten in Textdateien so strukturiert sein, dass ein Computer sie leicht bearbeiten kann.
Es gibt zwei Möglichkeiten, Nur-Text-Daten zu strukturieren:
Variabler Text
Feste Breite
Bei variablem Textformat werden Spalten durch ein Trennzeichen wie Komma, Doppelpunkt oder Tabulator getrennt. Für das Format mit fester Breite muss jede Datenspalte eine feste Länge für Zeichen haben.
Die Eigenschaft Format eines XMLport bestimmt den Typ der Datei, die Sie importieren oder exportieren möchten. Es gibt drei mögliche Werte:
FixedText
VariableText
XML
Eigenschaften für den Umgang mit Textdateien
Mehrere XMLport-Objekt‑ und XMLport-Knoteneigenschaften sind spezifisch für die Behandlung von Textdateien:
Breite – Bestimmt die Breite des Feldes mit fester Breite. Wenn FixedText in der Eigenschaft Format ausgewählt ist, sollten alle Elemente und Attribute der Text‑ und Feldtypen einen Eigenschaftswert Breite aufweisen, der auf größer als null festgelegt ist. Ansonsten werden Kompilierungsfehler generiert.
FieldDelimiter – Bestimmt das Texttrennzeichen für ein Feld. Der Standardwert ist ein doppeltes Anführungszeichen (").
FieldSeparator – Bestimmt das Feldtrennzeichen für Felder. Der Standardwert ist ein Komma (,).
RecordSeparator – Bestimmt das Datensatztrennzeichen für Datensätze. Der Standardwert ist <NewLine\>.
TableSeparator – Bestimmt das Tabellentrennzeichen für Tabellen. XMLports kann Daten aus oder in mehrere Tabellen gleichzeitig importieren oder exportieren. Die Tabellen werden in der Datei durch das Tabellentrennzeichen getrennt. Der Standardwert lautet <NewLine><NewLine\>.
Wenn variabler Text oder Formate mit fester Breite verwendet werden, spielt es keine Rolle, ob Sie „Element“ oder „Attribut“ als Knotentypen verwenden. Sie müssen jedoch weiterhin alle Attribute über allen Elementen anordnen, und Sie können nicht mehr als eine Hierarchieebene unter einem Element des Tabellenquellentyps verwenden.