XML-Filter konfigurieren

XML-Filter

Um mehr über Filter im Allgemeinen zu erfahren, siehe Abschnitt Informationen zu Filtern.

Verwenden Sie diesen Filter, wenn ein Trigger XML-codierte Daten erhält. Der Filter ermöglicht es Ihnen, einzelne Felder, Felder in sich wiederholenden Unterbereichen und sogar Name-Wert-Paare zu extrahieren. Die XML-Struktur gibt Elemente und Unterelemente, Attribute und ihre Werte sowie Textwerte (Elementwerte) vor.

Obwohl Sie die Struktur der XML-Datei selbst definieren können, empfiehlt NiceLabel Ihnen, die Struktur aus der vorhandenen XML-Beispieldatei zu importieren. Klicken Sie auf Datenstruktur importieren in der Menüleiste. Nachdem Sie die XML-Struktur importiert haben, wird im Abschnitt, Datenvorschau“ der XML-Inhalt angezeigt. Außerdem hebt dieser Abschnitt die Elemente und Attribute hervor, die Sie als Ausgabefelder definieren.

Beispiele für XML-Daten finden Sie im Abschnitt XML-Daten.

Struktur definieren

Um die XML-Objekte zu verwenden, konfigurieren Sie sie wie folgt:

Variablenwert: Gibt an, dass Sie das ausgewählte Element als Feld verwenden möchten und seinen Wert den entsprechenden Variablen in der Aktion Datenfilter verwenden zuordnen werden. Weitere Informationen finden Sie im Abschnitt XML-Felder definieren.
- Optionales Element: Gibt an, dass das Element nicht obligatorisch ist. Dies entspricht dem XML-Schema-(XSD-Datei-)Attribut minOccurs=0. Die einem solchen Feld zugeordnete Variable hat einen leeren Wert, wenn das Element nicht im XML erscheint.
Datenblöcke: Gibt an, dass das ausgewählte Element mehrere Male vorkommt und Daten für ein einzelnes Etikett bereitstellt. Ein Datenblock kann als sich wiederholender Bereich, als Zuweisungsbereich oder beides definiert werden.
- Wiederholbarer Bereich: Gibt an, dass Sie Werte aus allen wiederholt auftretenden Datenblöcken extrahieren wollen, nicht nur aus dem ersten. Sie können Felder innerhalb jedes Datenblocks definieren. Ordnen Sie in der Aktion Datenfilter verwenden die definierten Felder den jeweiligen Variablen zu. Weitere Informationen finden Sie im Abschnitt Wiederholbare Elemente Definieren.
- Zuweisungsbereich: Gibt an, dass der Datenblock Name-Wert Paare enthält. Feldnamen und ihre Werte werden gleichzeitig ausgelesen. Die Zuordnung zu Variablen erfolgt automatisch. Verwenden Sie diese Funktion, um den Filter für wechselnde Eingangsdaten einzurichten; so können Sie Wartungsaufwand vermeiden. Weitere Informationen finden Sie im Abschnitt XML-Zuweisungsbereich definieren.

Der Bereich „Datenvorschau“ vereinfacht die Konfiguration. Das Ergebnis der definierten Filterregeln wird im Vorschaubereich hervorgehoben.

Um die als Vorschau angezeigten XML-Daten zu ändern klicken Sie auf Öffnen und suchen Sie nach einer neuen Beispiel-XML-Datei.

XML-Felder definieren

Beim Definieren von XML-Feldern stellen Sie Werte der ausgewählten Elemente automatisch zur Verfügung. Die Filterdefinition stellt solche Felder für die Zuordnung zu Variablen in Aktionen zur Verfügung. Auf diese Weise können Sie Werte von Elementen oder Attributen extrahieren.

So definieren Sie einen Elementwert als Feld:

Wählen Sie das Element oder Attribut in der Strukturliste aus.
Wählen Sie unter Nutzung die Option Variablenwert aus.
Das Element wird in der Strukturliste in Fettdruck angezeigt, um zu verdeutlichen, dass es verwendet wird.
Der Element- oder Attributname wird als Name des Ausgabefeldes verwendet.
Der Abschnitt „Datenvorschau“ hebt den Wert des ausgewählten Elements hervor.

