XML-Struktur

Format

Das Format bestimmt die Struktur der XML-Datei sowie Einschränkungen und Regeln bei der Konfiguration der XML-Datei.

• M3-Standarddokument

  Nutzen Sie den M3-Standardbericht, wenn die XML-Datei zur Formatierung und Verteilung an eine externe Ausgabeverwaltungsanwendung übermittelt wird. Der Inhalt der XML-Datei umfasst neben den Zeilen auch Kopf-, Text-, Adress- und Übersichtsabschnitte. In der Regel ist das Layout im Hochformat ausgerichtet. Um sicherzustellen, dass die externe Anwendung immer funktioniert, gibt es Einschränkungen in Bezug darauf, was bei Verwendung dieses Formats geändert werden kann. Dieses Format kann nur für Druckerdateien vom Typ "Dokument" verwendet werden.

  Wenn das Format "1 - M3-Standarddokument" ausgewählt ist, werden weitere Felder wie das Stammelement, Schemas und Elementname deaktiviert oder nicht verwendet.

• M3-Standardbericht

  Nutzen Sie den M3-Standardbericht, wenn die XML-Datei zur Formatierung und Verteilung an eine externe Ausgabeverwaltungsanwendung übermittelt wird. Der XML-Inhalt besteht hauptsächlich aus Zeilen, kann jedoch in kleinerem Umfang auch Kopf- und Übersichtsdaten enthalten. Das Layout ist normalerweise auf Querformat eingestellt. Um sicherzustellen, dass die externe Anwendung immer funktioniert, gibt es Einschränkungen in Bezug darauf, was bei Verwendung dieses Formats geändert werden kann. Dieses Format kann nur für Druckerdateien vom Typ "Bericht" verwendet werden. Der M3-Standardbericht verwendet nur die Abschnitte Berichts-, Kopf-, Berichtskopf-, Gruppen-, Haupt- und Detailabschnitt.

  Wenn das Format "2 - M3-Standardbericht" ausgewählt ist, werden andere Felder wie Stammelement, Schemas und Elementname deaktiviert oder nicht verwendet.

• Öffnen

  "Öffnen" soll verwendet werden, wenn die XML-Datei für die Integration in andere Systeme verwendet werden soll. Das empfangende System benötigt dann möglicherweise ein bestimmtes Format. Es gibt keine Einschränkungen, was geändert werden kann. Dies wird hauptsächlich in der Funktion "Finanzberichte" verwendet.

  Wenn das Format "3 - Öffnen" ausgewählt ist, sind weitere Felder wie Stammelement, Schemas und Elementname aktiviert.

  • Stammelement: In diesem Feld wird das Stammelement eines XML-Dokuments angegeben. Es muss ein Stammelement enthalten, das das übergeordnete Element eines anderen Elements ist. Das Stammelement ist das erste und letzte Tag im XML-Dokument.

  • Standardnamensraum - Mit XML-Namensräumen lassen sich Elementnamenskonflikte vermeiden. In XML werden die Elementnamen vom Entwickler vergeben. Dies führt häufig zu Konflikten, wenn XML-Dokumente aus verschiedenen XML-Anwendungen kombiniert werden sollen. Der Namensraum wird durch ein xmlns-Attribut im öffnenden Tag eines Elements definiert. Die Namensraumdeklaration hat folgende Syntax: xmlns:prefix="URI".

    Wenn für ein Element ein Standardnamensraum definiert wird, müssen für sämtliche untergeordnete Elemente keine Präfixe mehr verwendet werden. Die Definition eines Standardnamensraums hat folgende Syntax: xmlns="namespaceURI"

    Das Feld "Standardnamenraum" muss einen Wert enthalten, damit die anderen Felder, z. B. "Namensraum 1" und "Präfix für Namensraum 1" beim Drucken in der XML-Struktur angezeigt werden.

  • Präfix für Namensraum 1: In diesem Feld wird das Präfix für Namensraum 1 angegeben.
  • Schemanamensraum: In diesem Feld wird der Schemanamensraum angegeben. Die Verwendung von Namensräumen und Präfixen wird empfohlen, um Mehrdeutigkeiten bei Element- und Attributdeklarationen zu vermeiden, da verschiedene Elemente und Attribute in XML-Dokumenten mit unterschiedlichem Vokabular beschrieben werden können. Die Unterscheidung zwischen Element- und Attributnamen einzelner Namensräume ist notwendig, wenn Schemata aus mehr als einem Namensraum verwendet werden.
  • Schema: In diesem Feld wird das XML-Schema angegeben. Das XML-Schema beschreibt die Struktur eines XML-Dokuments. Es dient dazu, die zulässigen Bausteine eines XML-Dokuments zu definieren:
  • Elementname: In diesem Feld wird der Elementname angegeben, aus dem sich der Name des Tags ergibt. Wenn es sich bei dem Element um einen Artikel handelt, lautet das Tag <Artikel>.

