DMS Provider Version 1.10 Handbuch

DMS Provider
Version 1.10
Handbuch
Stand 11.06.2010
Bonk Consulting GmbH • Werner-von-Siemens Str. 6 • D-98693 Ilmenau •
Tel. +49 (3677) 4663 100 • Fax +49 (3677) 4663 101
Geschäftsführer: Daniel Bonk
Gesellschaftssitz: Werner-von-Siemens Str. 6 • D-98693 Ilmenau • HRB 305925 Amtsgericht Jena

Inhalt
INHALT .................................................................................................................................2
TABELLENVERZEICHNIS .....................................................................................................5
ABBILDUNGSVERZEICHNIS ................................................................................................6
1 EINLEITUNG ...................................................................................................................9
2 LEISTUNGEN ................................................................................................................ 12
2.1 DIREKT MARKETING DIENSTE ................................................................................... 12
2.2 SCHNITTSTELLEN ..................................................................................................... 15
2.3 NUTZERVERWALTUNG .............................................................................................. 16
2.4 PROTOKOLLIERUNG.................................................................................................. 17
2.5 STATISTIK ............................................................................................................... 18
2.6 SICHERHEIT ............................................................................................................. 19
2.6.1 SSL ................................................................................................................................ 19
2.6.2 WEB APPLICATION GATEWAY .......................................................................................... 22
2.6.3 FIREWALL ........................................................................................................................ 22
2.6.4 PROXY ........................................................................................................................... 23
2.6.5 KERBEROS ....................................................................................................................... 24
2.7 SYSTEMARCHITEKTUR/SYSTEMLANDSCHAFT .............................................................. 25
3 SYSTEMANFORDERUNGEN ........................................................................................ 26
4 BEDIENUNGSANLEITUNG .......................................................................................... 27
4.1 AUSLIEFERUNGSZUSTAND ........................................................................................ 27
4.2 SYSTEMADMINISTRATOR .......................................................................................... 28
4.2.1 DIENSTE ......................................................................................................................... 29
4.2.2 SCHNITTSTELLEN ............................................................................................................ 65
4.2.3 PROTOKOLLIERUNG ........................................................................................................ 67
4.2.4 MANDANTEN .................................................................................................................. 68
4.2.5 MANDANTENSTATISTIKEN................................................................................................ 77
4.2.6 KONTO .......................................................................................................................... 81
4.2.7 ABMELDEN ..................................................................................................................... 81
4.3 MANDANTENADMINISTRATOR .................................................................................. 82
4.3.1 DIENSTE ......................................................................................................................... 83
4.3.2 NUTZER ......................................................................................................................... 83
4.3.3 NUTZERSTATISTIKEN ....................................................................................................... 91
4.3.4 KONTO .......................................................................................................................... 95

4.3.5 ABMELDEN ..................................................................................................................... 96
4.4 NUTZER .................................................................................................................. 97
4.4.1 DIENSTE ......................................................................................................................... 98
4.4.2 KONTO .......................................................................................................................... 98
4.4.3 ABMELDEN ..................................................................................................................... 99
5 DATENFORMATE ....................................................................................................... 100
5.1 ORWELLACCOUNTCHECK ....................................................................................... 100
5.1.1 FUNKTION ACCOUNTCHECK ......................................................................................... 100
5.1.2 FUNKTION CREDITCARDCHECK ..................................................................................... 101
5.2 ORWELLADDRESSCHECK ........................................................................................ 102
5.2.1 FUNKTION ADDRESSCHECK ........................................................................................... 102
5.3 ORWELLADDRESSCHECKV3_1 ................................................................................ 103
5.3.1 FUNKTION ADDRESSCHECK ........................................................................................... 103
5.4 ORWELLINPUTASSISTANT ...................................................................................... 104
5.4.1 FUNKTION POSTCODETOCITY ....................................................................................... 104
5.4.2 FUNKTION CITYTOPOSTCODE ....................................................................................... 104
5.4.3 FUNKTION STREET ........................................................................................................ 105
5.4.4 FUNKTION BANKCODETOBANKNAME ............................................................................ 105
5.4.5 FUNKTION PREPHONECHECK ........................................................................................ 106
5.4.6 FUNKTION FIRSTNAMECHECK ........................................................................................ 106
5.4.7 FUNKTION EMAILADDRESSCHECK .................................................................................. 107
5.5 ORWELLBANKSEARCHV1_0 .................................................................................... 108
5.5.1 FUNKTION BANKSEARCHMULTIFIELDINPUT .................................................................... 108
5.5.2 FUNKTION BANKSEARCHSINGLEFIELDINPUT ................................................................... 109
5.6 ORWELLPROVIDERADDRESSFACTORYDIRECT .......................................................... 110
5.6.1 FUNKTION PREMIUMNAMECHECK .................................................................................. 110
5.6.2 FUNKTION MOVEPROFESSIONAL ..................................................................................... 110
5.7 ORWELLPROVIDERADDRESSRESEARCHONLINE ........................................................ 111
5.7.1 FUNKTION ADRESSRESEARCH ......................................................................................... 111
5.8 ORWELLPROVIDERBEDIRECTSERVER ........................................................................ 112
5.8.1 FUNKTION SEARCH ........................................................................................................ 112
5.8.2 FUNKTION INFORMATION .............................................................................................. 113
5.9 ORWELLPROVIDERINFOSCOREONLINE ..................................................................... 115
5.9.1 FUNKTION CREDITCHECK.............................................................................................. 115
5.10 ORWELLINFOSCORECREDITCHECK .......................................................................... 117

5.10.1 FUNKTION ORWELLINFOSCORECREDITCHECK ............................................................ 117
5.11 ORWELLINFOSCORERPPCHECK .............................................................................. 118
5.11.1 FUNKTION ORWELLINFOSCORERPPCHECK ................................................................. 118
5.12 ORWELLNONCONSUMERACCOUNTCHECK .............................................................. 119
5.12.1 FUNKTION ORWELLINFOSCORENONCONSUMERACCOUNTCHECK .............................. 119
5.13 ORWELLINTERNATIONALADDRESSCHECKV2_0 ........................................................ 120
5.13.1 FUNKTION ORWELLINTERNATIONALADDRESSCHECK ................................................... 120
6 SUPPORT .................................................................................................................... 124
7 NUTZUNGSVORAUSSETZUNGEN ........................................................................... 125
8 COPYRIGHTS ............................................................................................................. 126

Tabellenverzeichnis
TABELLE 1: DIENSTE DES ORWELL DMS PROVIDER .................................................................................... 14
TABELLE 2: SCHNITTSTELLEN .................................................................................................................. 15
TABELLE 3: ORWELL INTERFACES ........................................................................................................... 15
TABELLE 4: DATENFORMAT ORWELL ACCOUNTCHECK – FUNKTION ACCOUNTCHECK ................................... 100
TABELLE 5: DATENFORMAT ORWELL ACCOUNTCHECK- FUNKTION CREDITCARDCHECK ................................. 101
TABELLE 6: DATENFORMAT ORWELL ADDRESSCHECK – FUNKTION ADDRESSCHECK ...................................... 102
TABELLE 7: DATENFORMAT ORWELL ADDRESSCHECKV3_1 – FUNKTION ADDRESSCHECK .............................. 103
TABELLE 8: DATENFORMAT ORWELL INPUTASSISTANT – FUNKTION POSTCODETOCITY ................................... 104
TABELLE 9: DATENFORMAT ORWELL INPUTASSISTANT - FUNKTION CITYTOPOSTCODE ................................... 104
TABELLE 10: DATENFORMAT ORWELL INPUTASSISTANT - FUNKTION STREET ................................................ 105
TABELLE 11: DATENFORMAT ORWELL INPUTASSISTANT - FUNKTION BANKCODETOBANKNAME ....................... 105
TABELLE 12: DATENFORMAT ORWELL INPUTASSISTANT - FUNKTION PREPHONENUMBERCHECK ...................... 106
TABELLE 13: DATENFORMAT ORWELL INPUTASSISTANT - FUNKTION FIRSTNAMECHECK ................................. 106
TABELLE 14: DATENFORMAT ORWELL INPUTASSISTANT – FUNKTION EMAILADDRESSCHECK............................ 107
TABELLE 15: DATENFORMAT ORWELL PROVIDERADDRESSFACTORYDIRECT - FUNKTION PREMIUMNAMECHECK .. 110
TABELLE 16: DATENFORMAT ORWELL PROVIDERADDRESSFACTORYDIRECT – FUNKTION MOVEPROFESSIONAL ..... 110
TABELLE 17: DATENFORMAT ORWELL PROVIDERADRESSRESEARCHONLINE – FUNKTION ADRESSRESEARCH ........ 111
TABELLE 18: DATENFORMAT ORWELL PROVIDERBEDIRECTSERVER – FUNKTION SEARCH ................................. 112
TABELLE 19: DATENFORMAT ORWELL PROVIDERBEDIRECTSERVER –FUNKTION INFORMATION ......................... 114
TABELLE 20: DATENFORMAT ORWELL INFOSCOREONLINE –FUNKTION CREDITCHECK ................................... 116
TABELLE 21: DATENFORMAT ORWELL INFOSCORECREDITCHECK – FUNKTION ORWELLINFOSCORECREDITCHECK
....................................................................................................................................................... 117
TABELLE 22: DATENFORMAT ORWELL INFOSCORERPPCHECK – FUNKTION ORWELLINFOSCORERPPCHECK ........ 118
TABELLE 23: DATENFORMAT ORWELL INFOSCORENONCONSUMERACCOUNTCHECK – FUNKTION
ORWELLNONCONSUMERACCOUNTCHECK .............................................................................................. 119
TABELLE 24: DATENFORMAT ORWELL INTERNATIONALADDRESSCHECKV2_0 – FUNKTION
ORWELLINTERNATIONALADDRESSCHECK ................................................................................................. 123

Abbildungsverzeichnis
ABBILDUNG 1: SSL VERBINDUNG ZWISCHEN ORWELL DMS PROVIDER UND ORWELL DMS PROVIDER .............. 20
ABBILDUNG 2: ANGRIFFSSZENARIEN AUF DEN ORWELL DMS ...................................................................... 21
ABBILDUNG 3: ANFRAGEVALIDIERUNG DURCH WEB APPLICATION GATEWAY .................................................... 22
ABBILDUNG 4: ORWELL DMS PROVIDER MIT PROXY .................................................................................. 23
ABBILDUNG 5: PORTUMSCHALTUNG DURCH PROXY ..................................................................................... 23
ABBILDUNG 6: SYSTEMLANDSCHAFT ORWELL DMS PROVIDER ..................................................................... 25
ABBILDUNG 7: ANMELDUNG SYSTEMADMINISTRATOR .................................................................................. 28
ABBILDUNG 8:ORWELL ACCOUNTCHECK – FUNKTION ACCOUNTCHECK ....................................................... 30
ABBILDUNG 9: ORWELL ACCOUNTCHECK – FUNKTION CREDITCARDCHECK .................................................. 31
ABBILDUNG 10: ORWELL ADDRESSCHECK – FUNKTION ADDRESSCHECK ....................................................... 32
ABBILDUNG 11: ORWELL ADDRESSCHECKV3_1 – FUNKTION ADDRESSCHECK ............................................... 33
ABBILDUNG 12: ORWELL INTERNATIONALADDRESSCHECKV2_0 – FUNKTION INTERNATIONALADDRESSCHECK-
TEIL1 ................................................................................................................................................. 34
ABBILDUNG 13: ORWELL INTERNATIONALADDRESSCHECKV2_0 – FUNKTION INTERNATIONALADDRESSCHECK-
TEIL2 ................................................................................................................................................. 35
ABBILDUNG 14: ORWELL INTERNATIONALADDRESSCHECKV2_0 – FUNKTION INTERNATIONALADDRESSCHECK-
TEIL3 ................................................................................................................................................. 36
ABBILDUNG 15: ORWELL INPUTASSISTANT – FUNKTION POSTCODE ............................................................. 39
ABBILDUNG 16: ORWELL INPUTASSISTANT – FUNKTION CITY ...................................................................... 40
ABBILDUNG 17: ORWELL INPUTASSISTANT – FUNKTION STREET .................................................................. 41
ABBILDUNG 18 ORWELL INPUTASSISTANT – FUNKTION BANKCODE .............................................................. 42
ABBILDUNG 19 ORWELL INPUTASSISTANT – FUNKTION PREPHONE............................................................... 43
ABBILDUNG 20 ORWELL INPUTASSISTANT –FUNKTION FIRSTNAME.............................................................. 44
ABBILDUNG 21: ORWELL INPUTASSISTANT – FUNKTION EMAIL .................................................................... 45
ABBILDUNG 22: ORWELL BANKSEARCHV1_0 – FUNKTION BANKSEARCHMULTIFIELDINPUT .............................. 47
ABBILDUNG 23: ORWELL BANKSEARCHV1_0 – FUNKTION BANKSEARCHSINGLEFIELDINPUT ............................. 48
ABBILDUNG 24: ORWELLPROVIDERBEDIRECTSERVER – FUNKTION SEARCH ...................................................... 50
ABBILDUNG 25: ORWELL PROVIDERBEDIRECTSERVER –FUNKTION INFORMATION ........................................... 51
ABBILDUNG 26: ORWELL PROVIDERADRESSRESEARCH – FUNKTION ADRESSRESEARCHBUSINESS –ANFRAGE .......... 53
ABBILDUNG 27 ORWELL PROVIDERADRESSRESEARCH – FUNKTION ADRESSRESEARCHBUSINESS – RESULTAT ......... 54
ABBILDUNG 28: ORWELL PROVIDERADRESSRESEARCH – FUNKTION ADRESSRESEARCHCONSUMER – ANFRAGE ..... 55
ABBILDUNG 29: ORWELL PROVIDERADRESSRESEARCH – FUNKTION ADRESSRESEARCHCONSUMER –RESULTAT ...... 56
ABBILDUNG 30: ORWELL PROVIDERINFOSCOREONLINE – FUNKTION CREDITCHECK - ANFRAGE......................... 57

ABBILDUNG 31: ORWELL PROVIDERINFOSCOREONLINE – FUNKTION CREDITCHECK - RESULTAT ........................ 58
ABBILDUNG 32: ORWELL INFOSCORERPPCHECK – ORWELLINFOSCORERPPCHECK .......................................... 59
ABBILDUNG 33: ORWELL INFOSCORECREDITCHECK – ORWELLINFOSCORECREDITCHECK ................................. 60
ABBILDUNG 34: ORWELL NONCONSUMERACCOUNTCHECK – ORWELLNONCONSUMERACCOUNTCHECK ........... 61
ABBILDUNG 35: ORWELL PROVIDERADDRESSFACTORYDIRECT – FUNKTION PREMIUMNAMECHECK .................... 62
ABBILDUNG 36: ORWELL PROVIDERADDRESSFACTORYDIRECT – FUNKTION MOVEPROFESSIONAL ........................ 64
ABBILDUNG 37: SCHNITTSTELLEN – BASICSOCKETADAPTER .......................................................................... 65
ABBILDUNG 38: SCHNITTSTELLEN – BASICCONNECTOR ............................................................................... 66
ABBILDUNG 39: PROTOKOLLIERUNG ......................................................................................................... 67
ABBILDUNG 40: WILLKOMMEN I ............................................................................................................. 69
ABBILDUNG 41: MANDANTENVERWALTUNG I ............................................................................................ 70
ABBILDUNG 42: MANDANTEN ANLEGEN ................................................................................................... 71
ABBILDUNG 43: DIENSTE ZUWEISEN I ...................................................................................................... 72
ABBILDUNG 44: MANDANTENVERWALTUNG II ........................................................................................... 73
ABBILDUNG 45: MANDANTEN EDITIEREN .................................................................................................. 74
ABBILDUNG 46: DIENSTE ZUWEISEN II ..................................................................................................... 75
ABBILDUNG 47: MANDANTEN LÖSCHEN BESTÄTIGEN .................................................................................. 76
ABBILDUNG 48: STATISTIK ALLER MANDANTEN ........................................................................................... 78
ABBILDUNG 49: STATISTIK ANPASSEN ........................................................................................................ 79
ABBILDUNG 50: KONTO ......................................................................................................................... 81
ABBILDUNG 51: ANMELDUNG MANDANTENADMINISTRATOR ........................................................................ 82
ABBILDUNG 52: WILLKOMMEN II ............................................................................................................ 83
ABBILDUNG 53: NUTZERVERWALTUNG I ................................................................................................... 84
ABBILDUNG 54: NUTZER ANLEGEN .......................................................................................................... 85
ABBILDUNG 55: DIENSTE ZUWEISEN III .................................................................................................... 86
ABBILDUNG 56: NUTZERVERWALTUNG II .................................................................................................. 87
ABBILDUNG 57: NUTZER EDITIEREN......................................................................................................... 88
ABBILDUNG 58: DIENSTE ZUWEISEN IV .................................................................................................... 89
ABBILDUNG 59: NUTZER LÖSCHEN BESTÄTIGEN ........................................................................................ 90
ABBILDUNG 60: STATISTIK ALLER NUTZER ................................................................................................. 92
ABBILDUNG 61: STATISTIK ANPASSEN ........................................................................................................ 93
ABBILDUNG 62: KONTO ......................................................................................................................... 95
ABBILDUNG 63: NUTZER ANMELDEN ....................................................................................................... 97

ABBILDUNG 64: KONTO ......................................................................................................................... 98
ABBILDUNG 65: DIENSTE ANZEIGEN ........................................................................................................ 99
ABBILDUNG 66: DATENFORMAT ORWELL BANKSEARCHV1_0 – FUNKTION BANKSEARCHMULTIFIELDINPUT ....... 108
ABBILDUNG 67: DATENFORMAT ORWELL BANKSEARCHV1_0 - FUNKTION BANKSEARCHSINGLEFIELDINPUT ...... 109

