Wertetabellen
Eine Wertetabelle übersetzt Werte des einen Systems in Werte des anderen. Der Webshop schreibt
paypal, SAP Business One erwartet PP – die Tabelle sagt, was woraus wird. Dieser Bildschirm
zeigt alle Wertetabellen und den Inhalt einer einzelnen.
Wie Sie eine Wertetabelle in einer Zuordnungszeile einsetzen, steht unter Werte umwandeln und umschlüsseln.
Berechtigungen
Der Bildschirm folgt der Berechtigung Zuordnung – siehe Berechtigungen.
| Stufe | Was Sie sehen und tun können |
|---|---|
| Keine | Der Menüpunkt Wertetabellen fehlt. |
| Nur lesen | Liste und Inhalt zum Nachsehen; Neue Wertetabelle, Löschen, Werte importieren, Eintrag hinzufügen und die Eingabefelder fehlen. |
| Voll | Alles – anlegen, ändern, importieren, löschen. |
Im Beispiel: A. Vogt hat Voll und pflegt die Tabellen. M. Brandt hat Nur lesen und sieht nach, welcher Zahlungsart welcher Schlüssel entspricht.

Aufbau
Links die Liste aller Wertetabellen, rechts der Inhalt der ausgewählten. Beides ist ein Bildschirm.
Der Inhalt steht in zwei Spalten: links Allgemeine Angaben und die Einträge, rechts Verwendung in Routen. Ist das Fenster schmal, rücken die beiden Spalten untereinander. Darunter liegt die Fußzeile.
Die Liste
Vier Spalten:
| Spalte | Inhalt |
|---|---|
| Name | der Name der Wertetabelle |
| Einträge | wie viele Zeilen sie hat; „–“, wenn sich die gespeicherten Einträge nicht lesen lassen (unten) |
| Verwendung | von wie vielen Routen sie benutzt wird |
| Zuletzt geändert | innerhalb der letzten 24 Stunden die Zeit seit der Änderung, danach Datum und Uhrzeit; der genaue Zeitpunkt erscheint, wenn Sie mit der Maus darauf zeigen |
Die Liste ist alphabetisch nach Name sortiert, und diese Reihenfolge liegt fest.
Über der Liste steht ein Suchfeld. Es durchsucht Name und Beschreibung. Nur wenn die Suche auf die Beschreibung traf, erscheint diese als zweite Zeile unter dem Namen.
Der Suchbegriff steht in der Adresse der Seite. Ein Lesezeichen, ein Neuladen oder die Rückkehr aus dem Inhalt einer Wertetabelle bringen dieselbe gefilterte Liste zurück. Wie das auf allen Listen funktioniert, steht unter Verlauf – Die Filter stehen in der Adresse.
Ein Stiftsymbol neben dem Namen meldet, dass gerade jemand anderes an dieser Wertetabelle arbeitet, und nennt den Namen.
Hat noch niemand eine Wertetabelle angelegt, steht statt der Liste Noch keine Wertetabellen. Findet die Suche nichts, steht dort Keine Treffer.
Eine Wertetabelle anlegen
Neue Wertetabelle über der Liste öffnet einen Dialog mit einem einzigen Feld: Name, Pflicht und mit Sternchen, höchstens 150 Zeichen. Bleibt es leer, meldet das Feld Pflichtfeld. Anlegen legt die Wertetabelle an und öffnet ihren Inhalt; Abbrechen schließt den Dialog und verwirft die Eingabe.
Ein schon vergebener Name löst eine Warnung aus, mehr nicht. Trägt eine andere Wertetabelle denselben Namen, erscheint über dem Feld der Hinweis „Es existiert bereits eine Wertetabelle mit diesem Namen.“ – Anlegen bleibt trotzdem bedienbar. Dieselbe Warnung erscheint, wenn Sie eine Wertetabelle später umbenennen. Der Name ist das, was die Zuordnungszeile zur Auswahl anbietet – ein eigener Name hält die Tabellen dort auseinander.
Die neue Wertetabelle öffnet mit einer leeren Eintragszeile, in die Sie gleich den ersten Wert schreiben.
Kopf und Fußzeile
| Element | Wirkung |
|---|---|
| Löschen (Kopf) | entfernt die ganze Wertetabelle, sofern keine Route sie verwendet (unten) |
| Vollbild / Vollbild verlassen / Schließen (Kopf) | steuern, wie viel Platz der Inhalt bekommt; Schließen blendet ihn aus, und die Liste steht wieder allein |
| Meldungen (Fußzeile) | erscheint, sobald an der Wertetabelle etwas offen ist, trägt eine Zahl und öffnet die Liste der Meldungen; der Tooltip lautet „Meldungen zu dieser Wertetabelle“ |
| Die Leiste zum Abarbeiten (Fußzeile) | erscheint, während Sie die Prüfliste abarbeiten |
| Die Autospeicher-Leiste (Fußzeile) | meldet, ob die letzte Eingabe gesichert ist |
In den Meldungen nennt jede Meldung zuerst die Zeile, an der sie sitzt: Eintrag 3: „Quellwert“ fehlt meint die dritte Zeile der Tabelle. Trifft dieselbe Meldung mehrere Zeilen, steht sie einmal für alle – Einträge 2, 4 und 7: „Quellwert“ ist mehrfach vergeben. Die Nummern sind die Positionen, wie die Tabelle jetzt steht. Ein Klick auf eine Meldung führt an ihre Stelle.
Was die Zahl auf der Schaltfläche zählt, steht unter Routen – Die Meldungen; welche Zustände die Autospeicher-Leiste kennt, unter Routen – Kopf und Fußzeile.
Xchange speichert jede Eingabe von selbst. Strg+Z nimmt die letzte Änderung zurück. Wirksam werden die Änderungen mit der Aktivierung des Konfigurationsstands – siehe Konfigurationsstände.
Über dem Inhalt können Hinweise in Orange stehen:
| Hinweis | Wann |
|---|---|
| „Wird gerade von … bearbeitet – Ihre Änderungen könnten zu einem Konflikt führen“ | Jemand anderes bearbeitet die Wertetabelle gerade; der Hinweis nennt den Namen. |
| „Sie bearbeiten diesen Datensatz bereits in einer anderen Sitzung – Ihre Änderungen könnten zu einem Konflikt führen“ | Sie selbst haben die Wertetabelle in einer zweiten Sitzung offen. Bearbeitet zugleich jemand anderes, steht nur der Hinweis davor. |
| „Es existiert bereits eine Wertetabelle mit diesem Namen.“ | Eine andere Wertetabelle trägt denselben Namen (oben). |
Im Beispiel: Hat L. Hoffmann die Wertetabelle offen, liest A. Vogt „Wird gerade von LHOFFMANN bearbeitet – …“.
Drei Lagen ersetzen den ganzen Inhalt:
| Lage | Anzeige |
|---|---|
| Service Layer nicht erreichbar | Daten nicht verfügbar – „Service Layer aktuell nicht erreichbar – Einträge können gerade nicht geladen werden.“ |
| Laufzeitspeicher nicht erreichbar | Daten nicht verfügbar – „Laufzeitspeicher aktuell nicht erreichbar – Einträge können gerade nicht geladen werden.“ |
| Wertetabelle nicht mehr da | Wertetabelle nicht gefunden – „Diese Wertetabelle existiert in der aktuellen Konfiguration nicht mehr.“, dazu Zurück zur Liste |
Allgemeine Angaben
| Feld | Inhalt |
|---|---|
| Name | muss gefüllt sein, höchstens 150 Zeichen; leer gelassen meldet das Feld Pflichtfeld, ein schon vergebener Name wird gemeldet wie beim Anlegen |
| Beschreibung | freiwillig, höchstens 254 Zeichen, drei Zeilen hoch |
Der Name ist das, was in der Zuordnungszeile zur Auswahl steht. Nennen Sie die Tabelle deshalb nach dem, was sie übersetzt – „Zahlungsarten Webshop“ sagt in der Auswahlliste, was eine durchnummerierte Bezeichnung dort verschweigt.
Einträge
Eine Zeile je Übersetzung.
| Spalte | Inhalt |
|---|---|
| (erste Spalte, unbeschriftet) | die laufende Nummer der Zeile |
| Quellwert | der Wert, wie ihn das Quellsystem schreibt |
| Zielwert | der Wert, den das Zielsystem erwartet |
Rechts in der Kopfzeile des Abschnitts stehen Werte importieren und Eintrag hinzufügen. Eintrag hinzufügen hängt eine leere Zeile an; das Kreuz rechts an einer Zeile (Eintrag entfernen) nimmt sie wieder heraus. Die Tabelle zeigt zunächst 100 Zeilen und lädt beim Scrollen nach.
Eine neue Wertetabelle wird mit einer leeren Zeile gespeichert; diese Zeile sieht jeder, der die Tabelle öffnet. Erst wenn keine Zeile mehr da ist, steht an ihrer Stelle Keine Einträge vorhanden. Einträge manuell hinzufügen.
Lassen sich die gespeicherten Einträge nicht lesen, zeigt die Tabelle keine Einträge, und darüber steht: Die gespeicherten Einträge und der Ersatzwert dieser Wertetabelle sind nicht lesbar. Angezeigt wird eine leere Tabelle; die gespeicherten Einträge bleiben erhalten, bis Sie Einträge oder Ersatzwert ändern.
Vier Dinge weist Xchange an einer Zeile zurück:
| Meldung | Was Sie tun |
|---|---|
| „Quellwert“ fehlt | ausfüllen |
| „Zielwert“ fehlt | ausfüllen |
| „Quellwert“ ist mehrfach vergeben | eine der Zeilen entfernen oder ändern |
| Quellwert „_default“ ist reserviert | anderen Wert wählen – _default ist für den Ersatzwert reserviert |
Rot markiert wird eine Zeile, sobald Sie sie bearbeitet haben, und überall dort, wo Prüfen auf den Konfigurationsständen etwas gefunden hat – eine solche Stelle ist rot, auch wenn Sie sie noch nicht angefasst haben. Eine Zeile, die Sie nicht bearbeitet haben und die keine Prüfung beanstandet hat, bleibt ruhig, auch wenn die Meldungen sie schon führen.
Ein fehlender Wert in einer Zeile, die die letzte Prüfung noch nicht kannte, wird nicht rot. Die Meldungen führen ihn grau in der eigenen Gruppe Fehlende Pflichtangaben. Er hält das Aktivieren trotzdem auf: Prüfen meldet ihn als Fehler. Mehr dazu unter Routen – Die Meldungen.

