CIB webdesk technischer Leitfaden

6.4. Wertetabellen

Allgemein
Konfigurierbare Wertetabellen
Beispiele für Wertetabellen

---

Allgemein

CIB webdesk bietet die Möglichkeit verschiedene Eigenschaften in der Oberfläche per Wertetabellen zu konfigurieren. Dies sind insbesondere die unter 7.4.1 Konfigurierbare Wertetabellen aufgeführten Wertetabellen für die Vorbelegung von Auswahlfeldern (ComboBox) in CIB webdesk Interview-Masken. Es sei angemerkt, dass sich Eigenschaften nicht nur auf die Oberfläche auswirken können, sondern auch auf die interne technische Repräsentation sowie die Verarbeitung.

Aus diesem Grund sollten Änderungen mit Vorsicht durchgeführt werden. Es wird abgeraten zusätzliche Werte hinzuzufügen. Die Spaltennamen in den Wertetabellen dürfen nicht verändert oder entfernt werden.

Verkleinerung oder Ändern der Initialmenge (Entfernen, Umbenennung von Einträgen) ist in der Regel unproblematisch möglich.

Die Einstellungen aus CIB webTom werden beim Laden einer Vorlage für ein Interview in CIB webdesk ausgewertet. Daher ist bei Änderungen zu bedenken, dass Eingabefelder die im CIB webTom für die Vorlagenadmi­nistration genutzt werden, dort identisch konfiguriert sind (identisch Auswahlmenge mit übereinstimmenden IDs – weitere Details dazu sind in Technischer Leitfaden CIB webTom). Sind in CIB TOM Auswahlen möglich, die in CIB webdesk nicht vorgesehen sind, wird die Auswahl in der Regel auf einen verfügbaren Wert (i.d.R. erster) oder leer eingestellt.

Will man zu einem späteren Zeitpunkt Auswahlmöglichkeiten entfernen oder überarbeiten, ist zu bedenken, dass Entwürfe und noch nicht abgeschlossene Dokumente diese Daten enthalten können. Hier kann es zu unerwarteten Situationen kommen, da CIB webdesk in der Regel davon ausgeht, dass dieser Wert nicht mehr zu verwenden ist und die Einstellung beim Zugriff (d.h. Laden eines Entwurfs oder Dokuments) ohne weiteren Hinweis auf einen gültigen Auswahlwert oder eine leere Auswahl umstellt.

In bestimmten Fällen kann es notwendig sein weitere Konfigurationsdateien anzupassen. Dies trifft insbesondere auf Konfigurationsdateien für die Nachverarbeitung zu, da die Auswahlwerte aus CIB webdesk (z.B. Archivschlüssel) zusammen mit dem Dokument abgelegt und an die Nachverarbeitung weitergereicht werden.

Die Wertetabellen finden sich im Verzeichnis WEB-INF/valuetables, die Namen haben das Format cib_ref_[name].csv.  Die Tabellen liegen in dem Format CSV (comma separated values) vor und lassen sich mit einem beliebigen Texteditor bearbeiten. Das Character-Encoding ist UTF-8.

Es wird zwischen Einzel- und Multiwerttabellen unterschieden. Einzelwerttabellen bilden eine einfache Primärschlüssel-Wert Beziehung ab. Multiwerttabellen bieten die Möglichkeit zu einem Primärschlüssel mehrere Werte anzugeben. Die Konfiguration der Multiwerttabellen wird in der korrespondierenden cib_ref_[name].properties vorgenommen.

Wertetabellen, die im Weiteren nicht aufgeführt sind, werden ausschließlich intern durch CIB webdesk genutzt und sollten auf keinen Fall verändert werden.

Konfigurierbare Wertetabellen

Die folgende Liste führt die Wertetabellen auf, die bei Bedarf angepasst werden können:

• cib_ref_envelopeType.csv                    Briefumschlagsart
• cib_ref_letterType.csv                           Briefart
• cib_ref_paperWeight.csv                      Papiergewicht
• cib_ref_shippingNote.csv                     Versandvermerk
• cib_ref_shippingType.csv                     Versandart
• cib_ref_forwardRule.csv                       Vorausverfügung
• cib_ref_branchOfficeSource.csv          Ansprechpartnerdaten

Es handelt sich um die entsprechenden Auswahlfelder (Combobox) im webdesk.

Beispiele für Wertetabellen

Nachfolgend sind je ein Beispiel für eine Einzelwerttabelle und eine Multiwerttabelle aufgeführt.

Einzelwertabelle:

cib_ref_shippingType.csv
ID;VALUE
-;---
0;Einschreiben
1;Einschreiben mit Rückschein 
2;SB-Einschreiben
3;Übergabeeinschreiben
4;Einschreiben Einwurf
5;Einschreiben eigenhändig
6;Expressbrief 

Diese Tabelle steuert den Inhalt der ComboBox „Versandart“ im Reiter „Empfänger“ im Interview.

Multiwertabelle:

cib_ref_letterType.csv

ID;SORT_INDEX;VALUE;COST;BASE_WEIGHT;FACTOR
1;1;Brief Standard;0.58;0;0
2;2;Brief Kompakt;0.90;0;0
3;3;Brief Gross;1.45;0;0
4;4;Infopost Standard;0.25;0;0
5;5;Infopost Kompakt;0.28;20;0.352
6;6;Infopost Gross;0.36;20;0.352

 Diese Tabelle steuert den Inhalt der Combobox  „Papiergewicht“  für den zentralen Druck und Postversand im Reiter „Dokumenterstellung“ im Interview. Hierfür werden die Spalten ID und VALUE verwendet. Die weiteren Werte werden bei der Berechnung der erwarteten Portokosten eines Serienbriefs verwendet.

Hinweis: Werte aus dieser Tabelle werden in der Nachverarbeitung verwendet, wobei nur die IDs durchgereicht werden Eine Änderung auf CIB webdesk Seite erfordert zumindest eine Überprüfung der Konfiguration bzw. des Verhaltens in der Nachverarbeitung – ggf. sind dort ebenfalls Konfigurationsänderungen notwendig.