1 Einleitung
Der ORWELL Direct Marketing Server (DMS) Provider der Bonk Consulting GmbH ist eine
webservicebasierte Integrationsplattform für eine Vielzahl von Diensten aus dem Direkt
Marketing Bereich. Die Dienste, die Ihnen der ORWELL DMS Provider zur Verfügung stellen
kann, eröffnen Ihnen komfortable Möglichkeiten zur Erfassung, Validierung und Anreicherung
von Kundendaten.
Für die Anbindung der gewünschten Dienstleister sowie zur Integration des ORWELL DMS
Provider in Ihre Systemlandschaft stellt er vorgefertigte Schnittstellen, die ORWELL
Interfaces, bereit.
Um Ihren Anforderungen und unseren Zielen immer besser gerecht zu werden, ist die Bonk
Consulting GmbH ständig bemüht, Schnittstellen zu weiteren Dienstleistern in den ORWELL
DMS Provider einzubinden. Damit wird das Angebot an Nutzen bringenden Dienstleistungen
permanent ausgebaut und vervollständigt.
Momentan kann der ORWELL DMS Provider folgende Dienstleistungen von
Partnerunternehmen der Bonk Consulting GmbH über den ORWELL DMS Provider
anbinden:
ORWELL Provider Services:
� ORWELL ProviderAddressFactoryDirect der Bonk Consulting GmbH, basierend auf
dem Produkt ADDRESSFACTORY DIRECT der Deutsche Post Direkt GmbH. Die
Postreferenz-Datei der Deutschen Post Direkt GmbH verfügt über ein Volumen von
95 Millionen aktuellen und ehemaligen Privatadressen.
� ORWELL ProviderBedirectServer der Bonk Consulting GmbH, basierend auf der
SELECT-Datenbank der bedirect GmbH & Co. KG. Die SELECT-Datenbank der
bedirect GmbH & Co. KG enthält Anschriften von wirtschaftlich aktiven und
bonitätsgeprüften Unternehmen in Deutschland.
� ORWELL ProviderInfoscoreOnline der Bonk Consulting GmbH, basierend auf dem
Datenpool der Arvato Infoscore GmbH. Die Arvato Infoscore GmbH bietet
Informationen über Eintragungen in den öffentlichen Schuldnerverzeichnissen der
Amtsgerichte und (Verbraucher-)Insolvenzdaten. Diese Daten werden zusätzlich um
exklusive Inkassodaten ergänzt.
� ORWELL InfoscoreRPPCheck der Bonk Consulting GmbH, ist eine Dienstleistung
unseres Partners Arvato Infoscore GmbH, über diesen Dienst ist die Validierung von
Bankverbindungen hinsichtlich ihrer Bonitätsmerkmale möglich. Als Datengrundlage
dient der Rücklastschriften-Präventions-Pool der Arvato Infoscore GmbH.
� ORWELL InfoscoreCreditCheck der Bonk Consulting GmbH, ist eine
Weiterentwicklung des ORWELL ProviderInfoscoreOnline Dienstes der Arvato
Infoscore GmbH, über diesen Dienst ebenfalls eine personenbezogene Prüfung der
Bonität möglich.
� ORWELL NonConsumerAccountCheck der Bonk Consulting GmbH, ermöglicht die
Prüfung einer Bankverbindung gegen die NonConsumerAccount Datenbank der
Arvato Infoscore GmbH.
Seite 9 von 126

� ORWELL ProviderAdressResearchOnline der Bonk Consulting GmbH, basierend auf
verschiedenen Datenquellen der Adress Research GmbH. Die Adress Research
GmbH ist Marktführer in der Ermittlung von Anschriften, bei denen herkömmliche
Rechercheverfahren keine brauchbaren Ergebnisse liefern.
� ORWELL InternationalAddressCheckV2_0- Der Dienst ORWELL
InternationalAddressCheckV2_0 ermöglicht Ihnen die Überprüfung von
internationalen Adressen auf postalische Richtigkeit. Der Dienst wird von unserem
Partner Uniserv bereitgestellt.
Hauseigene Produkte der Bonk Consulting GmbH:
ORWELL Services:
• ORWELL AccountCheck - Der ORWELL AccountCheck bietet die Möglichkeit,
Kontonummer / Bankleitzahl-Kombinationen auf Plausibilität zu prüfen. Grundlage für
den ORWELL AccountCheck bilden die Prüfregeln der Deutschen Bundesbank, die
quartalsweise aktualisiert werden. Neben der Kontrolle von Bankverbindungen kann
der ORWELL AccountCheck weiterhin Kreditkartennummern anhand eines allgemein
gültigen Algorithmus auf Plausibilität prüfen.
• ORWELL AddressCheck - Der ORWELL AddressCheck bietet die Möglichkeit,
postalische Adressen auf Plausibilität zu prüfen und gegebenenfalls zu korrigieren. Er
basiert auf dem DataFactory Streetcode der Deutsche Post AG.
• ORWELL AddressCheckV3_1 - Der ORWELL AddressCheckV3_1 ist eine
überarbeitete Fassung des bisherigen ORWELL AddressCheckV3_1. Er besitzt im
Gegensatz zum alten ORWELLAddressCheck individuell konfigurierbar und läßt sich
so besser an jeweilige Anforderungen anpassen.
• ORWELL InputAssistant - Der ORWELL InputAssistant ist eine Eingabehilfe für
Formulardaten wie Name, Vorname, Email, Postleitzahl, Ort, Straße sowie Telefon/-
Handy-Vorwahl. Diese Daten werden während der Eingabe geprüft und ergänzt.
• ORWELL InputAssistantV1_2 - Der ORWELL InputAssistant ist eine überarbeitete
Fassung des bisherigen ORWELL InputAssistant. Neu ist hier die über den
Funktionsaufruf konfigurierbare Steuerung der Anfrageabarbeitung, dazu gehören
Auswahl und Sortierverfahren, sowie eine Formatierung der Rückgabewerte.
• ORWELL BankSearchV1_0 - Der ORWELL BankSearch bietet die Möglichkeit Banken
in Abhängigkeit von Bankleitzahl, Bankname, Postleitzahl, Ort, BIC und IBAN zu
suchen. Weiterhin ist auch eine Identifikation einer Bank über den gelieferten
Ähnlichkeitswert möglich. Für die Suche stehen zwei Funktionen zur Verfügung,
welche eine parameterspezifische und eine parameterunspezifische Eingabe
ermöglichen. Beide Funktionen arbeiten bei der Suche fehlertolerant.
Die Anbindung der genannten, sowie neuer Services an den ORWELL DMS Provider erfolgt
über den ORWELL DMS Provider, der einen zentralen Zugang zu sämtlichen Dienstleistern
herstellt. Die Integration in Ihre hauseigene Systemlandschaft kann auf zwei unterschiedliche
Arten stattfinden. Einerseits können Sie die komfortable Variante per Webservice nutzen.
Andererseits bietet Ihnen der ORWELL DMS Provider eine Socket-Schnittstelle zur
Anbindung an Legacy-Systeme, die noch keine Webservices unterstützen. Um Ihren
Seite 10 von 126

Implementierungsaufwand hierbei zu minimieren, empfiehlt Ihnen die Bonk Consulting GmbH
das Produkt ORWELL INTERFACE.
Ein weiterer Bestandteil des ORWELL DMS Provider ist die integrierte mandantenfähige
Benutzerverwaltung. Sie ermöglicht Ihnen beispielsweise das bequeme Anlegen von
Mitarbeiterdatensätzen inklusive der Zuteilung individueller Dienstrechte.
Damit Sie zu jeder Zeit einen Überblick über die angefallenen Kosten haben, verfügt der
ORWELL DMS Provider über ein Statistiktool.
Letztendlich profitierte die Entwicklung des ORWELL DMS Provider von den Erfahrungen,
die die Bonk Consulting GmbH bei der Beratung von Direkt Marketing Prozessen gesammelt
hat. Dies hat zu einem leicht bedienbaren und flexibleren Produktpaket geführt, das ohne
großen Aufwand in verschiedenartigste Unternehmensinfrastrukturen integriert werden kann.
Seite 11 von 126

2 Leistungen
Das folgende Kapitel gibt einen Überblick über die durch den ORWELL DMS bereitgestellten
Dienstleistungen und Funktionen. Der erste Abschnitt, 2.1, enthält eine Übersicht über
sämtliche Dienstleister und deren Leistungsumfang, die Sie mit dem ORWELL DMS Provider
nutzen können. Nachfolgend werden unter dem Punkt 2.2 die Schnittstellen beschrieben die
existieren, um den ORWELL DMS Provider in Ihrer Systemumgebung verfügbar zu machen.
Die folgenden drei Punkte geben einen Einblick in die drei wichtigsten Funktionalitäten, die
der ORWELL DMS mitliefert. Dabei handelt es sich um die Nutzerverwaltung, die
Protokollierung und die statistische Auswertungsfunktion. Unter dem Punkt 0 werden
schließlich Sicherheitsmechanismen vorgestellt, die zwischen den einzelnen Komponenten des
ORWELL DMS zur sicheren Kommunikation untereinander eingesetzt werden.
2.1 Direkt Marketing Dienste
Es folgt nun eine Kurzbeschreibung der durch den ORWELL DMS Provider angebotenen
Dienste:
Dienstleister Dienst Beschreibung
ORWELL
AccountCheck
ORWELL
AddressCheck
ORWELL
InputAssistant
accountCheck Die übergebene Bankverbindung wird
anhand der Bankleitzahl und der
Kontonummer auf Plausibilität geprüft.
creditcardCheck Eine übergebene Kreditkartennummer
Seite 12 von 126
wird auf Ihre Plausibilität geprüft.
addressCheck Korrektur ungültiger, fehlerhafter oder
veralteter postalischer Adressen,
bestehend aus Postleitzahl, Ort und
Straße, Postfach
postCodeToCity Gibt zu einer übergebenen Postleitzahl
eine Liste von Postleitzahlen mit
dazugehörigen Orten zurück.
cityToPostCode Liefert zu einem übergebenen
Ortsnamen eine Liste von Postleitzahlen
mit den dazugehörigen Ortsnamen
zurück.
street Liefert zu einer übergebenen
Kombination aus Postleitzahl, Ortsname
und Straßenname eine Liste von
Straßenamen zurück. Eine gültige
Postleitzahl ist für die Prüfung
Voraussetzung.
bankCodeToBankName Liefert zu einer übergebenen BLZ den
Namen der Bank zurück.
prephoneNumberCheck Der Dienst überprüft eine übergebene
Telefonvorwahl auf Gültigkeit. Er kann
zwischen Festnetz- und Handy-
Vorwahlen unterscheiden.

ORWELL Provider
AdressResearchOnline
ORWELL Provider
AddressFactoryDirect
ORWELL Provider
BedirectServer
ORWELL Provider
InfoscoreOnline
ORWELL
InfoscoreCreditCheck
ORWELL
InfoscoreRPPCheck
ORWELL
NonConsumer
AccountCheck
ORWELL
InputAssistantV1_2
firstNameCheck Der Dienst überprüft einen übergebenen
Vornamen gegen die Daten der
Vornamensdatenbank der Bonk
Consulting GmbH. Bei einem Treffer
wird das logische Geschlecht zurück
gegeben.
emailCheck Der Dienst überprüft eine übergebene
Emailadresse unter den Gesichtspunkten
Syntax und Topleveldomain auf ihre
Seite 13 von 126
Gültigkeit.
adressResearchConsumer Adressvalidierung auf gerichtsfähige
Haushaltsadressen.
adressResearchBuisness Adressvalidierung auf gerichtsfähige
Geschäftsadressen.
premiumNameCheck Adressvalidierung auf postalische
Zustellbarkeit.
moveProfessional Lieferung der aktuellsten Umzugsadresse
– auch bei Mehrfachumzug.
search Der Dienst überprüft eine übergebene
Firmenadresse auf seine Gültigkeit. Bei
einer ungenauen Anfrage erhält man
eine korrigierte Firmenadresse oder
Mehrfachtreffer zurück.
information Dieser Dienst liefert zusätzliche
Informationen zur Firma, die mit der
search - Anfrage ermittelt wurde.
creditCheck Liefert Bonitätsdaten zu einer Adresse
orwellInfoscore
CreditCheck
orwellInfoscore
RPPCheck
orwellNonConsumer
AccountCheck
Liefert Bonitätsdaten zu einer Adresse.
Liefert Bonitätsdaten zu einer
Bankverbindung.
Identifiziert eine Bankverbindung als
Nicht-Privat-Bankverbindung.
postCodeExpansion Gibt zu einer übergebenen Postleitzahl
eine Liste von Postleitzahlen mit
dazugehörigen Orten zurück.
cityExpansion Liefert zu einem übergebenen
Ortsnamen eine Liste von Postleitzahlen
mit den dazugehörigen Ortsnamen
zurück.
streetExpansion Liefert zu einer übergebenen
Kombination aus Postleitzahl, Ortsname
und Straßenname eine Liste von
Straßenamen zurück.

ORWELL
BankSearchV1_0
ORWELL
AddressCheckV3_1
ORWELL
International
AddressCheckV2_0
houseNumberExpansion Liefert die Postleitzahl zur Hausnummer
einer Strasse.
bankCodeExpansion Liefert zu einer übergebenen BLZ den
Namen der Bank zurück.
prephoneNumberCheck Der Dienst überprüft eine übergebene
Telefonvorwahl auf Gültigkeit. Er kann
zwischen Festnetz- und Handy-
Vorwahlen unterscheiden.
firstNameCheck Der Dienst überprüft einen übergebenen
Vornamen gegen die Daten der
Vornamensdatenbank der Bonk
Consulting GmbH. Bei einem Treffer
wird das logische Geschlecht zurück
gegeben.
emailCheck Der Dienst überprüft eine übergebene
Emailadresse unter den Gesichtspunkten
Syntax und Topleveldomain auf ihre
bankSearch
MultiFieldInput
bankSearch
SingleFieldInput
Seite 14 von 126
Gültigkeit.
Der Dienst ermöglicht eine
parameterspezifische Suche über die
Parameter (Bankleitzahl, Bankname,
Postleitzahl, Ort und IBAN)
Der Dienst ermöglicht eine
unspezifische Suche, es wird dabei
versucht in der übergebenen
Zeichenkette die Parameter
(Bankleitzahl, Bankname, Postleitzahl,
Ort und IBAN) zu identifizieren und
formatiert zurückzugeben.
addressCheck Korrektur ungültiger, fehlerhafter oder
veralteter postalischer Adressen,
bestehend aus Postleitzahl, Ort und
internationalAddressChec
k
Tabelle 1: Dienste des ORWELL DMS Provider
Straße, Postfach
Korrektur internationaler ungültiger,
fehlerhafter oder veralteter postalischer
Adressen, bestehend aus Postleitzahl,
Ort und Straße, Postfach

2.2 Schnittstellen
Der ORWELL DMS Provider bietet zwei unterschiedliche Schnittstellen, um diesen in Ihre
Systemumgebung zu integrieren. Die erste Variante stellt die Implementierung via Webservice
dar. Eine weitere Möglichkeit ist die Anbindung über eine Socket-Schnittstelle.
Schnittstelle Kurzbeschreibung
BasicAdapter Webservices
BasicSocketAdapter Socket-Schnittstelle für Legacy-Systeme (ORWELL Interfaces)
Tabelle 2: Schnittstellen
Sollten Sie über sogenannte Legacy-Systeme verfügen, also solche, die eine Implementierung
über Webservices noch nicht unterstützen, haben Sie die Möglichkeit, unter Benutzung der
Socket-Schnittstelle sowie der ORWELL Interfaces Ihre IT-Landschaft ohne großen Aufwand
anzubinden. Die folgende Tabelle enthält die dazu notwendigen ORWELL Interfaces, die
momentan zur Verfügung stehen.
ORWELL Interface Kurzbeschreibung
ORWELL
MultiuserDLL
Interface
ORWELL Oracle
Interface
ORWELL PHP
Interface
ORWELL SAP
Interface
ORWELL Java RMI
Interface
ORWELL Java
Interface
Schnittstelle zur ADDRESSFACTORY DIRECT der Deutsche Post
Direkt GmbH und der ORWELL Produktlinie der Bonk Consulting
GmbH
Schnittstelle zu den Diensten der ADDRESSFACTORY DIRECT der
Deutsche Post Direkt GmbH und zur ORWELL Produktlinie der
Bonk Consulting GmbH
Schnittstelle zu den Diensten der ADDRESSFACTORY DIRECT der
Deutsche Post Direkt GmbH und zur ORWELL Produktlinie der
Bonk Consulting GmbH
Schnittstelle zu den Diensten der ADDRESSFACTORY DIRECT der
Deutsche Post Direkt GmbH und zur ORWELL Produktlinie der
Bonk Consulting GmbH
Anbindung des ORWELL DMS (Direkt Marketing Server) Provider
der Bonk Consulting GmbH in eine bestehende Java Applikation
Schnittstelle zu den Diensten der ADDRESSFACTORY DIRECT der
Deutsche Post Direkt GmbH und zur ORWELL Produktlinie der
Bonk Consulting GmbH
Tabelle 3: ORWELL Interfaces
Seite 15 von 126

