25
Freiburger Einwohnermeldeamtsabgleich (FREMA) Eine Software für die Tumorzentren und Onkologischen Schwerpunkte Baden-Württembergs Benutzerhandbuch Verfasser: Jan Friedrich Barleben Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner: Dr. med. Martin Boeker Geschäftsbereich Krebsregister und IT Tel.: +49 (0)761 203 6700 Vera Gumpp Klinisches Krebsregister Tel.: +49 (0)761 270 33021 Jan Friedrich Barleben IT-Entwicklung Tel.: +49 (0)761 270 33020 Aktueller Stand: 09.07.2015

Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Freiburger Einwohnermeldeamtsabgleich (FREMA)

Eine Software für die Tumorzentren und Onkologischen Schwerpunkte Baden-Württembergs

Benutzerhandbuch

Verfasser : Jan Friedrich Barleben

Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg

Ansprechpartner: Dr. med. Martin Boeker Geschäftsbereich Krebsregister und IT Tel.: +49 (0)761 203 6700 Vera Gumpp Klinisches Krebsregister Tel.: +49 (0)761 270 33021 Jan Friedrich Barleben IT-Entwicklung Tel.: +49 (0)761 270 33020

Aktueller Stand: 09.07.2015

Page 2: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 2 von 25

Inhalt 1 Softwarebeschreibung .................................................................................................... 4

2 Voraussetzungen für den Meldeamtsabgleich mit FREMA ............................................. 4

2.1 Freischaltung und Zugang zur MeldIT-Batchschnittstelle......................................... 4

Beantragung von Zugangsdaten ...................................................................... 4 2.1.1

Whitelisting der IP-Adresse des zugreifenden Rechners .................................. 4 2.1.2

2.2 Technische Voraussetzungen ................................................................................. 4

Ausstattung des zugreifenden Rechners .......................................................... 4 2.2.1

Internetzugriff ................................................................................................... 5 2.2.2

Datenbankverwaltung ....................................................................................... 5 2.2.3

Codeverwaltung ............................................................................................... 5 2.2.4

2.3 Testphase / Pilotbetrieb ........................................................................................... 6

3 Programmaufruf ............................................................................................................. 6

3.1 Konfigurationseinstellungen .................................................................................... 6

Beispiel: Verschlüsselter Proxy-Zugriff ............................................................. 7 3.1.1

4 Programmaufruf: ............................................................................................................ 8

4.1 Grafische Benutzeroberfläche ................................................................................. 8

4.2 Kommandozeilenaufruf ........................................................................................... 8

Zulässige Parameterwerte................................................................................ 9 4.2.1

Beispiele .........................................................................................................10 4.2.2

Importieren von Anfragen im CSV-Format: ....................................................................10

Senden von synchronen Anfragen: ...............................................................................10

Senden von asynchronen Anfragen:..............................................................................10

Abfragen aller offenen Aufträge: ....................................................................................10

Abfragen von vorhandenen Aufträgen mittels Auftragsnummer: ....................................10

Abfragen von vorhandenen Aufträgen mittels Auftragsnummern im XML-Format: .........11

Exportieren aller Datenbanktabellen im CSV- und XML-Format: ...................................11

Exportieren der Exporttabellen im CSV-Format: ..............................................11 4.2.3

Exportieren der Exporttabellen im XML-Format ...............................................11 4.2.4

Zurücksetzen der Datenbank.........................................................................................11

5 Programmablauf ............................................................................................................12

5.1 CSV-Import ............................................................................................................12

5.2 Aktualisierung von Importdaten ..............................................................................15

5.3 Wiederholungsabfragen .........................................................................................15

Page 3: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 3 von 25

5.4 Archivierung der XML-Anfragen .............................................................................15

xml_export ......................................................................................................15 5.4.1

5.5 Speicherung der Abfrageergebnisse ......................................................................15

6 Fehleranalyse / Validierung ..........................................................................................15

6.1 Logging der Fehler- und Statusmeldungen .............................................................15

6.2 Transaktionssicherheit von EMA-Anfragen .............................................................16

6.3 Validierung von EMA-Anfragen ..............................................................................16

7 Anhang ..........................................................................................................................16

7.1 Datenbanktabellen der SQLite-Datenbank vitalstatusabgleich.db3 .........................16

Tabelle: auftraege ...........................................................................................16 7.1.1

Tabelle: auftragsverwaltung ............................................................................17 7.1.2

Tabelle: auskunft_antworten ...........................................................................17 7.1.3

Tabelle: coderegister .......................................................................................17 7.1.4

Tabelle: codes .................................................................................................18 7.1.5