Formatierungsoptionen

Dieser Abschnitt definiert Funktionen zur Änderung von Zeichenfolgen, die auf ausgewählte Variablen oder Felder angewandt werden. Sie können eine oder mehrere Funktionen auswählen. Die Funktionen werden in der Reihenfolge ausgeführt, die in der Benutzeroberfläche ausgewählt ist – von oben nach unten.

Leerzeichen am Anfang löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Anfang einer Zeichenfolge.
Leerzeichen am Ende löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Ende einer Zeichenfolge.
Eröffnungs- und Abschlusszeichen löschen: Löscht die erste Instanz der ausgewählten Eröffnungs- und Abschlusszeichen, die in einer Zeichenfolge enthalten sind.

Beispiel 10. Beispiel

Wenn Sie „{“ als Eröffnungszeichen und „}“ als Abschlusszeichen verwenden, wird die Eingabe-Zeichenfolge {{Auswahl}} in {Auswahl} konvertiert.
Suchen und ersetzen: Führt anhand der angegebenen Werte für Finde und Ersetzen durch eine Standardfunktion für Suchen und Ersetzen durch. Sie können auch reguläre Ausdrücke verwenden.

Anmerkung

Es werden verschiedene Implementierungen der regulären Ausdrücke verwendet. Nutzt die .NET Framework-Syntax für reguläre Ausdrücke. Weitere Informationen finden Sie im Knowledge Base-Artikel.
Nicht-druckbare Zeichen durch Leerzeichen ersetzen: Ersetzt alle Steuerzeichen in einer Zeichenfolge durch Leerzeichen (ASCII-Dezimalwert 32). Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
Nicht druckbare Zeichen löschen: Löscht alle Steuerzeichen in der Zeichenfolge. Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
Sonderzeichen dekodieren: Sonderzeichen (oder Steuercodes) sind Zeichen, die keine Entsprechung auf der Tastatur haben, z. B. Wagenrücklauf oder Zeilenvorschub. verwendet eine menschenlesbare Codierung für solche Zeichen, beispielsweise <CR> für Wagenrücklauf und <LF> für Zeilenvorschub. Weitere Informationen finden Sie im Abschnitt Eingabe von Sonderzeichen (Steuercodes).

Diese Option konvertiert Sonderzeichen aus der Syntax in tatsächliche Binärzeichen.

Beispiel 11. Beispiel

Wenn Sie die Datenfolge „<CR><LF>“ empfangen, fasst sie als reine Zeichenfolge aus 8 Zeichen auf. Um die empfangenen Daten als zwei Binärzeichen zu erkennen, CR (Wagenrücklauf – ASCII-Code 13) und LF (Zeilenvorschub – ASCII-Code 10), müssen Sie diese Option aktivieren.
Suchen und Löschen von allem vor: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab Beginn der Daten bis zu der Zeichenfolge. Auch die gefundene Zeichenfolge kann gelöscht werden.
Suchen und Löschen von allem nach: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab der Zeichenfolge bis zum Ende der Daten. Auch die gefundene Zeichenfolge kann gelöscht werden.
Großschreibung ändern: Ändert alle Zeichen in Ihren Zeichenfolgen zu Groß- oder Kleinschreibung.

Datenvorschau

Dieser Bereich zeigt eine Vorschau der Felddefinition an. Wenn das definierte Element ausgewählt wird, zeigt die Vorschau dessen Position in den Vorschaudaten an.

Name der Vorschaudatei: Gibt die Datei an, welche die Beispieldaten enthält, die durch den Filter geparst werden sollen. Die Vorschaudatei wird aus der Filterdefinition kopiert. Wenn Sie den Namen der Vorschaudatei ändern, wird der neue Name gespeichert.
Öffnen: Wählt eine andere Datei aus, auf die die Filterregeln angewandt werden sollen.
Aktualisieren: Wendet die Filterregeln erneut auf den Inhalt der Vorschaudatei an.Automation Aktualisiert den „Datenvorschau“-Bereich mit dem Ergebnis.

Wiederholbare Elemente im XML-Filter definieren

