BiPRO Norm 440

Transcrição

BiPRO Norm 440

1
Norm 440 – Externe Navigation in VU-Portale
2
Release und Version
3
Release 1, Version 7, vom 15.04.2014
4
Status
5
Offizielle Norm
6
Editor
7
Geschäftsstelle BiPRO e.V.Autoren
8
Dirk Müller, LUTRONIK Software GmbH ([email protected])
9
Sebastian Meyer ([email protected])
10
Markus Rauch ([email protected])
11
Gregor Fell ([email protected])
12
Dr. Andreas Rohling ([email protected])
13
Gegenstand der Norm
14
Die Norm 440 definiert den automatisierten Einsprung in VU-Portale aus einem MVP.
15
Voraussetzung
16
17
18
19
20
21
22
23
24
Norm 200 Release 1 Version 2
25
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 1 von 16 -
26
Hinweis zur Veröffentlichung
27
Die anliegend überreichte Norm ist urheberrechtlich für die BiPRO geschützt. Das Dokument
28
wird Ihnen im Rahmen Ihrer Mitgliedschaft bei der BiPRO und damit als Mitglied dieses
29
geschlossenen Empfängerkreises überlassen. Dementsprechend stellt die Überlassung an
30
Sie keine Erstveröffentlichung der Norm dar. Zur Erstveröffentlichung gegenüber Dritten bleibt
31
somit die BiPRO alleine berechtigt. Die Veröffentlichung erfolgt gemäß Norm100. Aufgrund
32
der besonderen Wertigkeit der Normen für die Mitglieder sind wir gehalten, Verstöße
33
gerichtlich zu ahnden.
- Seite 2 von 16 -
34
Inhaltsverzeichnis
35
Norm 440 – Externe Navigation in VU-Portale .................................................................................... 1
36
Inhaltsverzeichnis ................................................................................................................................. 3
37
Prozessabbildung.................................................................................................................................. 4
38
Dienstbeschreibung .............................................................................................................................. 6
39
Prozessablauf ........................................................................................................................................ 7
40
Datenmodell ........................................................................................................................................... 9
41
Projektspezifische Objekte und Datentypen ...................................................................................... 9
42
Allgemeine BiPRO Datentypen ........................................................................................................ 10
43
Statuscodes und Meldungen.............................................................................................................. 12
44
Servicebeschreibung als WSDL ........................................................................................................ 13
- Seite 3 von 16 -
45
Prozessabbildung
46
Die Zielvorgabe laut Projektantrag lautet:
47
„Optimierung der Prozesse zwischen Vermittlern und VU beim Zugriff auf VU-Portale durch
48
den
49
Maklerverwaltungsprogramm (MVP)“.
50
Dies muss ohne grundlegende Änderungen in der Architektur des VU-Portals möglich sein. Da
51
also eine Normierung der URLs nicht möglich war, wurde die Möglichkeit geschaffen, das VU-
52
Portal nach „seinen“ individuell benötigten URLs zu fragen. Gemäß Projektantrag erfolgt
53
dieser URL-Anforderungsprozess ausschließlich durch einen Webservice je VU.
54
An diesen Webservice kann das MVP normierte Suchparameter übergeben wie z. B. eine
55
Versicherungsnummer. Das VU liefert darauf hin eine normierte Liste von URLs mit Zielen
56
zurück, die auf Seiten des eigenen Portals verweisen.
57
Der eigentliche Aufruf (Navigation) der erhaltenen URL erfolgt dann durch das MVP. So kann
58
jede beliebige vom VU benötigte URL-Syntax, also auch von http:// abweichende Protokolle
59
realisiert werden. Diese Lösung genügt den verschiedenen Portalzugängen der Versicherer,
60
da aufgrund individueller Authentifizierungs- und Sessionhandling-Verfahren die Navigation
61
evtl. über ein besonderes Programm und nicht durch einen Browser-Aufruf gestartet wird.
62
Es verbleibt in der Verantwortung des VU, in Abhängigkeit von den Möglichkeiten seines
63
Portals möglichst zweckmäßige Einsprungpunkte zu liefern.
64
Beispiele:
65
66
Vermittler
mit Hilfe
einer
normierten
externen
Navigation
z. B.
aus
1. Das MVP fordert Links zu einer bestimmten Versicherungsnummer an
a) Das VU-Portal bietet verschiedene Einsprungpunkte zu einem Vertrag
67
https://portal.meinvu.de/extranet/?vsnr=4711&link=vertrag
68
https://portal.meinvu.de/extranet/?vsnr=4711&link=dokumente
69
https://portal.meinvu.de/extranet/?vsnr=4711&link=rueckfrage
70
https://portal.meinvu.de/extranet/?vsnr=4711&link=schadenmeldung
71
b) Das VU-Portal kann nur auf die Seite mit den Vertragsdaten springen
- Seite 4 von 16 -
seinem
72
73
https://portal.meinvu.de/extranet/?vsnr=4711
c) Das VU-Portal bietet keine Möglichkeit, direkt eine Vertragsinformation
74
anzuzeigen
75
76
Hier kann der Makler zumindest durch einen Sprung auf die Einstiegsseite
unterstützt werden:
77
https://portal.meinvu.de/extranet
78
79
80
81
2. Das MVP übergibt Kundendaten an den Extranetdienst
a) Das VU-Portal stellt eine eigene Suchmaske / Trefferliste zur Verfügung
https://portal.meinvu.de/extranet/?link=Suche&name=Schmitz&ort=köln...
b) Der Extranetdienst sucht selbst nach den übergebenen Kundendaten
82
83
84
85
Wenn der Extranetdienst auf Hostdaten zugreifen kann, besteht grundsätzlich
die Möglichkeit, dass der Dienst selbst eine Suche durchführt und einen oder
mehrere URLs zu den jeweiligen Kundeninformationsseiten des VU-Portals
liefert:
86
https://portal.meinvu.de/extranet/?kunde=87628365
87
88
89
90
91
92
93
94
95
96
Dieses Vorgehen widerspricht der Grundidee des Projektes, in bestehende
Seiten des VU-Portals zu navigieren ohne neue Funktionalitäten
hinzuzufügen. Der Extranetdienst sollte nach Möglichkeit keine Funktionen
nachbilden, die bereits im VU-Portal angeboten werden.
97
98
99
Außerdem ist das Datenmodell absichtlich nicht auf die Übermittlung
umfangreicher strukturierter Datenmengen ausgelegt, so dass komplexe
Trefferlisten vom MVP nicht übersichtlich dargestellt werden könnten.
100
- Seite 5 von 16 -
101
Dienstbeschreibung
102
Die technische Servicebeschreibung (WSDL) sowie das Schema (XSD) zu diesem Projekt
103
liegen unter folgendem Namen als Normdokumente im BiPRO-DMS:
104
•
ExtranetService_1.0.1.0.wsdl
105
•
ExtranetService_1.0.1.0.xsd
- Seite 6 von 16 -
106
Prozessablauf
107
108
Abbildung 1: Beispiel für einen Arbeitsablauf im Maklerbüro
109
Die BiPRO Norm im Rahmen dieses Projekts umfasst folgende Abläufe:
110
111
112
113
114
115
116
1. MVP schickt getLink()-Request an VU Service, um die Liste möglicher Funktionen
(URL-Liste) zu erhalten:
a) Requestparameter wie z. B. Versicherungsscheinnummer, Name,
Adressdaten, etc.
b) Security Token falls vorhanden (Das MVP hat ggf. eine Authentifizierung nach
BiPRO-Norm 260 vorzunehmen)
2. VU Service prüft ggf. die Authentifizierung und ermittelt die zu den
- Seite 7 von 16 -
117
118
Requestparametern passenden URLs
3. VU Service liefert eines der folgenden Ergebnisse zurück (Response):
119
a) Rückgabe der URL(s)
120
b) Session abgelaufen, bzw. noch keine Session (ggf. Authentifizierung
121
122
123
erforderlich) etabliert
c) Ungültige Anfrage oder anderer Fehler
Mögliche Reaktionen des MVP:
124
a) Anzeige einer Auswahlliste der vom VU bereitgestellten Funktionen
125
b) MVP schickt RequestSecurityToken-Methode an den Security Token Service (STS)
126
des VU
127
Nach erfolgreicher Authentifizierung (BiPRO-Norm 260) wird der Extranetdienst
128
erneut aufgerufen
129
c) Anzeige eines Hinweis- oder Fehlertextes (BiPRO-Norm 320, siehe Seite 12)
130
- Seite 8 von 16 -
131
Datenmodell
132
Die Benennung der Attribute erfolgt einheitlich mit den anderen BiPRO-Projekten. Als
133
Datentyp kommt in den meisten Fällen jedoch ST_Suchfeld zum Einsatz, da die Charakteristik
134
eines Suchfeldes oft eine andere oder gar keine Plausibilitätsprüfung erfordert. Außerdem soll
135
die Suche mit Wildcards oder mit regulären Ausdrücken zugelassen werden, sobald hierzu
136
eine BiPRO-Norm verfügbar ist.
137
Daraus ergibt sich, dass die bestehenden BiPRO-Objekte keine Verwendung finden. Es
138
wurden daher eigene Suchobjekte mit den entsprechenden Attributen definiert:
139
140
Abbildung 2: Einbettung der Objekte in Request und Response
141
Projektspezifische Objekte und Datentypen
142
Extranetsuche
Das eigentliche Requestobjekt zur Übergabe der Suchparameter. Die
143
Unterteilung in Partnersuche, Vertragssuche, Schadensuche und
144
Vermittlersuche dient nur der Übersichtlichkeit
145
146
Links
Dieses Objekt wird als Response geliefert und enthält eine Auflistung
mit einzelnen Link-Objekten. In der Liste der Link-Objekte KÖNNEN
- Seite 9 von 16 -
147
mehrere Links mit derselben ExtranetZielID enthalten sein, die über die
148
Beschreibung (ST_Text50) präzisiert werden.
149
Link
Enthält die Elemente zur Beschreibung jedes einzelnen Links. Je Link
150
wird die URL für den Einsprung in das VU-Portal, eine ZielID zur
151
Qualifizierung des Links sowie ein Beschreibender Text zurück
152
gegeben.
153
ST_Suchfeld
Freitextfeld unbegrenzter Länge
154
ST_URL
Textfeld mit der Maximallänge 1024 Zeichen
155
ST_ExtranetZielID
Aufzählungsfeld mit der Länge 3. Gültig sind die folgenden Werte:
001 Hauptmenü
011 Schadenmeldung
021 Auswertungen
002 Stammdaten
012 Rückkaufswert
022 Rundschreiben
003 Bearbeiten
013 Rabattretter
023 Bestellen
004 Verträge
014 Vereinbarungen
024 Download
005 Dokumente
015 Produktion
025 Kontakt
006 Vorgänge
016 Provision
026 GDV
007 Schäden
017 Ranking
027 Partnersuche
008 Inkassostand
018 Posteingang
028 Vertragsuche
009 Angebot
019 Postausgang
029 Schadensuche
010 Anfrage
020 Störfälle
999 Sonstige
156
Die Präzisierung des Links, die über die aufgezählte Kategorisierung hinaus geht, erfolgt über
157
die Beschreibung.
158
Allgemeine BiPRO Datentypen
159
Folgende Datentypen wurden aus dem allgemeinen BiPRO Schema
160
bipro-objekte-allgemein-MAJOR-MINOR.xsd´verwendet (BiPRO Norm 400):
161
ST_Laenderkennzeichen
162
ST_VuNummer
163
ST_Sparte
- Seite 10 von 16 -
164
ST_Text50
- Seite 11 von 16 -
165
166
Statuscodes und Meldungen
Verarbeitung erfolgreich
Status
Meldung
StatusID
ArtID
MeldungID
Text
00000
00003
03000
Es wurden <Anzahl> Links in das VU-
Quelle
Portal bereitgestellt
00000
167
00003
03001
Die Suche lieferte kein Ergebnis
Verarbeitung fehlerhaft
Status
Meldung
StatusID
ArtID
MeldungID
Text
00001
00001
00101
Sie sind nicht authentifiziert
00001
00001
00102
Sie sind nicht ausreichend authentifiziert
00001
00001
03100
VuNummer fehlerhaft
00001
00001
03101
Nach dem Feld <Feldname> kann nicht
Quelle
Feldname
gesucht werden
00001
00001
03102
Ungültiger Inhalt in Feld <Feldname>
168
- Seite 12 von 16 -
Feldname
169
Servicebeschreibung als WSDL
170
Die Beschreibung des Service MUSS in Form des nachfolgend beschriebenen WSDL-Musters
171
erfolgen (BiPRO Norm 225).
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
<?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions
targetNamespace="${X1}"
xmlns:wsp="${X2}"
xmlns:sp="${X2.1}"
xmlns:wsu="${X3}"
xmlns:wsa="${X4}"
xmlns:bipro="${X1}"
xmlns:wsdl="${X5}"
xmlns:soapbind="${X6}">
<wsp:Policy wsu:Id="ExtranetServiceSecurityPolicy">
<wsp:ExactlyOne>
<wsp:All>
<sp:TransportBinding>
<wsp:Policy>
<sp:TransportToken>
<wsp:Policy>
<sp:HttpsToken RequireClientCertificate="false"/>
</wsp:Policy>
</sp:TransportToken>
</wsp:Policy>
</sp:TransportBinding>
<sp:SupportingTokens>
<wsp:Policy>
<sp:SecureConversationToken sp:IncludeToken="${X12}">
<sp:Issuer>
<wsa:Address>${X7}</wsa:Address>
</sp:Issuer>
</sp:SecureConversationToken>
</wsp:Policy>
</sp:SupportingTokens>
</wsp:All>
</wsp:ExactlyOne>
</wsp:Policy>
<wsdl:types>
<xsd:schema version="1.0"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:import namespace="${X1}" schemaLocation="${X8}"/>
- Seite 13 von 16 -
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
</xsd:schema>
</wsdl:types>
<wsdl:message name="getLinksRequest">
<wsdl:part name="parameters" element="bipro:getLinks"/>
</wsdl:message>
<wsdl:message name="getLinksResponse">
<wsdl:part name="parameters" element="bipro:getLinksResponse"/>
</wsdl:message>
<wsdl:message name="Exception">
<wsdl:part name="parameters" element="bipro:Exception"/>
</wsdl:message>
<wsdl:portType name="ExtranetServicePortType">
<wsdl:operation name="getLinks" parameterOrder="parameters">
<wsdl:documentation>${X9}</wsdl:documentation>
<wsdl:input message="bipro:getLinksRequest" name="getLinksRequest"/>
<wsdl:output message="bipro:getLinksResponse" name="getLinksResponse"/>
<wsdl:fault message="bipro:Exception" name="Exception"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="ExtranetServiceBinding" type="bipro:ExtranetServicePortType">
<wsp:PolicyReference URI="#ExtranetServiceSecurityPolicy" />
<soapbind:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="getLinks">
<soapbind:operation soapAction="urn:getLinks" style="document"/>
<wsdl:input name="getLinksRequest">
<soapbind:body use="literal"/>
</wsdl:input>
<wsdl:output name="getLinksResponse">
<soapbind:body use="literal"/>
</wsdl:output>
<wsdl:fault name="Exception">
<soapbind:fault name="Exception" use="literal"/>
</wsdl:fault>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="ExtranetService">
<wsdl:documentation>${X10}</wsdl:documentation>
<wsdl:port name="ExtranetService"> binding="bipro:ExtranetServiceBinding"
<soapbind:address location="${X11}" />
</wsdl:port>
- Seite 14 von 16 -
259
260
261
262
</wsdl:service>
</wsdl:definitions>
- Seite 15 von 16 -
263
Variable
Wert
${X1}
Namespace BiPRO: http://www.bipro.net/namespace
${X2}
Namespace WS-Policy
http://schemas.xmlsoap.org/ws/2004/09/policy
${X2.1}
Namespace WS-SecurityPolicy
http://schemas.xmlsoap.org/ws/2005/07/securitypolicy
${X3}
Namespace WS-Utility: http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd
${X4}
Namespace WS Addressing
http://schemas.xmlsoap.org/ws/2004/08/addressing
${X5}
Namespace WSDL: http://schemas.xmlsoap.org/wsdl/
${X6}
Namespace SOAP-Binding: http://schemas.xmlsoap.org/wsdl/soap/
${X7}
Adresse des Security Token Service
${X8}
Adresse des XML Schemas
${X9}
Dokumentation
der
Funktion.
ACHTUNG:
Diese
fachliche
Erläuterung wird möglicherweise innerhalb eines generischen
Clients innerhalb der Benutzeroberfläche visualisiert.
${X10}
Erläuterung
der
Aufgabe
des
Dokumentation.
ACHTUNG:
möglicherweise
von
Web
Services;
Diese
generischen
Fachliche
Erläuterung
Clients
in
wird
einer
Benutzeroberfläche visualisiert.
${X11}
Adresse des Web Service
${X12}
http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToke
n/AlwaysToRecipient
264
- Seite 16 von 16 -

BiPRO Norm 440

Transcrição

Documentos relacionados

Tarifierung, Angebot, Antrag im Bereich der Privaten

Norm 440 – Externe Navigation in VU-Portale

RDS einsetzen - softwareschule.ch

IG Metall Extranet - Infografik "Druck auf Betriebsräte"

IG Metall Extranet - Infogr

Kalender-Management

IG Metall Extranet - Infografik "Betriebsrat zahlt sich aus"

IG Metall Extranet - Infogr

AfroPort - das deutschsprachige Afrikaportal für Kunst, Kultur und

American University, Washington, D.C.