Tabelle: codes_staaten ...................................................................................18 7.1.6

Tabelle: codes_staatsangehoerigkeit ..............................................................18 7.1.7

Tabelle: export_adressen ................................................................................19 7.1.8

Tabelle: exporttabelle_zusatzinfos ..................................................................19 7.1.9

Tabelle: fehlerhafte_anfragen ..........................................................................19 7.1.10

Tabelle: exporttabelle ......................................................................................20 7.1.11

Tabelle: Importtabelle ......................................................................................21 7.1.12

Tabelle: korrekte_anfragen..............................................................................21 7.1.13

Tabelle: xml_antworten ...................................................................................21 7.1.14

Tabelle: importtabelle_archiv ...........................................................................22 7.1.15

7.2 Settings.xml............................................................................................................23

7.3 Verwendete MeldIT-XML-Schemata .......................................................................23

7.4 Software-Lizenzvertrag ..........................................................................................24

Page 4: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 4 von 25

1 Softwarebeschreibung

Die Freiburger Software für den EMA-Abgleich (Vorläufiger Projektname: FREMA) setzt auf der Batchverarbeitungskomponente von MeldIT auf und ermöglicht die automatisierte Abfrage von Meldeamtsdaten von der Datenzentrale Baden-Württemberg (DZBW). FREMA wird seit Ende 2014 vom Klinischen Krebsregister Freiburg entwickelt und kann allen interessierten Tumorzentren und Onkologischen Schwerpunkten Baden-Württembergs auf Anfrage kostenlos zur Verfügung gestellt werden.

Die detaillierte Schnittstellenbeschreibung zum Meldeamtsabgleich ist der MeldIT-Spezifikation zur Batchverarbeitung V. 2 zu entnehmen.

FREMA wurde mit der Programmiersprache C# für das .NET-Framework 4.5 von Microsoft entwickelt und verfügt ab Version 1.0 über eine Grafische Benutzeroberfläche. Daneben kann das Tool auch direkt über die Kommandozeile ausgeführt werden.

2 Voraussetzungen für den Meldeamtsabgleich mit FREMA Damit FREMA fehlerfrei arbeiten kann, sollten die nachfolgenden Voraussetzungen erfüllt werden. Das Tumorzentrum Freiburg weist darauf hin, dass es zu unerwarteten Problemen und Programmabstürzen kommen kann, wenn die nachfolgenden Voraussetzungen nicht erfüllt sind.

2.1 Freischaltung und Zugang zur MeldIT-Batchschnit tstelle Um die MeldIT-Batch-Schnittstelle über den EMA-Webdienst nutzen zu können, benötigen Sie einen kostenpflichtigen Zugang.

Beantragung von Zugangsdaten 2.1.1

Ihre Zugangsdaten erhalten Sie auf Anfrage von der KIVBF. Bitte beachten Sie, dass das Anlegen eines neuen Benutzeraccounts mit einmaligen Einrichtungsgebühren verbunden ist. Ihr Ansprechpartner ist Herr Sebastian Amberger.

Whitelisting der IP-Adresse des zugreifenden Rechne rs 2.1.2

Der EMA-Webdienst ignoriert Anfragen von unbekannten Dienstkonsumenten. Es ist daher notwendig, die externe IP-Adresse des zugreifenden Rechners in eine Whitelist eintragen zu lassen.

2.2 Technische Voraussetzungen

Ausstattung des zugreifenden Rechners 2.2.1

Vorausgesetzt wird ein aktueller PC mit Windows-Betriebssystem (z.B. Windows 7), .NET-Framework 4.5 und Internetzugriff. Eine Server-Architektur wird nicht benötigt.

Page 5: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 5 von 25

Internetzugriff 2.2.2

Proxy-Einstellungen für den Internetzugriff können in der Konfigurationsdatei settings.xml, die der Meldeamtssoftware beiliegt, eingetragen werden.

Datenbankverwaltung 2.2.3

Als Datenbank kommt eine relationale SQLite-Datenbank zum Einsatz. Die SQLite-Datenbank liegt der Meldeamtssoftware bei und kann vom Anwender selbst verwaltet werden. Das CCCF empfiehlt hierfür den Einsatz des Freeware-Tools SQLiteAdmin:1

Codeverwaltung 2.2.4

FREMA liegt bereits eine Sammlung von Nachschlagelisten bei, die zum Kodieren und Dekodieren von Feldwerten nach Vorgabe der MeldIT-Spezifikation benötigt werden. Aktuelle Nachschlagelisten können kostenlos über die Datenbanken des Statistischen Bundesamts bezogen werden.