Wenn ein XML-Element mehrmals in XML-Daten vorkommt, handelt es sich um ein sich wiederholendes Element. Für gewöhnlich enthalten solche Elemente Daten für ein einzelnes Etikett. Um anzugeben, dass Sie Daten aus allen wiederholt auftretenden Elementen verwenden wollen, und nicht nur aus dem ersten, definieren Sie das Element als Datenblock und aktivieren Sie die Option Wiederholbares Element. Beinhaltet der Filter die Definition von Elementen, die als Datenblock / wiederholbare Elemente definiert sind, zeigt die Aktion Datenfilter verwenden wiederholbare Elemente mit eingebetteten Platzhaltern an. Alle Aktionen, die unter einem solchen Platzhalter eingebunden sind, werden nur für Datenblöcke auf dieser Ebene ausgeführt.

Beispiel

Das Element <item> ist als Datenblock und als Wiederholbares Element definiert. Dadurch erhält der Filter die Anweisung, alle Instanzen des Elements <item> zu extrahieren, nicht nur die erste. In diesem Fall sollte <item> als Unterebene in der Aktion Datenfilter verwenden definiert werden. Sie müssen die Aktionen „Etikett öffnen“ und „Etikett drucken“ unter diesem Unterebenen-Platzhalter einbetten, damit sie für jede Instanz des Elements <item> wiederholt werden. Im folgenden Beispiel geschieht dies für drei Instanzen.

<?xml ver sion="1.0" encoding="utf-8"?>
<asx:abap xmlns:asx="http://www.sap.com/abapxml" ver sion="1.0">
 <asx:values>
  <NICELABEL_JOB>
   <T IMEST AMP>20130221100527.788134</T IMEST AMP>
   <USER>PGRI</USER>
   <IT _LABEL_DAT A>
   <item>
      <LBL_NAME>goods_r eceipt.nlbl</LBL_NAME>
      <LBL_PRINT ER>Pr oduction01</LBL_PRINT ER>
      <LBL_QUANT IT Y>1</LBL_QUANT IT Y>
      <MAKT X>MASS ONE</MAKT X>
      <MAT NR>28345</MAT NR>
      <MEINS>KG</MEINS>
      <WDAT U>19.01.2012</WDAT U>
      <QUANT IT Y>1</QUANT IT Y>
      <EXIDV>012345678901234560</EXIDV>
   </item>

   <item>
      <LBL_NAME>goods_r eceipt.nlbl</LBL_NAME>
      <LBL_PRINT ER>Pr oduction01</LBL_PRINT ER>
      <LBL_QUANT IT Y>1</LBL_QUANT IT Y>
      <MAKT X>MASS T WO</MAKT X>
      <MAT NR>28346</MAT NR>
      <MEINS>KG</MEINS>
      <WDAT U>11.01.2011</WDAT U>
      <QUANT IT Y>1</QUANT IT Y>
      <EXIDV>012345678901234577</EXIDV>
   </item>

   <item>
      <LBL_NAME>goods_r eceipt.nlbl</LBL_NAME>
      <LBL_PRINT ER>Pr oduction01</LBL_PRINT ER>
      <LBL_QUANT IT Y>1</LBL_QUANT IT Y>
      <MAKT X>MASS T HREE</MAKT X>
      <MAT NR>27844</MAT NR>
      <MEINS>KG</MEINS>
      <WDAT U>07.03.2009</WDAT U>
      <QUANT IT Y>1</QUANT IT Y>
      <EXIDV>012345678901234584</EXIDV>
   </item>

  </IT _LABEL_DAT A>
 </NICELABEL_JOB>
 </asx:values>
</asx:abap>

Warnung

XML-Datenfilter mit verschachtelten Datenblöcken duplizieren Werte aus dem vorherigen Zuweisungsbereich, wenn eine Variable im ersten Block, aber nicht im zweiten definiert ist. Nehmen wir an, Sie drucken zwei Etiketten. Im ersten Zuweisungsbereich haben Sie eine Variable definiert: <manufacturer_serial>. Im zweiten Zuweisungsbereich ist diese Variable nicht vorhanden.