2.3 Nutzerverwaltung
Der ORWELL DMS ermöglicht eine mandantenfähige Authentifizierung und Autorisierung
seiner Nutzer. Das bedeutet, dass alle auf dem ORWELL DMS existierenden Mandanten und
alle innerhalb eines Mandanten existierenden Benutzer eindeutig sein müssen. Als Login wird
die Kombination von Nutzernamen und Mandanten mit Trennzeichen verwendet (Beispiel:
login@mandator).
Jeder Benutzer benötigt zur Authentifizierung ein Passwort. Als Passwort wird ein mindestens
12-stelliges Passwort bestehend aus kleinen und großen Buchstaben, Ziffern und
Sonderzeichen erzwungen bzw. generiert. Die Passwörter sind auf Nutzerebene änderbar.
An jeden Mandanten sind Zugangsberechtigungen für Dienste gebunden, die er an seine
Benutzer als Untermenge weiter vererben kann. Die Zugangsberechtigungen können
nachträglich geändert werden. Die Zugangsberechtigungen sind bis auf einzelne
Funktionalitäten eines Dienstes aufschlüsselbar.
Das Anlegen eines Mandanten mit zugehörigem Administrator kann nur vom
Systemadministrator durchgeführt werden. Das Anlegen eines Nutzers kann nur vom
Mandantenadministrator innerhalb eines Mandanten erfolgen.
Zur Verwaltung der Mandanten und der Benutzer stellt der DMS eine webfähige
Administrationsoberfläche zur Verfügung.
Seite 16 von 126

2.4 Protokollierung
Alle Webservice-Transaktionen werden auf dem DMS zum Zwecke der
Transaktionssicherheit, Statistik und Abrechnung protokolliert. Die Protokollierung der
kundenbezogenen Daten erfolgt als SHA 256 Hashwert, so dass die Daten weder offen
einsehbar noch eindeutig rückführbar sind. Lediglich Mandant, Benutzer, Transaktions-ID,
Transaktionstyp sowie Abgleichstatus sind aus oben genannten Gründen offengelegt.
Die Protokollierungsdaten auf dem DMS Provider der Bonk Consulting verbleiben daraufhin
bis zu 3 Monaten auf dem System und werden danach gelöscht, falls nicht anders vertraglich
geregelt.
Der ORWELL DMS besitzt in allen seinen Komponenten Protokollierungsfunktionen, welche
folgende Aufgaben erfüllen:
� Die Protokollierung von Dienstzugriffen
� Die Protokollierung von aufgetretenen Fehlern
� Die Protokollierung von ablaufkritischen Ereignissen innerhalb einer Komponente
Um diesen drei Aufgaben besser gerecht zu werden, und um das anfallende Datenvolumen
möglichst gering zu halten, unterstützt der ORWELL DMS hierarchisch gestaffelte
Protokollierungsstufen:
� OFF - Niedrigste Protokollierungsstufe des ORWELL DMS. Protokollierung ist
ausgeschaltet
� FATAL - Protokollierung von nicht handhabbaren technischen Fehlern
� ERROR - Protokollierung von nicht handhabbaren fachlichen Fehlern
� WARN - Protokollierung von Sicherheitsverletzungen
� INFO - Standard Protokollierungsstufe des ORWELL DMS. Protokollierung von
Dienstzugriffen, Start und Stopp von Systemkomponenten sowie
Konfigurationsparametern
� DEBUG - Protokollierung von ablaufkritischen Ereignissen. Da hier das anfallende
Datenvolumen immens ist, sollte dieser Modus nur zum Auffinden von Laufzeitfehlern
verwendet werden
Die protokollierten Meldungen können sowohl in der Datenbank als auch in einer Datei
hinterlegt werden.
Zur Auswertung der Protokolle steht ein Statistiktool zur Verfügung.
Seite 17 von 126

2.5 Statistik
Neben den bisher vorgestellten Leistungen hält der ORWELL DMS Provider eine statistische
Auswertungsfunktion für Sie bereit. Die Statistik wird als ein Menüpunkt im Web-Frontend
des ORWELL DMS angezeigt. Sie gibt Ihnen eine Gesamtübersicht sowie eine detaillierte
Übersicht über die von Ihnen abgewickelten Transaktionen. Über einen integrierten Kalender
haben Sie die Möglichkeit, einen beliebigen Zeitraum auszuwählen, für den eine Statistik
erstellt werden soll. Je nachdem unter welchem Kontext Sie angemeldet sind, können Sie die
Statistik für einen Mandanten, also z. B. für eine komplette Abteilung, oder sogar separat für
einen Nutzer ausgeben lassen.
Wie die Nutzerverwaltung und die Statistikfunktion im Detail zu verwenden sind und welche
Konventionen dabei zu beachteten sind, wird weiter unten im Kapitel 4 erläutert.
Seite 18 von 126

2.6 Sicherheit
2.6.1 SSL
Zur Absicherung der Kommunikationsverbindungen verwendet der ORWELL DMS das
weitverbreitete Verschlüsselungsprotokoll SSL. Da sich das SSL Protokoll nach dem ISO/OSI
Modell zwischen Anwendungsschicht (http, ftp, rmi) und der Darstellungsschicht (tcp/ip)
befindet, ist es universell für die Absicherung von Webanwendungen einsetzbar.
Das SSL Protokoll erfüllt folgende Anforderungen bei Ablauf einer Transaktion
� Authentifizierung von Server und Client (optional)
� Verschlüsselung der zu übertragenden Datenpakete.
Um diesen Anforderungen gerecht zu werden, besteht das SSL-Protokoll aus den beiden
Teilen SSL-Handschlag Protokoll (engl. SSL Handshake Protocol, SSLHP) und SSL-Paket
Protokoll (engl. SSL-Record Protocol, SSLRP). Das SSLHP handelt den zu benutzenden
symmetrischen Verschlüsselungsalgorithmus samt Schlüssel aus. Dies geschieht über die
Verwendung eines asymmetrischen Verschlüsselungsverfahrens. Optional kann eine
Authentifizierung des Clients und des Servers gegeneinander mittels der Zertifikate beider
erfolgen.
Für den Einsatz von SSL im ORWELL DMS ist die Authentifizierung von Client und Server
eine Pflichteinstellung. Das für die Authentifizierung von Bonk Consulting notwendige
Zertifikat wird von der Firma Verisign (CA) erstellt und muss in den Client-Keystore des
ORWELL DMS Provider eingespielt werden, damit dieser die Identität des ORWELL DMS
Providers prüfen kann. Wird zwischen DMS Provider und DMS Provider der DMS Proxy
verwendet, so benötigt dieser kein SSL Zertifikat, da der Proxy auf der darunterliegenden
Darstellungsschicht TCP/IP arbeitet und somit transparent für das SSL Protokoll ist.
Der Austausch der Nutzdaten findet daraufhin mit dem SSLRP auf Basis eines symmetrischen
und dadurch wesentlich schnelleren Verschlüsselungsverfahrens statt. Das SSLRP unterteilt
den Datenstrom in Pakete und verschlüsselt diese mit dem ausgehandelten Algorithmus oder
empfängt Pakete und entschlüsselt sie. Über den Schlüssel, die Nutzdaten, die Fülldaten und
die Sequenznummer eines Datenpakets wird ein sogenannter Message Authentication Code
(MAC) mit Hilfe eines Prüfsummen-Algorithmus wie MD5 gebildet. Auf diese Weise ist auch
hier die Authentizität der Datenpakete sichergestellt, solange der Sitzungsschlüssel nicht
bekannt ist. Um eine ausreichende Sicherheit des Sitzungsschlüssels zu gewähren, wird hier
ein 128-Bit Schlüssel verwendet.
Der Sitzungsschlüssel wird im ORWELL DMS bei jeder Transaktion neu generiert.
Die folgende Darstellung zeigt den Aufbau einer SSL Verbindung zwischen ORWELL DMS
Provider und ORWELL DMS Provider mit den einzelnen Ablaufschritten.
Seite 19 von 126

Abbildung 1: SSL Verbindung zwischen ORWELL DMS Provider und ORWELL DMS Provider
1. Verbindungsaufbau durch ORWELL DMS Provider, Übertragung der Frage-Daten,
Protokollversion und der bekannten Verschlüsselungs- und Komprimierungsverfahren
2. Der ORWELL DMS Provider liefert daraufhin seine Protokollversion seine Frage-
Daten, seine gewähltes Verschlüsselungsverfahren und seine
Komprimierungsmethode zurück
3. Übertragung des Server-Zertifikats mit öffentlichem Serverschlüssel an den ORWELL
DMS Provider
4. Überprüfung des ORWELL DMS Provider Server-Zertifikats (Bonk Consulting
Zertifikats von Verisign) durch den ORWELL DMS Provider. Generierung des
Hauptschlüssels
5. Übertragung des mit dem öffentlichen Schlüssel des ORWELL DMS Providers
kodierten Hauptschlüssel zum Server
6. Entschlüsseln des Hauptschlüssels mit dem privaten Schlüssel des ORWELL DMS
Provider
Seite 20 von 126

7. Wechseln in den symmetrischen Übertragungsmodus zwischen ORWELL DMS
Provider und ORWELL DMS Provider auf Basis des gemeinsamen Hauptschlüssels zur
Datenübertragung
Mit Hilfe von SSL können „Mann in der Mitte Attacken“ auf die Verbindung zwischen
ORWELL DMS Provider und ORWELL DMS Provider abgewehrt werden. Als „Mann in der
Mitte Attacke“ bezeichnet man einen Angriff, in dem sich ein Dritter (der Angreifer) in den
Übertragungsweg zweier Kommunikationspartner einklinkt und auf diese Weise den beiden
Kommunikationspartner vortäuscht, der jeweils gegenüberliegende Partner zu sein. Aus
diesem Sachverhalt ergeben sich mehrere mögliche Unterszenarien, welche auch durch SSL
unterbunden werden.
Unterszenarien:
Abbildung 2: Angriffsszenarien auf den ORWELL DMS
� Lauschen(Fall A) - Ein Lauscher hört die Kommunikationsverbindungen ab und gelangt
so in den Besitz von Daten, die als Ausgangspunkt weiterer Angriffe dienen können.
Ein erfolgreicher Lauschangriff ist die Voraussetzung für einen „Mann in der Mitte“
Angriff. Ein Lauschangriff kann durch eine ausreichende Schlüssellänge (128 bit)
verhindert werden. Somit ist der Angreifer nicht in der Lage, an brisante Daten zu
gelangen, da er zum Entschlüsseln der Daten Jahre braucht.
� Täuschen(Fall A): Ein Angreifer fügt Nachrichten ein, löscht oder modifiziert legitime
Nachrichten. Dieser Angriff wird durch SSL verhindert, weil auch hier der Angreifer
zuerst in den Besitz des Schlüssels gelangen muss und beim Einfügen, Modifizieren
und Löschen einzelner Datenpakete der MAC nicht mehr stimmen würde. Dies
würde unweigerlich zum Verbindungsabbruch und zum Verwerfen der Transaktion
führen.
� Wiederholung(Fall B): Eine legitime Nachricht wird zu einem späteren Zeitpunkt
wiederholt. Die Wiederholung einer legitimen Nachricht ist ebenfalls nicht möglich,
Seite 21 von 126

da nach jeder Transaktion ein neuer Sitzungsschlüssel (Verbindungsschlüssel)
ausgehandelt wird. Somit würde auch der MAC nicht mehr stimmen, da der
Sitzungsschlüssel oder der Verbindungsschlüssel ebenfalls zur Bildung des MAC mit
einbezogen wird.
2.6.2 Web Application Gateway
Alle auf dem DMS Provider bereitgestellten Webservices sind auf die Verwendung eines Web
Application Gateway‘s zum Schutz der internen Systeme vorbereitet. Dies geschieht durch
separate Bereitstellung der XSD Schemas aus der WSDL Beschreibung des Webservices. Die
nachfolgende Abbildung beschreibt diesen Vorgang anhand des XML Request und des XML
Response des Webservices, welche für den Datenaustausch übermittelt werden.
XML Request
administ
status>A1100klaus WAG
Content-
Kontrolle
administ
rationadminxxXX12,.klaus
Port 8445
Validierung des XML Request & Response durch XSD Schema
≙
Seite 22 von 126
XML Response
administ
status>A1100klaus
-
-
-
-
-
Abbildung 3: Anfragevalidierung durch Web Application Gateway
Web Application Gateway‘s validieren daraufhin mittels XSD Schemas die ein- und
ausgehenden Webserviceanfragen hinsichtlich der im XSD Schema beschriebenen
Datenstruktur. Somit ist es unmöglich nicht schemakonforme Webserviceanfragen zu
verschicken und so an der Kommunikation beteiligte Systeme zu gefährden.
Der Webservice kann prinzipiell auch ohne Einsatz eines Web Application Gateway genutzt
werden. In diesem Fall werden jedoch die Zugriffe nicht durch das XSD Schema auf dem Web
Application Gateway geprüft.
2.6.3 Firewall
Der DMS Provider muss durch eine Firewall gegen unerlaubte Fremdzugriffe geschützt
werden. Der einzige Port der für den Betrieb der gehosteten Webservices notwendig ist, ist
der Port des integrierten Tomcat Webservers. Dieser Port muss auf der Firewall
freigeschaltet werden.

2.6.4 Proxy
Der ORWELL DMS Provider wird für den Betrieb im Internet mit einem Proxyserver
abgeschirmt. Der ORWELL DMS Provider ist durch den Proxy nicht direkt aus dem Netz
angreifbar, sondern der Angreifer muss zuerst den Proxy überwinden. Dies bietet mehr
Sicherheit gegenüber sogenannten „exploit“ Angriffen in denen ein Angreifer versucht durch
die Ausnutzung von Software Bugs die Systemkontrolle zu erlangen. Der Proxy Server wird
auf einer eigenen Maschine installiert, welche speziell für den Einsatz im Internet gehärtet
wurde, d.h. alle unsicheren Systemkomponenten wurden entfernt oder durch sichere ersetzt.
Netzwerk Kunde
ORWELL DMS
Customer
ORWELL
Proxy
Firewall
Internet
SSL / VPN
über Internet /
Standleitung
Seite 23 von 126
Firewall
Abbildung 4: ORWELL DMS Provider mit Proxy
Netzwerk
Bonk Consulting
ORWELL
Proxy
ORWELL
DMS Provider
Der zweite Grund, nicht ohne Proxy zu arbeiten, ist die Fähigkeit der Portumschaltung.
Internet
ORWELL Proxy
Port A
Portumschaltung
Port B
Abbildung 5: Portumschaltung durch Proxy
Mit der Portumschaltung umgeht man eine Abänderung der Firewall Regeln in einem
bestehenden System. Die Dienste des ORWELL DMS können so über einen schon geöffneten
Port nach außen umgelenkt werden. Dies bietet den Vorteil, dass die bestehenden Systeme
nicht durch das Öffnen neuer Ports gefährdet werden.
ORWELL DMS Customer

2.6.5 Kerberos
Kerberos bietet eine sichere und einheitliche Authentifizierung in einem ungesicherten
TCP/IP-Netzwerk auf sicheren Hostrechnern. Die Authentifizierung übernimmt eine
vertrauenswürdige dritte Partei. Diese dritte Partei ist ein besonders geschützter Kerberos-5-
Netzwerkdienst. Kerberos unterstützt Single Sign On, d.h., ein Benutzer muss sich nur noch
einmal anmelden, dann kann er alle Netzwerkdienste nutzen, ohne ein weiteres Mal ein
Passwort eingeben zu müssen. Kerberos übernimmt die weitere Authentifizierung.
Momentan unterstützt der ORWELL DMS kein Kerberos. Dieser Authentifizierungsdienst
kann aber auf Kundenwunsch integriert werden.
Seite 24 von 126

2.7 Systemarchitektur/Systemlandschaft
Der ORWELL DMS ist als ein dezentrales System zu betrachten. Es wird lediglich zwischen
der anwenderseitigen Konfiguration des ORWELL DMS Provider und der anbieterseitigen
Konfiguration des ORWELL DMS Provider unterschieden, welche sich hauptsächlich durch
ihre Konfiguration differenzieren. Er wird sowohl beim Anwender als auch beim Dienstleister
eingesetzt. Die Trennung in logisch und räumlich getrennte Systeme ist begründet durch die
Forderung der Anwender und Dienstleister nach Integration in die eigene Infrastruktur sowie
Flexibilität, Sicherheit und Abrechenbarkeit der Leistungen. Als Verbindung zwischen zwei
Direkt Marketing Servern kommt ein XML basiertes SSL verschlüsseltes Protokoll zum
Tragen, welches zusätzlich Daten für eine Authentifizierung der einzelnen Server
untereinander beinhaltet. Außerdem werden alle Anfragen über einen Proxy weitergeleitet,
so dass von außerhalb nicht direkt auf den ORWELL DMS Provider zugegriffen werden kann.
Abbildung 6: Systemlandschaft ORWELL DMS Provider
Über die Adaptoren werden die Anwenderschnittstellen in den ORWELL DMS Provider
eingebunden, dazu gehören das Oracle Interface, das Java RMI Interface, das SAP Interface,
das PHP Interface, sowie das MultiuserDll Interface. Über die Konnektoren werden die
Dienste einzelner Anbieter entweder direkt oder über einen entfernten ORWELL DMS den
Adaptern und somit den Schnittstellen zur Verfügung gestellt. Bei Zugriff eines Adapters auf
einen Dienst eines Konnektors erfolgt sowohl eine Authentifizierung, als auch eine
Autorisierung des Zugriffs. Die Konnektoren verfügen über einen
Protokollierungsmechanismus, der alle Transaktionen zwischen Adapter und Konnektor
festhält. Die Daten der Protokollierung sind über das Modul DMS Statistik auswert- und
abrechenbar. Die mitgelieferten Adapter und Konnektoren, sowie ihre Begleitanwendungen,
sind modular konfigurierbar.
Seite 25 von 126

3 Systemanforderungen
Hardware:
� x86 kompatibler Computer mit 1024 MB Speicher und mindestens 2 Ghz
� Netzwerkverbindung ins Intranet oder Internet
Software:
� Referenz System Windows
o Windows 2000 (32bit)
o Windows XP (32bit)
� Referenzsystem Linux
o Suse Linux 8.x, 9.x, 10.x (32bit, 64bit)
o Suse Enterprise Linux 10.x (32bit, 64bit)
� Referenzsystem Solaris
o SunOS 5.6 / 5.9 (32bit)
� Jboss Applikation Server Version 4.2.2
� Java SDK 1.5 oder höher
� MySQL 5.0
Seite 26 von 126