1 http://sqliteadmin.orbmu2k.de/

Page 6: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 6 von 25

Vor dem ersten Meldeamtsabgleich müssen die XML-Nachschlagelisten in die SQLite-Datenbank geladen werden. Dieser Vorgang muss nur durchführt werden, wenn die Datenbanktabellen coderegister, codes, codes_staaten oder codes_staatsangehoerigkeit noch keine Einträge enthalten.

Um die Nachschlagelisten in der Datenbank zu aktualisieren, wechseln Sie in das Programmverzeichnis und starten Sie die Meldeamtssoftware wie folgt:

ServiceStarter.exe -a=codeimport

Die betroffenen Datenbanktabellen werden vor dem Import der Nachschlagelisten automatisch zurückgesetzt.

2.3 Testphase / Pilotbetrieb

Vor dem Produktivbetrieb ist eine Testphase zu durchlaufen. Diese muss individuell mit der Datenzentrale Baden-Württemberg abgestimmt werden. Ansprechpartner ist Herr Sebastian Amberger von der KIVBF.

Da während der Testphase noch keine Gebühren anfallen, sollten Sie den Meldeamtsabgleich so ausführlich wie möglich mit unterschiedlichen Anfragevarianten testen. Das KIVBF kann Ihnen eine CSV-Liste mit Beispielanfragen zur Verfügung stellen.

3 Programmaufruf

3.1 Konfigurationseinstellungen

Es ist sinnvoll, Konfigurationseinstellungen, die sich nicht häufig ändern, in der Konfigurationsdatei „settings.xml zu hinterlegen, damit diese nicht bei jedem Programmstart erneut angegeben werden müssen. Die Datei settings.xml befindet sich im Programmverzeichnis der serviceStarter.exe und kann in jedem beliebigen Texteditor bearbeitet werden. Alternativ können Sie die Einstellungen auch direkt über Grafische Benutzeroberfläche anpassen. Die Kommandozeilenvariante von FREMA wird über ServiceStarter.exe aufgerufen.

Page 7: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 7 von 25

In manchen Fällen ist es sinnvoll, Einstellungen der settings.xml über die Kommandozeile zu setzen.

Beispiel: Verschlüsselter Proxy-Zugriff 3.1.1

Programmaufruf:

ServiceStarter.exe –phost=10.0.0.1 –pusr=testuser – ppwd=123 –pcrypt=true

Ergebnis: Auszug aus der settings.xml mit verschlüsseltem Passwort-Eintrag

… <proxy_hostname>10.0.0.1</proxy_hostname> <proxy_usr>testuser</proxy_usr> <proxy_pwd>+Ng9/XhtAfSrUKvV8U0mDg==</proxy_pwd> <proxy_encryption>true</proxy_encryption>

Page 8: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 8 von 25

4 Programmaufruf :

4.1 Grafische Benutzeroberfläche

FREMA (> V.1.0) besitzt eine Grafische Benutzeroberfläche, die über die Datei FREMA.exe gestartet werden kann. Über eine Auswahlliste können unterschiedliche Aktionen (z.B. das Senden neuer Anfragen) auswählt werden.

4.2 Kommandozeilenaufruf

serviceStarter.exe […]

[-a=@Aktion ] [-m=@Kommunikationsmethode ] [-e=@Exportformat ] [-o =@Auftragsnummern ] aa=@Auskunftsart ][-k=@Kunde ][-dl=@Dienstleister ][-wl=@Weiterleitung ][-icsv=@ImportCSVPfad ][-acsv=@CSVImportArchivPfad ][-ecsv=@ExportPfad ][-cd=@CSV-Trennzeichen ][-phost=@Proxy-Host ][-pusr=@Proxy-User ][-ppwd=@Proxy-Passwort ][-pcrypt=@Proxy-Passwort-Verschlüsselung ][-pport=@ProxyPort ][-pporttls=@Proxy-TLS-Port ][-srv=@Service ][-srvusr=@Service-User ][-srvpwd=@Server-Passwort ][-srvcrypt=@Service-Passwort-Verschlüsselung ][-?]

Page 9: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 9 von 25

Zulässige Parameterwerte 4.2.1

@Aktion send|request|csvimport|setproxy|setservice|codeimport|resetdb|exportdb|updatesettings

@Kommunikationsmethode sync|async @Exportformat all|xml|csv @Auftragsnummern Verkettete Liste: Nr1, Nr2, … @Auskunftsart Auskunftsart als Zeichenfolge. Überschreibt den

zugehörigen Eintrag in der settings.xml @Kunde Kunde als Zeichenfolge. Überschreibt den zugehörigen