<?xml ver sion="1.0" encoding="utf-8"?>
<asx:abap xmlns:asx="http://www.sap.com/abapxml" ver sion="1.0">
    <jobs>
      <element>
         <data>
            <item>
               <manufacturer_serial>706583012001</manufacturer_serial>
               <package_code>AA792CY</package_code>
            </item>
         </data>
         <label_filename>serial_number_label.nlbl</label_filename>
         <print_quantity>1</print_quantity>
         <printer_name>Warehouse_printer_09</printer_name>
      </element>
      <element>
         <data>
            <item>
               <package_code>BE273XS</package_code>
            </item>
         </data>
         <label_filename>serial_number_label.nlbl</label_filename>
         <print_quantity>1</print_quantity>
         <printer_name>Warehouse_09</printer_name>
      </element>
   </jobs>
</asx:abap>

Das erwartete Ergebnis wäre das zweite Etikett ohne <manufacturer_serial>-Daten. Beim tatsächlichen Druck würde das zweite Etikett jedoch den Wert <manufacturer_serial> des ersten Etiketts enthalten, d. h. 706583012001.

Es gibt jetzt vier Möglichkeiten:

Vermeiden Sie verschachtelte Datenblöcke.

Definieren Sie die Variablenwerte als leere Werte, wenn die Variablen nicht in verschachtelten Datenblöcken verwendet werden.

            <item>
               <manufacturer_serial></manufacturer_serial>
               <package_code>AA792CY</package_code>
            </item>

Verwenden Sie Bedingungen für Aktionen, um Variablen zu definieren.
Verwenden Sie Zeichenfolgenmanipulationen, wenn fehlende Variablen erkannt werden.

XML-Zuweisungsbereich definieren

Der XML-Filter erkennt Felder und ihre Werte in den empfangenen Daten automatisch. Daher ist eine manuelle Variable-zu-Feld-Zuordnung nicht notwendig.

Die Funktion Dynamische Struktur ist nützlich, wenn der Trigger Daten mit sich ändernder Struktur empfängt. In solchen Fällen bleibt die Haupt-Datenstruktur unverändert (z. B. Felder werden durch Kommas getrennt) oder dieselbe Struktur wird beibehalten, aber die Reihenfolge und/oder die Anzahl von Feldern ändert sich. Es könnten neue Felder hinzukommen oder alte Felder könnten nicht mehr verfügbar sein. Aufgrund der aktivierten Dynamischen Struktur erkennt der Filter die Struktur der empfangenen Datei automatisch. Gleichzeitig liest der Filter Feldnamen und Werte (Name-Wert-Paare) aus den Daten. Dadurch müssen Felder nicht manuell Variablen zugeordnet werden.

Die Aktion Datenfilter verwenden bietet keine Zuordnungsmöglichkeiten, da sie die Zuordnung dynamisch vornimmt. Sie müssen nicht einmal die Etikettenvariablen in der Trigger-Konfiguration festlegen. Die Aktion ordnet Feldwerte den gleichnamigen Etikettenvariablen zu, ohne dass die Variablen aus dem Etikett importiert werden müssen. Diese Regel gilt jedoch nur für die Aktion Etikett drucken. Wenn Sie die Feldwerte in einer anderen Aktion verwenden möchten, müssen Sie Variablen im Trigger definieren, dabei aber die automatische Zuordnung von Variablen zu Feldern beibehalten.

Anmerkung

Wenn ein Feld in den Eingabedaten keine entsprechende Variable auf dem Etikett hat, tritt kein Fehler auf. Ignoriert die fehlenden Variablen, ohne eine Meldung auszugeben.

XML-Zuweisungsbereiche konfigurieren

Wenn Sie den Datenblock als Zuweisungsbereich definieren, werden unter der Definition dieses Elements zwei Platzhalter angezeigt. Sie müssen angeben, wie der Feldname und -wert definiert sind, damit der Filter das Name-Wert-Paar extrahieren kann.

Variablenname: Gibt das Element an, das den Feldnamen enthält. Der Name kann nach Elementname, ausgewähltem Attributwert oder Elementwert definiert werden. Um automatische Zuordnung zu aktivieren, muss die Etikettenvariable denselben Namen haben.
Variablenwert: Gibt das Element an, das den Feldwert enthält. Der Name kann nach dem Elementnamen, ausgewählten Attributwert oder Elementwert definiert werden.

