XÖV-Bibliothek: Spezifikation der XÖV-Datentypen und XÖV-Kernkomponenten XÖV-Bibliothek XOEV-Bibliothek urn:xoev-de:kosit:xoev:bibliothek:xoevbibliothek Die XÖV-Bibliothek ist der zentrale Ort zur Verwaltung und Bereitstellung aller XÖV-spezifischer, zur Wiederverwendung vorgesehener XÖV-Bausteine. Ausnahme bilden die Bausteine der Art "Codeliste", die ausschließlich über das XRepository bereitgestellt werden. Koordinierungsstelle für IT-Standards KoSIT http://www.xoev.de/de/bibliothek 2022-10-14 Creative Commons Namensnennung - Keine Bearbeitung 4.0 International http://www.xoev.de/de/bibliothek Die XÖV-Bibliothek wurde um Inhalte zur Norm DIN 91379 ergänzt. Die Version 1.1 der Datentypen zur XÖV-Basisnachricht (qualified und unqualified) wurde erstellt, in der von dem Datentyp C der DIN SPEC 91379 auf den Datentyp C der Norm DIN 91379 umgestellt wurde. Dieser Typ enthält Angaben zur Identifikation einer Behörde / öffentlichen Stelle in einem Verzeichnisdienst sowie ihrer Erreichbarkeit. Angabe des Verzeichnisdienstes (bspw. DVDV), in welchem die Behörde / öffentliche Stelle unter der nachfolgend angegebenen Kennung eingetragen ist. Dieses Element enthält die eindeutige Kennzeichnung der Behörde / öffentlichen Stelle innerhalb des angegebenen Verzeichnisdienstes. Für den Verzeichnisdienst „DVDV“ enthält die Kennzeichnung das „Präfix“ und die „Kennung“ getrennt durch das Zeichen ':', also bspw. 'psw:01003110'. Dieses Element enthält den Namen der Behörde / öffentlichen Stelle. In diesem Element werden Angaben zur Erreichbarkeit übermittelt, mit denen die Behörde / öffentliche Stelle über Telefon, E-Mail etc. erreicht werden kann. Diese Angaben können z. B. verwendet werden, um in Einzelfällen Rückfragen zu stellen oder Problemklärungen durchzuführen. Kommunikationskanal / Erreichbarkeit Erreichbarkeit erreichbarkeit urn:de:xoev:codeliste:erreichbarkeit Eine Liste der Kommunikationsmedien und -kanäle, über die man eine Person oder Institution erreichen kann. Koordinierungsstelle für IT-Standards KoSIT Verzeichnisdienst Verzeichnisdienst verzeichnisdienst urn:xoev-de:kosit:codeliste:verzeichnisdienst Liste der Verzeichnisdienste, in die Behörden / öffentliche Stellen eingetragen sein können Koordinierungsstelle für IT-Standards KoSIT Dieser Typ enthält Angaben zur eindeutigen Identifikation einer Nachricht. Dieses Element enthält den „Universally Unique IDentifier (UUID)“ der Nachricht, der das primäre Identifikationsmerkmal einer Nachricht darstellt. Der UUID der Nachricht wird entsprechend rfc4122 gebildet und ermöglicht Nachrichten hersteller- und anwendungsübergreifend weltweit eindeutig zu identifizieren. Für jede Nachricht muss ein neuer UUID erzeugt werden, um eine eindeutige Identifikation der Nachricht sicherzustellen. Insbesondere ist es nicht zulässig, in einer korrigierten Nachricht den UUID der ursprünglichen Nachricht wiederzuverwenden. Sofern eine einmal erzeugte Nachricht ein weiteres Mal gesendet werden soll (bspw. aufgrund von Problemen beim Nachrichtentransport), muss der UUID nicht angepasst werden. Dieses Element enthält eine eindeutige Kennzeichnung des Nachrichtentyps. Die Identifikation erfolgt über eine Codeliste des entsprechenden XÖV-Standards. Dieses Element enthält den Erstellungszeitpunkt der Nachricht - es enthält explizit nicht den Sende- und Empfangszeitpunkt. Der Erstellungszeitpunkt muss neben einer Angabe zum Datum eine zeitliche Information beinhalten. Diese ist mit einer Genauigkeit auf Ebene von Millisekunden und der Angabe zur Zeitzone zu übermitteln. Dieser Typ enthält Angaben zur Erreichbarkeit über elektronische Kommunikationskanäle (z. B. Telefon, E-Mail). Der 'kanal' gibt an, über welchen Kommunikationskanal eine Erreichbarkeit besteht. Die Kennung beinhaltet die konkreten Angaben zur Erreichbarkeit über einen Kommunikationskanal, d. h. die Telefonnummer, E-Mail-Adresse oder dergleichen. Eine zusätzliche Bemerkung. Basistyp für alle Nachrichten zwischen Behörden und anderen öffentlichen Stellen (government-to-government). Nachrichtenkopf für Nachrichten zwischen Behörden und anderen (öffentlichen) Stellen. Der Nachrichtenkopf umfasst Angaben zur eindeutigen Identifikation des Autors und des Lesers der Nachricht sowie der Nachricht selbst. In diesem Attribut ist der Name des Produktes (der Software) einzutragen, mit dem die Nachricht erstellt worden ist. In diesem Attribut wird der Name der Organisation / Firma übermittelt, die für das Produkt (die Software) verantwortlich ist, mit dem die Nachricht erstellt wurde. In diesem Attribut werden ergänzende Hinweise zu dem Produkt eingetragen. Dies sind Angaben, die für eine möglichst präzise Identifikation im Fehlerfall hilfreich sind, wie zum Beispiel Version und Patchlevel. In diesem Attribut wird der Name des XÖV-Standards angegeben, aus dem die Nachricht stammt. Ist dieses Attribut vorhanden, handelt es sich aus Sicht des Autors um eine Testnachricht, die nicht im normalen Produktivbetrieb verarbeitet werden darf. Autor und Leser können bilateral weitere Absprachen über den konkreten Inhalt des Attributs treffen. In diesem Attribut wird die Version des XÖV-Standards eingetragen, aus dem die Nachricht stammt. Nachrichtenkopf für Nachrichten zwischen Behörden und anderen (öffentlichen) Stellen. Der Nachrichtenkopf umfasst Angaben zur eindeutigen Identifikation des Autors und des Lesers der Nachricht sowie der Nachricht selbst. Dieses Element enthält Angaben zur eindeutigen Identifikation einer Nachricht. Dieses Element enthält Angaben zum Leser der Nachricht. Der Leser ist die fachlich zuständige Behörde / öffentliche Stelle, der die Nachricht zugestellt werden soll und die die Nachricht fachlich verarbeiten soll. Dieses Element enthält Angaben zum Autor der Nachricht, die es dem Leser ermöglichen, bei Bedarf mit dem Autor in Verbindung zu treten. Der Autor ist die fachlich zuständige Behörde / öffentliche Stelle, die die Nachricht erstellt. Ein „Universally Unique IDentifier (UUID)“ entsprechend rfc4122.