4 Bedienungsanleitung
In dem nun folgenden Kapitel soll der Umgang mit dem ORWELL DMS Provider ausführlich
beschrieben werden. Grundlegende Funktionen, wie das Anlegen neuer Mandanten und
Benutzer, werden hier genauso behandelt wie die Beschreibung von Konventionen. Weiterhin
geht es um die Handhabung der verschiedenen ORWELL Dienstleistungen und die
Verwendung des Statistiktools.
4.1 Auslieferungszustand
Nachdem Sie den ORWELL DMS Provider auf ihrem Server installiert und konfiguriert haben,
können Sie über die URL http://IP:Port/DMSAdmin den ORWELL DMS Admin erreichen.
Im Auslieferungszustand des ORWELL DMS Admin ist standardmäßig der
Systemadministrator (Superadministrator) vorkonfiguriert.
Seite 27 von 126

4.2 Systemadministrator
Der Systemadministratoren-Account (administration) ist sowohl für Ihren ersten
Anmeldevorgang als auch zum Anlegen von Mandanten in Zukunft notwendig. Um sich
anzumelden, tragen Sie bitte folgende Zugangsdaten auf der Anmeldeseite des ORWELL DMS
Admin ein:
� Mandant: administration
� Benutzer: admin
� Passwort: default
Abbildung 7: Anmeldung Systemadministrator
Als Superadministrator verfügt dieser Account über sämtliche zur Verfügung stehenden
Rechte. Nur er ist dazu privilegiert, neue Mandanten anzulegen sowie Statistiken über alle
vorhandenen zu erstellen.
Im folgenden Abschnitt wird zunächst die Handhabung der ORWELL Dienstleistungen
erläutert. Navigieren Sie dazu nach Ihrer Anmeldung auf die Seite „Dienste“.
Seite 28 von 126

4.2.1 Dienste
Dieses Kapitel erläutert die Handhabung der an den ORWELL DMS Admin angebundenen
ORWELL Dienstleistungen. Die Verwendung aller ORWELL Dienstleistungen ist generell sehr
einfach gehalten. Tragen Sie jeweils im Bereich „Eingabe“ die geforderten Initialdaten ein. Mit
dem Button „Überprüfen“ stoßen Sie die Verarbeitung der Eingabedaten an. Der Bereich
„Ausgabe“ repräsentiert die Ergebnisse Ihrer Anfrage. Das Feld „Status“, im unteren Bereich,
gibt verschiedene Status-Informationen aus, die Ihnen bei der Interpretation der
Anfrageergebnisse von Nutzen sein können.
Für weiterführende Informationen über die einzelnen ORWELL Dienstleistungen
fordern Sie bitte das zugehörige Webservice-Handbuch an. Darin finden Sie neben
einer detaillierten Beschreibung der Dienstleistung und deren Funktionsweise auch
eine ausführliche Interpretation der Statuscodes.
Seite 29 von 126

4.2.1.1 ORWELL AccountCheck
Zur Verwendung des ORWELL AccountCheck’s wählen Sie aus der Dropdown – Box
„Dienste“ den Eintrag „OrwellAccountCheck“.
4.2.1.1.1 Funktion accountCheck
Die Funktionalität hinter dem Reiter „AccountCheck“ bietet Ihnen die Möglichkeit, die
Kombination aus einer Kontonummer und einer Bankleitzahl gegeneinander zu validieren.
Tragen Sie dazu im Bereich „Eingabe“ die zu validierenden Daten ein. Mit der Betätigung des
Buttons „Überprüfen“ werden die übergebenen Daten durch ein mathematisches Regelwerk
überprüft. Schließlich können Sie jedes Formular durch die Betätigung des Buttons
„Zurücksetzen“, für eine Neueingabe, leeren.
Abbildung 8:ORWELL AccountCheck – Funktion accountCheck
Im Bereich „Ausgabe“ werden Ihnen zusätzlich zu den eingegebenen Daten
Mehrwertinformationen, wie der Bankname, der Ort, an dem die Bank ansässig ist oder die
internationale Bank Identifikation ergänzt.
Genauere Informationen, z.B. darüber ob die Kontonummer zu der entsprechenden
Bankleitzahl passen könnte, oder ob nur die Bankleitzahl existiert, die Kontonummer aber
nicht dazu passt usw., lassen sich aus dem Feld „Status“ ableiten. Die Interpretation der dort
angezeigten Codes finden Sie unter „Beschreibung“.
Seite 30 von 126

4.2.1.1.2 Funktion creditCardCheck
Die Plausibilitätsprüfung einer Kreditkartennummer lässt sich mit dem KreditkartenCheck
durchführen. Wechseln Sie dazu auf den entsprechenden Reiter. Geben Sie im Bereich
„Eingabe“ die Kreditkartennummer ein, die Sie prüfen möchten, und klicken Sie den Button
„Überprüfen“.
Abbildung 9: ORWELL AccountCheck – Funktion creditCardCheck
Der zugehörige Bereich „Ausgabe“ wiederum, gibt die eingegebenen Daten sowie
ergänzende Informationen, in diesem Fall das Kreditkarteninstitut, zurück. Die
Entschlüsselung des kryptischen Feldes „Status“ entnehmen Sie bitte der Beschreibung rechts
nebenstehend. Der Status „KC01L1“ liefert folgende Beschreibung:
� Kreditkarteninstitut existiert, Kreditkartenummer plausibel
Seite 31 von 126

4.2.1.2 ORWELL AddressCheck
4.2.1.2.1 Funktion addressCheck
Der Dienst ORWELL AddressCheck ermöglicht Ihnen die Überprüfung von deutschen
Adressen auf postalische Zustellbarkeit.
Um diesen zu verwenden, wählen Sie bitte im Dropdown – Feld „OrwellAddressCheck“ aus.
Geben Sie anschließend die zu prüfenden Daten im Bereich „Eingabe“ ein und betätigen Sie
den Button „Überprüfen“.
Abbildung 10: ORWELL AddressCheck – Funktion addressCheck
Das Regelwerk des ORWELL AddressCheck ermittelt nun aus den hier verfälscht
eingegebenen Daten die am wahrscheinlichsten postalisch korrekte Adresse sowie
ergänzende Angaben. Diese bereinigten Daten werden im Bereich „Ausgabe“ angezeigt.
Unter „Status“ und „Beschreibung“ finden Sie wieder die Statuscodes zu Ihrer Anfrage.
Im Falle, dass eine Adresse zu 100% korrekt eingegeben wird, erscheint der Statuscode
„A1000“.
Seite 32 von 126

4.2.1.3 ORWELL AddressCheckV3_1
4.2.1.3.1 Funktion addressCheck
Der Dienst ORWELL AddressCheckV3_1 ermöglicht Ihnen die Überprüfung von deutschen
Adressen auf postalische Zustellbarkeit. Im Gegensatz zum älteren Dienst wurde die
Schnittestelle insoweit verändert, dass auf die Adressprüfung mit individuell Anpassbaren
Steuerparametern Einfluss genommen werden kann.
Abbildung 11: ORWELL AddressCheckV3_1 – Funktion addressCheck
Seite 33 von 126

4.2.1.4 ORWELL InternationalAddressCheckV2_0
4.2.1.4.1 Funktion internationalAddressCheck
Der Dienst ORWELL InternationalAddressCheckV2_0 ermöglicht Ihnen die Überprüfung von
internationalen Adressen auf postalische Richtigkeit. Die Qualität der Adresskorrektur ist von
der Qualität der einzelnen Landesdatenbanken abhängig. Das Länderkürzel ist für eine
Validierung der Adresse zwingend notwendig.
Abbildung 12: ORWELL InternationalAddressCheckV2_0 – Funktion internationalAddressCheck-Teil1
Seite 34 von 126

Abbildung 13: ORWELL InternationalAddressCheckV2_0 – Funktion internationalAddressCheck-Teil2
Seite 35 von 126

Abbildung 14: ORWELL InternationalAddressCheckV2_0 – Funktion internationalAddressCheck-Teil3
Seite 36 von 126

Seite 37 von 126

4.2.1.5 ORWELL InputAssistant
Ein weiterer hilfreicher Dienst ist der ORWELL InputAssistant. Er unterstützt die effektive
computergestützte Erfassung von Kundendaten dahingehend, dass diese möglichst schnell,
vollständig und korrekt über ein elektronisches Formular (Webseite, CRM-Eingabemaske,
etc.) in Ihr System / in Ihren Datenbestand gelangen.
Der ORWELL InputAssistant ist jetzt auch in der überarbeiteten Version 1.2 verfügbar,
welcher über zusätzliche Steuerparameter bei Funktionsaufruf den Ablauf der Anfragen sowie
die Art und Weise der rückgelieferten Parameter beeinflussen kann.
Wählen Sie „OrwellInputAssistant“ im Dropdown - Feld „Dienste“ aus. Der ORWELL
InputAssistant stellt ihnen unter den verschiedenen Registerkarten folgende Funktionen zur
Verfügung:
� postCodeToCity/postCodeExpansion(V1.2) Eingabeunterstützung Postleitzahl zu
Ort - zu einer vollständig oder unvollständig angegebenen Postleitzahl werden
passende Ortsnamen zurückgegeben.
� cityToPostCode/cityExpansion(V1.2) Eingabeunterstützung Ort zu Postleitzahl -
zu einem vollständig oder unvollständig angegebenen Ortsnamen werden passende
Postleitzahlen geliefert.
� street/streetExpansion(V1.2) Eingabeunterstützung Straßen - zu einer vorher
angegebenen Postleitzahlen-Orts-Straßen-Kombination werden passende Straßen
zurückgegeben. Die Angaben müssen auch hier nicht vollständig sein.
� xxx/houseNumberExpansion(V1.2) Liefert zu einer übergebenen Adresse anhand
der Hausnummer die Postleitzahl, wichtig für Straßen welche über mehrere
Postleitzahlen verfügen.
� bankCodeToBankName/bankCodeExpansion(V1.2) Eingabeunterstützung
Bankleitzahl - liefert zu einer Bankleitzahl den Namen der Bank. Dabei wird die
Bankleitzahl auf Gültigkeit überprüft.
� prephoneNumberCheck/prephoneNumberCheck(V1.2) Validierung Vorwahl -
überprüft eine Telefonnummer auf syntaktische Richtigkeit. Die
Gültigkeit der Vorwahl und ihre Netzzugehörigkeit (Mobil/Festnetz)
werden zurückgegeben.
� firstNameCheck/firstNameCheck(V1.2) Validierung Anrede - prüft einen
übergebenen Vornamen auf Vorhandensein in der Vornamensdatenbank der Bonk
Consulting. Zusätzlich wird das Geschlecht ermittelt und die Anrede (Herr/Frau)
zurückgeliefert.
� emailAddressCheck/emailAddressCheck(V1.2) Validierung Emailadresse - prüft
die Email-Adresse auf korrekte Syntax und auf ihre Zugehörigkeit zu einer gültigen
Topleveldomain.
Seite 38 von 126

4.2.1.5.1 Funktion postCode
Zur Benutzung der Funktion postCode geben Sie bitte in deren Eingabebereich eine
vollständige bzw. Teile einer Postleitzahl ein. Nachdem Sie „Überprüfen“ betätigt haben,
bietet Ihnen die Drop down - Box im Bereich „Ausgabe“ alle zugehörigen Orte zu einer
eindeutigen Postleitzahl an. Im Falle einer unvollständigen Eingabe werden die
wahrscheinlichsten Postleitzahlen sowie die zugehörigen Orte zur Selektierung angezeigt.
Abbildung 15: ORWELL InputAssistant – Funktion postCode
In beiden Fällen werden die zur Auswahl stehenden Daten durch einen Mausklick auf den
gewünschten Datensatz in das Formular übernommen.
Seite 39 von 126

4.2.1.5.2 Funktion city
Zur Verwendung der Funktionalität city betätigen Sie bitte den entsprechenden Reiter. Nach
Eingabe eines exakt geschriebenen Ortes bzw. bei abweichender oder unvollständiger
Eingabe werden in der Drop down - Box im Bereich „Ausgabe“ die dem Eingabewert
ähnlichsten Orte und Postleitzahlen angezeigt.
Abbildung 16: ORWELL InputAssistant – Funktion city
Die Übernahme der Daten in das Formular erfolgt wiederum durch die Auswahl des
gesuchten Datensatzes per Mausklick.
Seite 40 von 126

4.2.1.5.3 Funktion street
Wechseln Sie für die Benutzung der Funktionalität „street“ auf den zugehörigen Reiter. Geben
Sie eine korrekte Kombination aus einer Postleitzahl und einem Ort ein. Nachdem Sie
mindestens den Anfangsbuchstaben einer Straße eingegeben und „Überprüfen“ betätigt
haben, werden entsprechende, tatsächlich existierende Straßen die zu dieser Postleitzahl-Ort-
Kombination passen ausgegeben.
Abbildung 17: ORWELL InputAssistant – Funktion street
Die Eingabe weiterer Buchstaben hat eine Einschränkung des Suchergebnisses zur Folge. Der
gesuchte Datensatz kann wieder mit einem Mausklick auf den Entsprechenden in das
Formular übernommen werden.
Seite 41 von 126

4.2.1.5.4 Funktion bankCode
Die Funktionalität bankCode des Dienstes ORWELL InputAssistant überprüft eine
Bankleitzahl auf deren Existenz und gibt in diesem Fall den Namen der Bank zurück. Wechsel
Sie auf den Reiter „bankCode“ und geben Sie die zu prüfende Bankleitzahl ein.
Abbildung 18 ORWELL InputAssistant – Funktion bankcode
Das Feld „Status“ informiert Sie darüber ob die Bankleitzahl existiert oder nicht und zeigt im
positiven Fall den Name der zugehörigen Bank im Ausgabefeld an.
Seite 42 von 126

4.2.1.5.5 Funktion prephone
Mit der Funktion prephone können Sie Vorwahlen des deutschen Festnetzes sowie des
deutschen Mobilfunknetzes auf deren Existenz überprüft werden. Geben Sie auf dem Reiter
„prephone“ zu überprüfende Vorwahl ein.
Abbildung 19 ORWELL InputAssistant – Funktion prephone
Das Feld „Status“ gibt Ihnen verschiedene Auskünfte über die Vorwahl, z.B. ob es sich um
eine Festnetz- oder Mobilfunkvorwahl handelt.
Seite 43 von 126

4.2.1.5.6 Funktion firstName
Hinter der Funktionalität firstName verbirgt sich eine Datei, die einen Großteil der geläufigen
Vornamen enthält, die im deutschsprachigen Raum verwendet werden. Anhand dieser kann
ermittelt werden, ob der Vorname männlichen- oder weiblichen Geschlechts ist.
Unterstützen kann diese Funktionalität bei der automatischen Ergänzung des Feldes
Herr/Frau auf elektronischen Eingabeformularen.
Bitte geben Sie einen Vornamen in das Eingabefeld ein und betätigen Sie „Überprüfen“.
Abbildung 20 ORWELL InputAssistant –Funktion firstName
Das Statusfeld informiert Sie, ob der gesuchte Vorname gefunden wurde und welchen
Geschlechts dieser ist.
Seite 44 von 126

4.2.1.5.7 Funktion email
Eine email – Adresse wird auf die syntaktische Korrektheit und auf die Existenz der Top –
Level – Domäne überprüft. Geben Sie dazu die zu verifizierende Adresse in das vorgesehene
Eingabefeld ein und drücken Sie „Überprüfen“.
Abbildung 21: ORWELL InputAssistant – Funktion email
Informationen, ob die email – Adresse korrekt ist bzw. welche Bestandteile nicht den
syntaktischen Vorschriften genügen, erhalten Sie im Statusfeld.
Seite 45 von 126

4.2.1.6 ORWELL BankSearchV1_0
Der ORWELL BankSearchV1_0 sucht und identifiziert Bankdatensätze in der Datenbank der
Deutschen Bundesbank. Die Suche erfolgt dabei fehlertolerant über Ähnlichkeitsanalyse. Die
Ähnlichkeitsanalyse ist über parameterabhängige Schwellwerte individuell anpassbar.
Folgende Parameter werden für die Suche berücksichtigt:
� Bankleitzahl
� Bankname
� Ort
� Postleitzahl
� BIC (Bank Identifier Code)
� IBAN (International Bank Account Number)
Als Suchverknüpfung für die einzelnen Parameter kann UND bzw. ODER gewählt werden.
Weiterhin kann die Sortierung der Rückgabe parameterabhängig konfiguriert werden.
Die Ähnlichkeit eines Datensatzes wird als ein prozentualer Ähnlichkeitswert für jeden
zurückgelieferten Datensatz berechnet und kann für weitere Betrachtungen verwendet
werden.
Seite 46 von 126

4.2.1.6.1 Funktion bankSearchMultiFieldInput
Mit dieser Funktion wird eine Bankverbindung über die Parameter (Bankleitzahl, Bankname,
Postleizahl, Ort, BIC und IBAN) gesucht. Anhand des Fuzzywerts ist anschließend eine
Korrektur der Bankverbindung möglich.
Abbildung 22: ORWELL BankSearchV1_0 – Funktion bankSearchMultiFieldInput
Seite 47 von 126

4.2.1.6.2 bankSearchMultiFieldInput
Mit dieser Funktion wird eine Bankverbindung über eine Zeichenkette gesucht, die
Formatierung und Inhalt der Zeichenkette ist dabei unerheblich, da die Parameter
(Bankleitzahl, Bankname, Postleizahl, Ort, BIC und IBAN) über Ähnlichkeitsanalyse
identifiziert werden. Anhand des Fuzzywerts ist anschließend eine Korrektur bzw.
Formatierung der Bankverbindung möglich.
Abbildung 23: ORWELL BankSearchV1_0 – Funktion bankSearchSingleFieldInput
Seite 48 von 126

