Zum Hauptinhalt springen

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.

StufeWas Sie sehen und tun können
KeineDer Menüpunkt Wertetabellen fehlt.
Nur lesenListe und Inhalt zum Nachsehen; Neue Wertetabelle, Löschen, Werte importieren, Eintrag hinzufügen und die Eingabefelder fehlen.
VollAlles – 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.

Der Bildschirm Wertetabellen mit der Liste links und der geöffneten Wertetabelle „Zahlungsarten Webshop“ rechts: Einträge, Ersatzwert und die Verwendung in Route „Bestellungen Webshop“.

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:

SpalteInhalt
Nameder Name der Wertetabelle
Einträgewie viele Zeilen sie hat; „–“, wenn sich die gespeicherten Einträge nicht lesen lassen (unten)
Verwendungvon wie vielen Routen sie benutzt wird
Zuletzt geändertinnerhalb 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​

ElementWirkung
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:

HinweisWann
„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:

LageAnzeige
Service Layer nicht erreichbarDaten nicht verfügbar – „Service Layer aktuell nicht erreichbar – Einträge können gerade nicht geladen werden.“
Laufzeitspeicher nicht erreichbarDaten nicht verfügbar – „Laufzeitspeicher aktuell nicht erreichbar – Einträge können gerade nicht geladen werden.“
Wertetabelle nicht mehr daWertetabelle nicht gefunden – „Diese Wertetabelle existiert in der aktuellen Konfiguration nicht mehr.“, dazu Zurück zur Liste

Allgemeine Angaben​

FeldInhalt
Namemuss gefüllt sein, höchstens 150 Zeichen; leer gelassen meldet das Feld Pflichtfeld, ein schon vergebener Name wird gemeldet wie beim Anlegen
Beschreibungfreiwillig, 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.

SpalteInhalt
(erste Spalte, unbeschriftet)die laufende Nummer der Zeile
Quellwertder Wert, wie ihn das Quellsystem schreibt
Zielwertder 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:

MeldungWas Sie tun
„Quellwert“ fehltausfüllen
„Zielwert“ fehltausfüllen
„Quellwert“ ist mehrfach vergebeneine der Zeilen entfernen oder ändern
Quellwert „_default“ ist reserviertanderen 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.

Die Einträge der Wertetabelle „Zahlungsarten Webshop“ mit eingeschaltetem Ersatzwert.

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.

Zwei Ersatzwerte, zwei Anlässe

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:

FallErgebnis
Der Quellwert steht in einer Zeileder zugehörige Zielwert
Er fehlt in der Tabelle, und ein Ersatzwert ist gesetztder Ersatzwert
Er fehlt in der Tabelle, und Ersatzwert verwenden ist ausgeschaltetder 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.

FeldInhalt
Datei auswähleneine CSV-, TXT- oder TSV-Datei mit zwei Spalten
Oder Inhalt einfügenderselbe Inhalt als Text, je Zeile ein Paar
Verhalten beim ImportZusammenführen (vorgewählt) oder Ersetzen; bei Ersetzen steht darunter „Alle bestehenden Einträge und der Ersatzwert werden überschrieben.“
Vorschauwas 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:

VerhaltenWas geschieht
ZusammenführenEin 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.
ErsetzenAlle 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.

Ersetzen löscht auch den 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:

MeldungBedeutung
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:

MeldungBedeutung
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:

ZahlWas sie zählt
Einträgewie viele Zeilen die Wertetabelle nach dem Import haben wird
Übersprungenwie viele Zeilen der Datei unbrauchbar waren
Zusammengeführtwie 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.

Der Dialog Werte importieren beim Zusammenführen: oben die Zeile _default mit dem Abzeichen Ersatzwert, darunter paypal und klarna, am Ende rot die Zeile giropay mit „Mehr als zwei Spalten.“

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​