Eine Zeile entfernen
Beim Kreuz an einer Zeile hängt es davon ab, ob in der Zeile etwas steht: Eine Zeile, die Sie angelegt und noch nicht gefüllt haben, verschwindet sofort. Eine Zeile mit Inhalt wird erst nach Nachfrage entfernt, und die Nachfrage nennt deren Quellwert – oder den Zielwert, wenn nur dieser gefüllt ist.
Der Ersatzwert
Unter den Einträgen steht der Bereich Ersatzwert mit dem Kästchen Ersatzwert verwenden. Ist es eingeschaltet, erscheint darunter ein Eingabefeld – das ist der Ersatzwert selbst. Das Feld steht unbeschriftet unter dem Kästchen.
Der Ersatzwert ist der Zielwert für jeden Quellwert, der in der Tabelle fehlt. Bei den
Zahlungsarten ist das SO: Taucht im Shop eine neue Zahlungsart auf, geht der Beleg mit SO
durch.
Das Wort Ersatzwert gibt es an zwei Stellen. Der Ersatzwert der Wertetabelle – der hier – springt ein, wenn der Quellwert da ist, aber in der Tabelle fehlt. Der Ersatzwert bei leerem Quellwert steht in den Einstellungen der Zuordnungszeile auf dem Reiter Leerer Quellwert und springt ein, wenn der Quellwert leer ankommt. Beide Einschalter heißen Ersatzwert verwenden; welcher gemeint ist, sagt der Bildschirm, auf dem er steht. Siehe Routen – Zuordnung.
Wie ein Wert nachgeschlagen wird
Xchange vergleicht den Quellwert zeichengenau mit der linken Spalte. Groß- und Kleinschreibung
zählt, Leerzeichen im Wert zählen mit: PayPal und paypal sind zwei verschiedene Werte.
Leerzeichen am Anfang und Ende entfernt Xchange beim Speichern – aus Quellwert, Zielwert und
Ersatzwert, gleich ob Sie den Wert tippen oder importieren.
Dann gibt es drei Ausgänge:
| Fall | Ergebnis |
|---|---|
| Der Quellwert steht in einer Zeile | der zugehörige Zielwert |
| Er fehlt in der Tabelle, und ein Ersatzwert ist gesetzt | der Ersatzwert |
| Er fehlt in der Tabelle, und Ersatzwert verwenden ist ausgeschaltet | der Wert ist leer |
Ohne Ersatzwert verschwindet ein Wert, der in der Tabelle fehlt – er wird leer statt
unverändert weitergereicht. Im Beispiel ist SO gesetzt, eine neue Zahlungsart klarna geht also
mit SO durch; ohne Ersatzwert käme sie leer im Zielsystem an.
Was mit dem leeren Ergebnis dann geschieht, entscheidet das Leerverhalten der Zuordnungszeile – genauso wie bei einem leeren Quellwert, für den Xchange die Tabelle überspringt.
Werte importieren
Werte importieren steht rechts in der Kopfzeile des Abschnitts Einträge. Der Dialog nimmt Werte aus einer Datei oder aus der Zwischenablage.
| Feld | Inhalt |
|---|---|
| Datei auswählen | eine CSV-, TXT- oder TSV-Datei mit zwei Spalten |
| Oder Inhalt einfügen | derselbe Inhalt als Text, je Zeile ein Paar |
| Verhalten beim Import | Zusammenführen (vorgewählt) oder Ersetzen; bei Ersetzen steht darunter „Alle bestehenden Einträge und der Ersatzwert werden überschrieben.“ |
| Vorschau | was der Import ergeben wird, Zeile für Zeile |
Eine gewählte Datei landet im Textfeld Oder Inhalt einfügen. Dort können Sie ihren Inhalt vor dem Import noch korrigieren.
Das Trennzeichen erkennt Xchange selbst. Geprüft werden Tabulator, Semikolon und Komma, in dieser Reihenfolge; es gewinnt, was in mehr als der Hälfte der Zeilen vorkommt. Aus Excel kopierte Zellen kommen mit Tabulatoren, eine deutsche CSV-Datei mit Semikolon – für beides reicht das Einfügen. Leerzeilen zählen nicht mit.
Die beiden Verhalten:
| Verhalten | Was geschieht |
|---|---|
| Zusammenführen | Ein Quellwert, den es schon gibt, wird an seiner Stelle überschrieben. Neue kommen ans Ende. Zeilen ohne Quell- und Zielwert fallen weg. Der Ersatzwert bleibt – außer die Datei bringt selbst einen mit. |
| Ersetzen | Alle bestehenden Einträge und der Ersatzwert werden überschrieben. Eine Datei ohne Ersatzwert löscht ihn damit. |
Der Ersatzwert steht in der Datei als Zeile mit dem Quellwert _default. Deshalb ist dieser
Quellwert in der Tabelle reserviert. In der Vorschau steht diese Zeile ganz oben, mit dem Abzeichen
Ersatzwert.
Bringt die Datei keine _default-Zeile mit, ist der Ersatzwert nach Ersetzen weg, und fehlende
Werte kommen leer an. Der Import wird sofort gespeichert; Strg+Z holt den vorigen Stand zurück.
Fehlerhafte Zeilen überspringt der Import – sie stehen in der Vorschau am Ende, rot, mit dem Grund daneben:
| Meldung | Bedeutung |
|---|---|
| Kein Trennzeichen erkannt. Erwartet werden zwei Spalten, getrennt durch Tabulator, Semikolon oder Komma. | Kein Trennzeichen kommt in mehr als der Hälfte der Zeilen vor; dann wird jede Zeile übersprungen. |
| Quellwert fehlt. | Die linke Spalte ist leer. |
| Mehr als zwei Spalten. | Die Zeile hat ein Trennzeichen zu viel. |
Eine einzelne Zeile ohne Trennzeichen in einer sonst gültigen Datei ist kein Fehler: Sie wird mit leerem Zielwert übernommen, und die Meldungen führen danach den fehlenden Zielwert.
Oben im Dialog kann eine Meldung zur Datei selbst stehen:
| Meldung | Bedeutung |
|---|---|
| Die Datei ist … MB groß. Zulässig sind höchstens 5 MB. | Die Datei ist zu groß. |
| Die Datei konnte nicht gelesen werden. | Die Datei ließ sich nicht öffnen. |
Lassen sich zwei Einträge der Wertetabelle nicht auseinanderhalten, sperrt der Dialog den Import und sagt: Zwei Einträge der Wertetabelle lassen sich nicht eindeutig zuordnen. Laden Sie die Seite neu und importieren Sie erneut.
Rechts neben der Überschrift Vorschau steht die Zusammenfassung mit drei Zahlen:
| Zahl | Was sie zählt |
|---|---|
| Einträge | wie viele Zeilen die Wertetabelle nach dem Import haben wird |
| Übersprungen | wie viele Zeilen der Datei unbrauchbar waren |
| Zusammengeführt | wie viele bestehende Einträge überschrieben werden, samt der Dubletten innerhalb der Datei |
Steht ein Quellwert in der Datei zweimal, gewinnt das letzte Vorkommen.
Die Schaltfläche unten rechts nennt, wie viele Einträge sie importiert – die _default-Zeile zählt
nicht mit. Erst ein Klick darauf übernimmt die Werte in die Einträge-Tabelle; bis dahin bleibt die
Tabelle, wie sie ist. Danach bestätigt eine kurze Meldung, wie viele Einträge übernommen wurden.