XML-Datei aufteilen

Dieses Kontrollfeld steuert, ob das Ergebnis für einen Ausgabejob in mehrere kleinere XML-Dateien aufgeteilt werden soll. Sie können eine Aufteilung pro Dokument vornehmen. Beispielsweise eine XML-Datei pro Rechnung oder pro Einkaufsauftrag. Wenn Sie in "Ausgabeservice. Öffnen" (MNS216) Schnittstelle 3 = IDM Output Management und Schnittstelle 6 = IDM Output Mgt, doppelte Schnittstelle ausgewählt haben, muss das Kontrollfeld aktiviert sein.

Prüfung CSV-Dateien

• Tabellenname

  Dieses Feld wird mit einem Tabellennamen in der Excel-Vorlage abgeglichen, um festzustellen, wo die CSV-Daten eingefügt werden müssen.

• Blattname

  Dieses Feld wird mit einem Blattnamen in der Excel-Vorlage abgeglichen, um zu bestimmen, wo die CSV-Daten eingefügt werden sollen. Nach Angabe eines Tabellennamens wird "Listenname" zu einem erforderlichen Feld, nachdem ein Tabellenname angegeben wurde. Für eine einzelne CSV ist der Blattname auch dann erforderlich, wenn in "XML-Strukturabschnitt. Öffnen" (CMS009/E) das Feld "Spaltenformat" den Wert 1 oder 2 hat.

  Hinweis

  Wenn die Felder "Tabellenname" und "Blattname" beide leer gelassen werden, werden hochgeladene Vorlagen ignoriert, da die Vorlagen keine Treffer und daher keine Informationen bieten, wo die Daten eingefügt werden sollen. Dies führt zu einer Excel-Ausgabe ohne irgendeine Formatierung. Dieses Feld wird mit einem Blattnamen in der Excel-Vorlage abgeglichen, um festzustellen, wo die CSV-Daten eingefügt werden sollen. Der Blattname wird zum Pflichtfeld, sobald ein Tabellenname angegeben wird.

• Abschn Überschr

  In diesem Feld können Sie angeben, welche Abschnitte aus "XML-Struktur. Abschnitt öffnen" (CMS007) in der obersten Zeile der CSV-Datei gedruckt werden sollen. Die obersten Zeilen enthalten nur die Textelementbeschriftungen, die in "XML-Strukturabschnitt. Öffnen" (CMS009) angegeben sind.

  Hinweis

  Nur Abschnitte mit Status 30 und 80 können als Überschrift ausgewählt werden.

• Mehr. Sp.Köpfe

  Dieses Kontrollfeld steuert, ob die zusätzliche Beschriftung in der Zeile über den Feldbeschriftungen angezeigt werden soll. Wenn Sie die Option deaktivieren, wird in der CSV-Datei die zusätzliche Meldung in "XML-Strukturabschnitt. Öffnen" (CMS009) nicht angezeigt.

• Mehrere Zeilen

  Dieses Kontrollfeld steuert, wie der Bereich nach dem Zeilengruppierungselement in "XML-Strukturabschnitt. Öffnen" (CMS009) aufgeteilt wird. Wenn Sie die Option deaktivieren, umgeht der CSV-Export Zeilengruppierungselemente und zeigt alle Felder in einer einzelnen Zeile an.

  Hinweis

  Die Funktionen "Mehrere Sp.Köpfe" und "Mehrere Zeilen" gelten nur für Berichte.

