- Allgemeine Informationen -

Transkript

1 Statistisches Bundesamt Erhebungsdatenbank des Bundes und der Länder Datenbankgestützte Verwaltung von Erhebungsidentifikatoren und deren Ressourcen - Allgemeine Informationen - Version: Stand: Status: Freigegeben Kontakt: erhebungsdatenbank@destatis.de

2 Inhaltsverzeichnis: 1 Dokumenthistorie Allgemeines Schnittstellen zur ErhebungsDB Browserbasierte WEB-Schnittstelle WEB-Service-Schnittstelle: eworkflow/automatisierung der Prozesse Aufbau des Erhebungsidentifikators Version der ID Statistikidentifikator Zeitidentifikator (gültig ab BZR) Länderkennzeichen Aufbau des eindeutigen Ressourcenschlüssels Erhebungsidentifikator Ressourcentyp Spezialisierung frei wählbare Spezialisierung teilweise frei wählbare Spezialisierung wählbare Spezialisierung feste Spezialisierung Ressourcenabhängiger Schlüssel "Version der Ressource (4-stellig)": "Zeitidentifikator (6-stellig) + Version der Ressource (4-stellig)": Zusammenfassende Darstellung Version Seite 2 von 11

3 1 Dokumenthistorie Version Stand Erläuterungen Ausprägungen zur Spezialisierung angepasst Neue Ressource mit dem Ressourcentyp 88-Transformation aufgenommen Anpassung der geänderten URL zur externen ErhebungsDB Formale Überarbeitung Formale Überarbeitung Erstellung Version Seite 3 von 11

4 2 Allgemeines Die Erhebungsdatenbank (ErhebungsDB) des Bundes und der Länder dient zur Vergabe eines bundesweit eindeutigen, einheitlichen Erhebungsidentifikators (ErhebungsID) zur Kennzeichnung von Daten im XML-basierten DatML/RAW-Format und den dazugehörigen Ressourcen (gekennzeichnet durch den eindeutigen Ressourcenschlüssel) zur Steuerung von generischen Verarbeitungsprozessen. 2.1 Schnittstellen zur ErhebungsDB Der Zugriff auf die ErhebungsDB wird über 2 Schnittstellen realisiert: Browserbasierte WEB-Schnittstelle Eine browserbasierte WEB-Schnittstelle zur Navigation auf den Inhalten, zur Darstellung der Inhalte und zum Zugriff auf gespeicherte Ressourcen (z.b. Erhebungsbeschreibung (DatML/SDF), Liefervereinbarung (PDF), Elektr. Fragebogen (DatML/ASK), PL-Metadaten (DatML/EDT), Fachinformationen, usw.) über eine Download-Funktion. Im Internet ist die ErhebungsDB über folgende URL erreichbar: WEB-Service-Schnittstelle: Zur Anbindung operativer Systeme wurde eine WEB-Service-Schnittstelle mit umfangreichen Methoden zum lesenden Zugriff auf die Inhalte der ErhebungsDB realisiert. 2.2 eworkflow/automatisierung der Prozesse Neben der Bereitstellung von Informationen für Statistik, Softwarehersteller und die Öffentlichkeit, ist eine wesentliche Aufgabe der ErhebungsDB, über die eingespeicherten und zu einer ErhebungsID bereitgestellten Ressourcen den elektronischen Workflow sowie die Automatisierung von Prozessen zu unterstützen. Die ErhebungsDB, mit den darin enthaltenen Identifikatoren und zugehörigen Ressourcen, ist Mittler zwischen den Werkzeugen zur Erstellung der fachlichen Beschreibungen in der Statistik (PL-Editor, SDF-Editor, Formular-Editor) sowie den Prozessen zur Online-Datengewinnung (IDEV,.CORE) und internen Prozessen zur Weiterverarbeitung der Daten (KonVertCenter, PL-Ablaufumgebung, PL- Fachverfahren). Version Seite 4 von 11

