de:app:020cor:080cfg:070swm:0100dbiswh

Verwalten von Feldzuordnungen für Eingangsnachrichten

Transaktion DBISWH

Diese Transaktion dient zur Verwaltung von Feldzuordnungen von Eingangsnachrichten.

Sie ermöglicht die Zuordnung von Feldern in einer elektronischen Eingangsnachricht zu den Feldern der Applikation. Die Feld-Definition ermöglicht die automatische Zuordnung (Mapping) eingehender Nachrichten zu den Feldern der zugehörigen Geschäftstransaktion.

Hinweis: Wenn ein Nachrichtentyp nicht einer Zieltransaktion zugeordnet werden kann, wird die Transaktion “Weiterleiten von Offenen Vorgängen” (SPTROU) als Zieltransaktion angegeben. Kann eine Zieltransaktion ermittelt werden, es ist jedoch keine Zuordnung (kein Mapping) hinterlegt, werden alle Felder der Eingangsnachricht unter “Unmapped” in der Zieltransaktion dargestellt. Schlägt die Zuordnung aufgrund eines fehlenden Codetable-Eintrags fehl, werden die nicht zugeordneten Felder ebenfalls nach “Unmapped” verschoben.

Die Transaktion ermöglicht über die Icons:

Nach der Auswahl des Quellformats (über die Combobox “Quelle”) und des Nachrichtentyps werden in der Tabelle unten auf dem Panel die Zuordnungen der Nachrichten-Tags (Tag) mit den Applikations-Feldern (Zielfeld) dargestellt. Die jeweils zugehörige Transaktion wird im gleichnamigen Feld angezeigt.

Die “Transaktion” kann eingetragen oder gesucht werden durch Anklicken des Icons, wodurch sämtliche Transaktions-Zuordnungen für den erfassten Nachrichtentyp anzeigt werden.

Hinweis für SWIFT Score Nachrichten: Score-Nachrichten sind MT798, die im Tag 77E eine eingebettete Kunde-an-Bank oder Bank-an-Kunde Nachricht enthalten. Das Mapping ist für die eingebettete Nachricht zu erstellen. Sowohl die MT798 als auch die eingebettete Nachricht enthalten jeweils ein Tag :20:. Für das Tag :20: der eingebetteten Nachricht muss im Mapping REF.2 im Subtyp angegeben werden.

Alternative Feldzuordnung

Um insbesondere das Testen von Eingangsnachrichten aufgrund gesetzlicher Änderungen zu unterstützen (wie z.B. SWIFT 2018/2020 mit unterschiedlichen Zeichensätzen ('X', 'Z') oder Feldzuordnungen), ist es möglich, pro Nachrichtentyp und Zieltransaktion eine alternative Feldzuordnung zu definieren.

Die Checkbox “Alternative Feldzuordnung” zeigt die alternativen Zuordnungen und ermöglicht dem Benutzer, bei Bedarf Änderungen vorzunehmen. Abhängig vom SWIFT-Aktivierungsdatum (definiert in Verwalten von System-Einstellungen) verwendet die Applikation das korrekte Mapping im “Manager für eingehende Nachrichten”.

Mit der Einführung von Sequenzen in Garantie-Nachrichten werden nun viele identische Feld-Tags in beiden Sequenzen verwendet. Um “Tags” in unterschiedlicher Sequenzen zu identifizieren, wird die Sequenz (B, C) als Suffix an die “Sub-ID” im Mapping angehängt.

Hinzufügen einer neuen Feldzuordnung

Es ist es möglich, eine bestehende Zuordnung aus der Datenbank zu kopieren oder die Definition von einer externen Datei zu kopieren .

Ändern einer bestehenden Feldzuordnung

Die zu ändernde Feldzuordnung ist auszuwählen, und danach ist das Icon anzuklicken. Es ist möglich, vorhandene Feldbeschreibungen zu ändern, zu löschen oder neue Feldbeschreibungen durch Verwendung der “-/+”-Buttons hinzuzufügen.

Überschreiben

“Überschreiben” ist zu markieren, wenn ein eventuell bereits vorhandener Feldinhalt im Zielfeld durch den Feldinhalt der aktuellen Nachricht überschrieben werden soll.

Umwandlung

Unter “Umwandlung” wird beschrieben, wie der Inhalt des “Tags” in die Anwendung übernommen werden soll. Es gibt hier z.B. die Möglichkeit, einen BIC direkt in eine Adresse umzusetzen, einen Code in Langtext umzuschlüsseln usw.

Codetable

Die am häufigsten verwendete Umwandlung ist “Codetable”. Ist zum Zielfeld ein “embedded Codetable” definiert, das benutzt werden soll, wird die Spalte “Argument” leer gelassen, ansonsten muss dort das zu benutzende Codetable angeben werden. Dadurch werden die in der Nachricht verwendeten Codetable-Einträge korrekt in der Applikation ausgegeben (z.B.: MT 700-Zuordnung des “Type of LC” (LCRTYP) nach LETOPN).