• UTC-Abweichung anzeigen

  Dieses Kontrollfeld steuert, ob die UTC-Informationen in der XML-Struktur angezeigt werden. Wenn das Kontrollfeld nicht aktiviert ist, sind die UTC-Informationen in der XML-Struktur nicht verfügbar. Die Verwendung mehrere Überschriften und Zeilen ist eine Funktion, die nur auf Berichte anwendbar ist.

Archivinformationen

Die Bilder F und G in (CMS006) enthalten Informationen zur Dokumentarchivierung. Die Informationen entsprechen den in IDM benötigten Informationen, werden jedoch auch für andere Archivierungsanwendungen verwendet. Ein Medium des Typs *ARCHIVE muss bei der Auswahl des Ausgabemediums für Archivinformationen aufgenommen werden, die in der XML-Datei enthalten sein sollen.

• Dokumenttyp

  Zeigt die Dokumenttyp-ID innerhalb von IDM an. Die ID in M3 BE muss genau mit der ID in IDM übereinstimmen. Sie müssen einen Wert oder eine Referenz zu einem XML-Objekt angeben.

• Dateiname

  Zeigt den Dateinamen an, der in IDM verwendet werden soll. Sie müssen einen Wert oder eine Referenz zu einem XML-Objekt angeben.

• Zugriffssteuerungsliste

  Zeigt die Zugriffssteuerungsliste in IDM an. Die ID in M3 BE muss genau mit der ID in IDM übereinstimmen. Sie müssen einen Wert oder eine Referenz zu einem XML-Objekt angeben.

• Archivieren

  Wenn in "Listen- und Druckerprogr. Konfigurieren" (CMS005) für "Archivierungskontrolle" die Option 0 = Einstellung aus CMS006 verw. ausgewählt ist, wird über dieses Feld angegeben, ob Kopien der Druckerdatei archiviert werden müssen. Wählen Sie 0 = Nein aus, um die Archivierungskontrolle in (CMS006) zu deaktivieren und Medien aus "Auswahl Ausgabemedium. Öffnen" (MNS205) oder "Dok.-Medienkontrollobjekt. Medium verb." (CRS949) für Druckerdateien vom Dokument- und Berichtstyp zu verwenden. Wählen Sie 1 = Nur Original aus, um nur das ursprüngliche Dokument zu archivieren. Wählen Sie 2 = Nur Kopien aus, um nur die Kopien des Dokuments zu archivieren. Wählen Sie 3 = Original und Kopien aus, um das Original und die Kopien des Dokuments zu archivieren. Wählen Sie 4 = Ja aus, um Druckerdateien vom Typ "Bericht" zu archivieren.

  Wählen Sie eine der folgenden Optionen aus:

  • 1 = Nur Original: Archiviert nur das ursprüngliche Dokument.
  • 2 = Nur Kopien: Archiviert nur die Kopien des Dokuments.
  • 3 = Original und Kopien: Archiviert das Original und die Kopien des Dokuments.

  Wenn für "ArchivKontrolle" 1, 2 oder 3 die Option "Version aktualisieren" aktiviert ist, wird die Version eines in IDM gespeicherten Dokuments aktualisiert, wenn sie mit den Archivierungsattributen und dem Dokumenttyp des neuen Dokuments übereinstimmt. Diese Funktion gibt es nur bei IDM.

• Dateityp

  Wenn in (CMS006) für "Archiv" der Wert 1, 2, 3 oder 4 ausgewählt ist, wird dieses Feld verwendet, um den zu archivierenden Dateityp anzuzeigen. Wenn IDM Output Management für Schnittstellen-XML-Dateien verwendet wird, sind nur die Eingaben "PDF", "Word" oder "Word und PDF" gültig. Bei Auswahl einer anderen Eingabe entspricht der Dateityp "PDF". Wenn IDM Output Management für Schnittstellen-CSV-Dateien verwendet wird, werden alle Optionen ignoriert und der Dateityp ist immer "Excel".

  Beim Archivieren von Dokumenten in IDM sind die gültigen Dateitypen 1 = PDF, 2 = Excel und 6 = Word. Die Option "Version aktualisieren" ist für Dateityp 7 = Word und PDF nicht gültig.