Eintrag in der settings.xml @Dienstleister Dienstleister als Zeichenfolge. Überschreibt den

zugehörigen Eintrag in der settings.xml @Weiterleitung a

Wird die Weiterleitung nicht über einen Parameter angegeben, gilt für den Programmablauf Weiterleitung=keineweiterleitung, bei „a“ Weiterleitung=weiterleitungautomatisch

@ImportCSVPfad Gibt den Dateipfad zum Importverzeichnis an, in dem sich die CSV-Dateien befinden. Überschreibt den zugehörigen Eintrag in der settings.xml

@CSVImportArchivPfad Gibt den Dateipfad zum Archivverzeichnis der bereits eingelesenen CSV-Dateien an. Überschreibt den zugehörigen Eintrag in der settings.xml

@ ExportPfad Gibt den Dateipfad zum Exportverzeichnis an. Überschreibt den zugehörigen Eintrag in der settings.xml

@CSV-Trennzeichen Gibt das CSV-Trennzeichen, das beim Einlesen und Exportieren von CSV-Dateien verwendet werden soll. Überschreibt den zugehörigen Eintrag in der settings.xml

@Proxy -Host Gibt den Proxy-Host (z.B. eine IP-Adresse) des Proxy-Servers an. Wird benötigt, wenn sich der Rechner hinter einer Firewall befindet. Überschreibt den zugehörigen Eintrag in der settings.xml

@Proxy -User Gibt den Proxy-Benutzer an. Überschreibt den zugehörigen Eintrag in der settings.xml

@Proxy -Passwort Gibt das Proxy-Passwort an. Wenn das Passwort verschlüsselt gespeichert werden soll, muss zusätzlich die Proxy-Passwort-Verschlüsselung aktiviert sein. Überschreibt den zugehörigen Eintrag in der settings.xml

@Proxy -Passwort -Verschlüsselung

true|false

@ProxyPort Gibt den Proxy-Port an (z.B. 80). Überschreibt den zugehörigen Eintrag in der settings.xml

@Proxy-TLS-Port Gibt den Proxy-TLS-Port an (z.B. 80). Überschreibt den zugehörigen Eintrag in der settings.xml

@Service Enthält den URI des EMA-Webdienstes. Überschreibt den zugehörigen Eintrag in der settings.xml

@Service -User Setzt den Benutzernamen für die Authentifizierung von Anfragen beim Webdienst. Überschreibt den zugehörigen Eintrag in der settings.xml

@ Server -Passwort Setzt das Passwort für die Authentifizierung von Anfragen beim Webdienst. Wenn das Passwort verschlüsselt gespeichert werden soll, muss zusätzlich die Service-

Page 10: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 10 von 25

Passwort-Verschlüsselung aktiviert sein. Überschreibt den zugehörigen Eintrag in der settings.xml

@Service -Passwort -Verschlüsselung

true|false

-? Zeigt die Hilfe an

Beispiele 4.2.2 Viele der folgenden Beispielabfragen liegen der Software zusätzlich als .bat-Dateien bei, die direkt über die Kommandozeile ausgeführt werden können.

Importieren von Anfragen im CSV-Format:

ServiceStarter.exe -a=csvimport

Liest die CSV-Dateien ein und speichert die darin enthaltenen Suchprofile in der Importtabelle. Unbearbeitete Suchprofile mit identischen Identifiern werden automatisch überschrieben.

Senden von synchronen Anfragen:

ServiceStarter.exe -a=send -m=sync

Übermittelt alle Suchprofile aus der Importtabelle synchron an den EMA-Webdienst. Die Abfrageergebnisse stehen direkt im Anschluss zur Verfügung.

Senden von asynchronen Anfragen:

ServiceStarter.exe -a=send -m=async

Übermittelt alle Suchprofile aus der Importtabelle asynchron an den EMA-Webdienst. Die Suchprofile werden automatisch in Pakete mit bis zu 1500 Einzelanfragen zusammengefasst. Zu jedem Paket wird ein Auftrag mit Quittung gespeichert.

Abfragen aller offenen Aufträge:

ServiceStarter.exe -a=request

Frägt alle asynchronen Pakete vom EMA-Webdienst ab, die noch nicht vollständig an den Kunden übermittelt wurden.

Abfragen von vorhandenen Aufträgen mittels Auftrags nummer:

ServiceStarter.exe -a=request -o=9429,9431

Frägt die Aufträge mit den Auftragsnummern 9429 und 9431 asynchron vom EMA-

Page 11: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 11 von 25

Webdienst ab. Ob die zugehörigen Pakete bereits zuvor vollständig an den Kunden übermittelt wurden, spielt dabei keine Rolle.