Warnung

Das XML-Element, das Name:Wert Paare enthält, darf nicht als Stammelement festgelegt werden, muss sich aber mindestens auf der zweiten Ebene befinden. Im folgenden XML-Beispiel befindet sich das Element <label> z. B. auf der zweiten Ebene und kann die Name:Wert Paare enthalten.

Formatierungsoptionen

Leerzeichen am Anfang löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Anfang einer Zeichenfolge.
Leerzeichen am Ende löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Ende einer Zeichenfolge.
Eröffnungs- und Abschlusszeichen löschen: Löscht die erste Instanz der ausgewählten Eröffnungs- und Abschlusszeichen, die in einer Zeichenfolge enthalten sind.

Beispiel 12. Beispiel

Wenn Sie „{“ als Eröffnungszeichen und „}“ als Abschlusszeichen verwenden, wird die Eingabe-Zeichenfolge {{Auswahl}} in {Auswahl} konvertiert.
Suchen und ersetzen: Führt anhand der angegebenen Werte für Finde und Ersetzen durch eine Standardfunktion für Suchen und Ersetzen durch. Sie können auch reguläre Ausdrücke verwenden.

Anmerkung

Es werden verschiedene Implementierungen der regulären Ausdrücke verwendet. Nutzt die .NET Framework-Syntax für reguläre Ausdrücke. Weitere Informationen finden Sie im Knowledge Base-Artikel.
Nicht-druckbare Zeichen durch Leerzeichen ersetzen: Ersetzt alle Steuerzeichen in einer Zeichenfolge durch Leerzeichen (ASCII-Dezimalwert 32). Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
Nicht druckbare Zeichen löschen: Löscht alle Steuerzeichen in der Zeichenfolge. Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
Sonderzeichen dekodieren: Sonderzeichen (oder Steuercodes) sind Zeichen, die keine Entsprechung auf der Tastatur haben, z. B. Wagenrücklauf oder Zeilenvorschub. verwendet eine menschenlesbare Codierung für solche Zeichen, beispielsweise <CR> für Wagenrücklauf und <LF> für Zeilenvorschub. Weitere Informationen finden Sie im Abschnitt Eingabe von Sonderzeichen (Steuercodes).

Diese Option konvertiert Sonderzeichen aus der Syntax in tatsächliche Binärzeichen.

Beispiel 13. Beispiel

Wenn Sie die Datenfolge „<CR><LF>“ empfangen, fasst sie als reine Zeichenfolge aus 8 Zeichen auf. Um die empfangenen Daten als zwei Binärzeichen zu erkennen, CR (Wagenrücklauf – ASCII-Code 13) und LF (Zeilenvorschub – ASCII-Code 10), müssen Sie diese Option aktivieren.
Suchen und Löschen von allem vor: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab Beginn der Daten bis zu der Zeichenfolge. Auch die gefundene Zeichenfolge kann gelöscht werden.
Suchen und Löschen von allem nach: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab der Zeichenfolge bis zum Ende der Daten. Auch die gefundene Zeichenfolge kann gelöscht werden.
Großschreibung ändern: Ändert alle Zeichen in Ihren Zeichenfolgen zu Groß- oder Kleinschreibung.

Beispiel

Das Element <label> ist als Datenblock und als Zuweisungsbereich definiert. Der Variablenname wird anhand des Wertes des Attributnamens, der Variablenwert anhand des Elementtexts bereitgestellt.

<?xml version="1.0" standalone="no"?>
<labels _FORMAT="case.nlbl" _PRINTERNAME="Production01" _QUANTITY="1">
    <label>
        <variable name="CASEID">0000000123</variable>
        <variable name="CARTONTYPE"/>
        <variable name="ORDERKEY">0000000534</variable>
        <variable name="BUYERPO"/>
        <variable name="ROUTE"> </variable>
        <variable name="CONTAINERDETAILID">0000004212</variable>
        <variable name="SERIALREFERENCE">0</variable>
        <variable name="FILTERVALUE">0</variable>
        <variable name="INDICATORDIGIT">0</variable>
        <variable name="DATE">11/19/2012 10:59:03</variable>
    </label>
</labels>