Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagexml
<Mapping>
  <Map Source="fname" Target="Forname" />
  <Map SourceValue="HansHanna" Target="Forname" />
  <Map SourceValue="Muster" Target="LastName" When="source('test') === 'someValue'" />
  <Map SourceExpression="25*78" Target="Calculator" When="target('LastName') === 'Muster'" />

  <Map>
    <Map.Source>fname</Map.Source>
    <Map.Target>Forname<Target>Vorname</Map.Target>
  </Map>
  <Map>
    <Map.SourceValue>Hans<SourceValue>Hanna</Map.SourceValue>
    <Map.Target>Forname<Target>Firstname</Map.Target>
  </Map>
  <Map>
    <Map.SourceValue>Muster</Map.SourceValue>
    <Map.Target>LastName</Map.Target>
    <Map.When><![CDATA[source('test') < 12]]></Map.When>
  </Map>
  <If Condition="source('test') === 'someValue'">
    <Map>
      <Map.SourceExpression>25*78</Map.SourceExpression>
      <Map.Target>Calculator</Map.Target>
    </Map>
  </If>
</Mapping>

...

Im Mapping kann man mit einfachen deklarativen Anweisungen ein Mapping vornehmen oder über JavaScript eine komplexere Logik abbilden. Auf der JavaScript-Seite befindet sich eine detailliertere Einführung.

...

Ein Map-Element stellt eine einzelne Zuordnungsoperation dar.
Es muss genau eine Source-Eigenschaft und das Target gesetzt sein.

Eigenschaft

Beschreibung

Source

  • Im Standardfall: Der Name, der den Wert identifiziert, z. B der Spaltenname der Datenbank im Generic SQL Provider.

  • Bei XML-Datenquelle: siehe XML

Wenn der Wert nicht gefunden wird, wird null weitergegeben.

SourceValue

Ein konstante Wert, der verwendet werden soll.

SourceExpression

Eine primedocs-JavaScript-Expression, die ausgewertet wird.

Target

Die Zieleigenschaft für das Mapping. Die möglichen Zielfelder bei AddressProvidern sind unter Standard-Kontakt-Mapping dokumentiert.

When

Eine primedocs-JavaScript-Expression, die es erlaubt, das Mapping bedingt auszuführen.
Wenn der Wert auf wahr ausgewertet wird, wird das Mapping ausgeführt.

...

Resultat des XPath

Zurückgegebener Wert

Attribut

Wert des Attributs

Element

Inhalt/Wert des Elements

Text

Der Text

CData

Ist das Resultat in CData gewrappt, wird dieses ohne das CData-Tag zurückgegeben,.

Beispiel:

XML-Quelldatei:

Code Block
languagexml
<Kontakt>
  <Company>PrimeSoft AG</Company>
  <Adresse>
    <PLZ>8360</PLZ>
    <City>Eschlikon</City>
    <Street>Bahnhofstrasse 4</Street>
  </Adresse>
  <Contact>
    <Option Type="Phone">+41 71 511 0 500</Option>
    <Option Type="Mail">info@primesoft-group.com</Option>
  </Contact>
</Kontakt>

Mapping:

Code Block
languagexml
<Mapping Type="XML">
  <Map Source="//PLZ" Target="Postleitzahl" />
  <Map Source="/Kontakt/Adresse/City" Target="Stadt" />
  <Map Source="//Street" Target="Strasse" />
  <Map Target="KompletteAdresse">
    <Map.SourceExpression>
      source('//Company') + '\r\n' + source('//Street') + '\r\n' + source('//PLZ') + ' ' + source('//City')
    </Map.SourceExpression>
  </Map>
  <Map Source="//Contact/Option[@Type='Phone']" Target="Telefon" />
</Mapping>

Resultat:

Code Block
languagenone
Postleitzahl:       8360
Stadt:              Eschlikon
Strasse:            Bahnhofstrasse 4
KompletteAdresse:   PrimeSoft AG
                    Bahnhofstrasse 4
                    8360 Eschlikon
Telefon:            +41 71 511 0 500

...

Code Block
languagexml
<Mapping>
  <Map Source="Privat" Target="Phone" />
  <Map Source="Büro" Target="Phone" When="target('Phone') != null" />
  <Map Source="Mobile" Target="Phone" When="target('Phone') != null" />
</Mapping>

Beachten Sie die Reihenfolge: Die Map-Elemente werden der Reihenfolge nach ausgewertet, d. h., dass die letzte vorhandene Nummer verwendet wird.

...