4.2.1.7 ORWELL ProviderBedirectServer
Der ORWELL ProviderBedirectServer liefert Ihnen umfangreiche Informationen zu
wirtschaftsaktiven und bonitätsgeprüften deutschen Businessadressen. Diese Dienstleistung
bietet die Funktionalitäten search und information an. Über die Funktion search kann eine
Firma anhand ihrer Adresse in der Bedirect-Datenbank identifiziert werden. Dazu bekommt
man die sogenannte BIPID als eindeutigen Referenzschlüssel geliefert. Anhand der BIPID
können dann über die Funktion information aktuelle Stammdaten, Unternehmensdaten und
Entscheiderdaten geliefert werden.
Um diesen Dienst verwenden zu können, wählen Sie ihn über das Dropdown - Feld „Dienste“
aus.
Seite 49 von 126

4.2.1.7.1 Funktion search
Geben Sie nun die Daten der zu prüfenden Firma im Bereich „Eingabe“ auf dem Reiter
„Search“ ein und betätigen Sie den Button „Überprüfen“.
Abbildung 24: OrwellProviderBedirectServer – Funktion search
Im Bereich „Ausgabe“ werden Ihnen die Basisdaten des angefragten Unternehmens angezeigt.
Für detaillierte Informationen über diese Firma benötigen Sie deren BIP ID. Kopieren Sie
diese zunächst. Wechseln Sie nun auf den Reiter „Information“.
Seite 50 von 126

4.2.1.7.2 Funktion information
Fügen Sie in das Feld „BIP ID“ die zuvor kopierte Nummer ein. Anschließend müssen Sie noch
den Anfragetyp im Feld „Typ“ definieren. Hier stehen drei Möglichkeiten zur Auswahl:
1. Stammdaten = 1
2. Unternehmensdaten = 2
3. Entscheiderdaten = 3
Geben Sie 1, 2 oder 3 für den gewünschten Anfragetyp ein. Nach Betätigung des Buttons
„Überprüfen“ erhalten Sie die angefragten Informationen im Bereich „Ausgabe“.
Abbildung 25: ORWELL ProviderBedirectServer –Funktion information
Konkretere Informationen über den Dienst ORWELL ProviderBedirectServer sowie zu der
Bedeutung der Ausgabefelder erhalten Sie in dem zugehörigen Webservice-Handbuch.
Seite 51 von 126

4.2.1.8 ORWELL ProviderAdressResearch
Der Dienst ORWELL ProviderAdressResearch unseres Partners Adress Research GmbH
recherchiert gerichtsfähige Adressen für die Bereiche Business und Consumer.
Die Benutzung beider Funktionen erfolgt äquivalent nach folgendem Ablauf:
1. Ihr Aktenzeichen + Name der Firma/Person + Adresse schicken Sie über den
Dienst ORWELLProviderAdressResearch an die Datenbank der Adress Research
GmbH.
a. Daraus ergibt sich der Status: Anfrage erfolgt.
2. Die Adress Research GmbH prüft die gesendeten Daten nach den üblichen
Verfahren und korrigiert diese bei Bedarf. Diese Überprüfung kann je nach
Aufwand, der notwendig ist um die gesuchte Firma/Person ausfindig zu machen,
bis zu einem Monat Zeit in Anspruch nehmen.
3. Anhand Ihres Aktenzeichens bzw. Ihrer Referenznummer können Sie die
Ergebnisse der Recherche abfragen.
Wählen Sie für die Recherche nach einer Businessadresse den Dienst
„OrwellProviderAdressResearch“ über das Drop down - Feld „Dienste“ aus und danach den
Reiter „AdressResearchBusiness“.
Geben Sie Ihr Aktenzeichen und die Ihnen bekannten Daten im Bereich „Eingabe“ ein und
betätigen Sie den Button „Überprüfen“. Ihre Anfrage wurde dadurch an die Adress Research
GmbH übermittelt und befindet sich, wie im Feld „Status“ angezeigt, im Zustand „Anfrage
erfolgt“.
Seite 52 von 126

4.2.1.8.1 Funktion adressResearchConsumer
Abbildung 26: ORWELL ProviderAdressResearch – Funktion adressResearchBusiness –Anfrage
Zur beispielhaften Vorführung des Dienstes leeren Sie nun das Formular über den Button
„Zurücksetzen“. Geben Sie das Aktenzeichen ein unter welchem Sie die angefragten Daten
bei der Adress Research GmbH hinterlegt haben und betätigen Sie erneut den Button
„Überprüfen“.
In der Praxis sollten Sie der Adress Research GmbH ein paar Tage Zeit zur
Bearbeitung Ihrer Anfrage geben.
Seite 53 von 126

4.2.1.8.2 Funktion adressResearchBusiness
Abbildung 27 ORWELL ProviderAdressResearch – Funktion adressResearchBusiness – Resultat
Mit der vorhergehenden Aktion haben Sie die Rechercheergebnisse zu diesem Aktenzeichen
abgefragt. Als Ergebnis erhalten Sie, in diesem Beispiel, eine korrigierte Adresse zu der von
Ihnen gesuchten Firma. Der Status „A3000 Anfrage bearbeitet“ besagt, dass die Adress
Research GmbH Ihr Aktenzeichen bearbeitet hat. Dabei konnten im Idealfall aktuelle Daten
recherchiert werden.
Die Funktion AdressResearchConsumer des Dienstes ORWELL ProviderAdressResearch lässt
sich ähnlich wie AdressResearchBusiness bedienen. Wechseln Sie dazu auf den Reiter
„AdressResearchConsumer“ und verfahren Sie entsprechend.
Bitte achten Sie darauf, dass hier anstelle firmentypischer Felder personenbezogene
erscheinen.
Seite 54 von 126

Abbildung 28: ORWELL ProviderAdressResearch – Funktion adressResearchConsumer – Anfrage
Seite 55 von 126

Abbildung 29: ORWELL ProviderAdressResearch – Funktion adressResearchConsumer –Resultat
Seite 56 von 126

4.2.1.9 ORWELL ProviderInfoscoreOnline
4.2.1.9.1 Funktion creditCheck
Mit dem Dienst ORWELL ProviderInfoscoreOnline können Sie verschiedene Arten von
Bonitätsprüfungen durchführen und eine Risikoabschätzung über das Zahlungsverhalten Ihrer
Kunden vornehmen. Das führt zu einem reibungsfreieren Ablauf der kundenbezogenen
Geschäftsprozesse in Ihrem Unternehmen und zu einer verminderten Kapitalbindung durch
ausstehende Rechnungen, da präventiv Zahlungsausfälle hervorgerufen durch
Zahlungsunfähigkeit oder schlechte Zahlungsmoral eines Kunden verhindert werden. Die
Prüfung steht sowohl für Geschäftskunden- als auch für Privatkundenadressen zur Verfügung.
Zur Überprüfung eines Kunden geben Sie zunächst den Abfragegrund ein. Hier stehen
verschiedene Abfragegründe zur Auswahl, die Sie bitte dem Webservice Handbuch dieser
Dienstleistung entnehmen.
Die hier gezeigte Bonitätsprüfung mit dem Kürzel „ABK“ wird beispielsweise vor dem
Abschluss eines Kaufvertrages durchgeführt.
Ergänzen Sie anschließend im Bereich „Eingabe“ alle Ihnen bekannten Informationen zu der
Person nach der Sie recherchieren möchten. Betätigen Sie den Button „Überprüfen“.
Abbildung 30: ORWELL ProviderInfoscoreOnline – Funktion creditCheck - Anfrage
Seite 57 von 126

Im Bereich „Ausgabe“ erhalten Sie die Ergebnisse Ihrer Anfrage. Möglicherweise hat Ihre
Anfrage zu einem Mehrfachtreffer geführt. Einen Mehrfachtreffer erkennen Sie, wenn sich in
dem Dropdown – Feld „Trefferliste“ mehr als genau ein Eintrag befindet. Dieser Fall kann
dann auftreten wenn, wie z.B. hier, mehrere Personen ähnliche Merkmale aufweisen. In
diesem Beispiel sind drei Personen mit dem Vornamen „Susanne“ an der gleichen Adresse
gemeldet. Zwei dieser drei Personen haben dabei den gleichen Nachnamen und
unterscheiden sich lediglich durch das Merkmal Geburtsdatum.
Schauen Sie die Trefferliste durch und wählen Sie die gesuchte Person aus. Neben
Bonitätsinformationen würden Sie hier auch eine korrigierte Anschrift (Umzugsadresse)
erhalten, sollte sich diese zwischenzeitlich geändert haben.
In einigen Fällen erscheint hinter dem Punkt „Merkmalliste“ eine weitere Drop down – Box.
Dies ist davon abhängig, ob der Datensatz der gesuchten Person sogenannte
Negativitätsmerkmale beinhaltet. Wenn dies der Fall ist, können diese per Mausklick
auswählen weiterführende Auskünfte zu der Person erhalten. Die Aufschlüsselung der
Negativitätsmerkmale finden Sie im Webservice-Handbuch.
Abbildung 31: ORWELL ProviderInfoscoreOnline – Funktion creditCheck - Resultat
Seite 58 von 126

4.2.1.10 ORWELL InfoscoreRPPCheck
4.2.1.10.1 Funktion infoscoreRPPCheck
Der Dienst ORWELL InfoscoreRPPCheck prüft eine Bankverbindung gegen den
Rücklastschriften-Präventions-Pool der Arvato Infoscore GmbH. Der Rücklastschriften-
Präventions-Pool beinhaltet eine Sammlung von Bankverbindungen aus verschiedenen
Geschäftsbereichen der Bertelsmann AG auf denen oft Fehlbuchungen durchgeführt werden.
Abbildung 32: ORWELL InfoscoreRPPCheck – orwellInfoscoreRPPCheck
Seite 59 von 126

4.2.1.11 ORWELL InfoscoreCreditCheck
Der Dienst ORWELLInfoscoreCreditCheck ist eine verkürzte Version des Dienstes ORWELL
ProviderInfoscoreOnline, er liefert im Gegensatz zu diesen nur den eScoreValue, die
eScoreClass und die Bonitätsmerkmale. Voradresse und Zusatzmerkmale werden nicht
geliefert.
Abbildung 33: ORWELL InfoscoreCreditCheck – orwellInfoscoreCreditCheck
Seite 60 von 126

4.2.1.12 ORWELL NonConsumerAccountCheck
4.2.1.12.1 Funktion nonConsumerAccountCheck
Der Dienst ORWELL NonConsumerAccountCheck identifiziert eine bestehende
Bankverbindung als eine Nicht-Privatkunden-Bankverbindung. Dazu zählen beispielsweise
Bankverbindungen öffentlicher Einrichtungen oder von Firmen.
Abbildung 34: ORWELL NonConsumerAccountCheck – orwellNonConsumerAccountCheck
Seite 61 von 126

4.2.1.13 ORWELL ProviderAddressFactoryDirect
Mit dem Dienst „OrwellProviderAddressFactoryDirect“ können Sie zwei Funktionen nutzen:
„PremiumNameCheck“ und „MoveProfessional“.
4.2.1.13.1 Funktion PremiumNameCheck
Der „PremiumNameCheck“ korrigiert falsch geschriebene Vor- und Nachnamen und
kennzeichnet eine unzustellbare Adresse auf Personen- und Namensebene. Die Funktion
„MoveProfessional“ liefert zu einer Person die aktuelle Umzugsadresse.
Zur Verwendung des Dienstes „OrwellProviderAddressFactoryDirect“ wählen Sie diesen
bitte im Dropdown – Feld „Dienste“ aus. Die zwei oben beschriebenen Funktionen
verbergen sich hinter den Reitern, die Sie per Mausklick auswählen können.
Füllen Sie nun im Bereich „Eingabe“ des „PremiumNameCheck“ die Datenfelder mit den
Ihnen bekannten Informationen. Betätigen Sie den Button „Überprüfen“.
Abbildung 35: ORWELL ProviderAddressFactoryDirect – Funktion premiumNameCheck
Seite 62 von 126

Die eingegebenen Daten werden nach Möglichkeit korrigiert im Bereich „Ausgabe“ angezeigt.
Detaillierte Hinweise gibt bekanntermaßen wieder das Feld „Status“. Es folgt die
Interpretation dieses Beispiels:
� A0020: Die übergebene Adresse wurde im Referenzbestand eindeutig gefunden, wich
von diesem ab und wurde entsprechend korrigiert.
� A0110: Die übergebene Strasse wurde in der postkonformen Kurzschreibweise
zurückgeliefert.
� B0030: Der Nachname der übergebenen Person konnte im Referenzbestand nicht
eindeutig gefunden werden.
� B0042: Der Vorname der übergebenen Person konnte im Referenzbestand nicht
eindeutig gefunden werden.
� B0052: Die übergebene PLZ/Ort – Kombination wurde mehrfach im
Referenzbestand gefunden. Beispiel: Ort Neustadt ohne PLZ. Wird nur in
Zusammenhang mit dem Status A0030 ausgegeben.
� B0530: Die eingegebene Person konnte einem Eintrag in der Fake – Liste zugeordnet
werden.
4.2.1.13.2 Funktion moveProfessional
Nach der Erläuterung der Funktion „PremiumNameCheck“ folgt nun die des
„MoveProfessional“. Nachdem Sie den zugehörigen Reiter mit einem Mausklick aktiviert
haben, können Sie Daten für die Person eingeben, zu der Sie die aktuelle Umzugsadresse
suchen. Nach der Betätigung des Buttons „Überprüfen“ wird Ihnen im Bereich „Ausgabe“ die
aktuelle Umzugsadresse zu der gesuchten Person geliefert. Voraussetzung dafür bildet zum
Beispiel ein Nachsendeauftrag den diese Person bei der Deutschen Post hinterlegt hat bzw.
das die Person überhaupt schon einmal umgezogen ist.
Seite 63 von 126

Abbildung 36: ORWELL ProviderAddressFactoryDirect – Funktion moveProfessional
In unseren Beispielen können aus Datenschutzgründen selbstverständlich keine
personenbezogenen Daten verwendet werden. Deshalb können die meisten Beispiele nicht
realistisch gezeigt werden. Beim „MoveProfessional“ hat das zur Folge, dass hier keine
Umzugsadresse geliefert werden konnte, weil kein Bezug zwischen der Person und der
Adresse herstellbar ist. Dies müsste aus den Statuscodes erkennbar sein:
� A0010: Die übergebene Adresse entspricht dem Referenzeintrag, oder konnte einem
Referenzeintrag eindeutig zugeordnet werden.
� C0000: Es konnte keine Umzugsadresse zu der übergebenen Adresse gefunden
werden. Es wurden mehrere Umzugsadressen zu der übergebenen Adresse
gefunden.
Interpretation: Die hier angegebene Adresse wurde als korrekt erkannt. Zu dieser Adresse
sind mehrere Umzugsadressen gemeldet. Weil die hier verwendete Beispielperson aber nicht
existiert, kann nun verständlicherweise keine Umzugsadresse geliefert werden.
Informationen zu den beiden hier erläuterten Funktionen entnehmen Sie bitte wieder dem
zugehörigen Webservice – Handbuch.
Seite 64 von 126

4.2.2 Schnittstellen
An dieser Stelle soll die Konfiguration der Schnittstellen „BasicSocketAdapter“ und
„BasisConnector“ erläutert werden.
Der BasicSocketAdapter muss in dieser Oberfläche für die ORWELL Interfaces konfiguriert
werden. Wählen Sie dazu im Drop down-Menü den Eintrag „BasicSocketAdapter“ aus.
Tragen Sie nun Ihre Zugangsdaten ein und betätigen Sie zum Speichern den Button „Setzen“.
Abbildung 37: Schnittstellen – BasicSocketAdapter
Mit der Schnittstelle „BasisConnector“ richten Sie die Verbindung zum ORWELL Provider ein.
Wählen Sie den „BasisConnector“ im Menü aus, tragen Sie die Zugangsdaten ein und
betätigen Sie den Button „Setzen“.
Seite 65 von 126

Abbildung 38: Schnittstellen – BasicConnector
Seite 66 von 126

4.2.3 Protokollierung
Die Aufgaben und Funktionsweisen des Protokollierungsmoduls wurden bereits unter dem
Punkt 2.4 Protokollierung erläutert. An dieser Stelle soll geklärt werden, wie Sie vorgehen
müssen, um das Protokollierungslevel für einen Dienstleister anzupassen.
Betätigen Sie zuerst den Button „Protokollierung“ im Navigationsmenü, um die folgende
Darstellung zu erhalten.
Abbildung 39: Protokollierung
Standardmäßig ist der Protokollierungslevel (LogLevel) für alle Dienstleister auf den Wert
„Info“ gesetzt. Sie haben nun die Möglichkeit, den LogLevel für jeden Dienstleister separat
einzustellen.
Bitte prüfen Sie, welchen Protokollierungslevel Sie für den jeweiligen Dienstleister
für notwendig erachten. Je höher Sie den LogLevel wählen, desto größer ist das
Datenvolumen der Protokolldateien!
Wählen Sie zur Einstellung des Protokollierungslevels aus der Dropdown - Box
„Diensteanbieter“ den Dienstleister für den Sie den LogLevel ändern möchten. Markieren Sie
anschließend im Bereich „LogLevel“ den entsprechenden Radio Button und bestätigen Sie Ihre
Änderungen durch die Betätigung des Buttons „Setzen“.
Verfahren Sie nach diesem Schema mit sämtlichen weiteren Dienstleistern.
Seite 67 von 126