• Attribut-ID

  Zeigt die Attribut-ID innerhalb von IDM an. Die gültige Attribut-ID ist von der Dokumenttyp-ID abhängig. Die ID in M3 Business Engine muss genau mit der ID in IDM übereinstimmen.

  Für die "Version aktualisieren" muss die Attribut-ID in M3 mit der Attribut-ID in IDM übereinstimmen. Nur das neueste Dokument mit denselben Attributen wird mit der neuen Version in IDM aktualisiert.

• Attributwert

  Zeigt, wie der Wert für eine Attribut-ID festgelegt wird.

  "Version aktualisieren" ist für Attribute mit mehreren Werten nicht zulässig. Die Versionen werden nur aktualisiert, wenn der Abgleich für Attribute mit Einzelwerten vorgenommen wird.

• Dokumenttyp

  Der Dokumenttyp, der beim Archivieren des Dokuments in IDM verwendet wird, muss die Eigenschaft "Eindeutige ID verwenden" in IDM aktiviert sein, damit die Versionsfunktion zur Aktualisierung verwendet werden kann.

Freie Felder

Verwenden Sie Bild H in (CMS006), um die fest programmierten Werte sowie die vordefinierten und benutzerdefinierten Konstanten zu erfassen. Diese werden in den Feldern "Betreff" und "E-Mail-Text" von "Auswahl Ausgabemedium. Öffnen" (MNS205) und "Dok.-Medienkontrollobjekt. Medium verb." (CRS949) als Parameter verwendet.

Die Werte werden aus der XML-Ausgabedatei extrahiert und dann in benutzerdefinierten und vordefinierten Konstanten gespeichert.

Die folgende Tabelle zeigt die verfügbaren benutzerdefinierten Konstanten:

• Bestimmter Wert

  Zeigt die hartkodierten oder konstanten Werte an.

• XML-Abschnitt

  Verwenden Sie dieses Feld, um den XML-Abschnitt anzugeben, der in einer bestimmten Druckerdatei verfügbar ist. Dieser Abschnitt kann in "XML-Struktur. Abschnitt öffnen" (CMS007) gefunden werden.

• Elementsequenznummer

  Verwenden Sie dieses Feld, um die in einem bestimmten XML-Abschnitt verfügbaren Elemente anzugeben. Diese Elemente können in "XML-Strukturabschnitt. Öffnen" (CMS009) gefunden werden.

Verknüpfte Dokumenttypen für Infor Document Management

In Bild H (CMS006) ermöglichen es die verknüpften Dokumentfelder dem Benutzer, bis zu fünf Dokumenttypen aus "Dokumenttyp. Öffnen" (MNS060) auszuwählen. Diese Dokumenttypen werden mit einer entsprechenden Datei abgeglichen, die in Infor Document Management hochgeladen wurde, und anschließend in die Ausgabe aufgenommen. Verknüpfte Dokumente werden gemäß dem Dokumenttyp und den Attributen abgerufen, die in (MNS060) ausgewählt wurden.

Die ausgewählte Medienoption wird verwendet, um zu bestimmen, wann eine Anlage enthalten sein soll. Wenn beispielsweise Option 2 = "Drucken" ausgewählt ist, enthält diese Option nur dann eine Anlage, wenn die ausgewählte Ausgabe zum Drucken vorgesehen ist und nicht per E-Mail gesendet werden soll.

Kontrollfeld "Zusammenführen"

Durch die Option "Zusammenführen" wird festgelegt, ob die Anlagen in einer einzelnen PDF-Datei zusammengeführt werden sollen. Die Zusammenführungsoption ist nur für diesen Dateityp gültig: 1 = PDF in (MNS205). Andere Dateitypen in (MNS205) führen dazu, dass verknüpfte Dokumente separat angehängt werden, so als ob die Option nicht ausgewählt worden wäre.