Sind die in der Nachricht zu einem Feld verfügbaren Werte identisch mit den in der Applikation bekannten Langtexten, wird Umwandlung “Codetable” ausgewählt und die Tabelle, die ebenfalls dem Applikations-Feld zugeordnet ist. Es spielt dabei keine Rolle, in welcher Sprache der Langtext im System bekannt ist.

Stehen andere Werte, die den in der Applikation bekannten Werten eindeutig zuzuordnen sind, zur Verfügung, muss eine Umsetzungstabelle definiert werden, die als Schlüssel den in der Applikation bekannten Wert und als Langtext den Nachrichtenwert enthält. Sind in der Nachricht verschiedene, dem gleichen Schlüssel zuzuordnende Werte vorhanden, wird dies anders gehandhabt: Es wird eine Umsetzungstabelle definiert, deren Schlüssel mindestens eine Stelle länger ist als der Schlüssel des Feldes in der Applikation. Die Langtexte werden dann dem gewünschten Schlüssel zzgl. beispielsweise einer Laufnummer (oder einem Sprachkennzeichen) zugeordnet.
Damit sind die Schlüssel der Umsetzungstabelle formal wieder eindeutig. Bei Übernahme ins Applikations-Feld wird der angehängte Teil jedoch wieder abgeschnitten und nur der in der Applikation bekannte Teil bleibt übrig.

Es muss jedoch bedacht werden, dass die erhaltenen Werte ggf. auch wieder aus der Applikation ausgegeben werden müssen (z.B. in den Ausführungsbestätigungen zurück an TradeConnect). Ist die Zuordnung nicht eindeutig, muss beim Zurücksenden erkannt werden (z.B. aus der Konstellation mehrerer Feldinhalte), welcher eindeutige Wert zurückzugeben ist.

Prüfe Key in Codetable

Bei dieser Umwandlung wird geprüft, ob der Feldinhalt als Code in dem in der Spalte “Argument” genannten Codetable (Leer = embedded Codetable des Zielfeldes) vorhanden ist. Wenn nicht, erfolgt keine Übernahme. Ein Verwendungsbeispiel sind Währungsangaben, die gegen das Codetable CURTXT geprüft werden können.

Codetabelle für 'unmapped'

Bei dieser Umwandlung wird der Feldinhalt aus der eingehenden Nachricht gegen das in der Spalte “Argument” angegebene Codetable aufgelöst und der Code inkl. des Langtextes aus der Codetabelle in “unmapped” zur Verfügung gestellt. Damit wird erreicht, dass Felder, die nicht automatisch übernommen werden können und nur einen Code enthalten, dem Sachbearbeiter in einer verständlichen Form angezeigt werden. Der Sachbearbeiter kann dann aufgrund der Informationen entscheiden was zu tun ist. Um eine solche Umwandlung zu definieren ist zunächst eine Codetabelle mit den Codes des Feldes der eingehenden Nachricht anzulegen. In der Spalte “Text” wird der Text, der zusätzlich zum Code in unmapped angezeigt werden soll, eingetragen.

Negativer Betrag

“Neg. Betrag” dient dazu, ein Tag, das von der inhaltlichen Bedeutung her einen negativen Betrag enthält, in der Applikation mit einem “minus”, also als negativen Betrag zu versehen (z.B.: MT707 nach LETAME. Das Tag 33B enthält den “Decrease Amount”, wird in den Nachrichten aber ohne das führende Minus weitergegeben. In der Applikation wird dieses Tag durch das Setzen der Umwandlung als negativer Betrag in das Feld “Erhöhungsbetrag” eingetragen.).

Numerischer Wert (Zahl)

Ein “Numerischer Wert” wird für Felder benutzt, die die Sub-ID “NBR” verwenden, um anzugeben, dass es sich um ein numerisches Feld handelt.

BIC-Auflösung

Bei “BIC-Auflösung” handelt es sich um die Auflösung eines in der Eingangsnachricht enthaltenen BIC (Bank Identifier Code) in eine in der Applikation gespeicherte Adresse.

BIC Trimming

Wie BIC-Auflösung, allerdings für BICs, die mit Terminalcode, d.h. 12-stellig vorliegen. Der Terminalcode wird entfernt. Falls der Branchcode “XXX” ist, wird auch dieser vor der Auflösung entfernt.

Adressauflösung (PTM)

Auflösung einer Adresse anhand eines in der Eingangsnachricht vorkommenden Schlüssels, der zur Authentifizierung der Adresse benutzt wird. Die Auflösung erfolgt kanalspezifisch über die in der Tabelle PTM gespeicherten Werte.

Ignorieren