4.2.4 Mandanten
Der ORWELL DMS Provider ist als mandantenfähige Software ausgelegt. Die
Mandantenfähigkeit ermöglicht es Ihnen, mehrere Kunden oder Abteilungen Ihrer Firma auf
demselben Software-System anzulegen, ohne dass diese gegenseitigen Einblick in deren
Benutzerverwaltung oder Statistiken haben. Allein der Systemadministrator
(Superadministrator) hat das Recht, alle diese Daten einzusehen.
4.2.4.1 Modellierungsmöglichkeiten
Wie bereits erwähnt wurde, ist es ausschließlich dem Systemadministrator vorbehalten neue
Mandanten anzulegen. Dieser weist dem neuen Mandanten die Dienste zu, zu deren
Verwendung er berechtigt sein wird. Während der Erstellung des neuen Mandanten wird
automatisch ein Mandantenadministrator-Account angelegt. Der Administrator des neuen
Mandanten ist später berechtigt, neue Benutzer in seinem Kontext zu erstellen und diesen
seine geerbten Dienstrechte weiter zu vererben. Außerdem kann der
Mandantenadministrator Statistiken über alle seine Benutzer oder separat für jeden einzelnen
abfragen.
Bevor Sie im Kontext des Systemadministrators mit dem Anlegen neuer Mandanten beginnen,
sollten Sie sich überlegen, wie Sie Ihre Bedürfnisse am Besten modellieren. Dazu werden im
Folgenden zwei Denkansätze konstruiert:
1. Sollte in Ihrem Unternehmen eine Trennung von verschiedenen Nutzern nicht
notwendig sein, so reicht es aus, wenn Sie sich nur einen Mandanten erstellen.
2. Möchten Sie Ihre Nutzer aus verwaltungstechnischen Gründen, z.B. nach
Abteilungen, trennen, oder um separate Statistiken erstellen zu können, sollten
Sie es vorziehen, mehrere Mandanten einzurichten.
Seite 68 von 126

4.2.4.2 Anlegen neuer Mandanten
Nachdem Sie die Zugangsdaten des Systemadministrators, wie in Abbildung 7: Anmeldung,
eingetragen und den Button „Login“ betätigt haben, gelangen Sie auf die Startseite des
ORWELL DMS Admin mit dem Navigationsmenü.
Abbildung 40: Willkommen I
Seite 69 von 126

Über den Menüpunkt „Mandanten“ gelangen Sie in die Mandantenverwaltung.
Abbildung 41: Mandantenverwaltung I
Seite 70 von 126

Nach der Betätigung des Buttons „Anlegen“ öffnet sich der Dialog zum Erstellen eines neuen
Mandanten.
Abbildung 42: Mandanten anlegen
Beispielhaft soll nun der Mandant bonkconsulting eingerichtet werden. Befüllen Sie dazu die
vorhandenen Felder nach obigem Beispiel, oder tragen Sie dort Ihre eigenen Daten ein.
� Mandantenname: Name Ihres Mandanten, den Sie später zum Einloggen
benötigen
� Mandantenbeschreibung: hier können Sie eine kurze Beschreibung Ihres
Mandanten hinterlegen
Setzen Sie in der Checkbox „Mandant aktiviert“ ein Häkchen, damit sich der neue Mandant
sofort am System anmelden kann. Wird dieses Häkchen nicht gesetzt, bleibt der Mandant
vorerst desaktiviert und kann somit keinerlei Aktionen ausführen. Die Aktivierung kann später
nachgeholt werden.
Drücken Sie nun den Button „Anlegen“, wonach Sie dem Mandanten bonkconsulting Dienste
zuweisen können. Dies geschieht durch das Setzen von Häkchen in die entsprechenden
Checkboxen.
Seite 71 von 126

Abbildung 43: Dienste zuweisen I
Bitte beachten Sie, dass dem Mandanten bonkconsulting später nur die ihm hier
zugewiesenen Dienste zur Weitervererbung an dessen User zur Verfügung stehen!
„Übernehmen“ Sie Ihre Einstellungen, um diese in die Datenbank zu speichern.
Anschließend gelangen Sie wieder auf die Seite der Mandantenverwaltung, wo nun der
Mandant bonkconsulting existiert.
Seite 72 von 126

Abbildung 44: Mandantenverwaltung II
Seite 73 von 126

4.2.4.3 Bearbeiten von Mandanten
Die Bearbeitung von Mandanten kann nur durch den Systemadministrator vorgenommen
werden.
Bitte denken Sie daran, dass Sie für diese Aktion im Kontext des Mandanten administration
angemeldet sind.
Eine Bearbeitung der Mandantendaten wird notwendig, wenn diese aktiviert, deaktiviert oder
neue Dienste zugewiesen oder bestehende entzogen werden sollen.
Betätigen Sie für eine dieser Aktionen das „Stiftsymbol“ hinter dem entsprechenden
Mandanten. Im folgenden Dialog können Sie dem Mandanten durch Setzen oder Entfernen
des Häkchens „Mandant aktiviert“ aktivieren oder desaktivieren. Die Festschreibung Ihrer
Anpassungen geschieht durch die Betätigung des Buttons „Übernehmen“.
Abbildung 45: Mandanten editieren
Die Zuweisung oder Entziehung von Diensten kann nach der Betätigung des Buttons „Dienste
zuweisen“ vorgenommen werden. Die folgende Abbildung gibt Aufschluss über die
verfügbaren und bereits aktivierten Dienste, die wieder durch ein Häkchen gekennzeichnet
sind. Die aktivierten Dienste werden dabei in der Sortierung nach oben gerückt.
Seite 74 von 126

Abbildung 46: Dienste zuweisen II
Beeinflussen Sie hier die Dienste nach Ihren Bedürfnissen durch Setzen oder Entfernen der
entsprechenden Häkchen. Ihre Änderungen werden wieder mit dem Button „Übernehmen“
bestätigt.
Seite 75 von 126

4.2.4.4 Löschen von Mandanten
Wie das Anlegen und das Bearbeiten von Mandanten, ist auch das Löschen aus
Sicherheitsgründen nur dem Systemadministrator gestattet.
Betätigen Sie zum Löschen eines Mandanten das entsprechende „Kreuzsymbol“ hinter diesem
auf der Seite der Mandantenverwaltung.
Beim Entfernen eines Mandanten werden auch die ihm zugeordneten Nutzer gelöscht, weil
der Mandant das hierarchisch übergeordnete Objekt darstellt!
Schließen Sie den Löschvorgang durch Betätigung des Buttons „Löschen“ ab.
Abbildung 47: Mandanten löschen bestätigen
Seite 76 von 126

4.2.5 Mandantenstatistiken
Im einleitenden Kapitel wurde bereits kurz erläutert, welche Möglichkeiten Ihnen die
statistische Auswertungsfunktion bietet. Diese Informationen sollen im Folgenden wiederholt
und weiter vertieft werden.
Sind Sie im Kontext des Systemadministrators administration mit dem ORWELL DMS Admin
verbunden, haben Sie die Möglichkeit, sich Statistiken über Ihre Mandanten erstellen zu lassen.
Die Statistiken geben Ihnen Auskünfte über die Anzahl getätigter Transaktionen innerhalb des
von Ihnen selektierten Berichtszeitraumes. Sie können dabei entscheiden ob Sie die Anzahl an
Transaktion über alle Mandanten anzeigen möchten oder für jeden Einzelnen separat.
In jedem Fall sind die Statistiken so aufgebaut, dass Sie einerseits eine Gesamtübersicht,
aufgeschlüsselt nach Dienstleistern sowie den zugehörigen Diensten, andererseits eine
detaillierte Übersicht, die um Status Codes erweitert ist, präsentiert bekommen.
Interessant sind diese Statistiken vor allem für das Führungspersonal, das Rechnungswesen
oder für Statistiker. Auf eine einfache und übersichtliche Art und Weise können Transaktionen
der Mandanten nachvollzogen und abgerechnet werden.
Seite 77 von 126

4.2.5.1 Mandantenstatistiken erstellen
Sie erreichen das Statistikwerkzeug über den Link „Statistik“ im Navigationsmenü.
Abbildung 48: Statistik aller Mandanten
Standardmäßig sind beim Betreten der Statistikseite der aktuelle Monat als
Berichtszeitraum sowie „Alle Mandanten“ vorselektiert.
Seite 78 von 126

Über die „Kalender“-Symbole können Sie jetzt ein „Anfangs-„ und ein „Enddatum“ festlegen.
Die Zeitspanne zwischen diesen beiden Daten entspricht dem Berichtszeitraum, für den Sie
Ihre individuelle Statistik anfertigen möchten. Wählen Sie anschließend in der Dropdown-Box
„Mandant wählen“ einen Mandanten aus. Betätigen Sie zur Aktualisierung der Statistik den
Button „Aktualisieren“.
Abbildung 49: Statistik anpassen
Seite 79 von 126

4.2.5.2 Mandantenstatistiken drucken
Nach Bedarf können Sie die Statistiken ausdrucken. Dies kann über die Druckfunktion des
Browsers vorgenommen werden. Die besten Ergebnisse erzielen Sie, wenn Sie auf ihrem PC
einen PDF-Drucker, wie FreePDF XP, installieren. Dieser wandelt die Statistikseite in ein
Dokument des PDF-Formates um, welches Sie anschließend in ihrem elektronischen
Dokumentenarchiv speichern und ausdrucken können.
Seite 80 von 126

4.2.6 Konto
Unter dem Menüpunkt „Konto“ können Sie das Passwort des Systemadministrators ändern.
Abbildung 50: Konto
Geben Sie dazu in die Textbox „Passwort“ das neue Kennwort ein und wiederholen Sie dieses
in der Textbox „Passwort bestätigen“. Der Button „Übernehmen“ speichert Ihre
vorgenommenen Einstellungen in die Datenbank.
4.2.7 Abmelden
Die Abmeldung vom ORWELL DMS Admin erfolgt über den Button „Abmelden“ im
Navigationsmenü.
Seite 81 von 126

4.3 Mandantenadministrator
Während Sie im Kontext des Systemadministrators administration einen oder mehrere
Mandanten erstellt haben, wurde für jeden dieser Mandanten automatisch ein
Mandantenadministrator, Benutzer: admin, kreiert. Dieser Account befähigt Sie nun, sich als
Administrator bei ihrem Mandanten anzumelden. Tragen Sie dazu bitte folgende
Zugangsdaten auf der Anmeldeseite des ORWELL DMS Admin Provider ein:
� Mandant: bonkconsulting (oder alternativ Ihr Mandant)
� Benutzer: admin
� Passwort: (das von Ihnen vergebene Passwort)
Abbildung 51: Anmeldung Mandantenadministrator
Der Mandantenadministrator ist berechtigt, neue Benutzer anzulegen. Diesem darf er die
Rechte auf Dienste weitervererben, die er vom Systemadministrator zugeteilt bekommen hat.
Weiterhin hat der Mandantenadministrator das Recht, Statistiken über seine Nutzer
anzufertigen und einzusehen.
Die Verwendung sämtlicher administrativer Möglichkeiten des Mandantenadministrators wird
im Kapitel 4.2.4.1 Modellierungsmöglichkeiten beschrieben.
Seite 82 von 126

4.3.1 Dienste
Bitte lesen Sie dazu den Abschnitt 4.2.1.
4.3.2 Nutzer
Ein Benutzer ist ein Mitarbeiter Ihres Unternehmens, der das Recht hat, Dienste zu benutzen,
die ihm vom Mandantenadministrator vererbt wurden.
4.3.2.1 Anlegen neuer Nutzer
Nachdem Sie die Zugangsdaten des Mandantenadministrators eingetragen und sich über den
Button „Login“ mit dem ORWELL DMS Admin verbunden haben, gelangen Sie auf die
Startseite mit dem Navigationsmenü.
Abbildung 52: Willkommen II
Seite 83 von 126

Der Menüpunkt „Nutzer“ führt Sie auf die Seite zur Verwaltung Ihrer Nutzer.
Abbildung 53: Nutzerverwaltung I
Sie sind nun als Administrator Ihres Mandanten angemeldet.
Über den Button „Anlegen“ gelangen Sie zu dem Dialog, der Ihnen das Erstellen eines neuen
Nutzers ermöglicht.
Seite 84 von 126

Abbildung 54: Nutzer anlegen
Um unser Beispiel fortzuführen, soll an dieser Stelle der Benutzer mustermannm eingerichtet
werden. Befüllen Sie dazu wieder die vorgegebenen Felder nach der Vorgabe der Abbildung
43. Selbstverständlich können Sie dort auch gleich einen realen Mitarbeiter anlegen.
� Benutzername: Name Ihres Mitarbeiters, mit dem sich dieser später einloggen kann
� Beschreibung: Hier können Sie eine kurze Beschreibung Ihres Mitarbeiters hinterlegen,
z.B. die entsprechende Abteilung, Position, o. ä.
� Passwort: Das Passwort muss mindestens aus zwei Groß- und zwei Kleinbuchstaben,
zwei Zahlen sowie zwei druckbaren Sonderzeichen bestehen.
Setzen Sie in der Checkbox „Status“ ein Häkchen damit sich der neue Nutzer sofort am
System anmelden kann. Wird dieses Häkchen nicht gesetzt, bleibt der Nutzer vorerst
deaktiviert und kann somit keinerlei Aktionen ausführen. Die Aktivierung kann später
nachgeholt werden.
Drücken Sie nun den Button „Übernehmen“, wonach Sie dem Nutzer mustermannm Dienste
zuweisen können. Dies geschieht wie immer durch das Setzen von Häkchen in die
entsprechenden Checkboxen.
Seite 85 von 126

Abbildung 55: Dienste zuweisen III
In der Liste werden nur diejenigen Dienste zur Auswahl angeboten, die der
Mandantenadministrator vom Systemadministrator zugeteilt bekommen hat.
Bestätigen Sie auch an dieser Stelle Ihre Eingaben mit dem Button „Übernehmen“.
Seite 86 von 126

Anschließend gelangen Sie wieder auf die Seite der Nutzerverwaltung. Dort sollte nun Ihr neu
erstellter Nutzer mit aufgelistet sein. Um einen weiteren Nutzer anzulegen, verfahren Sie
bitte nach gleichem Schema.
Abbildung 56: Nutzerverwaltung II
Seite 87 von 126

4.3.2.2 Bearbeiten von Nutzern
Die Bearbeitung von Nutzern kann nur durch den Mandantenadministrator vorgenommen
werden.
Bitte denken Sie daran, sich für diese Aktion im Kontext des
Mandantenadministrators admin anzumelden.
Eine Bearbeitung der Nutzerdaten wird notwendig, wenn dieser aktiviert oder desaktiviert
werden soll. Außerdem können Sie hier das Passwort des Benutzers ändern oder ihm neue
Dienste zuweisen oder bestehende entziehen. Betätigen Sie für eine dieser Aktionen das
„Stiftsymbol“ hinter dem entsprechenden Nutzer auf der Seite der Nutzerverwaltung
(Abbildung 56).
Im folgenden Dialog können Sie den Nutzer durch Setzen oder Entfernen des Häkchens
„Nutzer aktivieren“ aktivieren oder deaktivieren.
Abbildung 57: Nutzer editieren
Die Festschreibung Ihrer Anpassungen geschieht durch Betätigung des Buttons
„Übernehmen“.
Eine Zuweisung oder Entziehung von Diensten kann nach der Betätigung des Buttons
„Dienste zuweisen“ vorgenommen werden. Die folgende Abbildung gibt Aufschluss über die
verfügbaren und bereits aktivierten Dienste, die wieder durch ein Häkchen gekennzeichnet
sind.
Seite 88 von 126

Abbildung 58: Dienste zuweisen IV
Nehmen Sie nun die Anpassungen nach den Bedürfnissen des ausgewählten Nutzers vor und
bestätigen Sie Ihre Änderungen mit dem Button „Übernehmen“. Sie befinden sich
anschließend wieder auf der Seite der Nutzerverwaltung.
Seite 89 von 126

4.3.2.3 Löschen von Nutzern
Wie das Anlegen und das Bearbeiten von Nutzern, ist auch das Löschen aus
Sicherheitsgründen nur dem Mandantenadministrator gestattet.
Betätigen Sie zum Löschen das entsprechende „Kreuzsymbol“ hinter dem zu entfernenden
Mandanten auf der Seite der Nutzerverwaltung.
Abbildung 59: Nutzer Löschen Bestätigen
Schließen Sie den Löschvorgang durch Betätigung des Buttons „Löschen“ ab. Somit wurde der
Nutzer mustermannm aus der Datenbank entfernt und erscheint auch nicht mehr in der Liste
der Nutzerverwaltung.
Seite 90 von 126

4.3.3 Nutzerstatistiken
Momentan sind Sie als Mandantenadministrators mit dem ORWELL DMS Admin verbunden.
In diesem Kontext haben Sie die Möglichkeit, sich Statistiken über Ihre Nutzer erstellen zu
lassen. Die Statistiken geben Ihnen Auskünfte über die Anzahl getätigter Transaktionen
innerhalb des von Ihnen selektierten Berichtszeitraumes. Sie können dabei entscheiden, ob Sie
die Anzahl an Transaktion über alle Nutzer anzeigen möchten oder für jeden separat.
In jedem Fall sind die Statistiken so aufgebaut, dass Sie einerseits eine Gesamtübersicht,
aufgeschlüsselt nach Dienstleistern sowie den zugehörigen Diensten, andererseits eine
detaillierte Übersicht, die um Status Codes erweitert ist, präsentiert bekommen.
Interessant sind diese Statistiken vor allem für das Führungspersonal, das Rechnungswesen
oder Statistiker. Auf eine einfache und übersichtliche Weise können Transaktionen der
Mandanten nachvollzogen und abgerechnet werden.
Seite 91 von 126

4.3.3.1 Nutzerstatistiken erstellen
Die statistische Auswertungsfunktion erreichen Sie über den Button „Statistik“ im
Navigationsmenü.
Abbildung 60: Statistik aller Nutzer
Standardmäßig sind beim Betreten der Statistikseite der aktuelle Monat als
Berichtszeitraum sowie Alle Benutzer vorselektiert.
Seite 92 von 126

