Benutzerdefinierte Textblöcke hinzufügen

In diesem Dokument werden benutzerdefinierte Textblöcke definiert.

Benutzerdefinierte Textblöcke werden als Zusatzinformationen für eine Druckerdatei verwendet, die in einer XML-Struktur verbunden werden kann. Das Verbinden kann in "XML-Struktur. Abschnitt öffnen" (CMS007) über 24 = Benutzerdefinierten Textblock hinzufügen erfolgen. Vor der Verwendung des benutzerdefinierten Textblocks müssen folgende Programme eingerichtet werden:
Hinweis

Das Hinzufügen neuer Abschnitte kann sich stark auf die Leistung der Ausgabefunktion auswirken. Außerdem gilt diese Funktion nur für Druckerdateien vom Typ 1 = Dokument.

A. "XML-Textschlüsselgruppe. Öffnen" (CMS034)

Dieses Programm definiert die Schlüsselgruppen. Schlüsselgruppen sind eindeutige Datensätze mit einer Länge von 36 Zeichen. Jede Schlüsselgruppe kann vier Schlüsselfelder enthalten. Felder aus "Tabellenfelder. Öffnen" (MNS121) können als Schlüsselfelder verwendet werden. Diese Schlüsselfelder werden in (CMS038) verwendet.
Hinweis

Das CONO-Feld kann nicht als Schlüsselfeld verwendet werden.

Führen Sie folgende Schritte aus, um eine Schlüsselgruppe zu erstellen:
  1. Starten Sie (CMS034).
  2. Geben Sie den Namen der Schlüsselgruppe an. Verwenden Sie Option 1 = Erstellen.
  3. Geben Sie in Bild E eine Beschreibung an. Durch Klicken auf die Schaltfläche "Sprache" kann dies auch pro Sprache definiert werden.
  4. Geben Sie bis zu vier Schlüsselfelder an. Diese Schlüsselfelder geben ein Feld aus einer M3-Tabelle an.
  5. Drücken Sie die Eingabetaste.

B. "Benutzerdefinierter XML-Text. Öffnen" (CMS036)

Dieses Programm definiert die Text-IDs, die den in der XML-Struktur angezeigten Textblock enthalten. Text-IDs können in folgender Kombination verwendet werden:
  • Text-ID und Sprache
  • Text-ID

    Aktiviertes Feld "Einzelne Division verwendet" (SNDI) für (CMS036).

Felder, die in (CMS036/B) zu berücksichtigen sind:
  • Text-ID - Gibt die Text-ID an. Text-ID wird mehreren Startdaten und Sprachen zugewiesen.
  • Startdatum - Gibt das Datum an, an dem die Text-ID zur Verwendung verfügbar ist.
  • Sprache - zeigt die Sprache an, die zum Abgleichen mit dem Feld "XML-Dokumentsprache" verwendet wird. Die Sprache hat Priorität beim Abgleichen eines Text-ID-Datensatzes, der in der XML-Struktur angezeigt wird.
Hinweis

Beide Kombinationen sind unabhängig vom Startdatum. Wenn keine der Text-ID-Kombinationen ein gültiges Startdatum enthält oder bereits nach dem Enddatum liegt, wird der Textblock nicht generiert.

Felder, die in (CMS036/E) zu berücksichtigen sind:
  • Beschreibung - Beschreibt die Text-ID und kann über die Schaltfläche "Sprache" in verschiedene Sprachen übersetzt werden.
  • Enddatum - Gibt das letzte gültige Datum des Datensatzes an.
  • Texttyp - Gibt den Texttyp in der XML-Struktur an.
  • Textplatzierung - Gibt den Textsubtyp an. 1 = Vortext oder 2 = Nachtext.
  • Beschriftung - Gibt die Bezeichnung des Textblocks an. Beschriftungen können als 1 = Meldungs-ID oder 2 = Text klassifiziert werden. Beschriftungstext kann über die Schaltfläche "Sprache" in verschiedene Sprachen übersetzt werden.
  • Text - Ein Textbrowser, in dem der Benutzer eine Information eingeben muss. Wenn keine Eingabe erfolgt, wird der Textblock in der XML-Struktur nicht angezeigt, auch wenn Kriterien erfüllt sind.

