XML-Elemente

Allgemeine Funktion, die für alle Formate verwendet wird

• Elementtyp

  Elemente mit Typ 1 (Textelement) enthalten die Daten, während Elemente mit Typ 2 und 3 zum Erstellen von Unterabschnitten (Definieren von Start- und Endelementen) verwendet werden.

• Quelle der Daten

  Wird verwendet, wenn Textelemente die Quelle von Daten sind. Sie geben an, woher die Daten abgerufen werden sollen. Die am häufigsten verwendeten Datenquelle ist 1 = Feld, die beim Abrufen von Daten aus Tabellen oder virtuellen Feldern verwendet werden.

  Die Quelle der Datenfelder kann auch beim Anpassen der Felder "Betreff", "E-Mail-Text" und "Dateiname" in "Auswahl Ausgabemedium. Öffnen" (MNS205) und "Dok.-Medienkontrollobjekt. Medium verb." (CRS949) verwendet werden. Die Feldwerte werden aus der konfigurierbaren XML-Datei extrahiert und dann in vordefinierten Konstanten gespeichert.

  Die folgende Tabelle zeigt die verfügbaren vordefinierten Konstanten:

  Konstanten	Beschreibung
  <CDTT>	Aktuelles Datum und aktuelle Zeit
  <STDT>	Aktuelles Datum mit UTC-Informationen
  <CSTI>	Aktuelle Zeit mit UTC-Informationen
  <USID>	Aktuelle Benutzer-ID
  <DIVI>	Aktuelle Division
  <PRTF>	Aktuelles Druckerprogramm
  <PGNM>	Aktuelles Startprogramm
  <RLAY>	(MNS210/B) Berichtslayout
  <RPLY>	(CMS025/B) Berichtslayout
  <LITX>	Berichtstext im Startprogramm
  <PFDS>	(CMS005/E) Druckerdateibeschreibung
  <XMLT>	(CMS006/E) Variante
  <XMDS>	(CMS004/B) Beschreibung
  <DODV>	Druckerprogrammdivision

• Beschreibung

  Wird in (CMS009) als interne Beschreibung verwendet und ist nie in der XML-Datei enthalten.

• Elementname

  Der in der XML-Datei zu verwendende Elementname kann nur für XML-Strukturen mit Format 3 = Offen geändert werden. Siehe unten für den Standard, der für Format 1 und 2 verwendet wird.

• Bezeichnung

  Bezeichnungen sind in der XML-Datei enthalten. Das Attribut "Bezeichnung" (definiert in Bild F) enthält Bezeichnungen, die in die korrekte Sprache übersetzt wurden (basierend auf Benutzer, Kunde oder Lieferant).

  Hinweis

  Für gruppierte Abschnitte (in (CMS007/E) festgelegt) wird das Attribut "Bezeichnung" in die Gruppierungsabschnittsstufe verschoben und nicht als Element in Bild F definiert.

  Diese Methoden werden für die Festlegung der Bezeichnung verwendet:

  • Eingabe 1 - Es ist keine Bezeichnung enthalten.
  • Eingabe 2 - Die Standard-M3-Nachrichten-ID wird aus der Tabelle übernommen, aus der das Feld stammt. Die Übersetzung wird aus der Meldungsdatei MVXCON übernommen.
  • Eingabe 3 - Eine übersteuernde M3-Meldungs-ID und Meldungsdatei können definiert werden. Wenn keine Meldungsdatei definiert wird, wird MVXCON verwendet.
  • Eingabe 4 - Ein übersteuernder Text kann angegeben werden. Die Übersetzung wird über die Schaltfläche für die Sprache festgelegt. Der übersteuernde Text kann 1-15 Zeichen lang sein.

    Das Kontrollfeld "Fallback auf Standardmeldung" wird verwendet, wenn die Sprache, die für die Druckerdatei festgelegt wurde, in der Sprachschaltfläche nicht angegeben ist. Wenn das Kontrollfeld aktiviert ist, wird in der XML-Datei der Wert von "Standardmeldungs-ID" als Beschriftung für ein Feld, einen Abschnitt oder eine Variante verwendet. Wenn das Kontrollfeld nicht aktiviert ist, enthält die XML-Beschriftung eines Felds, eines Abschnitts oder einer Variante keine Beschriftung.

  • Eingabe 5 - Text für die Bezeichnung wird aus einem anderen Feld übernommen. Wird normalerweise verwendet, wenn die Bezeichnung durch die Ausgabefunktion dynamisch festgelegt wird, z. B. Dimension 1–7.