Abfragen von vorhandenen Aufträgen mittels Auftrags nummern im XML-Format:

ServiceStarter.exe -a=request -oxml="C:\csv\export\auftraege_2015-03-20T122825.xml"

Öffnet die angegebene Export-XML-Datei und extrahiert die darin enthaltenen Auftragsnummern. Pro Auftragsnummer wird anschließend eine asynchrone Abfrage an den EMA-Webdienst gestellt.

Exportieren aller Datenbanktabellen im CSV- und XML -Format:

ServiceStarter.exe -a=exportdb -e=all

Exportiert alle nicht leeren Datenbanktabellen im CSV- und XML-Format in das Exportverzeichnis.

Exportieren der Exporttabellen im CSV-Format: 4.2.3

ServiceStarter.exe -a=exportdb -e=csv

Führt einen CSV-Export der gespeicherten Abfrageergebnisse in das Exportverzeichnis durch.

Exportieren der Exporttabellen im XML-Format 4.2.4

ServiceStarter.exe -a=exportdb -e=xml

Führt einen XML-Export der gespeicherten Abfrageergebnisse in das Exportverzeichnis durch.

Zurücksetzen der Datenbank

ServiceStarter.exe -a=resetdb

Setzt die Datenbank komplett zurück. Alle Datenbanktabellen werden geleert.

Page 12: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 12 von 25

5 Programmablauf Die folgende Tabelle enthält eine Übersicht über alle verwendeten Identifier. Sie dient dazu, den Programmablauf besser nachvollziehen zu können:

Identifier Datentyp Woher? Wo anzugeben? Zeichennachricht String, max. 20

Zeichen Kundenangabe CSV-Importdatei

Zeichensuchprofil String, max. 50 Zeichen

Kundenangabe CSV-Importdatei

Interne_Patid_kunde 64 Bit Integer, max. 20 Dezimalstellen

Kundenangabe CSV-Importdatei

Auftragsnummer 64 Bit Integer, max. 20 Dezimalstellen

DZBW Programmaufruf (fakultativ)

Auftragspositionsnummer Zahl zwischen 1 und 1500

DZBW -

5.1 CSV-Import Vor dem Meldeamtsabgleich müssen die Anfragen mittels CSV-Schnittstelle in die Datenbank übertragen werden.

Die Anzahl der einzulesenden CSV-Dateien ist nicht beschränkt. Eine Stückelung in Einzelpakete ist nicht notwendig. Die Importdateien müssen eine der vorgegeben Dateiendungen „csv“ oder „txt“ besitzen. Die Groß- und Kleinschreibung spielt dabei keine Rolle, Umlaute sollten jedoch ersetzt werden. Es wird empfohlen, den Dateinamen mit einem Zeitstempel o.ä. zu kombinieren.

Unterstützt werden alle CSV-Dateien mit Spaltenbezeichnungen in der ersten Zeile. Das verwendete Trennzeichen kann in der settings.xml angegeben werden. Die CSV-Dateien müssen die UTF-8-Zeichenkodierung unterstützen und wie folgt aufgebaut werden, wobei die Reihenfolge der einzelnen Felder frei gewählt werden kann. Die Felddefinitionen der nachfolgenden Tabelle wurden größtenteils der XMeld-Spezifikation zur Batch-Schnittstelle entnommen:

Spaltenbezeichner Datentyp Erläuterungen adr_gemeindeschluessel_schluessel

String(8) Jede Gemeinde führt zur eindeutigen Identifizierung einen amtlichen Gemeindeschlüssel (AGS). Der AGS wird von den Statistischen Landesämtern festgelegt und von den Statistischen Landesämtern und dem Statistischen Bundesamt herausgegeben. Von dem AGS kann bisher neben der Gemeinde das Bundesland, der Regierungsbezirk und der Landkreis abgeleitet werden.

Page 13: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 13 von 25

Es wird der AGS der Gemeinde abgebildet, in der die Wohnung der (natürlichen) Person liegt.

adr_hausnummer Integer Es wird die Hausnummer der Anschrift abgebildet, in der die Wohnung der (natürlichen) Person liegt. Es sind nur die Ziffern der Hausnummer zulässig.

adr_hausnummerbuchstabezusatzziffer

String(2) Es sind Buchstaben oder Zusatzziffern zur Hausnummer anzugeben (vgl. auch DSMeld Blatt 1208; Beispiele: 124 A, 109.5).