Führen Sie folgende Schritte aus, um eine Text-ID zu erstellen:

  1. Starten Sie "Benutzerdefinierter XML-Text. Öffnen" (CMS036).
  2. Geben Sie im Feld "Text-ID" die Text-ID an, die mehreren Startdaten zugewiesen werden kann, um deren Gültigkeit zu bestimmen. Sie ist in (CMS038) mit einer Schlüsselgruppe verbunden.
  3. Geben Sie im Feld "Startdatum" an, ab welchem Datum der Text gültig ist.
  4. Geben Sie im Feld "Sprache" die Sprache an, in der externe Dokumente gedruckt werden sollen.
  5. Verwenden Sie Option 1 = Erstellen.
  6. Geben Sie in Bild E die Beschreibung an, die auch pro Sprache definiert werden kann, indem Sie auf die Schaltfläche "Sprache" klicken.
  7. Geben Sie im Feld "Enddatum" das letzte gültige Datum des Datensatzes an.
  8. Geben Sie im Feld "Texttyp" den Texttyp an, der in die XML-Datei aufgenommen werden soll.
  9. Geben Sie im Feld "Textplatzierung" den Subtyp des Textes an.

    Gültige Eingaben für die Textplatzierung:

    • 1 = Vor - der Textsubtyp ist "Vortext".
    • 2 = Nach - der Textsubtyp ist "Nachtext".
  10. Geben Sie die Beschriftung an, indem Sie entweder eine Meldungs-ID oder einen Text angeben. Wenn Sie eine Meldungs-ID angeben, wird die Beschriftung automatisch in der Sprache des M3-Endbenutzers angezeigt. Wenn Sie einen Text eingeben, kann durch Klicken auf die Schaltfläche "Sprache" das Feld auch entsprechend der Sprache definiert werden.
  11. Drücken Sie die Eingabetaste.
  12. Geben Sie den Text im M3-Textfenster an. Dieser Text gibt den Textblock an, der in der XML-Datei angezeigt wird. Die Felder "Textblock" und "Sprache" müssen leer sein, andernfalls tritt ein Fehler auf.
  13. Drücken Sie die Eingabetaste.
    Hinweis

    Sie können mehrere Text-IDs mit demselben Namen erstellen, solange das jeweilige Startdatum unterschiedlich ist. Sie können mehrere Text-IDs mit demselben Namen und Startdatum erstellen, solange die Sprachen unterschiedlich sind. Der zu verwendende benutzerdefinierte Textblock ist derjenige, der mit dem Sprach-Trigger übereinstimmt.

C. "Benutzerdef. XML-Text. Schl.Feld öffnen" (CMS038)

Dieses Programm definiert die Text-ID und den Schlüsselfeldwert, der mit der Schlüsselgruppe verbunden ist. Werte für "Schlüsselfeld" sind fest programmiert (hartcodiert). Wenn den Schlüsselfeldern in (CMS038) Werte zugewiesen sind, kann die entsprechende Schlüsselgruppe in (CMS034) nicht geändert oder gelöscht werden.
Hinweis

Sie können die Schlüsselfeldwerte und die Text-ID leer lassen, obwohl dies nicht als generische Einrichtung gilt. Die Feldwerte müssen auch im XML-Format leer sein, damit der benutzerdefinierte Textblock angezeigt wird.

In "Listen- und Druckerprogr. Konfigurieren" (CMS005) ist das Feld "Einzelne Division verwendet" (SNDI) für (CMS038) aktiviert.

Führen Sie folgende Schritte aus, um einer Text-ID Schlüsselwerte zuzuweisen:
  1. Starten Sie (CMS038).
  2. Geben Sie die "Text-ID" an. Diese Text-ID ist mit einer Schlüsselgruppe verbunden.
    Hinweis

    Die Position der Text-ID kann je nach verwendeter Sortierfolge variieren.

  3. Geben Sie im Feld "Schlüsselgruppe" die eindeutige Schlüsselgruppen-ID an. Das Feld wird in (CMS034) verwaltet.
  4. Klicken Sie auf "Anwenden". Die Spaltenbeschriftungen basieren auf den in (CMS034) definierten Beschriftungen der Schlüsselfelder.
  5. Geben Sie im Feld "Wert" den Wert des Schlüsselfelds an, das mit einem Objekt oder einem Wert in "Ben.def. XML-Txt AbschnSteuerung. Öffnen" (CMS033) verglichen werden soll.
  6. Verwenden Sie Option 1 = Erstellen.
  7. In Bild E werden die Werte der Schlüsselfelder angezeigt, diese können aber nicht geändert werden.
  8. Drücken Sie die Eingabetaste.

D. "Ben.def. XML-Txt AbschnSteuerung. Öffnen" (CMS033)

Dieses Programm wird verwendet, um die Schlüsselgruppe (CMS034) mit einem Basis-XML-Abschnitt (CMS007) zu verbinden. Ein Objekt, ein Wert oder eine Kombination aus Objekt und Wert wird dann pro Schlüsselfeld zugewiesen, das mit den Werten in (CMS038) verglichen werden soll. Sobald diese Informationen abgeglichen sind, steht der benutzerdefinierte Textblock in der XML-Struktur zur Verfügung.

Felder, die in (CMS033/B) zu berücksichtigen sind:
  • Druckerdatei - Hier ist der konfigurierbare Textblock verbunden.
  • XML-Abschnitt - Hier ist der konfigurierbare Textblock zugeordnet. Dieses Feld muss einen Wert größer als 100 haben. Es wird auch in anderen CMS-Programmen wie "XML-Abschnitt. Tabelle öffnen" (CMS008) und "XML Kd.def. Zw.Summe-Felder. Verbinden" (CMS018) verwendet.
