Altova MapForce 2025 Enterprise Edition

Teilt den Input-String mit Hilfe des als Argument angegebenen Trennzeichens in eine Sequenz von Strings auf.

mf-func-tokenize

 

Sprachen

Built-in, C++, C#, Java, XQuery, XSLT 2.0, XSLT 3.0..

 

Parameter

Name

Beschreibung

input

Der Input-String.

delimiter

Das zu verwendende Trennzeichen.

 

Beispiel

Wenn der Input-String A,B,C und "delimiter" ,  ist, gibt die Funktion eine Sequenz von drei Strings zurück: A, B und C.

 

mf-func-tokenize-example

 

Im oben gezeigten Modell-Mapping ist das Ergebnis der Funktion eine Sequenz von Strings. Entsprechend den allgemeinen Mappingregeln wird für jedes Datenelement in der Quellsequenz ein neues Datenelement item in der Zielkomponente erstellt. Die Mapping-Ausgabe sieht daher folgendermaßen aus:

 

<items>
  <item>A</item>
  <item>B</item>
  <item>C</item>
</items>

 

 

Ein komplexeres Beispiel dazu finden Sie im Mapping tokenizeString1.mfd im Ordner <Dokumente>\Altova\MapForce2025\MapForceExamples\.

mf-func-tokenize-example2

tokenizeString1.mfd

Unten sehen Sie ein Fragment aus der XML-Quelldatei. Das Element Tool hat zwei Attribute: Name und Code. Das Element Tool besteht aus kommagetrenntem Text.

 

<?xml version="1.0" encoding="UTF-8"?>
<AltovaTools xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="AltovaTools.xsd">
  <Version>2010</Version>
  <Tool Name="XMLSpy" Code="XS">XML editor, XSLT editor, XSLT debugger, XQuery editor, XQuery debugger, XML Schema / DTD editor, WSDL editor, SOAP debugger</Tool>
  <Tool Name="MapForce" Code="MF">Data integration, XML mapping, database mapping, text conversion, EDI translator, Excel mapping, XBRL mapping, Web services</Tool>
  <Tool Name="StyleVision" Code="SV">Stylesheet designer, electronic forms, XSLT design, XSL:FO design, database reporting, XBRL rendering</Tool>
  <Tool Name="UModel" Code="UM">UML modeling tool, code generation, reverse engineering, UML, BPMN, SysML, project documentation, XMI interchange</Tool>
  <Tool Name="DatabaseSpy" Code="DS">Multi-database tool, SQL auto-completion, graphical database design, table browser, content editor, database comparison tool</Tool>
  <!-- ... -->
</AltovaTools>

 

Im Mapping geschieht Folgendes:

 

Die tokenize-Funktion erhält Daten aus dem Quelldatenelement Tool und unterteilt die Daten mit Hilfe des Komma-Trennzeichens , in separate Blöcke. Der erste Block ist "XML editor", der zweite "XSLT editor", usw.

Für jeden mit der tokenize-Funktion erzeugten Block wird in der Zielkomponente eine neue Zeile generiert. Dies geschieht aufgrund der Verbindung zwischen dem Ergebnis der Funktion und dem Datenelement Rows in der Zielkomponente.

Außerdem wird das Ergebnis der tokenize-Funktion auf die Funktion left-trim gemappt, die in jedem Block das vorangestellte Leerzeichen entfernt.

Das Ergebnis der left-trim-Funktion (die einzelnen Blöcke) wird in das Datenelement Feature der Zielkomponente geschrieben.

Die Ausgabedatei der Zielkomponente wurde als CSV-Datei (AltovaToolFeatures.csv) definiert, wobei als Feldtrennzeichen ein Semikolon definiert wurde (Doppelklicken Sie auf die Komponente, um die Einstellungen zu sehen).

 

Das Ergebnis des Mappings ist, dass für jeden von der tokenize-Funktion erstellten Block in der CSV-Zieldatei eine neue Zeile erstellt wird. Ein Fragment der Mapping-Ausgabe sieht folgendermaßen aus:

 

Tool;Feature

XMLSpy;XML editor

XMLSpy;XSLT editor

XMLSpy;XSLT debugger

XMLSpy;XQuery editor

XMLSpy;XQuery debugger

XMLSpy;XML Schema / DTD editor

XMLSpy;WSDL editor

XMLSpy;SOAP debugger

MapForce;Data integration

MapForce;XML mapping

MapForce;database mapping

MapForce;text conversion

MapForce;EDI translator

MapForce;Excel mapping

 

© 2018-2024 Altova GmbH