Der Integrationsleitfaden - Eine Schritt für Schritt Bedienungsanleitung
Auf dieser Seite finden Sie alle relevanten Informationen zur Integration und Nutzung des Online-Dienstes “Waffenrechtliche Erlaubnisse”.
Stand: Dec 12, 2024
Inhaltsverzeichnis
- 1 Kurzzusammenfassung
- 2 1. Leistungsumfang und Anmeldung des Nachnutzungsinteresses
- 3 2. Voraussetzung für Routing und Transport der Antragsdaten schaffen
- 4 3. Self-Service Ticket befüllen & Basisdaten eingeben
- 5 4. Zugang zum OZG Service Management erhalten und Antragsstrecken individualisieren
- 6 5. Antragsstrecken auf Website einbinden
- 7 6. Datenschutz
- 8 7. Antragsstrecken und Nachrichtenzustellung testen
- 9 8. Go-live und Bekanntgabe des Produktiv-Links
- 10 9. Optionale Funktionen der Antragsstrecken
Kurzzusammenfassung
In diesem Integrationsleitfaden finden Sie die erforderlichen Schritte von der Anmeldung des Nachnutzungsinteresses bis zum Go-Live Ihrer Antragsstrecken des OZG-Online-Dienstes “Waffenrechtliche Erlaubnisse” (eWaffe). Im Downloadbereich der Nachnutzungsplattform finden Sie zahlreiche Informationen, die im Zuge der Entwicklung und Nachnutzung erarbeitet wurden. Dort bieten wir Ihnen eine Checkliste, allgemeine Projektinformationen, Dokumente zum Datenschutz und zur Nachnutzung für Waffenbehörden sowie alle Informationen rund um die fachliche Konzeption und technische Anbindung zum Download an.
Ein wichtiger Hinweis zur behördeninternen Vorbereitung auf die Integration des Online-Dienstes:
In den Behörden arbeitet die AKDB meistens mit einer fachlichen und einer technischen Ansprechperson zusammen. Die meisten der im Integrationsleitfaden aufgeführten Schritte betreffen vorwiegend Ihre(n) technische Ansprechperson, sodass sich - wenn noch nicht geschehen - die interne Absprache und Koordination zwischen Fachlichkeit und Technik empfiehlt. Die technische Ansprechperson, die die Integration unseres Online-Dienstes begleiten, kommen zumeist aus der IT-Abteilung/Webseiten-Administration und sollten rechtzeitig in den (geplanten) Integrationsprozess eingebunden werden. Die Fachlichkeit ist zumeist nur punktuell gefordert, beispielsweise bei der Textanpassung der Antragsoberfläche und gegen Ende der Integration des Online-Dienstes, wenn geprüft wird, ob die Anträge auch richtig in der Behörde ankommen.
1. Leistungsumfang und Anmeldung des Nachnutzungsinteresses
Der nachnutzbare OZG-Online-Dienst “Waffenrechtliche Erlaubnisse” (eWaffe) umfasst mehrere Antragsstrecken, die wiederum einzelne oder gebündelte LeiKa-Leistungen abbilden. Um die OZG-Leistungen jeweils vollständig umzusetzen, wird die Einbindung aller zur Verfügung stehenden Antragsstrecken empfohlen. Nachfolgende Tabelle listet alle umsetzungsrelevanten Antragsstrecken, die entsprechende LeiKa-ID und ihren aktuellen Umsetzungsstand auf.
Wenn Sie als Waffenbehörde den Online-Dienst “eWaffe” nachnutzen möchten, wenden Sie sich bitte per E-Mail an eWaffeService@akdb.de. Geben Sie in dieser E-Mail bitte an, wer in Ihrer Behörde die zentral verantwortliche Person für die Integration der Antragsstrecken des Online-Dienstes ist.
Vielen Dank für Ihr Nachnutzungsinteresse! Sofern Sie dieses in der Vergangenheit bereits gegenüber dem Projekt bekundet haben, ist die “Anmeldung des Nachnutzungsinteresses” erfüllt und wir haben Sie vermerkt.
Nr. | Antragsstrecke | Technischer Titel der Antragsstrecke | Leika-ID | Umsetzungsstand |
---|---|---|---|---|
1 | Grüne WBK - Erstantrag | ewaffe-gruene-wbk-person-erteilung | 99089018001015 | |
2 | Gelbe WBK - Erstantrag | ewaffe-gelbe-wbk-sportschuetze-erteilung | 99089018001016 | |
3 | Rote WBK - Erstantrag (Waffen- und Munitionssammler bzw. Sachverständige) | ewaffe-rote-wbk-erteilung | 99089018001019 (Sammler) 99089018001002 (Sachverständige) | |
4 | Kleiner Waffenschein Erteilung | ewaffe-kleiner-waffenschein-erteilung | 99089124001000 | |
5 | Anzeige Erwerb | ewaffe-wbk-eintragung-erwerb | 99089087261000 | |
6 | Anzeige Überlassung | ewaffe-wbk-austragung-ueberlassung | 99089035261000 | |
7 | WBK Vereine - Erstantrag (Schießsportliche Vereine und jagdliche Vereinigungen)
| ewaffe-wbk-vereine-erteilung
| 99089018001017 (Schießsportliche Vereine) 99089018001018 (Jagdliche Vereinigungen) | |
8 | Voreintrag | ewaffe-wbk-voreintrag | 99089018001022 (WBK Grün) 99089018001020 (Schießsport) 99089018001021 (Jagd) | |
9 | Europäischer Feuerwaffenpass Ausstellung | ewaffe-eu-feuerwaffenpass-ausstellung | 99089010012001 | |
10 | Waffenschein Erteilung | ewaffe-waffenschein-erteilung | 99089122001000 | |
11 | Waffenschein Verlängerung | ewaffe-waffenschein-verlaengerung | 99089122020000 | |
12 | Europäischer Feuerwaffenpass Verlängerung | ewaffe-eu-feuerwaffenpass-verlaengerung | 99089010020001 | |
13 | Ausnahme vom Mindestalter zum Schießen auf Schießstätten zur Förderung des Leistungssports Bewilligung | ewaffe-ausnahme-mindestalter-schiessstaetten | 99089097017000 | |
14 | Erlaubnis zum Schießen | ewaffe-schiesserlaubnis-erteilung | 99089088001000 | |
15 | Anzeige Unbrauchbarmachung | ewaffe-anzeige-unbrauchbarmachung | 99089108261000 | |
16 | Nachweis Einbau eines Blockiersystems bei Erbwaffen | ewaffe-blockiersystem-erbwaffen | 99089173169000 | |
17 | WBK grün Erbfall | ewaffe-wbk-erbfall | 99089018001001 | |
18 | Anzeige Verlust | ewaffe-anzeige-verlust | 99089107261000 | |
19 | Erlaubnis zur Mitnahme Erteilung | ewaffe-mitnahme-erteilung | 99089130001000 | |
20 | Erlaubnis zur Mitnahme Verlängerung | ewaffe-mitnahme-verlaengerung | 99089130020000 | |
21 | Verbringung von Waffen | ewaffe-verbringung-erteilung | 99089188001001 | |
22 | Bescheid Widerspruch | ewaffe-bescheid-widerspruch |
| in Entwicklung |
tbd | Antragslotse | tbd | keine LeiKa-ID | in Entwicklung |
2. Voraussetzung für Routing und Transport der Antragsdaten schaffen
Beginnend mit diesem Schritt ist Ihre technische Ansprechperson aus der betreuenden IT-Abteilung der Waffenbehörde federführend einzubeziehen. Hier geht es insbesondere um die Themen “OSCI-Verschlüsselungszertifikate” und “DVDV-Eintrag”.
Zum Hintergrund dieses Schrittes: Der Online-Dienst “Waffenrechtliche Erlaubnisse” (eWaffe) überträgt mittels des XÖV-Datenaustauschstandards XeWaffe die Antragdaten der jeweiligen Antragsstrecken. Eine Unterstützung des XeWaffe Standards durch das Fachverfahren der Waffenbehörden ist notwendig, um die Antragsdaten maschinell auslesen zu können.
Der Transport der Antragsdaten erfolgt gemäß der EfA-Mindestanforderungen über das OSCI-Transportprotokoll, für das Routing kommt der Verzeichnisdienst DVDV zum Einsatz. Daher ist für die bereitzustellenden Dienste eine Eintragung der Waffenbehörde (Dienstanbieter) als DVDV-Empfänger bei der DVDV Pflegenden Stelle des jeweiligen Landes notwendig. Das “DVDV Eintragungskonzept XeWaffe” (genehmigt durch das Informationstechnikzentrum Bund, kurz ITZBund) und unterstützend die “DVDV Eintragungskonzept Handreichung” befinden sich im Downloadbereich.
Die DVDV Pflegende Stelle des Landes benötigt mit dem Antrag auch die OSCI-Verschlüsselungszertifikate der Waffenbehörde (das sogenannte DVDV-Übermittlungszertifikat und das OSCI-Intermediär-Zertifikat). Weitere Informationen zur Beantragung dieser finden Sie im Kapitel 2a.
Weitere Details zu den Verschlüsselungszertifikaten können Sie der nachfolgenden aufklappbaren Textbox entnehmen.
2a. OSCI-Verschlüsselungszertifikat beantragen
Die Waffenbehörde muss ihrer DVDV Pflegenden Stelle mit dem Antrag auf DVDV-Eintragung die OSCI-Verschlüsselungszertifikate (PKI Public Key) zusenden. Das Nachnutzen anderweitig vorhandener OSCI-Zertifikate ist nicht möglich. Es werden neue Zertifikate benötigt; diese auf der Seite der Telesec auszuwählen. Vor der Beantragung eines neues Zertifikates ist zu prüfen, ob es für Ihre Behörde bereits einen vertraglichen Anbieter von Zertifikaten gibt. Die voraussichtlich bei der Zertifikatsbeschaffung entstehenden Kosten sind nicht durch Projektmittel gedeckt und sind von den Behörden zu tragen. Hierzu empfiehlt sich eine Absprache zwischen der Behörde und dem nachnutzendem Land, da einige Länder Anschubfinanzierungen in Aussicht gestellt haben.
2b. Beantragung und Abholung eines Zertifikates am Beispiel Telesec
In diesem Kapitel wird an dem Beispiel des Anbieters einer Pilotkommune aufgezeigt, wie ein OSCI-Zertifikat beantragt werden kann. Sollten Sie über die folgende ausklappbare Darstellung hinaus Fragen an den Anbieter haben, können Sie sich an deren Support wenden.
2c. DVDV-Eintrag durch eine Waffenbehörde beantragen
Nach dem Erhalt des Zertifikats ist durch die Waffenbehörde ein Eintrag im DVDV bei der DVDV-Pflegenden Stelle des Landes zu veranlassen. Hierzu bedarf es gemäß des projekteigenen DVDV-Eintragungskonzepts folgende hier beispielhaft dargestellte Angaben seitens der Behörde. Bitte beachten Sie, dass all diese Angaben, sofern nicht in der Tabelle als Optional gekennzeichnet, für einen korrekten DVDV-Eintrag zwingend benötigt werden.
Eigenschaft | Beispiel Waffenbehörde |
---|---|
Organisationskategorie | Waffenbehörde |
Behördenname | Landratsamt Beispielname / Name der zuständigen Polizeistelle Beispielname / Gemeindeverwaltung Beispielname |
Behördenanschrift | Beispielstraße 1, 12345 Beispielstadt |
Kurzbezeichnung der dazugehörigen Dienste gem. DVDV-Eintragungskonzept | XeWaffe13WBK-wap2wab |
DVDV-Präfix | wab |
DVDV-Organisations-ID (nähere Erläuterung in der nachfolgenden Tabelle) | 123456780000 (Produktion) |
Beispieldatensatz zur Beantragung des DVDV-Eintrags bei der DVDV Pflegenden Stelle
Die 12-stellige DVDV-Organisations-ID wird wie folgt gebildet:
Stelle | Erläuterung |
---|---|
Präfix | Der Wert “wab” ist der feststehende Präfix für alle behördlichen Nutzenden. |
Stelle 1-8: | Diese Stellen sind für den Amtlichen Gemeindeschlüssel (AGS) Ihrer Gebietskörperschaft / Polizeibehörde vorgesehen. Je nach Art der Gebietskörperschaft / der Polizeibehörde sind hierbei unterschiedliche Konventionen zu beachten. Diese werden im Folgenden aufgeführt: Gemeinden Alle Gemeinden besitzen einen 8-stelligen AGS, welcher hier eingefügt wird Beispiel Stadt Starnberg: 09188139 Landkreise Landkreise besitzen üblicherweise einen 5-stelligen AGS, welcher durch drei Nullen am Ende der Schlüssels aufgefüllt wird Beispiel Landkreis Starnberg: 09188000 Polizeibehörden Polizeibehörden besitzen üblicherweise keinen AGS, weshalb der Landkreisschlüssel oder der Gemeindeschlüssel des Standortes des Behörde anzugeben ist. Beispiel Polizeibehörde mit Sitz im Landkreis Starnberg: 09188000 Beispiel Polizeibehörde mit Sitz in der Stadt Starnberg und einer Zuständigkeit für die Stadt und den Landkreis Starnberg: 09188139 |
Stelle 9-10: | 00 (Als Standardwert ist die 00 anzugeben. Diese Angabe wird seitens der DVDV pflegenden Stelle geprüft und hochgezählt, falls eine weitere antragsverarbeitende Behörde vor Ort bereits eingetragen ist) |
Stelle 11-12: | 00 = produktiv verwendeter Schlüssel |
AGS: https://www.xrepository.de/details/urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:ags Kreisschlüssel: https://www.xrepository.de/details/urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:kreis
Die im Beispieldatensatz aufgeführten Informationen müssen der DVDV Pflegenden Stelle des Landes (zumeist per E-Mail) übersandt werden.
Welche DVDV Pflegende Stelle für Sie zuständig ist, finden Sie in der nachfolgenden ausklappbaren Liste der DVDV Pflegende Stellen der Länder. Eine detaillierte Liste mit einzelnen Ansprechpersonen der DVDV Pflegenden Stellen der Länder ist im geschützten Bereich auf der Webseite des ITZBund zum Download verfügbar. Der Link dazu befindet sich im Downloadbereich.
2d. Fachverfahrenshersteller beauftragen
An dieser Stelle ist es zudem sinnvoll, die Beauftragung Ihres Fachverfahrensherstellers in die Wege zu leiten und intern die Installation des Releases Ihres Fachverfahrens vorzubereiten. Es empfiehlt sich daher, die IT-Abteilung bzw. den IT-Dienstleister, der die Installation des Releases des Fachverfahrensherstellers durchführt, rechtzeitig in Ihre Planung einzubinden. Die voraussichtlich bei der Beauftragung Ihrer Fachverfahrensanbindung entstehenden Kosten sind von der Behörde zu tragen. Hierzu empfiehlt sich die Absprache zwischen Behörde und Land, da einige Länder Fördermöglichkeiten bieten könnten.
3. Self-Service Ticket befüllen & Basisdaten eingeben
Sobald Sie die Nachnutzung angemeldet haben und die Voraussetzungen für Routing und Transport der Antragsdaten bis zum landesspezifischen OSCI-Intermediär geschaffen haben, können Sie die Einrichtung des Mandanten für Ihre Organisation mithilfe eines sog. “Self-Service-Tickets” beantragen. Im elektronischen Self-Service-Ticket sind alle Daten anzugeben, die seitens der AKDB für die technische Bereitstellung der Antragsstrecken benötigt werden. Mit dem Ausfüllen und Absenden des Self-Service-Tickets stellen wir Ihnen standardmäßig alle Antragsstrecken bereit, die aktuell zur Nachnutzung verfügbar sind (siehe Kapitel 1).
✅Sie können alle Angaben im Ticket zwischenspeichern. Sie müssen das Self-Service-Ticket daher nicht in einer Sitzung vollständig ausfüllen und abschicken.
Nachträgliche Bearbeitungen des Self-Service-Tickets nach der Übermittlung können in Absprache mit dem Rollout-Team getätigt werden.
Anhand der eingereichten Daten erfolgt die Einrichtung Ihres Mandanten und der Antragsstrecken mit Ihrem AGS durch die AKDB. Sie werden per E-Mail über die erfolgreiche Einrichtung informiert. Prüfen Sie in regelmäßigen Abständen auch Ihren Spam-Ordner.
Weiterhin erhalten die angegebenen fachlichen und technischen Ansprechpersonen eine E-Mail mit einem Einladungslink für die Mandantenkonfiguration für die “PRO-Umgebung” des OZG Service Managements (weiteres dazu siehe unten im Abschnitt 4c).
4. Zugang zum OZG Service Management erhalten und Antragsstrecken individualisieren
Das OZG Service Management ist die Management-Oberfläche und das Bearbeitungstool für die Online- und EfA-Dienste der AKDB. Dort finden Sie einen Bereich für Ihre Kommune und können z.B. Textbausteine in den Antragsstrecken anpassen.
4a. Zugangsdaten für das OZG Service Management
Die von Ihnen im Self-Service angegebenen fachlichen und technischen Ansprechpersonen erhalten nach der Einrichtung des Mandanten und der Antragsstrecken eine E-Mail mit einem Einladungslink für die PRO-Umgebung des OZG Service Managements. 72 Stunden nach Erhalt der E-Mail läuft dieser Einladungslink ab. Unter Umständen wird diese Mail automatisch in den Spam-Ordner verschoben. Falls keine Zugangsdaten verschickt wurden, der Einladungslink abgelaufen ist oder weitere Personen Zugriff erhalten sollen (z.B. Vertreter:innen), senden Sie eine Anfrage mit Ihrem Anliegen (unter Angabe Ihrer antragsbearbeitenden Stelle, gewünschte Dienste, Vor-/Nachname sowie E-Mail-Adresse) über folgenden Link: Support Anfrage eWaffe.
4b. Zugang zu dem OZG Service Management
Um eine Fehlermeldung bei der Aktivierung zu vermeiden, sollte der Einladungslink nicht über den Internet Explorer, sondern über einen der folgenden Webbrowser geöffnet werden: Google Chrome, Firefox, Safari, Microsoft Edge, Opera. Der Einstieg zum OZG Service Management ist mit Benutzername und Passwort geschützt. Bitte beachten Sie bei der Anmeldung, dass bei der Eingabe “Benutzername (vorname.nachname) bzw. E-Mail-Adresse” lediglich Kleinbuchstaben verwendet werden können. Es bestehen keine spezifischen Passwortkriterien.
4c. Produktiv- und Testumgebung
Grundsätzlich gibt es für Ihre Dienste eine produktive Umgebung (PRO) im OZG Service Management, die unter folgenden Link abzurufen ist:
Die produktive Umgebung (PRO) kann direkt für die Integration der Online-Dienste in die Webseite Ihrer Kommune bzw. Behörde verwendet werden. Auf der produktiven Umgebung (PRO) können Sie die Zustellung der Antragsdaten in Ihr Fachverfahren testen.
Hinweis: Wenn Sie auf der produktiven Umgebung (PRO) Ihre Dienste testen, sollte dies auf einem nicht öffentlichen Bereich - zum Beispiel auf einem dafür vorgesehenen Test- oder passwortgeschützten Bereich - Ihrer Webseite erfolgen. Sollte dieser Bereich eine abweichende Domain zu der Webseite Ihrer Gebietskörperschaft haben, muss diese im Self-Service Ticket entsprechend vermerkt werden.
4d. Metriken
Die grafische Darstellung veranschaulicht die Nutzung der Online-Dienste in Ihrer Behörde und zählt deren Aufrufe („Start“), die erfolgreich gestellten Anträge („Success“) und die Anträge, die in einen Timeout gelaufen sind.
“Success” bedeutet nur, dass der Antrag erfolgreich von Ihren Bürger:innen abgeschickt wurde. Es bedeutet nicht, dass dieser Antrag auch erfolgreich in ihr Fachverfahren zugestellt werden konnte.
Das Timeout setzt dabei nach 30-minütiger Inaktivität der Nutzer:innen ein und löscht den aktuellen Bearbeitungsstand.
“Start” bringt zum Ausdruck, dass die Webseite, auf der sich der Online-Dienst befindet aufgerufen wurde, jedoch keine Daten von Nutzer:innen eingetragen wurden.
Es werden hierbei lediglich die Aufrufe der Dienste gezählt. Personenbezogene Daten werden nicht gespeichert.
Standardmäßig wird die Darstellung der letzten 30 Tage angezeigt. Rechts oberhalb der Grafik kann die gewünschte Zeitspanne gewählt werden.
4e. Individualisierung der Texte
Sämtliche Texte im Online-Dienst können über das OZG Service Management individualisiert werden. Durch Auswählen der Ellipse (“drei Punkte“) bei der entsprechenden Antragsstrecke öffnet sich ein Reiter, unter dem “Texte bearbeiten“ ausgewählt werden kann.
Es müssen einige Textstellen auf der produktiven Umgebung (PRO) von Ihnen angepasst werden. Wie die nachfolgende Abbildung verdeutlich, sind diese Textstellen in der Gruppe „variables“ als Platzhalter gebündelt.
⚠️ In den variables tauchen vier Textbausteine auf, die Sie nicht anpassen müssen. Diese lauten: behoerde_telefon
, behoerde_email
, behoerde_akkusativ_mit_artikel
& “gemeinde_genitiv_mit_artikel
Beschreibung | Screenshot |
---|---|
|
|
Jedem Textbereich der Antragsseiten ist im OZG Service Management ein eindeutiger Schlüssel zugeordnet. Die folgenden Abbildungen zeigen die Textbereiche in den Antragsstrecken mit den dazugehörigen Schlüsseln, die im OZG Service Management zwingend anzupassen sind.
Zusätzlich finden unter “variables” auch die folgenden Textbausteine, die nur unter bestimmten Bedingungen anzupassen sind:
Name Textbaustein | Erläuterung |
---|---|
| Dieser Textbaustein muss nur dann geändert werden, wenn Ihre Waffenbehörde nicht im Freistaat Bayern ansässig ist. |
| Diesen Textbaustein bzw. die dort standardmäßig hinterlegte URL https://www.gesetze-bayern.de/Content/Document/BayKVzKG/true muss nur dann geändert werden, wenn Ihre Waffenbehörde nicht im Freistaat Bayern ansässig ist. |
| Dieser Textbaustein ist anzupassen, falls Sie die Antragsstrecken über die Bündelungskomponente einbinden. Hierbei der Platzhalter “[...]“ durch den Namen Ihres Landkreises/ Ihrer Stadt zu ersetzen. Die Änderung wird nach der Speicherung in den Titel der Bündelungskomponente übertragen. |
| Hiermit können Sie den Hintergrund der Bündelungskomponente bei Bedarf farblich anpassen. |
| Hiermit können Sie die Buttons der Bündelungskomponente bei Bedarf farblich anpassen. |
| Hiermit können Sie den Text der Bündelungskomponente bei Bedarf farblich anpassen. |
Um Texte von einem Online-Dienst in andere Online-Dienste übertragen zu können, gehen Sie wie folgt vor:
Beschreibung | Screenshot |
---|---|
Um Texte von einem Online-Dienst in andere Online-Dienste übertragen zu können, gehen Sie wie folgt vor:
|
|
Nach dem erfolgreichen Versand eines Antrags erhalten Ihre Bürgerinnen und Bürger eine automatisiert Bestätigungs-Mail mit einem definierten Standard-Text. Folgender Screenshot zeigt dies exemplarisch:
Die Texte müssen nicht zwangsläufig bearbeitet werden. Diesen können Sie optional anpassen, in dem Sie in der Textbearbeitung im OZG Service Management folgende Parameter bearbeiten:
Der Text muss für jede Antragsstrecke angepasst werden, kann aber wie beschrieben auf alle anderen Antragsstrecken mit wenigen Klicks übertragen werden.
4f. Konfiguration von Pflichtfeldern
Die Antragsstrecken der eWaffe werden standardmäßig mit optionalen und Pflichtfeldern ausgeliefert. Sie können mithilfe des OZG Service Managements bei Bedarf optionale Felder in Pflichtfelder umwandeln.
Beschreibung | Screenshot |
---|---|
Öffnen Sie das OZG Service Management und navigieren Sie zum Übersichtsbereich Ihrer Kommune.
|
|
|
|
5. Antragsstrecken auf Website einbinden
Die Antragsstrecken werden über die Website der antragsbearbeitenden Stelle als Web Component auf der im Self-Service-Ticket angegebenen Domain des Mandanten (Gebietskörperschaft / Polizeibehörde) eingebunden. Dies sollte über die für die Website zuständigen Personen (z.B. Webmaster) erfolgen. Die Einbettung über Web Components ermöglicht eine nahtlose Integration durch responsives Design, Individualisierung der Texte im Antrag, Design-Anpassungen (bspw. Logo, Farben) sowie das Ein-/Ausblenden von Anzeigeelementen. Die technische Einbindung erfolgt gemäß der https://digitale-verwaltung-as-a-service.de/get-started-now/.
Der Link https://digitale-verwaltung-as-a-service.de/get-started-now/ ist sehr wichtig für die technische Einbindung. Speichern Sie sich diesen am besten ab.
5a. Einbindung einzelner Antragsstrecken
In dem folgenden ausklappbaren Codeauszug finden Sie ein Beispiel für die Einbindung der Antragsstrecke “Erteilung grüne WBK als einzelne Person mit der dem technischen Titel “ewaffe-gruene-wbk-person-erteilung” für die PRO-Umgebung (s.o. Tabelle im 1. Kapitel) . Die hervorgehobenen Teile des Codes sind dienst (Dienstname)- und mandantenspezifisch (AGS) auf deren gewünschte Umgebung (bevorzugt auf PRO) anzupassen. Zusätzlich steht Ihnen die Verwendung des Potleitzahlen-Checks zur Überprüfung der örtlichen Zuständigkeit Ihrer Behörde optional zur Verfügung.
Für die Einbindung anderer Antragsstrecken wie z.B. der “Roten WBK für Sammler und Sachverständige” ist der hier angegebene Dienstname durch den “technischen Titel” der Antragsstrecke auf dem OZG Service Management zu ersetzen. Nähere Informationen zu den technischen Titeln der einzelnen Antragsstrecken können Sie der Tabelle im 1. Kapitel entnehmen.
5b. Einbindung mehrerer Antragsstrecken über die Bündelungskomponente eWaffe
5ba. Beispiel minimale Einbindung
In dem folgenden ausklappbaren Codeauszug finden Sie ein Beispiel für die minimale Einbindung der “Bündelungskomponente eWaffe” mit der dem technischen Diensttitel “ewaffe-buendelungskomponente” für die PRO-Umgebung. Die hervorgehobenen Teile des Codes sind verpflichtend mandantenspezifisch (AGS) auf den gewünschte Umgebung (bevorzugt auf PRO) anzupassen.
5bb. Beispiel erweiterte Einbindung
In dem folgenden ausklappbaren Codeauszug finden Sie ein Beispiel für die erweiterte Einbindung der “Bündelungskomponente eWaffe” mit der dem technischen Diensttitel “ewaffe-buendelungskomponente” für die PRO-Umgebung. Die hervorgehobenen Teile des Codes sind optional konfigurierbar- und verpflichtend mandantenspezifisch (AGS) auf den gewünschte Umgebung (bevorzugt auf PRO) anzupassen.
5c. Nutzerkonto
Grundsätzlich sind die Online-Dienste über die BundID sowie die BayernID verwendbar. Über die Einbindung weiterer Nutzerkonten der Länder wird im Einzelfall entschieden.
5d. Support
Über den Integrationsleitfaden hinaus bieten unsere FAQs weitere nützliche Informationen. Sollten Sie Hilfestellung benötigen, können Sie Ihre Fragen künftig über ein sog. “Support-Ticket” an das Rollout-Team des OZG-Umsetzungsprojekts eWaffe richten. Dieses können Sie unter folgenden Link aufrufen und ausfüllen.
Für eine zügige Fehleranalyse empfehlen wir bei technischen Support-Anfragen folgende Informationen anzugeben:
Kurze Beschreibung des Fehlers
Fehlerzeitpunkt
Links auf Produktions- und Testumgebung
Verwendeter Browser und Browserversion
Verwendetes Betriebssystem
Screenshots (Fehlermeldung und Details, HTML)
Für Fragen und Probleme mit Ihrem Fachverfahren wenden Sie sich bitte direkt an Ihren Hersteller.
5c. Änderungshinweise zu Antragsstrecken
Bitte beachten Sie, dass ggf. technisch oder fachlich bedingte Änderungen an den Antragsstrecken durch die AKDB vorgenommen werden. Durch die zentrale Bereitstellung der Antragsstrecken sind Änderungen direkt für Sie wirksam. Hier können Sie die aktuellen Änderungshinweise einsehen: https://digitale-verwaltung-as-a-service.de/dienste-demos/ .
6. Datenschutz
Mit Inkrafttreten des Gesetzes zur Änderung des Onlinezugangsgesetzes - OZGÄndG („OZG 2.0“) wurde eine zentrale, datenschutzrechtliche Verantwortung der den Onlinedienst betreibenden Behörde normiert (§ 8a Abs. 4 OZG n.F.).
Aufgrund dieser gesetzlichen Änderung ist eine Unterzeichnung einer datenschutzrechtlichen Vereinbarung zur Auftragsverarbeitung durch die jeweils einzelnen (kommunalen) Behörden nicht mehr notwendig. Das Bayerische Staatsministerium für Digitales (StMD) übernimmt als betreibende Behörde ab sofort für den EfA-Online-Dienst „eWaffe“ die zentrale datenschutzrechtliche Verantwortung.
Zur Nachvollziehbarkeit von Datenflüssen und Funktionalitäten des Online-Dienst, steht das Datenschutzkonzept inkl. Anlagen im Downloadbereich der Nachnutzungsplattform zur Verfügung. Das gesamte Datenschutzkonzept inkl. Anlagen stellen wir gerne auf Nachfrage zur Verfügung.
7. Antragsstrecken und Nachrichtenzustellung testen
Nach der Einrichtung des Online-Dienstes sollte die Funktion der Webseiten-Einbindung sowie die Zustellung der Antragsdaten an das Fachverfahren getestet werden.
Wichtig ist, die entsprechenden Funktionen im Online-Dienst auszuwählen und zu testen, ob die zur Beurteilung des erwarteten Verhaltens des Online-Dienstes geeignet sind. Für die durchzuführenden Tests werden folgende Webbrowser empfohlen, durch die > 95 % der Serviceanfragen abgedeckt werden: Google Chrome, Firefox, Safari, Microsoft Edge, Opera. Die Verwendung anderer Webbrowser kann zu Fehlermeldungen und verringerter Nutzerfreundlichkeit führen. Dies gilt sowohl für Desktop- als für auch Mobile-Browser.
Unterstützend können Sie die folgenden Anwendungsfälle für den Test der Antragsstrecken des Online-Dienstes “waffenrechtliche Erlaubnisse” verwenden. Im Fehlerfall kommunizieren Sie diesen bitte wie gewohnt über Ihr Self-Service-Ticket.
8. Go-live und Bekanntgabe des Produktiv-Links
Bitte informieren Sie uns per E-Mail an eWaffeService@akdb.de über den Go-Live (=Einbindung auf Ihrer Produktiv-Webseite) und geben den Produktiv-Link zur Antragsstrecke bekannt.
8a. Abschluss des Rollouts und weiteres Vorgehen im Betrieb
Mit der Meldung des Go-Live mindestens einer Antragsstrecke ist der Rollout des Online-Dienstes abgeschlossen. Von nun an werden fachliche wie technische Anfragen bzgl. aktiv genutzer Antragsstrecken vom AKDB Kundenservice über das Kundenportal AKDB entgegengenommen und bearbeitet.
Sollte in Ihrer Behörde noch kein Admin-Account für das Portal eingerichtet vorliegen, wird der von Ihnen genannten technische Ansprechpartner automatisch von uns als Admin hinterlegt. Dieser Ansprechpartner erhält dazu innerhalb von 5 Werktage automatisch eine Informationsmail zur Einführung in das Kundenportal AKDB.
Sofern in Ihrer Behörde bereits ein Admin-Zugang besteht, informieren wir Sie in unser abschließenden E-Mail an wen Sie sich konkret hausintern wenden können. Diese Person kann für Sie einen Zugang im Kundenportal der AKDB anlegen.
8b. Auffindbarkeit im Landes- und Bundesportal
Zu guter Letzt müssen die Informationen über die neuen Online-Dienste der Waffenbehörde über das Verwaltungsportal des Landes zugänglich gemacht werden, damit sie an den Portalverbund weitergegeben und auch über das Bundesverwaltungsportal aufgerufen werden können.
Dazu muss die Waffenbehörde eine Person der eigenen Behörde beauftragen, die für die Pflege im Verwaltungsportal des Landes bzw. der Internetseite der Behörde verantwortlich ist, die Informationen (z. B. im Redaktionssystem des Verwaltungsportal des Landes) zu pflegen bzw. bereit zu stellen. Dieser Person müssen Informationen je Online-Dienst (vor allem: Bezeichnung/Titel, kurze Beschreibung was online erledigt werden kann, URL direkt zum Online-Dienst sowie Informationen zur Identifizierung, Online-Zahlungsweise und Sprache neben Deutsch) sowie der Leistungsschlüssel der Leistung, der der Online-Dienst zugeordnet werden muss, mitgeteilt werden.
8c. Erstellung von Deeplinks im Rahmen der Bündelungskomponente zur Eintragung in das Landesportal
Aufbau der Deeplinks
Grundsätzlich bestehen Links aus einer führenden URL - z.B. der Webseiten-URL Ihrer Behörde. Dies kann je nach Konfiguration aus “www.“ “https://“ oder einer Kombination dessen bestehen. Sind auf dieser URL weitere Unterseiten vorhanden, sind diese gewöhnlich durch ein “/“ von der URL und untereinander getrennt.
Durch ein “#“ markiert wird ein Online-Dienst - in Beispiel unten die Bündelungskomponente eWaffe - auf der Unterseite der URL referenziert.
https://digitale-verwaltung-as-a-service.de/dienste-demos/ewaffe-buendelungskomponente.html#/
Erstellung der Deeplinks für Ihre Einbindung
Basierend auf dem oben beispielhalft erläuterten Link, werden die Schritte zur Erstellung der Deeplinks innerhalb einer eingebundenen Bündelungskomponente erläutert.
Beschreibung | Abbildung |
---|---|
Aufruf der Übersichtsseite der Bündelungskomponente Link: https://digitale-verwaltung-as-a-service.de/dienste-demos/ewaffe-buendelungskomponente.html#/ |
|
Hinzufügung der Referenz auf den konkreten Online-Dienst innerhalb der Bündelungskomponente
Link (Bspl. grüne WBK): https://digitale-verwaltung-as-a-service.de/dienste-demos/ewaffe-buendelungskomponente.html#ewaffe-gruene-wbk-person-erteilung |
|
Kopieren des Links und Test in einem anderen Browser(-fenster)
|
9. Optionale Funktionen der Antragsstrecken
Im Folgenden werden optionale Funktionen ihrer Antragsstrecken genannt, die für die Funktionalität nicht verpflichtend zu konfigurieren sind, welche aber eine sinnvolle technische und fachliche Ergänzung zu den Basisfunktionalitäten darstellen.
9a. Postleitzahlen-Check (PLZ-Check)
9b. Mehrsprachigkeit
Der Online-Dienst kann zu einem späteren Projektzeitpunkt mehrsprachig angeboten werden. Gemäß der Anleitung auf der Entwicklungsplattform “Digitale Verwaltung as a Service” kann dann das Attribut “language selection” genutzt werden.