Verwendung in Routen
Rechts steht die Liste aller Routen, die diese Wertetabelle verwenden, gruppiert nach Anbindung. Jede Zeile nennt den Namen der Route, rechts daneben ihr Objekt, und ein Symbol davor zeigt die Richtung. Innerhalb einer Anbindung stehen die Routen in derselben Reihenfolge wie in der Routenliste. Die internen Routen haben keine Anbindung; sie stehen unter „SAP Business One“, und das steht immer zuoberst. Ein Klick öffnet die Route.
Ist die Wertetabelle unbenutzt, steht hier Keine Verwendung – „Keine Route verwendet diese Wertetabelle.“
Eine Wertetabelle löschen
Löschen im Kopf entfernt die ganze Wertetabelle samt ihren Einträgen. Xchange fragt vorher nach und nennt den Namen.
Löschen setzt voraus, dass die Wertetabelle unbenutzt ist. Löschen bleibt dabei bedienbar; benutzt eine Route die Tabelle, erscheint statt der Nachfrage ein Hinweis, der sagt, von wie vielen Routen sie verwendet wird. Welche das sind, steht unter Verwendung in Routen. Nehmen Sie die Wertetabelle zuerst aus deren Zuordnungszeilen heraus.
Siehe auch
- Werte umwandeln und umschlüsseln (Anleitung) – wie Sie eine Wertetabelle an eine Zuordnungszeile hängen
- Routen – Zuordnung (Referenz) – die Zuordnungszeile, das Leerverhalten und der zweite Ersatzwert
- Zuordnung (Grundkonzept) – wie ein Zielfeld überhaupt gefüllt wird
- Berechtigungen (Grundkonzept) – welche Stufe wofür reicht