Über die Kalender-Symbole können Sie jetzt ein „Anfangs“- und ein „Enddatum“. Die
Zeitspanne zwischen diesen beiden Daten entspricht dem Berichtszeitraum, für den Sie Ihre
individuelle Statistik anfertigen möchten. Wählen Sie anschließend in der Drop down-Box
„Benutzer auswählen“ einen Benutzer aus. Betätigen Sie zur Aktualisierung der Statistik den
Button „Aktualisieren“.
Abbildung 61: Statistik anpassen
Seite 93 von 126

4.3.3.2 Nutzerstatistiken drucken
Nach Bedarf können Sie die Statistiken ausdrucken. Dies kann über die Druckfunktion des
Browsers vorgenommen werden. Die besten Ergebnisse erzielen Sie, wenn Sie auf ihrem PC
einen PDF-Drucker, wie FreePDF XP installieren. Dieser wandelt die Statistikseite in ein
Dokument des PDF-Formates um, welches Sie anschließend in Ihrem elektronischen
Dokumentenarchiv speichern und ausdrucken können.
Seite 94 von 126

4.3.4 Konto
Der Administrator eines Mandanten (Mandantenadministrator) admin hat die Möglichkeit, sein
Standardpasswort zu ändern. Dies geschieht über den Menüpunkt „Konto“.
Halten Sie sich bitte auch hier wieder an die üblichen Passwortkonventionen.
Abbildung 62: Konto
Seite 95 von 126

4.3.5 Abmelden
Die Abmeldung vom ORWELL DMS Admin erfolgt über den Button „Abmelden“ im
Navigationsmenü.
Seite 96 von 126

4.4 Nutzer
Nutzer haben die Möglichkeit sich am ORWELL DMS Admin anzumelden, um ihr Passwort zu
ändern oder die Dienste anzuzeigen, zu deren Benutzung sie berechtigt sind.
Zur Anmeldung tragen Sie bitte Ihre Zugangsdaten auf der Anmeldeseite des ORWELL DMS
Admin ein:
� Mandant: bonkconsulting
� Benutzer: mustermannm
� Passwort: (das von Ihnen vergebene Passwort)
Abbildung 63: Nutzer anmelden
Seite 97 von 126

4.4.1 Dienste
Lesen Sie dazu bitte im Abschnitt 4.2.1.
4.4.2 Konto
Nach der erfolgreichen Anmeldung gelangen Sie auf die bekannte „Willkommenseite“. Der
Link „Konto“ im Navigationsmenü führt Sie zu der Seite, auf der Ihr Nutzer sein Passwort
ändern kann. Das geschieht durch die Eingabe des Kennwortes in die Textbox „Passwort“
und die wiederholte Eingabe in die Textbox „Passwort bestätigen“. Der Button
„Übernehmen“ speichert Ihre Eingaben.
Abbildung 64: Konto
Seite 98 von 126

4.4.2.1 Dienste anzeigen
Damit ein Nutzer nachvollziehen kann, welche Dienste er nutzen darf, klickt er auf den
Button „Dienste anzeigen“. Anschließend öffnet sich eine Ansicht, die alle verfügbaren Dienste
auflistet.
4.4.3 Abmelden
Abbildung 65: Dienste anzeigen
Die Abmeldung vom ORWELL DMS Admin erfolgt über den Button „Abmelden“ im
Navigationsmenü.
Seite 99 von 126

5 Datenformate
Für die Kommunikation zwischen DMS Customer und DMS Provider werden folgende
dienstanbieterspezifischen Datenformate verwendet.
5.1 OrwellAccountCheck
5.1.1 Funktion accountCheck
Name I/
O
Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehörendes Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
banknameshort O String Kurzbezeichnung des Kreditinstituts ohne Rechtsform
accountnumber I/O String Kontonummer
bankcode I/O String Bankleitzahl
bankcodeowner O String Bankleitzahlen-Besitz-Merkmal
bankcodedelete O String Bankleitzahl zur Löschung vorgesehen
bankcodenew O String Nachfolgebankleitzahl bei Löschung
postcode O String Postleitzahl der Bank
city O String Standort der Bank
pan O String PAN
bic O String BIC
methode O String Nummer der Prüfmethode
datasetid O String ID des gelieferten Datensatzes
datasetchangecode O String Änderungskennzeichen
status O String codierter Abgleichstatus
Tabelle 4: Datenformat ORWELL AccountCheck – Funktion accountCheck
Seite 100 von 126

5.1.2 Funktion creditCardCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
creditcardnumber I/O String Kreditkartennummer
creditcardtype I/O String Kreditkartentyp
status O String codierter Abgleichstatus
Tabelle 5: Datenformat ORWELL AccountCheck- Funktion creditCardCheck
Seite 101 von 126

5.2 OrwellAddressCheck
5.2.1 Funktion addressCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
firstname I/O String Vorname
lastname I/O String Nachname
postcode I/O String Postleitzahl
city I/O String Stadt
district I/O String Stadtteil
street I/O String Straße
housenumber I/O String Hausnummer
pobnumber I/O String Postfachnummer
federalstate O String Bundesland
cargocode O String Frachtleitcode
alort O String Eindeutige Ortskennzeichnung im Data Factory Streetcode
der Deutschen Post Direkt GmbH.
streetkey O String Eindeutige Straßenkennzeichnung im Data Factory
Streetcode der Deutschen Post Direkt GmbH
cityold O String veralteter Ortsname
streetold O String veralteter Straßenname
status O String codierter Abgleichstatus
Tabelle 6: Datenformat ORWELL AddressCheck – Funktion addressCheck
Seite 102 von 126

5.3 OrwellAddressCheckV3_1
5.3.1 Funktion addressCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
firstName I/O String Vorname
lastName I/O String Nachname
postCode I/O String Postleitzahl
city I/O String Stadt
district I/O String Stadtteil
street I/O String Straße
houseNumber I/O String Hausnummer
pobNumber I/O String Postfachnummer
postCodeSim I String Ähnlichkeitsschwellwert - Postleitzahl
citySim I String Ähnlichkeitsschwellwert - Ort
streetSim I String Ähnlichkeitsschwellwert - Straße
addressCorrigible I String Schwellwert für Adresse korrigierbar.
addressMultiHit I String Schwellwert für Adresse mehrdeutig.
maxHits I String Maximal zurückgelieferte Trefferanzahl.
search I String Suchmethode
sort I String Sortiermethode
encoding I String Zeichensatzcodierung
federalState O String Bundesland
cargoCode O String Frachtleitcode
alort O String Eindeutige Ortskennzeichnung im Data Factory Streetcode
der Deutschen Post Direkt GmbH.
streetkey O String Eindeutige Straßenkennzeichnung im Data Factory
Streetcode der Deutschen Post Direkt GmbH
cityOld O String veralteter Ortsname
streetOld O String veralteter Straßenname
fuzzyValue O String Ähnlichkeitswert
type O String Adresstyp
status O String codierter Abgleichstatus
Tabelle 7: Datenformat ORWELL AddressCheckV3_1 – Funktion addressCheck
Seite 103 von 126

5.4 OrwellInputAssistant
5.4.1 Funktion postcodeToCity
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
postcode I/O String Postleitzahl
city O String Stadt, Ort
status O String codierter Abgleichstatus
Tabelle 8: Datenformat ORWELL InputAssistant – Funktion postcodeToCity
5.4.2 Funktion cityToPostcode
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
postcode I/O String Postleitzahl
city O String Stadt, Ort
status O String codierter Abgleichstatus
Tabelle 9: Datenformat ORWELL InputAssistant - Funktion cityToPostcode
Seite 104 von 126

5.4.3 Funktion street
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
postcode I String Postleitzahl
city I String Stadt, Ort
street I/O String Straße
status O String codierter Abgleichstatus
Tabelle 10: Datenformat ORWELL InputAssistant - Funktion street
5.4.4 Funktion bankcodeToBankname
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
bankcode I/O String Postleitzahl
bankname I/O String Stadt, Ort
status O String codierter Abgleichstatus
Tabelle 11: Datenformat ORWELL InputAssistant - Funktion bankcodeToBankname
Seite 105 von 126

5.4.5 Funktion prephoneCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
prephone I/O String Vorwahl
status O String codierter Abgleichstatus
Tabelle 12: Datenformat ORWELL InputAssistant - Funktion prephoneNumberCheck
5.4.6 Funktion firstNameCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
firstname I/O String Vorname
status O String codierter Abgleichstatus
Tabelle 13: Datenformat ORWELL InputAssistant - Funktion firstNameCheck
Seite 106 von 126

5.4.7 Funktion emailAddressCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
emailaddress I/O String Email-Adresse
status O String codierter Abgleichstatus
Tabelle 14: Datenformat ORWELL InputAssistant – Funktion emailAddressCheck
Seite 107 von 126

5.5 OrwellBankSearchV1_0
5.5.1 Funktion bankSearchMultiFieldInput
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
bankCode I/O String Bankleitzahl
bank I/O String Bankname
bankShort O String Bankname, Kurzbezeichnung
postCode I/O String Postleitzahl
city I/O String Ort
bic I/O String Bank Identifier Code
iban I String International Bank Account Number
pan O String Primary Account Number
bankCodeFuzzy I String Geforderte Mindestähnlichkeit für Bankleitzahl
bankFuzzy I String Geforderte Mindestähnlichkeit für Banknamen
postCodeFuzzy I String Geforderte Mindestähnlichkeit für Postleitzahl
cityFuzzy I String Geforderte Mindestähnlichkeit für Ort
bicFuzzy I String Geforderte Mindestähnlichkeit für BIC
overallFuzzy I String Geforderte Gesamtähnlichkeit
fuzzyValue O String Berechnete Ähnlichkeit des zurückgelieferten Datensatzes
maxHits I String Anzahl der maximal zurückgelieferten Treffer
search I String Suchverfahren
sort I String Sortierung der zurückgelieferten Treffer
encoding I String Derzeit ungenutzt.
status O String codierter Abgleichstatus
Abbildung 66: Datenformat ORWELL BanksearchV1_0 – Funktion bankSearchMultiFieldInput
Seite 108 von 126

5.5.2 Funktion bankSearchSingleFieldInput
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
input I String Zeichenkette mit Bankdaten
bankCode O String Bankleitzahl
bank O String Bankname
bankShort O String Bankname, Kurzbezeichnung
postCode O String Postleitzahl
city O String Ort
bic O String Bank Identifier Code
pan O String Primary Account Number
bankCodeFuzzy I String Geforderte Mindestähnlichkeit für Bankleitzahl
bankFuzzy I String Geforderte Mindestähnlichkeit für Banknamen
postCodeFuzzy I String Geforderte Mindestähnlichkeit für Postleitzahl
cityFuzzy I String Geforderte Mindestähnlichkeit für Ort
bicFuzzy I String Geforderte Mindestähnlichkeit für BIC
overallFuzzy I String Geforderte Gesamtähnlichkeit
fuzzyValue O String Berechnete Ähnlichkeit des zurückgelieferten Datensatzes
maxHits I String Anzahl der maximal zurückgelieferten Treffer
search I String Suchverfahren
sort I String Sortierung der zurückgelieferten Treffer
encoding I String Derzeit ungenutzt.
status O String codierter Abgleichstatus
Abbildung 67: Datenformat ORWELL BankSearchV1_0 - Funktion bankSearchSingleFieldInput
Seite 109 von 126

5.6 OrwellProviderAddressFactoryDirect
5.6.1 Funktion premiumNameCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-Login-
Passwort Kombination ist für eine erfolgreiche Dienstnutzung
auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
firstname I/O String Vorname
lastname I/O String Nachname
postcode I/O String Postleitzahl
city I/O String Stadt, Ort
street I/O String Straße
housenumber I/O String Hausnummer
status O String codierter Abgleichstatus
Tabelle 15: Datenformat ORWELL ProviderAddressFactoryDirect - Funktion premiumNameCheck
5.6.2 Funktion moveProfessional
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-Login-
Passwort Kombination ist für eine erfolgreiche Dienstnutzung
auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
firstname I/O String Vorname
lastname I/O String Nachname
postcode I/O String Postleitzahl
city I/O String Stadt, Ort
street I/O String Straße
housenumber I/O String Hausnummer
status O String codierter Abgleichstatus
Tabelle 16: Datenformat ORWELL ProviderAddressFactoryDirect – Funktion moveProfessional
Seite 110 von 126

5.7 OrwellProviderAddressResearchOnline
5.7.1 Funktion adressResearch
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
persontype I/O String Einordnung der Kundenadresse (0=Auto, I=Privatadresse,
O=Geschäftsadresse)
salutation I/O String Anrede, Titel (Herr, Frau, Firma)
firstname I/O String Vorname
lastname I/O String Nachname
nameaffix I/O String Namenszusatz
countrycode I/O String Länderkennzeichen
postcode I/O String Postleitzahl
city I/O String Stadt, Ort
district I/O String Stadtteil, Teilort
street I/O String Straße
housenumber I/O String Hausnummer
pobnumber I/O String Postfachnummer
status O String codierter Abgleichstatus
Tabelle 17: Datenformat ORWELL ProviderAdressResearchOnline – Funktion adressResearch
Seite 111 von 126

5.8 OrwellProviderBedirectServer
5.8.1 Funktion search
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
companyname I String Bestandteil des Firmennamens.
companyname1 O String Firmenname 1
companyname2 O String Firmenname 2
companyname3 O String Firmenname 3
postcode I/O String Postleitzahl
city I/O String Stadt, Ort
street I/O String Straße mit Hausnummer
requestid O String Bearbeitungsnummer bedirect.
bipid O String Datensatznummer bedirect
prephonenumber O String Telefonvorwahl
phonenumber O String Telefonnummer
status O String Abgleichstatus
Tabelle 18: Datenformat ORWELL ProviderBedirectServer – Funktion search
Seite 112 von 126

5.8.2 Funktion information
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese
kann sowohl übergeben als auch vom DMS Customer
generiert werden.
bipid I/O String Datensatznummer bedirect
type I String Anfragetyp bedirect
requestid O String Bearbeitungsnummer bedirect
companyname1 O String Firmenname 1
companyname2 O String Firmenname 2
companyname3 O String Firmenname 3
postcode O String Postleitzahl
city O String Stadt, Ort
street O String Straße mit Hausnummer
pobpostcode String Postfachpostleitzahl
pob String Postfachnummer
prephone O String Telefonvorwahl
phonenumber O String Telefonnummer
faxprephone String Faxvorwahl
faxnumber String Faxnummer
crf O String Crefo-Nr, Referenzschlüssel zur Creditreform-
Datenbank.
zcrf O String Crefo-Nr, der Zentrale bei Niederlassungen
bcrf O String Crefo-Nr, Besitz-Unternehmen bei Beteiligungen
deletecauseprofile O String Codierter Löschgrund
deletecausetext O String Beschreibung des Löschgrunds
conditionprofile O String codiertes Zustandsmerkmal
conditiontext O String Beschreibung des Zustandsmerkmals
homepage O String Homepage
organisationform O String codierte Rechtsform
organisationtext O String Beschreibung der Rechtsform
employeecode O String codierte Mitarbeiterstaffel
salescode O String codierte Umsatzstaffel
capitalcode O String codierte Kapitalstaffel
deletecausetime O String Letzte Änderung des Löschgrunds
contiditiontime O String Letzte Änderung des Zustandsmerkmals
companynametime O String Letzte Änderung Firmennamens
addresstime O String Letzte Änderung der Zustellanschrift
pobtime O String Letzte Änderung der Postfachanschrift
phonetime O String Letzte Änderung der Telefonnummer
Seite 113 von 126

faxtime O String Letzte Änderung der Faxnummer
employeetime O String Letzte Änderung der Mitarbeiterstaffel
capitaltime O String Letzte Änderung der Kapitalstaffel
primarybranchcode O String Primärbranchen nach WZ2003 codiert
primarybranchcode O String Beschreibung der Primärbranche
branch1 O String Branchenzuordnung 1 nach WZ2003 codiert
branchtext1 O String Beschreibung der Branche 1
branch2 O String Branchenzuordnung 2 nach WZ2003 codiert
branchtext2 O String Beschreibung der Branche 2.
branch3 O String Branchenzuordnung 3 nach WZ2003 codiert
branchtext3 O String Beschreibung der Branche 3
branch4 O String Branchenzuordnung 4 nach bedirect codiert
branchtext4 O String Beschreibung der Branche 4
bedirectbranch1 O String Branchenzuordnung 1 nach bedirect codiert
bedirectbranchtext1 O String Beschreibung der Branche 1
bedirectbranch2 O String Branchenzuordnung 2 nach bedirect codiert
bedirectbranchtext2 O String Beschreibung der Branche 2
bedirectbranch3 O String Branchenzuordnung 3 nach bedirect codiert
bedirectbranchtext3 O String Beschreibung der Branche 3
bedirectbranch4 O String Branchenzuordnung 4 nach bedirect codiert
bedirectbranchtext4 O String Beschreibung der Branche 3
decidersalutation O String Entscheider Anrede (Herr, Frau)
decidertitle O String Entscheider Graduierung (Prof.,Dr., Dr. med. etc.)
deciderfirstname O String Entscheider Vorname
deciderlastname O String Entscheider Nachname
decidernameprefix O String Entscheider Namensprefix (von, van, etc.)
decidernamesuffix O String Entscheider Namensprefix (Senior, Junior, etc)
decidertime O String Letze Änderung der Entscheiderdaten.
hkzgkzprofile1 O String hierarchisches bzw. gesellschaftsrechtliches Kennzeichen
codiert
hkzgkztext1 O String Beschreibung hierarchisches bzw. gesellschaftsrechtliches
Kennzeichen (z.B. Inhaber, Gesellschafter,
Geschäftsführer)
hkzgkzprofile2 O String hierarchisches bzw. gesellschaftsrechtliches Kennzeichen
codiert
hkzgkztext2 O String Beschreibung hierarchisches bzw. gesellschaftsrechtliches
Kennzeichen (z.B. Inhaber, Gesellschafter,
Geschäftsführer)
hkzgkzprofile3 O String hierarchisches bzw. gesellschaftsrechtliches Kennzeichen
codiert
hkzgkztext3 O String Beschreibung hierarchisches bzw. gesellschaftsrechtliches
Kennzeichen (z.B. Inhaber, Gesellschafter,
Geschäftsführer)
status O String codierter Abgleichstatus
Tabelle 19: Datenformat ORWELL ProviderBedirectServer –Funktion information
Seite 114 von 126

