Zum Hauptinhalt springen

Änderungshistorie DVDV-Bibliothek für .NET

Änderungen V 2.15.0 - 2.16.0 (07.07.2025)​

  • DVDV2-2139: Für die Erzeugumg der im nupkg-Paket enthaltene Hilfe wird jetzt anstelle von sandcastle das Werkzeug docfx verwendet. Dadurch hat diese Hilfe ein neues Erscheinungsbild.
  • DVDV2-2032: Sie können zur standalone-Authentifizierung jetzt auch Zertifikate nutzen, die einen Signaturalgorithmen mit Elliptischen Kurven nutzen, genauer: SHA256withECDSA, SHA384withECDSA oder SHA512withECDSA. Die bisher unterstützten Signaturalgorithmen funktionieren unverändert weiter, das sind: SHA1withRSA, SHA384withRSA, SHA512withRSA, RSASSA-PSS.
  • DVDV2-1850: Update auf RestSharp 112.1.0. Dies ist verbunden mit einer breaking change: Die Methode SetRemoteCertificateValidationCallback aus dem Interface Dvdv.Api.Manager.IDVDV2Manager wurden ersetzt durch gleichnamige Methoden in Dvdv.Api.Manager.IDVDV2ServerConnectionParamsBuilderStandalone bzw. Dvdv.Api.Manager.IDVDV2ServerConnectionParamsBuilderIam. Die Methode RemoveRemoteCertificateValidationCallback wurde ersatzlos aus dem Interface Dvdv.Api.Manager.IDVDV2Manager gestrichen.
  • DVDV2-2137: Zahlreiche weitere Bibliothekenupdates.
  • DVDV2-2287: Die Klasse de.dvdv2.object.OrganizationCategory enthält jetzt auch auch das sogenannten Kategorienpräfix, also z.B. 'ubb' für 'Untere Bauaufsichtsbehörde'.
  • DVDV2-2388: Wenn der Authentifizierungsserver oder der DVDV-Server mit eine Response mit einem HTTP-Response mit Code >= 400 aber ungleich 404 geantwortet hat, dann hat die Bibliothek bisher eine DVDVIOException anstelle einer DVDVHttpException geworfen. (Hinweis DVDVHttpException erbt von DVDVIOException). Dementsprechend konnte Ihr Anwendungscode nicht die für eine detaillierte Fehlerbehandlung nötigen Felder StatusCode und Rfc7807Problem erreichen. Ab jetzt wirft die Bibliothek in dieser Situation korrekterweise eine DVDVHttpException. Die Basisklasse DVDVIOException ist solchen Fehlersituationen vorbehalten, in denen keine Response vom Server zurückgekommen ist.

Änderungen V 2.11.0 - 2.15.0 (30.04.2025)​

  • DVDV2-2352: Seit Bibliotheksversion 2.10.0 hat die DVDV-Bibliothek fälschlicherweise ein Failover versucht, wenn eine Abfrage den Response-Code 204 (NO_CONTENT) lieferte. Das deutet nämlich auf einen fachlichen fehler hin (siehe DVDV2-2071) und rechtfertigt daher keinen Failoverversuch. Ab jetzt findet in dieser Situation korrekterweise kein Failoverversuch statt. Nach wie vor wirft die Bibliothek in dieser Situation korrekterweise eine entsprechende Exception.

Änderungen DVDV-Server 2.15.0 (unabhängig von DVDV-Bibliotheksversionen)​

Die folgende Änderung betrifft den DVDV-Server und ist daher unabhängig von der eingesetzten Version des DVDV-Bibliothek.

  • DVDV2-2270: Die Rückgabe der in 2.8.0 / DVDV2-1898 eingebauten Methode DVDVManager.getCategories zur Abfrage des Kategorienbaums ist jetzt auf allen Baumebenen alphabetisch sortiert. Bisher war die Reihenfolge undefiniert bzw. von Implementierungsdetails abhängig.

Änderungen V 2.10.0 - 2.11.0 (06.05.2024)​

  • DVDV2-2120: Neue Utility-Methode Dvdv.Api.Object.Certificate.ReadCertificate(), liefert das Zertifikat als Instanz der Klasse System.Security.Cryptography.X509Certificates.
  • CR48/DVDV2-2069: Die DVDV-Bibliothek nutzt jetzt die in DVDV-Server 2.11.0 eingeführte Schnittstelle in der Version "v2". Diese Änderung ist für die Anwendung transparent, sollte also nicht zu Verhaltensänderungen führen. Die Änderung betrifft nur die von der Bibliothek gekapselten HTTP-Requests: Bei einem Aufruf der Methode IDVDV2Manager.FindOrganizationDescription oder IDVDV2Manager.FindServiceDescription wird dann, wenn es keine Treffer gibt, der Server nicht mehr mit dem Response-Code 404 (NOT_FOUND) sondern mit dem Response-Code 204 (NO_CONTENT) antworten.

Änderungen V 2.5.0 - V 2.10.0 (14.12.2023)​

  • DVDVSP-27 / DVDV2-1958: Neue Methode IDVDV2Manager.FindOrganizationDescriptions. Diese ist vergleichbar mit der bisherigen IDVDV2Manager.FindOrganizationDescription, funktioniert aber ohne Angabe eines Kategoriennamens und kann deshalb im Prinzip mehr als eine Organisation zurückliefern.
  • DVDV2-1898: Neue Methode IDVDV2Manager.GetCategories zur Abfrage des Kategorienbaums
  • DVDV2-1898: Neue Methode IDVDV2Manager.FindServiceSpecificationUrisByCategory zur Abfrage aller Dienstbeschreibungs-URIs, die der angegebenen Organisationskategorie zugeordnet sind.
  • DVDV2-1954: Neue Methode DVDV2ServerConnectionParamsBuilderStandalone.SetClientCertificateAfterChange. Mit dieser können Sie ein alternatives Zertifikat zusammen mit einem ungefähren Wechseltermin angeben. Die DVDV-Bibliothek wird dann zur Authentifizierung am DVDV-Server nötigenfalls beide Zertifikate ausprobieren. Der ungefähre Wechseltermin legt fest, welches der beiden Zertifikate bevorzugt wird: Vor dem ungefähren Wechseltermin ist es das mit DVDV2ServerConnectionParamsBuilderStandalone.SetClientCertificate angegebene und nach dem ungefähren Wechseltermin das alternative. Falls Sie das controlfile-Beispiel nutzen, so ist dort im Zuge dieser Änderung eine Modifikation der Konfigurationsdateien nötig.
  • DVDV2-2024: Neues Feld Organization.LocationStateId gibt den Länderschlüssel des Bundeslandes an, in dem die Organisation ihren Sitz hat.