adr_postleitzahl String(5) Jeder Gemeinde ist (sind) eine (oder mehrere) Postleitzahl(en) zugeordnet. Die Postleitzahl unterstützt die maschinelle Verteilung / Zustellung bei der Deutschen Post AG. Die Zuordnung einer Postleitzahl ist nicht davon abhängig, dass der Ort auch tatsächlich eine 'Gemeinde' ist. Auch Ortschaften / Dörfer, die keinen eigenständigen Gemeindestatus besitzen, können eine Postleitzahl führen. Insoweit ist der Eintrag im Postleitzahlenverzeichnis nicht identisch mit dem amtlichen Gemeindeverzeichnis. Die Postleitzahl wird durch die Deutsche Post AG festgelegt / herausgegeben. Es wird die für die Wohnung der (natürlichen) Person gültige Postleitzahl in der Gemeinde abgebildet.

adr_strasse String(25) Es wird der Straßenname abgebildet, in der die Wohnung der (natürlichen) Person liegt. Eine sinnvoll gekürzte Straßenbezeichnung ist zulässig. Ein Straßenname muss nicht zwingend vorhanden sein. Ist keine Straßenbezeichnung wohl aber eine Hausnummer vorhanden, so ist Hausnummer anzugeben. Sind weder eine Straßenbezeichnung noch Hausnummer vorhanden, so ist ohne Hausnummer anzugeben.

adr_wohnort String(50) Es wird der Wohnort (Gemeindename) abgebildet, in der die Wohnung der (natürlichen) Person liegt.

anzahlzudurchsuchendegemeinden

Integer Der Wert 0 gibt an, dass keine Einschränkung bzw. Kostenobergrenze vorliegt.

familienname String(60) Der aktuelle Familienname. Familienname kann sein der Geburtsname, der gemeinsam bestimmte Ehename oder Lebenspartnerschaftsname, der Ehename oder der Lebenspartnerschaftsname zusammen mit dem hinzugefügten Begleitnamen.

Page 14: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 14 von 25

geschlecht_schluessel String(1) Eine Instanz dieses Typs kennzeichnet das Geschlecht des Betroffenen. Effektiv: Code des Geschlechts ('m', 'w'); ACHTUNG: 's' und 'x' werden NICHT unterstützt!

interne_patid_kunde Long-Integer (max. 20 Dezimalstellen)

Interne ID (im Normalfall der MPI), die dazu benötigt wird einzelne Anfragen leichter im Export einem bestimmten Patienten zuzuordnen. Diese ID wird nicht an das Melderegister übermittelt.

steuerungsinformation_adresskettenverfolgung

String(5) „true“ oder „false“. Diese Angabe ist zwar eine Pflichtangabe, wird jedoch nicht in MeldIT ausgewertet.

tagdergeburt String(10) Der Tag der Geburt ist in der Reihenfolge Jahr, Monat, Tag anzugeben. Fehlende oder unvollständige Geburtsdaten sind wie folgt anzugeben: fehlende Tages-, Monats- oder Jahresangaben sind jeweils durch Nullen anzugeben. Bei fehlender Monatsangabe wird auch die Tagesangabe durch Nullen angegeben.

vorname String(60) Alle Vornamen sind in der intendierten Reihenfolge in dem Kindelement vorname anzugeben. Dieses Element darf nur fehlen, wenn durch das optionale Element zuRechtNichtVorhanden angezeigt wird, dass ein Vorname zu Recht nicht vorhanden ist.

weiterleitung

„keineweiterleitung“ oder „weiterleitungautomatisch“

wiederholanfrage_auftragsnummer_alteanfrage

Long-Integer Dies ist die Auftragsnummer der (früheren) Antwort des Leistungserbringers, auf die Bezug genommen werden soll.

wiederholanfrage_auftragspositionsnummer_alteanfrage

Integer Mit diesem Zuordnungsmerkmal kann eine bestimmte Auftragsposition eines früheren Auftrages eindeutig identifiziert werden.

wiederholung String(1) 'n' oder 'j' zeich ennachricht String(20) Identifier, der die Profilanfragen innerhalb

der Importtabelle / Exporttabelle gruppiert. Beispiel: 28.06.2014-001

zeichensuchprofil String(50) Kundenspezifisches Identifizierungsmerkmal für das Auskunftsersuchen innerhalb der Batchanfrage. Wird im zugeordneten Ergebniselement (siehe Nachricht 0604) wieder zurückgeliefert und erlaubt so die Zuordnung von Auskunftsersuchen und zugehörigem Ergebnis auf der Kundenseite. Vorschlag: Durchnummerierung mit Inkrementierung der aktuellen Zelle um 1 beginnend bei 1

Page 15: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 15 von 25

5.2 Aktualisierung von Importdaten