• Spaltenformat

  Wird verwendet, um das Zellenformat in der Excel-Ausgabe (FSLBAL) festzulegen.

  Sie können das Spaltenformat mithilfe der folgenden Eingaben definieren:

  • Eingabe 0 = Keine, Zellenformat wird immer auf "Allgemein" gesetzt.
  • Eingabe 1 = Nach Feldwert; Zellenformat wird auf "Text" gesetzt, wenn der Datentyp "String" (siehe (CMS009/E)) ist. Ansonsten wird das Zellenformat auf "Allgemeine" gesetzt.
  • Eingabe 2 = Text, Zellenformat wird immer auf "Text" gesetzt.

  Auch wenn "Mehrere Zeilen" in "XML-Struktur. Öffnen" (CMS006/E) aktiviert sind, bestimmt immer die erste Zeile das Zellenformat für die gesamte Spalte.

  Hinweis

  Diese Funktion funktioniert nur, wenn eine Excel-Vorlage verwendet wird. Daher muss in "XML-Struktur. Öffnen" (CMS006/E) für eine einzelne CSV-Datei und "XML-Struktur. Abschnitt öffnen" (CMS007/E) für mehrere CSV-Dateien ein Blattname angegeben werden.

• Soll-/Haben-Code

  Gibt an, ob Informationen zum Soll-/Haben-Code in die XML-Datei aufgenommen werden sollen. Sie werden nur für Felder angezeigt, bei denen in "Feldgruppe. Erlaubte Felder anzeigen" (CRS109/E) der Feldinformationscode A01-Währung lautet.

  Wenn das Feld "Soll-/Haben-Code" als Attribut ausgewählt ist, wird "D-C" in die XML-Datei aufgenommen. Wenn die M3 BE-Tabelle ein eigenes Feld für den Soll/Haben-Code hat, wird dieser verwendet, anderenfalls wird der S/H-Code basierend auf dem Betrag und der Einstellung in "Settings – Hauptbuch" (CRS750/E) festgelegt. Die Voraussetzung für die Aufnahme des Attributs in die XML-Datei ist, dass die Soll-/Haben-Code-Funktion für die Division in (CRS750/E) aktiv ist.

• Nullwert ausblenden

  Wird nur für Felder mit Datentyp "5-Dezimal" angezeigt.

  Numerische Felder, die null sind, können in der XML-Datei als 0,00 oder als leer definiert werden. Wenn das Feld "Nullwert ausblenden" aktiviert ist, wird Null als leeres Feld berücksichtigt, andernfalls als 0,00.

• Attribute (Bild F)

  Das Bild F wird verwendet, um die Attribute für die Elemente zu definieren. Pro Element können maximal sieben Attribute definiert werden.

  Attribut 1 und 2 sind reservierte Attribute, die nicht bearbeitet werden können.

  • Attribut 1: Enthält den Wert für die Beschriftung (Details oben).
  • Attribut 2: Enthält den Wert für den Soll-/Haben-Code (Details oben).

Format 1 - M3-Standarddokument

Elementsequenznummer

Wird als Sequenz des Elements innerhalb eines Abschnitts der XML-Datei verwendet. Der Sequenznummernbereich ist in drei Gruppen aufgeteilt:

Elementname

Wenn die Datenquelle auf 1-Feld gesetzt ist, wird das Element nach folgenden Regeln gesetzt:

• Bei Datenbankfeldern wird es auf den sechsstelligen Datenbanknamen gesetzt, z. B. OAORNO oder MMITNO.
• Bei virtuellen Feldern wird & durch VF ersetzt, z. B. VFCUCD oder VFACAM
• Bei anderen Datenquellen wird der Elementname auf ZZxxxx gesetzt, wobei xxxx das vordefinierte Suffix pro Datenquelle ist.