Bei “Ignorieren” können nicht zu verwendende Felder ignoriert werden. Sie erscheinen dann nicht in der Liste “unmapped” in der Transaktion.

Unmapped

Mit dieser Umwandlungsmethode ist es möglich, Felder in die Mappingregel aufzunehmen und trotzdem unter “Unmapped” in der Transaktion erscheinen zu lassen. Dabei erfolgt im Gegensatz zu “Codetabelle für Unmapped” keine Umsetzung des Inhaltes. Der Feldinhalt der Eingangsnachricht wird 1 zu 1 unter “unmapped” angezeigt. Derartige Mappingeinträge sind technisch nicht notwendig, können aber dazu dienen, die Verwendung der Tags der Eingangsnachrichten besser zu dokumentieren.

Text zu Datum

“Text zu Datum” wandelt ein sechsstelliges (YYMMTT) oder achtstelliges (YYYYMMTT) Datum im Textformat in einem Datenfeld vom Typ “Date” um.

TradeConnect-ID

Die “TradeConnect-ID” wird bei der Zuordnung von TradeConnect-Nachrichten verwendet.

"Text bis zum /" und "Text ab dem ersten /"

Tags in einer Nachricht, in denen 2 Teile von variabler Länge stehen, die durch einen “/” getrennt sind, können über diese Funktion entsprechend zugeordnet werden. Hierbei übernimmt TX1 den Feldinhalt vor dem “/” und TX2 den Feldinhalt nach dem ersten “/”.

Code aus 22A

Die Transformationslogik auf Basis von “Purpose Codes / Nachrichten Funktionen” ist verfügbar, wenn es notwendig ist, das gleiche Tag der gleichen Sequenz auf verschiedene Zielfelder abhängig von dem Tag “Purpose Codes” (Tag 22A der SWIFT MT760) abzubilden.

“Purpose Codes / Nachrichten Funktionen” als Argumente können entweder für die Transformation als “Purpose code (22A)” oder für “BIC-Auflösung” definiert werden.

Erlaubte “Purpose Codes / Nachrichten Funktionen” sind ISSU, ISCO und ICCO. Intern ist die Logik so gestaltet, dass alle anderen “Purpose Codes / Nachrichten Funktionen” (wie beispielsweise die für die Änderung) entsprechend angepasst werden.

Nachrichten Funktion ADVI, ACNF, ISAB, ISAW, ADVA, ACNA, ISUA verwenden dieselbe Zuordnung wie sie für ISSU definiert wurde.
Nachrichten Funktion ISCA verwendet dieselbe Zuordnung wie sie für ISCO definiert wurde.
Nachrichten Funktion ICCA verwendet dieselbe Zuordnung wie sie für ICCO definiert wurde. 

Löschen einer bestehenden Feldzuordnung

Die zu löschende Feldzuordnung ist auszuwählen und danach ist das Icon zu klicken. Nach Bestätigung des Löschens ist die ausgewählte Feldzuordnung aus der Datenbank entfernt.

Import und Export von Feldzuordnungen

Feldzuordnungen können über die Icons und importiert bzw. exportiert werden. Für den Import wird hierbei die Transaktion “Importieren der Feldzuordnung von Eingangsnachrichten” und für den Export die Transaktion “Exportieren der Feldzuordnung von Eingangsnachrichten” aufgerufen.

Transaktions-Panels

Feldzuordnung



Datenfelder

Datenfeld Beschreibung
Nachr.-Typ-Beschreibung Dieses Feld enthält den beschreibenden Langnamen des gewählten Nachrichtentyps.
Nachrichtenformat und Quelle cf Appendix A, Tabelle SWH Feld FMT
Nachrichtentyp cf Appendix A, Tabelle SWH Feld MT
Transaktion Dieses Feld enthält die Geschäftstransaktion, mit der die Nachricht verbunden
werden soll.
cf Appendix A, Tabelle ATP Feld COD
Alternative Mapping cf Appendix A, Tabelle SWH Feld ALTMAPFLG
Field Tag der Nachricht cf Appendix A, Tabelle SWM Feld TAG
Nachrichten-TAG Sub-ID cf Appendix A, Tabelle SWM Feld SUBTAG
Gruppe Dieses Feld enthält die Feldergruppe bezügl. der ausgewählten Transaktion. Die
verfügbaren Felder der ausgewählten Feldergruppe werden im Feld “mögliche
Datenfelder” angezeigt.
cf Appendix A, Tabelle SWM Feld DSTGRP
Zielfeld cf Appendix A, Tabelle SWM Feld DST
Überschreiben-Flag cf Appendix A, Tabelle SWM Feld OVWFLG
Zusätzliche Mappingmethode cf Appendix A, Tabelle SWM Feld MET
Weisung cf Appendix A, Tabelle SWM Feld INS


de/app/020cor/080cfg/070swm/0100dbiswh.txt · Last modified: 2022/09/23 15:18 by dm