5 3 Aufbau des Erhebungsidentifikators Der Erhebungsidentifikators (13 Zeichen) setzt sich aus folgenden Komponenten zusammen: Version der ID (1 Zeichen) Statistikidentifikator (4 Zeichen) Zeitidentifikator (gültig ab BZR) (6 Zeichen) Länderkennzeichen (2 Zeichen) 3.1 Version der ID Die 1-stellige Version der ID/Systematik der ErhebungsID grenzt bereits im Einsatz befindliche Belegkennzeichen (EMSY, POSEIDON) gegen den neuen einheitlichen Erhebungsidentifikator ab. Bestehende Belegkennzeichen erhalten die Version der ID/Systematik = 0, der neue einheitliche Erhebungsidentifikator wird mit Version der ID/Systematik = 1 gekennzeichnet. 3.2 Statistikidentifikator Frei vergebene 4-stellige laufende Nummer zur dauerhaften Kennzeichnung von Erhebungen. Der Statistikidentifikator wird beim Anlegen einer neuen Erhebung von der zentralen Erhebungsverwaltung bundesweit einheitlich und eindeutig vergeben und kann nicht erneut verwendet werden. Er wird verfeinert durch Angaben des Zeitidentifikators (gültig ab BZR) und eines Länderkennzeichens. Zusätzlich findet bei Vergabe des Statistikidentifikators durch das System eine dauerhafte Verknüpfung mit einer oder mehreren zugeordneten 5-stelligen EVAS-Nummern mit zusätzlichem erläuterndem Text statt. Die EVAS-Nummern mit deren erläutendem Text werden als Attribute zum Statistikidentifikator abgelegt, sind selbst aber nicht Bestandteil des Statistikidentifikators. Version Seite 5 von 11

6 3.3 Zeitidentifikator (gültig ab BZR) Der 6-stellige Zeitidentifikator definiert den Berichtszeitraum (BZR), ab dem die zu diesem Erhebungsidentifikator gespeicherten Ressourcen zur Erzeugung und Lieferung von statistischen Daten verwendet werden können. Die Verwendung eines neuen Zeitidentifikators zu einem Erhebungsidentifikator führt zu einem neuen Erhebungsidentifikator mit entsprechendem Eintrag in der zentralen Erhebungsdatenbank. Er wird in folgender Form abgelegt. <jjxttt> wobei jj für das Jahr 2-stellig vorgegeben ist (00-99), x ttt Beispiele: zur Interpretation ttt (0 = Jahr; 1 = Halbjahr; 2 = Semester; 3 = Quartal; 4 = Monat, 5 = Woche und 6 = Tag) in Abhängigkeit von x mit belegt = 1. Halbjahr = Dezember = 2. Semester 2009 Version Seite 6 von 11

7 3.4 Länderkennzeichen Zur weiteren Verfeinerung einer Erhebung dient das 2-stellige Länderkennzeichen. Über dieses Länderkennzeichen können zu einem Erhebungsidentifikator länderspezifische Erhebungsinformationen erzeugt und in der zentralen Datenbank in Form von gespeicherten Ressourcen vorgehalten werden. Mögliche Angaben für das Länderkennzeichen sind: 00 - StBA 01 - Schleswig-Holstein 02 - Hamburg 03 - Niedersachsen 04 - Bremen 05 - Nordrhein-Westfalen 06 - Hessen 07 - Rheinland-Pfalz 08 - Baden-Württemberg 09 - Bayern 10 - Saarland 11 - Berlin 12 - Brandenburg 13 - Mecklenburg-Vorpommern 14 - Sachsen 15 - Sachsen-Anhalt 16 - Thüringen 99 - Verbund Version Seite 7 von 11

8 4 Aufbau des eindeutigen Ressourcenschlüssels Der eindeutige Ressourcenschlüssel (je nach Ressourcentyp 21- bzw. 27-stellig) setzt sich aus folgenden Komponenten zusammen: Erhebungsidentifikator (13 Zeichen) Version der ID (1 Zeichen) Statistikidentifikator (4 Zeichen) Zeitidentifikator (6 Zeichen) Länderkennzeichen (2 Zeichen) Ressourcentyp (2 Zeichen) Spezialisierung (2 Zeichen) ressourcenabhängiger Schlüssel (4 bzw. 10 Zeichen je nach Ressourcentyp) 4.1 Erhebungsidentifikator Siehe Punkt 2 - Aufbau des Erhebungsidentifikators. 4.2 Ressourcentyp Dient zur Abgrenzung der einzelnen Ressourcen. Zurzeit werden folgende Ressourcentypen unterstützt: 99 - Erhebungsbeschreibung (DatML/SDF) 98 - Liefervereinbarung (PDF) 97 - Elektr Fragebogen (DatML/ASK) 95 - Umsatztabelle raw2flat 94 - PL-Metadaten (DatML/EDT) 93 - PL-Prüfcode (Java-Datei) 92 - Einheitlicher Papierfragebogen 91 - Fachinformationen 90 - Beispiele 89 - Datensatzbeschreibung 88 - Transformation Version Seite 8 von 11