Felder, die in (CMS033/E) zu berücksichtigen sind:
  • In diesem Feld wird die eindeutige Schlüsselgruppen-ID angegeben, die in (CMS034) verwaltet wird.
  • Basis-XML-Abschnitt - Gibt den Basis-XML-Abschnitt an, mit dem der konfigurierbare Textblock verbunden ist.
Optionen zum Einrichten von "Ben.def. XML-Txt AbschnSteuerung. Öffnen" (CMS033):
  • Werte als Schlüsselfelder verwenden - Verwendet, um hartcodierte Werte festzulegen. Wenn diese hartcodierten Werte mit dem Datensatz in (CMS038) übereinstimmen, wird der benutzerdefinierte Textblock in der XML-Datei angezeigt.
  • Werte als Schlüsselfelder verwenden - Verwendet, um Objekte auf Basis des verfügbaren Tabellenfeldwerts zu definieren. Wenn diese Objektdefinitionen mit den Datensätzen in der XML-Struktur übereinstimmen, wird der benutzerdefinierte Textblock angezeigt.
  • Objekte und Werte als Schlüsselfelder verwenden - Verwendet, um sowohl Objekte als auch Werte für Schlüsselfelder zu definieren. Diese Auswahl folgt dem Verhalten, dass bei Übereinstimmung von hartcodierten Werten mit (CMS038) und bei Übereinstimmung von Objektwerten mit der XML-Struktur der benutzerdefinierte Textblock gezeigt wird.
Führen Sie folgende Schritte aus, um eine Schlüsselgruppe einem Basis-XML-Abschnitt zuzuweisen:
  1. Starten Sie (CMS033).
  2. Geben Sie im Feld "Druckerdatei" den eindeutigen Identifikator für konfigurierbare XML-Ausgaben an.
  3. Geben Sie im Feld "XML-Abschnitt" den Wert des XML-Abschnitts an. Dieser muss größer als 100 sein.
  4. Verwenden Sie Option 1 = Erstellen.
  5. Geben Sie in Bild E im Feld "Schlüsselgruppe" eine eindeutige Schlüsselgruppen-ID an. Dieses Feld wird in (CMS034) verwaltet.
  6. Geben Sie im Feld "Basis-XML-Abschnitt" den Basis-XML-Abschnitt an, der als übergeordneter Abschnitt betrachtet wird. Wenn Sie den Basis-XML-Abschnitt drucken, wird auch der untergeordnete Abschnitt gedruckt.
  7. Geben Sie entweder ein Objekt, einen Wert oder eine Kombination aus Objekt und Wert an. Das Objekt gibt ein Schlüsselfeld in einer M3-Tabelle an. Im Feld „Wert“ wird der Wert des Schlüsselfelds angegeben, der mit einem Wert in (CMS038) verglichen wird.
  8. Drücken Sie die Eingabetaste.

E. Benutzerdefinierten Textblock mit der XML-Struktur in (CMS007) verbinden

Nach dem Erstellen der Datensätze für den benutzerdefinierten Textblock können diese im Basis-XML-Abschnitt in (CMS007) hinzugefügt werden, und die Druckerdatei kann gedruckt werden. Wie erwartet sollte ein konfigurierbarer Textblock in der XML-Struktur angezeigt werden.
  1. Starten Sie "XML-Struktur. Öffnen" (CMS006), wählen Sie "XML-Struktur" aus, und verwenden Sie Option 24 = XML-Struktur. Abschnitt öffnen, um (CMS007) zu starten.
  2. Wählen Sie den Abschnitt aus, in den der benutzerdefinierten Textblock in (CMS007) eingefügt werden soll, und verwenden Sie die verknüpfte Option 24 = Benutzerdefinierten Textblock hinzufügen.
  3. M3-Browser zum Anzeigen von Abschnitt und Schlüsselgruppe, die in "Ben.def. XML-Txt AbschnSteuerung. Öffnen" (CMS033) erstellt wurden.
  4. Wählen Sie den Datensatz aus, zu dem der Abschnitt in der XML-Struktur hinzugefügt werden soll.
  5. Nach dem Einbinden in die XML-Struktur ist der benutzerdefinierte Textblock verfügbar, wenn die Druckerdatei generiert wird.

Dieselben Text-IDs, aber verschiedene Startdaten können in "Benutzerdefinierter XML-Text. Öffnen" (CMS036) erstellt werden. "Text-ID" und "Sprache" sind die primären Schlüssel die übereinstimmen, gefolgt von den Datumsangaben. Wenn eine Übereinstimmung bei Text-ID und Sprache gefunden wird, bei der die Datumsangaben jedoch ungültig sind, erfolgt keine Aufnahme in einem Datensatz mit leerer Sprache. Stattdessen wird der Textblock nicht in der XML-Struktur angezeigt.

Bei verschiedenen Text-IDs werden erst die Sprache, dann die Datumsangaben für die Anzeige des Textblocks in der XML-Struktur berücksichtigt. Wenn jedoch kein passender Datensatz in der Division vorhanden ist, werden Text-IDs in der leeren Division gesucht.

Verwandte Themen