Norm 440 – Externe Navigation in VU-Portale

Transcrição

1
Norm 440 – Externe Navigation in VU-Portale
2
Release und Version
3
Release 1, Version 4.0, vom 19. Juni 2007
4
Status
5
Offizielle Norm
6
Editor
7
Dirk Müller, LUTRONIK Software GmbH
8
Autoren
9
Dirk Müller, LUTRONIK Software GmbH ([email protected])
10
Sebastian Meyer ([email protected])
11
Markus Rauch ([email protected])
12
Gregor Fell ([email protected])
13
Dr. Andreas Rohling ([email protected])
14
Gegenstand der Norm
15
Die Norm 440 definiert den automatisierten Einsprung in VU-Portale aus einem MVP.
16
Voraussetzung
17
18
19
20
21
22
23
24
25
Norm
Norm
Norm
Norm
Norm
Norm
Norm
Norm
200 Release 1 Version 2
26
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 1 von 15 -
27
Hinweis zur Veröffentlichung
28
Die anliegend überreichte Norm ist urheberrechtlich für die BiPRO geschützt. Das Dokument
29
wird Ihnen im Rahmen Ihrer Mitgliedschaft bei der BiPRO und damit als Mitglied dieses
30
geschlossenen Empfängerkreises überlassen. Dementsprechend stellt die Überlassung an
31
Sie keine Erstveröffentlichung der Norm dar. Zur Erstveröffentlichung gegenüber Dritten bleibt
32
somit die BiPRO alleine berechtigt. Die Veröffentlichung erfolgt gemäß Norm100. Aufgrund
33
der besonderen Wertigkeit der Normen für die Mitglieder sind wir gehalten, Verstöße
34
gerichtlich zu ahnden.
- Seite 2 von 15 -
35
Inhaltsverzeichnis
36
Norm 440 – Externe Navigation in VU-Portale .................................................................................... 1
37
Inhaltsverzeichnis ................................................................................................................................. 3
38
Prozessabbildung .................................................................................................................................. 4
39
Dienstbeschreibung .............................................................................................................................. 6
40
Prozessablauf ........................................................................................................................................ 7
41
Datenmodell ........................................................................................................................................... 9
42
Projektspezifische Objekte und Datentypen ...................................................................................... 9
43
Allgemeine BiPRO Datentypen ........................................................................................................ 10
44
Statuscodes und Meldungen.............................................................................................................. 11
45
Servicebeschreibung als WSDL ........................................................................................................ 12
- Seite 3 von 15 -
46
Prozessabbildung
47
Die Zielvorgabe laut Projektantrag lautet:
48
„Optimierung der Prozesse zwischen Vermittlern und VU beim Zugriff auf VU-Portale durch
49
den
50
Maklerverwaltungsprogramm (MVP)“.
51
Dies muss ohne grundlegende Änderungen in der Architektur des VU-Portals möglich sein. Da
52
also eine Normierung der URLs nicht möglich war, wurde die Möglichkeit geschaffen, das VU-
53
Portal nach „seinen“ individuell benötigten URLs zu fragen. Gemäß Projektantrag erfolgt
54
dieser URL-Anforderungsprozess ausschließlich durch einen Webservice je VU.
55
An diesen Webservice kann das MVP normierte Suchparameter übergeben wie z. B. eine
56
Versicherungsnummer. Das VU liefert darauf hin eine normierte Liste von URLs mit Zielen
57
zurück, die auf Seiten des eigenen Portals verweisen.
58
Der eigentliche Aufruf (Navigation) der erhaltenen URL erfolgt dann durch das MVP. So kann
59
jede beliebige vom VU benötigte URL-Syntax, also auch von http:// abweichende Protokolle
60
realisiert werden. Diese Lösung genügt den verschiedenen Portalzugängen der Versicherer,
61
da aufgrund individueller Authentifizierungs- und Sessionhandling-Verfahren die Navigation
62
evtl. über ein besonderes Programm und nicht durch einen Browser-Aufruf gestartet wird.
63
Es verbleibt in der Verantwortung des VU, in Abhängigkeit von den Möglichkeiten seines
64
Portals möglichst zweckmäßige Einsprungpunkte zu liefern.
65
Beispiele:
66
67
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
68
https://portal.meinvu.de/extranet/?vsnr=4711&link=vertrag
69
https://portal.meinvu.de/extranet/?vsnr=4711&link=dokumente
70
https://portal.meinvu.de/extranet/?vsnr=4711&link=rueckfrage
71
https://portal.meinvu.de/extranet/?vsnr=4711&link=schadenmeldung
72
b) Das VU-Portal kann nur auf die Seite mit den Vertragsdaten springen
- Seite 4 von 15 -
seinem
73
74
https://portal.meinvu.de/extranet/?vsnr=4711
c) Das VU-Portal bietet keine Möglichkeit, direkt eine Vertragsinformation
75
anzuzeigen
76
77
Hier kann der Makler zumindest durch einen Sprung auf die Einstiegsseite
unterstützt werden:
78
https://portal.meinvu.de/extranet
79
80
81
82
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
83
84
85
86
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:
87
https://portal.meinvu.de/extranet/?kunde=87628365
88
89
90
91
92
93
94
95
96
97
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.
98
99
100
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.
101
- Seite 5 von 15 -
102
Dienstbeschreibung
103
Die technische Servicebeschreibung (WSDL) sowie das Schema (XSD) zu diesem Projekt
104
liegen unter folgendem Namen als Normdokumente im BiPRO-DMS:
105
•
ExtranetService_1.0.1.0.wsdl
106
•
ExtranetService_1.0.1.0.xsd
- Seite 6 von 15 -
107
Prozessablauf
108
109
Abbildung 1: Beispiel für einen Arbeitsablauf im Maklerbüro
110
Die BiPRO Norm im Rahmen dieses Projekts umfasst folgende Abläufe:
111
112
113
114
115
116
117
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 410 vorzunehmen)
2. VU Service prüft ggf. die Authentifizierung und ermittelt die zu den
- Seite 7 von 15 -
118
119
Requestparametern passenden URLs
3. VU Service liefert eines der folgenden Ergebnisse zurück (Response):
120
a) Rückgabe der URL(s)
121
b) Session abgelaufen, bzw. noch keine Session (ggf. Authentifizierung
122
123
124
erforderlich) etabliert
c) Ungültige Anfrage oder anderer Fehler
Mögliche Reaktionen des MVP:
125
a) Anzeige einer Auswahlliste der vom VU bereitgestellten Funktionen
126
b) MVP schickt RequestSecurityToken-Methode an den Security Token Service (STS)
127
des VU (BiPRO-Norm 410)
128
Nach erfolgreicher Authentifizierung wird der Extranetdienst erneut aufgerufen
129
c) Anzeige eines Hinweis- oder Fehlertextes (BiPRO-Norm 320, siehe Seite 11)
130
- Seite 8 von 15 -
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.
- Seite 9 von 15 -
147
Link
Enthält die Elemente zur Beschreibung jedes einzelnen Links. Je Link
148
wird die URL für den Einsprung in das VU-Portal, eine ZielID zur
149
Qualifizierung des Links sowie ein Beschreibender Text zurück
150
gegeben.
151
ST_Suchfeld
Freitextfeld unbegrenzter Länge
152
ST_URL
Textfeld mit der Maximallänge 1024 Zeichen
153
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
154
155
Allgemeine BiPRO Datentypen
156
Folgende Datentypen wurden aus dem allgemeinen BiPRO Schema
157
bipro-objekte-allgemein-MAJOR-MINOR.xsd´verwendet (BiPRO Norm 400):
158
ST_Laenderkennzeichen
159
ST_VuNummer
160
ST_Sparte
161
ST_Text50
- Seite 10 von 15 -
162
163
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
164
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>
165
- Seite 11 von 15 -
Feldname
166
Servicebeschreibung als WSDL
167
Die Beschreibung des Service MUSS in Form des nachfolgend beschriebenen WSDL-Musters
168
erfolgen (BiPRO Norm 225).
169
170
171
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
<?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions
targetNamespace="${X1}"
xmlns:wsp="${X2}"
xmlns:wssp="${X2.1}"
xmlns:wsu="${X3}"
xmlns:wsa="${X4}"
xmlns:bipro="${X1}"
xmlns:wsdl="${X5}"
xmlns:soapbind="${X6}"
<wsp:Policy wsu:Id="BiPROSecurityPolicy">
<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">
- Seite 12 von 15 -
209
210
211
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
<xsd:import namespace="${X1}" schemaLocation="${X8}"/>
</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}" />
- Seite 13 von 15 -
256
257
258
259
260
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
- Seite 14 von 15 -
261
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
262
- Seite 15 von 15 -

Norm 440 – Externe Navigation in VU-Portale

Transcrição

Documentos relacionados

Tarifierung, Angebot, Antrag im Bereich der Privaten

BiPRO Norm 440

RDS einsetzen - softwareschule.ch

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

Kalender-Management

IG Metall Extranet - Infogr

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

American University, Washington, D.C.

Norm 230 – Übertragung von Dateien

No image - MOTOCROSS-SHOP

Norm - VDMA