XML-Abschnitte

Verwenden Sie "XML-Struktur. Abschnitt öffnen" (CMS007), um die XML-Abschnitte zu definieren.

Die XML-Struktur wird in logische Teile unterteilt, die in Form von XML-Abschnitten vorliegen. Für jede Druckerdatei und jede Variante gibt es vordefinierte XML-Abschnitte, die automatisch erstellt werden, wenn eine neue XML-Struktur erstellt wird. Vordefinierte XML-Abschnitte können nicht gelöscht werden. Dies gilt für folgende Formate:
  • 1 = M3-Standarddokument
  • 2 = M3-Standardbericht
  • 3 = Offen

Sie können jedoch bei Verwendung von Format 3 = "Offen" einen Abschnitt direkt in (CMS007) über das Feld Abschnittstyp erstellen. Der neu erstellte Abschnitt wird als Gruppierungsabschnitt (GRP_SEC) bezeichnet.

  • Abschnittsstatus

    Status

    Geben Sie in "XML-Struktur. Abschnitt öffnen" (CMS007/E) an, ob der Abschnittsstatus aktiv (d. h. im Ausdruck enthalten) oder inaktiv sein soll. Folgende Abschnitte können aktiviert werden: XML und CSV.XML, CSV, Flat File oder alle Formate, je nach gewünschter Ausgabe.

    • Ein Abschnitt mit Status 10 ist weder in der XML- noch in der CSV-Datei enthalten.
    • Ein Abschnitt mit Status 20 ist nur in der XML-Datei enthalten.
    • Ein Abschnitt mit Status 30 ist nur in der CSV-Datei enthalten.
    • Ein Abschnitt mit Status 40 ist nur in der CSV-Datei enthalten.
    • Ein Abschnitt mit Status 80 ist in allen Formaten für XML-, CSV- und Flat-Dateien enthalten.
    Hinweis: 

    In "XML-Struktur. Abschnitt öffnen" (CMS007/B) wird Abschnittstyp LINE_MAIN standardmäßig auf Status 80 = "Aktiv" gesetzt, d. h. der Abschnitt ist sowohl in der XML- als auch in der CSV-Datei enthalten. Alle anderen Abschnitte haben Status 20 = "Aktiv für XML", d. h. sie werden in der XML-Ausgabe berücksichtigt. 30 = LINE_MAIN ist der einzige Abschnittstyp, der für das Format "Offen" verfügbar ist.

    Sie können mehrere Abschnittstypen verwenden, die sowohl für XML-, CSV-, Flatfile-Formate oder mehrere dieser Formate aktiv sind. Verwenden Sie Option 2 = "Ändern", um den Abschnittsstatus zu aktualisieren.

    Sie können mehrere Abschnittstypen verwenden, die sowohl für XML-, CSV-, Flatfile-Formate oder mehrere dieser Formate aktiv sind. Sie können den Abschnittsstatus über die API für das Druckdateidokument und über (CMS007/E) für den Berichtstyp und das Format "Offen" ändern.

  • Tabellenname

    Das Feld für den Tabellennamen wird erst sichtbar, wenn der Abschnittsstatus in "XML-Struktur. Abschnitt öffnen" (CMS007/E) auf 30 = "Aktiv für CSV" oder 80 = "Aktiv" aktualisiert wird. Der Wert wird mit einem Tabellennamen in der Excel-Vorlage abgeglichen, um festzustellen, wo die CSV-Daten eingefügt werden sollen.

  • Blattname

    Das Feld für den Blattnamen wird zusammen mit dem Tabellennamen angezeigt, aber erst dann, wenn der Abschnittsstatus in "XML-Struktur. Abschnitt öffnen" (CMS007/E) auf 30 = "Aktiv für CSV" oder 80 = "Aktiv" aktualisiert wird. Dieses Feld wird mit einem Blattnamen in der Excel-Vorlage abgeglichen, um festzustellen, wo die CSV-Daten eingefügt werden sollen.

  • Elementname

    Sie können den Elementnamen nur für die Finanzberichtsfunktion ändern oder löschen.

  • Name GruppElem

    In diesem Feld wird die ID des Elements angegeben, das den XML-Abschnitt gruppiert. Ein leerer Wert gibt an, dass der Abschnitt nicht gruppiert ist. Ein gruppierter Abschnitt bedeutet, dass alle XML-Abschnitte, die in Sequenz gedruckt werden, nach dem Feld "Name GruppElem" gruppiert werden. Es bedeutet außerdem, dass alle Elementbezeichnungen in den gruppierten Abschnitt verschoben werden.

    Lassen Sie dieses Feld für die Finanzberichtsfunktion leer.

  • Nach Abschnitt gruppieren

    In diesem Feld wird der Gruppierungsabschnitt angegeben, zu dem der aktuelle Abschnitt gehört. Dieses Feld unterstützt die Organisation von Abschnitten in Kategorien. Wenn Sie in diesem Feld einen Wert festlegen, wirkt sich der Wert auch auf die Struktur der XML-Datei aus. Dieses Feld wird für Format 3 = "Offene Druckdateien" verwendet. Weitere Informationen dazu finden Sie unter Design und Struktur der XML-Datei.

  • Bezeichnung

    Bezeichnungen werden in "XML-Struktur. Öffnen" (CMS007/E) eingefügt.

    Folgende Methoden werden verwendet, um zu entscheiden, wie Sie die Bezeichnung festlegen sollen:
    • Eingabe 1: Es ist keine Bezeichnung enthalten.
    • Eingabe 2: Die Standard-M3 BE-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 BE-Nachrichten-ID und Meldungsdatei können definiert werden. Wenn keine Meldungsdatei definiert wird, wird MVXCON verwendet.
    • Eingabe 4: Ein übersteuernder Text kann angegeben werden. Der übersteuernde Text kann 1-15 Zeichen lang sein. Die Übersetzung wird über die Schaltfläche für die Sprache festgelegt.

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

    • 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.
  • Attribute

    Bild F wird zum Anzeigen und Definieren der Attribute verwendet. Pro Abschnitt können maximal sieben Attribute definiert werden.

    Die Attribute 1-3 hängen vom Parameter "Abschnittsattribute" ab und können nicht bearbeitet werden.

    • Attribut 1: Enthält den Wert für Bezeichnung
    • Attribut 2: Enthält den Wert für Typ
    • Attribut 3: Enthält den Wert für Subtyp.
    Die Attribute 4-7 werden als benutzerdefinierte Attribute betrachtet, in denen Sie eine Bezeichnung angeben oder ändern können. Zur XML-Struktur der Abschnittsbezeichnung wird ein benutzerdefiniertes Attribut hinzugefügt.
    Hinweis: 

    Doppelte Attributnamen sind nicht zulässig.

    Wenn neue, vordefinierte Abschnitte bereitgestellt werden, können sie unter Verwendung der Option 20 = "XML-Struktur. Öffnen" (CMS006) zu bestehenden Strukturen hinzugefügt werden.

  • Abschn. erweit.

    In diesem Feld wird die Erweiterungspunktlogik des aktuellen Abschnitts ein- oder ausgeschaltet.

    Wenn das Feld aktiviert ist, werden alle Feldwerte in einem HashMap gespeichert. Zusammen mit den anderen Parametern wie Druckerdatei, Batchjobnummer, XML-Struktur, Variante und Abschnittsnummer werden diese an ein Batchprogramm übergeben und im XtendM3-Skript zur Verfügung gestellt.