9 4.3 Spezialisierung Dient der weiteren Verfeinerung von gespeicherten Ressourcen. Je nach Ressourcentyp erfolgt bei der Spezialisierung folgende Unterscheidung: frei wählbare Spezialisierung ( 00 - Beschreibungstext 99 - Beschreibungstext) 92 - Einheitlicher Papierfragebogen 88 - Transformation teilweise frei wählbare Spezialisierung a. wählbar ( 00 - Allgemein verfügbar, 01 - Ressource für.core, 02 - Ressource für IDEV, 03 - Ressource für Fachanwendung, 04 - Ressource für CAPI, 05 - Ressource für CATI) b. frei wählbar ( 20 - Beschreibungstext 99 - Beschreibungstext) 89 - Datensatzbeschreibung wählbare Spezialisierung ( 00 - Allgemein verfügbar, 01 - Ressource für.core und 02 - Ressource für IDEV) "95 - Umsatztabelle raw2flat "90 - Beispiele ( 00 - Allgemein verfügbar, 01 - Ressource für.core, 02 - Ressource für IDEV, 03 - Ressource für Fachanwendung, 04 - Ressource für CAPI, 05 - Ressource für CATI) "97 - Elektr. Fragebogen (DatML/ASK) "94 - PL-Metadaten (DatML/EDT) "93 - PL-Prüfcode (Java-Datei) feste Spezialisierung ( 00 - Allgemein verfügbar) "99 - Erhebungsbeschreibung (DatML/SDF) "98 - Liefervereinbarung (PDF) "91 - Fachinformationen Version Seite 9 von 11

10 4.4 Ressourcenabhängiger Schlüssel Dient zur Versionierung von gespeicherten Ressourcen. Je nach Ressourcentyp erfolgt beim ressourcenabhängigen Schlüssel folgende Unterscheidung: "Version der Ressource (4-stellig)": 99 - Erhebungsbeschreibung(DatML/SDF), 98 - Liefervereinbarung(PDF), 97 - Elektr. Fragebogen (DatML/ASK), 95 - Umsatztabelle raw2flat, 92 - Einheitlicher Papierfragebogen, 91 - Fachinformationen, 90 - Beispiele und 89 - Datensatzbeschreibung 88 - Transformation "Zeitidentifikator (6-stellig) + Version der Ressource (4-stellig)": 94 - PL-Metadaten(DatML/EDT) und 93 - PL-Prüfcode(Java-Datei). Version Seite 10 von 11

11 4.5 Zusammenfassende Darstellung Nachfolgende Tabelle soll noch einmal den Aufbau des Schlüssels darstellen. Die in der Erhebungsdatenbank vorgehaltenen Statusanzeigen sind nicht Bestandteil des Schlüssels und dienen lediglich der Steuerung von Zugriffen auf gespeicherte Informationen. Position Länge Inhalt Erhebungsidentifikator 01 1 Version der ID Statistikidentifikator Zeitidentifikator (gültig ab BZR) Länderkennzeichen eindeutiger Ressourcenschlüssel Ressourcentyp Spezialisierung ressourcenabhängiger Schlüssel a.) für die Ressourcentypen: 99 - Erhebungsbeschreibung(DatML/SDF), 98 - Liefervereinbarung(PDF), 97 - Elektr. Fragebogen (DatML/ASK), 95 - Umsatztabelle raw2flat, 92 - Einheitlicher Papierfragebogen, 91 - Fachinformationen, 90 - Beispiele und 89 - Datensatzbeschreibung 88 - Transformation Version der Ressource b.) für die Ressourcentypen: 94 - PL-Metadaten(DatML/EDT) und 93 - PL-Prüfcode(Java-Datei) Zeitidentifikator (gültig ab BZR) Version der Ressource Version Seite 11 von 11