Alle neuen Suchprofile werden nach dem Einlesen der CSV-Dateien in der Datenbanktabelle importtabelle gespeichert. Hier liegen sie solange, bis sie erfolgreich an den EMA-Service übermittelt wurden. Bereits bearbeitete Suchprofile liegen in der Datenbanktabelle importtabelle_archiv.

CSV-Importanfragen können vor der Übermittlung an das DZBW beliebig oft überarbeitet werden. Veraltete Anfragen werden beim Einlesen aktuellerer Anfragen automatisch über ihre Identifier erkannt und überschrieben.

5.3 Wiederholungsabfragen

Wiederholungsabfragen sind in der aktuellen Programmversion noch nicht implementiert.

Grundsätzlich sollen Wiederholungsanfragen nur für synchrone Anfragen möglich sein. Pro Kalendertag und Auftrag können maximal 2 kostenlose Wiederholungsanfragen gestellt werden. FREMA würde zunächst vor einer Meldung überprüfen, ob die Voraussetzungen für eine Wiederholungsanfrage gegeben sind. Jeder Importdatensatz besitzt einen Zeitstempel, der eine Versionierung der einzelnen Anfragen ermöglicht. Bei Wiederholungsanfragen würde immer der neueste, noch nicht gemeldete Datensatz innerhalb einer Gruppierung nach Zeichennachricht, Zeichensuchprofil und Interner_PatId_kunde berücksichtigt werden.

5.4 Archivierung der XML-Anfragen

Die XML-Anfragen und -antworten des Webdienstes werden in den Datenbanktabellen xml_antworten, fehlerhafte_anfragen und korrekte_anfragen gespeichert und können z.B. für Auswertungen herangezogen werden.

xml_export 5.4.1

XML-Anfragen und -antworten werden nicht in der Datenbank sondern auf Dateiebene in dem Verzeichnis csv/export/xml_export gespeichert.

5.5 Speicherung der Abfrageergebnisse Abfrageergebnisse von Suchanfragen werden direkt in die Exporttabellen geschrieben. Es ist möglich, die Exporttabellen im CSV- oder XML-Format zu exportieren.

6 Fehleranalyse / Validierung

6.1 Logging der Fehler- und Statusmeldungen Fast alle Fehler- und die meisten Statusmeldungen, die während der Programmausführung auftreten, werden in Log-Dateien geschrieben. Die Log-Dateien befinden sich in einem

Page 16: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 16 von 25

Unterordner des Programmverzeichnisses und sind nach Datum gruppiert, damit sie leichter ausgewertet werden können.

6.2 Transaktionssicherheit von EMA-Anfragen

Synchrone Einzelanfragen werden transaktionssicher übermittelt. Sollte FREMA während der Laufzeit unerwartet beendet werden, kann die Datenübertragung beim nächsten Programmstart problemlos fortgesetzt werden.

Asynchrone Anfragen werden paketweise verarbeitet und über Quittungen, die vom DZBW ausgegeben werden, bestätigt. Erst wenn eine gespeicherte Quittung vorliegt, gilt ein Paket als erfolgreich zugestellt. Sollte es zu einem unerwarteten Programmabbruch kommen, gilt es zu überprüfen, ob bereits Quittungen in der Datenbank vorhanden sind oder nicht. Hierzu kann man die Liste der unbearbeiteten Importanfragen mit der Liste der offenen Aufträge abgleichen. Bei Problemen wenden Sie sich bitte direkt an die Datenzentrale Baden-Württemberg.

6.3 Validierung von EMA-Anfragen

Alle EMA-Anfragen werden vor der Übermittlung gegen die MeldIT-XML-Schemata validiert. Treten hierbei Validierungsfehler auf, wird die jeweilige Anfrage im weiteren Meldeprozess ignoriert und stattdessen eine Fehlermeldung ausgegeben.

7 Anhang

7.1 Datenbanktabellen der SQLite-Datenbank vitalsta tusabgleich.db3

Tabelle: auftraege 7.1.1

Page 17: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 17 von 25

Tabelle: auftragsverwaltung 7.1.2

Tabelle: auskunft_antworten 7.1.3

Tabelle: coderegister 7.1.4

Page 18: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 18 von 25

Tabelle: codes 7.1.5

Tabelle: codes_staaten 7.1.6

Tabelle: codes_staatsangehoerigkeit 7.1.7

Page 19: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 19 von 25

Tabelle: export_adressen 7.1.8

Tabelle: exporttabelle_zusatzinfos 7.1.9

Tabelle: fehlerhafte_anfragen 7.1.10

Page 20: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 20 von 25