XML-Beispiel

XML-Beispiel mit drei Elementen

<UHIVDT Label="Rechnungsnummer">201401561</UHIVDT>

<VFORNO Label="KA-Nr">1000025077</VFORNO>

<OAWHLO Label="Lagerort">110</OAWHLO>

Format 2 – M3-Standarddokument

Die Formatelemente für M3-Standardberichte sind in einem Format mit Zeilen und Spalten strukturiert. Jede Spalte muss zu einer Zeile gehören. In (CMS009) geben Start- und Endelemente eine Zeile an, und alle Elemente zwischen diesen Start- und Endelementen gehören zu dieser Zeile.

• Elementsequenznummer

  Dient der Sequenzierung des Elements in der XML-Datei und der Entscheidung darüber, zu welcher Zeile das Element gehört.

  Für jede Zeile ist ein Bereich von Sequenznummern reserviert:

  Elementsequenznummer	Reserviert
  0002-0999	Reserviert für Zeile 1
  1002-1999	Reserviert für Zeile 2
  …	…
  8002-8999	Reserviert für Zeile 9

• Zeilen hinzufügen oder löschen

  Das Hinzufügen von Zeilen erfolgt mit der Funktionstaste F21 = Zeile hinzufügen, wodurch ein Start- und ein Endelement für die nächste freie Zeile erstellt werden. Das Löschen von Zeilen erfolgt mit der Funktionstaste F22 = Zeile löschen, wodurch das Startelement, das Endelement und das gesamte Textelement dazwischen für die Zeile mit der höchsten Zahl gelöscht werden.

• Spaltennummer

  Wird verwendet, die Spaltennummer des Feldes in einem Layout anzugeben. Innerhalb einer Zeile muss die Nummer eindeutig sein. Die Spaltennummer ist Teil des Elementnamens. Wenn Sie die Spaltennummer ändern, wird der Elementname automatisch aktualisiert.

• Feldlänge

  Wird verwendet, um den benötigten Platz für das Feld in einem Layout anzugeben. Der Standardwert wird aus der Feldlänge in der Tabelle übernommen.

• Elementname

  Geben Sie "Cx" ein, wobei "x" für die Spaltennummer steht (siehe Spaltennummer oben).

• Zusätzliche Beschriftung

  Wenn ein Feld eine zusätzliche Beschriftung benötigt, wird diese durch Angabe einer M3-Meldungs-ID und einer Meldungsdatei definiert. Wenn keine Meldungsdatei definiert wird, wird "MVXCON" verwendet. Die zusätzliche Beschriftung wird dann in die XML-Datei aufgenommen und in die richtige Sprache übersetzt (basierend auf Benutzer, Kunde oder Lieferant).

• Feld auf Ebene der Jobausführung deaktivieren

  Bestimmte Felder müssen möglicherweise deaktiviert werden, damit sie nicht für den gesamten Job in der XML-Datei berücksichtigt werden. Beispielsweise sollte das Feld "USt-Code" nur berücksichtigt werden, wenn USt verwendet wird.

  Dies wird durch den Parameter "Deaktiviert ausführen" gesteuert. Die Entscheidung, ob ein Feld deaktiviert werden soll, basiert auf einem virtuellen Feld aus dem Abschnittstyp REPORT. Wenn das virtuelle Feld auf "wahr" (Wert 1) gesetzt ist, wird das Feld als deaktiviert betrachtet.

  Eingaben für Parameter "Deaktiviert ausführen":

  • 1 = Keine Deaktivierungskontrolle
  • 2 = Deaktivierungskontrolle - Feld wird immer noch in der XML-Datei berücksichtigt, aber der Wert wird im Falle einer Deaktivierung auf "Leer" gesetzt
  • 3 = Deaktivierungskontrolle und entfernen - Feld wird aus der XML-Datei entfernt, wenn es deaktiviert ist

Format 3 - Offen

Für das Format "Offen" gibt es keine zusätzliche Funktionalität oder andere Einschränkungen.