5.9 OrwellProviderInfoscoreOnline
5.9.1 Funktion creditCheck
Name I/O Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS
Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehöriges Passwort. Eine gültige
Mandanten-Login-Passwort Kombination ist für
eine erfolgreiche Dienstnutzung auf dem DMS
Provider erforderlich
tid I/O String Transaktions-ID zur Kennzeichnung einer
durchgeführten Transaktion über die
Kommunikationsstrecke. Diese kann sowohl
übergeben als auch vom DMS Customer generiert
werden
requestreason I String rechtlicher Anfragegrund codiert
requestdate I String Anfragedatum
staffernumber I String Sachbearbeiternummer (optionaler Parameter)
customernumber I String Kundennummer (optionaler Parameter)
salutation I/O String Anrede
firstname I/O String Vorname
lastname I/O String Nachname
dateofbirth I/O String Geburtsdatum
countrycode I/O String Länderkennzeichen
postcode I/O String Postleitzahl
city I/O String Stadt, Ort
street I/O String Straße
streetwithhousenumber I String Straße mit Hausnummer
informascoreflag O String Informa Score Wert geliefert
informascoretyp O String Informa Score Typ
informascorevalue O String Informa Score
cargocode O String Frachtleitcode
attribute O String eingetragenes Negativmerkmal codiert
attributedate O String Datum der Merkmaleintragung
attributenumber O String Aktenzeichen des Merkmals
attributeprimäryclaim O String Hauptforderung
attributecleared O String Merkmal erledigt Kennzeichen
persontype O String rechtlicher Personentyp codiert
(Privat/Geschäftlich)
requesttype O String Auskunftsart, Leistungen codiert (Informa Score,
Adressverifizierung, etc.)
requeststate O String Status der Anfrage bei Infoscore
preaddressfirstname I/O String Voradresse-Vorname
preaddresslastname I/O String Voradresse-Nachname
preaddressbirthday I/O String Voradresse-Geburtstag
Seite 115 von 126

preaddresscountrycode I/O String Voradresse-Länderkennzeichen
preaddresspostecode I/O String Voradresse-Postleitzahl
preaddresscity I/O String Voradresse-Stadt, Ort
preaddressstreet I/O String Voradresse-Straße
preaddresshousenumber I/O String Voradresse-Hausnummer
moveaddressfirstname O String Umzugsadresse-Vorname
moveaddresslastname O String Umzugsadresse-Nachname
moveaddressbirthday O String Umzugsadresse-Geburtstag
moveaddresscountrycode O String Umzugsadresse-Länderkennzeichen
moveaddresspostecode O String Umzugsadresse-Postleitzahl
moveaddresscity O String Umzugsadresse-Stadt, Ort
moveaddressstreet O String Umzugsadresse-Straße
moveaddresshousenumber O String Umzugsadresse-Hausnummer
status O String codierter Abgleichstatus
Tabelle 20: Datenformat ORWELL InfoscoreOnline –Funktion creditCheck
Seite 116 von 126

5.10 OrwellInfoscoreCreditCheck
5.10.1 Funktion orwellInfoscoreCreditCheck
Name I/
O
Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehörendes Passwort. Eine gültige
Mandanten-Login-Passwort Kombination ist für eine
erfolgreiche Dienstnutzung auf dem DMS Provider
erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer
durchgeführten Transaktion über die
Kommunikationsstrecke. Diese kann sowohl übergeben
als auch vom DMS Customer generiert werden.
customerNo I/O String Kundennummer
title I String Anrede
firstName I String Vorname
lastName I String Nachname
dateOfBirth I String Geburtsdatum
country I String Länderkennzeichen
postCode I String Postleitzahl
city I String Ort
street I String Straße
houseNumber I String Hausnummer
requestReason I String Berechtigtes Interesse (Anfragegrund-Kürzel)
requestEScore
Value
I String EScoreWert anfordern
EScoreValue O String EScoreWert
EScoreClass O String EScoreClasse
type O Feature Merkmal-Type
date O Feature Merkmal-Datum
docReference O Feature Merkmal-Aktenzeichen
principalClaim O Feature Merkmal-Hauptforderung
Completition
Date
O Feature Merkmal-Erledigungsdatum
completitionFlag O Feature Merkmal-Erledigungskennzeichen
status O String codierter Abgleichstatus
Tabelle 21: Datenformat ORWELL InfoscoreCreditCheck – Funktion orwellInfoscoreCreditCheck
Seite 117 von 126

5.11 OrwellInfoscoreRPPCheck
5.11.1 Funktion orwellInfoscoreRPPCheck
Name I/
O
Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehörendes Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
bankCode I/O String Bankleitzahl
bankAccount I/O String Kontonummer
country I String Länderkennzeichen
Request
Validation
I String Validierung der Bankverbindung einschalten.
requestBasic I String Prüfung durch RPP einschalten.
requestPlus I String Zur Zeit nicht unterstützt
EScoreValue O String ESCoreAmpelWert (Rot oder Grün)
RC O String ReturnCode
bankAccountVali
dationMessage
O String Beschreibung des Validierungsergebnisses
bankAccountVali
dationResult
O String Validierungsergebnis
bankName O String Bankname
contentCode O String Grund der Meldung
Content
Description
O String Bezeichnung des Inhalts
contentType O String Typ der Meldung
description O String Beschreibung
errorCodeName O String Fehlercode
firstNoticeDate O String Datum der ersten Meldung
lastNoticeDate O String Datum der letzten Meldung
noOfMatches O String Anzahl der RPP Treffer
rppMatch O String RPPTreffer(0 = nein, 1 = ja)
status O String codierter Abgleichstatus
Tabelle 22: Datenformat ORWELL InfoscoreRPPCheck – Funktion orwellInfoscoreRPPCheck
Seite 118 von 126

5.12 OrwellNonConsumerAccountCheck
5.12.1 Funktion
orwellInfoscoreNonConsumerAccountCheck
Name I/
O
Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehörendes Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
bankCode O String Kurzbezeichnung des Kreditinstituts ohne Rechtsform
bankAccount I/O String Kontonummer
status O String codierter Abgleichstatus
Tabelle 23: Datenformat ORWELL InfoscoreNonConsumerAccountCheck – Funktion orwellNonConsumerAccountCheck
Seite 119 von 126

5.13 OrwellInternationalAddressCheckV2_0
5.13.1 Funktion orwellInternationalAddressCheck
Name I/
O
Typ Beschreibung
mandator I String Mandantenname des DMS Customer auf DMS Provider
login I String Zum Mandanten gehöriges Login
password I String Zum Login gehörendes Passwort. Eine gültige Mandanten-
Login-Passwort Kombination ist für eine erfolgreiche
Dienstnutzung auf dem DMS Provider erforderlich.
tid I/O String Transaktions-ID zur Kennzeichnung einer durchgeführten
Transaktion über die Kommunikationsstrecke. Diese kann
sowohl übergeben als auch vom DMS Customer generiert
werden.
resultClass O int Ergebnisklasse der postalischen Prüfung
resultPoboxClass O int Ergebnisklasse der Postfachadresse.
resultSpecClass O int Ergebnisklasse der Spezialadresse.
resultCoordinate-
Class
O int Ergebnisklasse der Koordinaten.
alternativeCity O String Alternativer Ortsname.
alternativeStr O String Alternativer Straßenname.
areaCensal O String Statistische Bezirksnummer
buildingName I/O String Bezeichnung eines Gebäudes bzw. Anwesens.
buildingType O String Hausnummer-Typ:
buildingZip O String PLZ des Gebäudes
carReg O String Internationales KFZ-Kennzeichen
carrierRoute O String Zustellsammelroute
carrierSortInd O String Postbotenbezirk
cityAbbrev O String Kurzbezeichnung für Ort.
cityAdminCode O String INSEE-Code für den Hauptort
cityCode O String Ortsnummer
cityDetail O String Geographischer Zusatz.
cityDistrict I/O String Ortsteil
cityDistrictCode O String Teilortnummer.
cityNorm O String Ortsname normiert
cityRegion O String Ortsname mit Provinzkürzel
citySuffix O Ortsnamenszusatz
cityViable O String Kennzeichen Ortsgröße
community O String Gemeindename.
communityCode O String Gemeindenummer.
coordinateLevel O String Koordinatengültigkeitsebene
country I/O String 3-stellige Abkürzung des Landes
countryFull O String Land, vollständig ausgeschrieben
countryIso2 O String 2-stelliger Ländercode nach ISO 3166
county O String Name des Bezirks
Seite 120 von 126

depDistrict O String Abhängiger Ortsteil
district O String Bezirks-/Kreisname
districtCode O String Teilortsnummer.
districtPrint O String Ortsteil für Adressierung.
floorNo O String Etagen- bzw. Stockwerksnummer.
floorZip O String Etagen-PLZ. Postleitzahl des Stockwerks in floorNo
freguesi O String Name des "Freguesi".
freguesiCode O String "Freguesi"-Code.
hno I/O String Hausnummer
hnoAddition O String Hausnummernzusatz
hnoCityCode O String Ortsnummer
hnoCityDistrict O String Ortsteil des Hausnummernbereichs.
hnoMatch O String Kennzeichen Hausnummernprüfung.
hnoNorm O String Normierte Hausnummer.
hnoNum O String Numerischer Teil der Hausnummer.
hnoPos O String Position der Hausnummer relativ zur Straße:
hnoRange O String Hausnummernbereich
hnoRistanti O String
Default-Hausnummernbox. Kennung, ob Default-Hsnr-Box
vorhanden.
hnoZip O String PLZ, in dem dieser Hausnummernbereich liegt.
icAdr O String
Kennzeichen für die Angabe von Ort und Zustellort in der
Versand- Adresse. Der Zustellort muss immer angegeben
werden.
icArrd O String Kennzeichen, ob Ort in Arrondissements aufgeteilt ist.
langCode O String Kennzeichen, aus welcher Sprache der Ortsname stammt.
line1 I/O String Formatierte erste Zeile in der Ausgabeadresse.
line2 I/O String Formatierte zweite Zeile in der Ausgabeadresse.
line3 I/O String Formatierte dritte Zeile in der Ausgabeadresse.
line4 I/O String Formatierte vierte Zeile in der Ausgabeadresse.
line5 I/O String Formatierte fünfte Zeile in der Ausgabeadresse.
line6 I/O String Formatierte sechste Zeile in der Ausgabeadresse.
majorStr I/O String Übergeordnete Straße.
mvalCity O String Ähnlichkeit Ort
mvalOrganisation O String Ähnlichkeit Organisation
mvalStr O String Ähnlichkeit Straße
nielsen O String Nielsengebiet. Nielsen-Code.
organisation I/O String Firmenname/Organisationsname.
predirStr O String Präfix-Richtung der Straße, abgekürzt (z.B. E für EAST)
region O String Grafschaft, Bundesstaat, Provinz, Kanton oder Region.
regionCode O String Codenummer für Regionsbezeichnung in 'region'
resAbbrev O String Kennzeichen Ort/Straße gekürzt
resBuildName O String Kennzeichen Gebäudename
resChange O String Kenzeichen Adresse verändert
resCity O String Kennzeichen Ort verändert
resCityDistrict O String Kennzeichen Ortsteil verändert
resDepDistrict O String Kennzeichen abhängiger Ortsteil
resHno O String Kennzeichen Hausnummer
Seite 121 von 126

esOrganisation O String Kennzeichen Organisation
resPostField O String Kennzeichen Adresse codiert
resRef O String Kennzeichen Straßenumschlüsselung
resRegion O String Kennzeichen Region geändert
resSec O String Kennzeichen Sekundär-Adresse
resStr O String Kennzeichen Straße
resSubBuildName O String Kennzeichen Gebäudenamenzusatz verändert
resVariant O String Nicht relevant.
resZip O String Kennzeichen Postleitzahl.
resZipAddOn O String Kennzeichen Postleitzahlzusatz geändert
sec I/O String Hausnummernzusatz, Bezeichnung und Wert
secTypFull O String Hausnummernzusatz-Typ
state I/O String Bundesstaat. 2-stelliges Bundesstaatkürzel.
stateFull O String Bundesstaat, ausgeschrieben.
str I/O String Straße ohne Hausnummer.
strAbbrev O String Kurzschreibweise des Straßennamens.
strHno I/O String Straßenname mit Hausnummer und Zusätzen.
strKernel O String Straßenname ohne Straßentyp
strLangCode O String Sprachcodierung Straße
strNo O String Straßennummer
strPostdir O String Suffix-Richtung der Straße.
strType O String Straßentyp
strZip O String Straßenpostleitzahl
subBuildName I/O String Gebäudenamenszusatz
XCoordinate O String Geograpische Länge
YCoordinate O String Geograpische Breite
zip I/O String Postleitzahl
zipAddOn I/O String Postleitzahlzusatz
zipRange O String Postleitzahlenbereich
zipScheme O String Postleitzahlenschema
zipType O String Postleitzahlentyp
poBoxCountry I/O String Postfach Land
poBoxZip I/O String Postfach Postleitzahl.
poBoxCity I/O String Postfach Ort.
poBoxNumber I/O String Postfach Nummer.
resPoBoxZip O String Kennzeichen Postfachpostleitzahl verändert
resPoBoxCity O String Kennzeichen Postfachort verändert
resPoBoxNumber O String Kennzeichen Postfachnummer verändert
specCountry I/O String Spezialadresse Land
specZip I/O String Spezialadresse Postleitzahl
specCity I/O String Spezialadresse Ort
specIcCity O String Kennzeichen für Besonderheiten eines Ortes
resSpecZip O String Kennzeichen Spezialadresse Postleitzahl verändert
resSpecCity O String Kennzeichen Spezialadresse Ort verändert
parCase I String Parameter- Groß-/Kleinschreibweise der Ausgabe
parSpecialChars I String Parameter Behandlung von Sonderzeichen in der Ausgabe.
Seite 122 von 126

parNormOutput I
Parameter Normierung der Ausgabe und Strukturierung für
String
Frankreich.
parLanguage I String Parameter Spracheauswahl
parLenOutLine I String Parameter Länge der Ausgabezeilen.
parCityLen I String Parameter Länge des Ausgabearguments Ort
parStrLen I String Parameter Länge des Ausgabearguments Straße
parCityAbbrev I
Parameter Einsetzen der Kurzschreibweise in Argument
String
Ort.
parStrAbbrev I
Parameter Einsetzen der Kurzschreibweise in Argument
String
Straße
parAlternativeCity I String Parameter Sprache Ort
parAlternativeStr I String Parameter Sprache Straße
parZipHno I String Parameter Hausnummernbereiche anzeigen
parCheckPobox I String Parameter Postfachprüfung
parStrMval I String Parameter Mindestähnlichkeit Straße
parCheckStr I String Parameter Umfang der Straßenprüfung
parStrType I String Parameter Schreibweise des Straßentyps.
parStrMainType I String Parameter Straßentyp 'Calle'.
parRef I String Parameter Umschlüsselung Straße
parCityMval I String Parameter Mindestähnlichkeit Ort
parOutCity I String Parameter Ausgabeart Ort
parSuppresDistrict
I String Parameter Unterdrückung der Teilortausgabe
Equal
parUseCity I String Parameter Ortsanalyse
parZipFull I String Parameter Postleitzahl
parBulkPurchaser I String Parameter Großempfängerpostleitzahl
parSelListMax I String Parameter Maximale Trefferanzahl in Rückgabe
parInsuffResult I String Parameter Feineinstellung der Match-Qualität.
parUntieRange I String Parameter Auswahllisten auflösen
parHnoConfirmed I String Parameter Hausnummernprüfung
parAmbigDpv I String nicht relevant
parBusinessCheck I String nicht relevant
parBusinessFetch I String nicht relevant
parDpv I String nicht relevant
parJoker1 I String nicht relevant
parJoker2 I String nicht relevant
parJoker3 I String nicht relevant
parJoker4 I String nicht relevant
parJoker5 I String nicht relevant
parRdi I String nicht relevant
parZipSearch I String nicht relevant
Tabelle 24: Datenformat ORWELL InternationalAddressCheckV2_0 – Funktion orwellInternationalAddressCheck
Seite 123 von 126

6 Support
Unseren Support erreichen Sie unter folgender Emailadresse:
support@bonk-consulting.de
oder unter der Telefonnummer
+49 (0) 3677 / 4663-158.
Seite 124 von 126

7 Nutzungsvoraussetzungen
Vertraglich ist die Nutzung mit der Bonk-Consulting GmbH, dem Kunden sowie mit den
jeweiligen Dienstanbietern zu regeln.
Seite 125 von 126

8 Copyrights
Windows ist ein eingetragenes Warenzeichen der Microsoft Corporation.
SuSE ist ein eingetragenes Warenzeichen der Suse Linux AG.
Solaris ist ein eingetragenes Warenzeichen von Sun Microsystems, Inc.
Jboss ist ein eingetragenes Warenzeichen der Open Source Company.
Java ist ein eingetragenes Warenzeichen der Sun Microsystems, Inc.
ADDRESSFACTORY Direct ist ein eingetragenes Warenzeichen von der Deutsche Post Direkt
GmbH.
Seite 126 von 126