Tabelle: exporttabelle 7.1.11

Page 21: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 21 von 25

Tabelle: Importtabelle 7.1.12

Tabelle: korrekte_anfragen 7.1.13

Tabelle: xml_antworten 7.1.14

Page 22: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 22 von 25

Tabelle: importtabelle_archiv 7.1.15

Page 23: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 23 von 25

7.2 Settings.xml

7.3 Verwendete MeldIT-XML-Schemata

xmeld_normal.xsd xmeld-nachrichten.xsd xmeld-baukasten.xsd xmeld-basistypen.xsd

Page 24: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 24 von 25

7.4 Software-Lizenzvertrag

Die Benutzung der Software durch Sie, den Anwender, erfolgt ausschließlich zu den nachfolgenden Bedingungen. Wenn Sie die Software oder einzelne Komponenten daraus nutzen, stimmen Sie dadurch diesem Vertrag zu. 1. NUTZUNGSBEDINGUNGEN 1.1 FREEWARE-VERSION Die Tumorzentren und Onkologischen Schwerpunkte Baden-Württembergs haben das Recht, die Freeware-Version der vorliegenden Software kostenlos auf beliebig vielen PCs beliebig lang einzusetzen. Die Freeware-Version darf beliebig kopiert und weitergegeben werden, jedoch nur vollständig und unentgeltlich. Eine Verbreitung der Software auf Datenträgern, Webseiten oder Cloud-Diensten ist den Tumorzentren und Onkologischen Schwerpunkte Baden-Württembergs auch ohne Rücksprache mit dem Rechteinhaber gestattet. Es ist nicht gestattet, die Software in ihrer Funktion oder ihrem Erscheinungsbild zu verändern oder zu übersetzen, zurückzuentwickeln, zu entkompilieren oder zu deassemblieren. Der Autor/Hersteller behält sich das Recht vor, die Software nach eigenem Ermessen zu aktualisieren und neue oder korrigierte Versionen herzustellen. 2. GARANTIE- UND HAFTUNGSAUSSCHLUSS Die Software wurde vom Autor/Hersteller sorgfältig erstellt und getestet sowie vor der Veröffentlichung auf Viren geprüft und wird Ihnen im reinen Ist-Zustand zur Verfügung gestellt. Es wird darauf hingewiesen, dass es nicht möglich ist, Software-Programme so zu entwickeln, dass sie für alle Anwendungsbedingungen fehlerfrei einsetzbar sind. Der Autor/Hersteller garantiert nicht die Eignung der Software für einen bestimmten Anwendungsfall oder eine bestimmte Konfiguration. Der Autor/Hersteller übernimmt keinerlei Haftung oder Gewährleistung für Fehler in der Software und Fehler und Schäden, die sich aus der Nutzung oder Unfähigkeit zur Nutzung der Software ergeben. Dies schließt den Verlust von Geschäftsgewinnen, die Unterbrechung der geschäftlichen Abläufe, den Verlust von Daten sowie alle übrigen materiellen und ideellen Verluste und deren Folgeschäden ein und gilt selbst dann, wenn der Autor/Hersteller zuvor ausdrücklich auf die Möglichkeit derartiger Schäden hingewiesen worden ist. Sie erklären mit der Nutzung der Software Ihr Einverständnis mit den o.g. Nutzungsbedingungen sowie dem Garantie- und Haftungsausschluss. Sollten einzelne Bestimmungen in diesen Bedingungen nichtig, unwirksam oder anfechtbar sein oder werden, so wird hiervon die Wirksamkeit aller sonstigen Bestimmungen oder Vereinbarungen nicht berührt. Die gesamte maximale Haftung ist auf die Registriergebühr beschränkt, sofern Sie eine solche für die Software bezahlt haben. 3. COPYRIGHT

Page 25: Freiburger Einwohnermeldeamtsabgleich (FREMA)...Auftraggeber: Comprehensive Cancer Center Freiburg (CCCF) Klinisches Krebsregister Hugstetter Str. 55 79106 Freiburg Ansprechpartner:

Benutzerhandbuch Freiburger Software für Einwohnermeldeamtsabgleich (FREMA)

Seite 25 von 25

Die vorliegende Software wurde von der Abteilung IT-Entwicklung des Klinischen Krebsregisters des Freiburger Tumorzentrums entwickelt. Der verantwortliche Entwickler ist Jan Friedrich Barleben. Das Copyright © 2015 liegt beim Comprehensive Cancer Center Freiburg (CCCF), Hugstetter Str. 55, 79106 Freiburg im Breisgau. Der Geschäftsführer des CCCF ist Rainer Bredenkamp.