11. Zukünftige Versionen

Es ist damit zu rechnen, dass diese Spezifikation weiterentwickelt wird. In Planung ist die Übermittlung von Katalogdaten und - wenn hierfür ein klarer Bedarf zu erkennen ist - für die Übermittlung von Lieferscheinen und Rechnungen. Es ist also dafür Sorge zu tragen, dass Server und Client, die unterschiedliche Versionen der veloconnect-Spezifikation implementieren, reibungslos zusammenarbeiten können. Die Weiterentwicklung der Spezifikation wird daher folgenden Regeln unterworfen:

Regel: Versions-Richtlinie. 

  1. Jede veloconnect-Spezifikation wird nach dem Schema {version}.{revision} numeriert. Hierbei ist {version} die Versionsnummer und {revision} die Revisionsnummer. Die vorliegende Spezifikation hat also die Versionsnummer 1 und die Revisionsnummer 0. Eine Spezifikation ist neuer als eine andere, wenn ihre Versionsnummer größer ist, oder wenn die Versionsnummern übereinstimmen und die Revisionsnummer größer ist.
  2. Innerhalb eines Zeitraums von 12 Monaten findet höchstens ein Wechsel der Versionsnummer statt.
  3. Die in der Spezifikation definierten Namensräume werden alle nach dem Muster urn:veloconnect:{name}-{version}.{revision} bezeichnet. Die Versionsnummer stimmt mit der Versionsnummer der Spezifikation überein. Eine Änderung der Revisionsnummer findet nur statt, wenn die Schemadefinitionen für diesen Namensraum geändert werden.
  4. Zu jedem Namensraum, der in einer veloconnect-Spezifikation verwendet wird, gibt es in jeder neueren Spezifikation mit gleicher Versionsnummer genau einen Namensraum, dessen Bezeichnung bis auf die Revisionsnummer mit diesem übereinstimmt.
  5. Die Modifikationen der Schemadefinitionen werden wie folgt sein. Sei D ein nach der Spezifikation u.v gültiges XML-Dokument und u.y eine neuere Spezifikation. Wir können D derart zu einem XML-Dokument E transformieren, dass wir die Bezeichner von Namensräumen durch ihre im vorherigen Abschnitt zugeordneten Bezeichner der neueren Spezifikation ersetzen. Das transformierte Dokument E wird dann auch wieder ein nach der Spezifikation u.y gültiges Dokument sein.
  6. Sei D ein nach der Spezifikation u.v gültiges XML-Dokument und x.y eine neuere Spezifikation, wobei x und u verschieden sind. Falls eine zum vorherigen Fall analoge Transformation der Namensräume zum Dokument E möglich ist und das Wurzelelement von E im neueren Schema deklariert ist, dann ist das Dokument E auch wieder ein nach der Spezifikation x.y gültiges Dokument.

Letzlich bedeutet diese Regel eine weitgehende Abwärtskompatibiltät. Ebenso zeigt dies, dass Implementierungen Namensräume im wesentlichen als Signal verwenden, um zu erkennen nach welchem Stand der Spezifikation die beteiligten Parteien arbeiten, und die Verwendung der unqualifizierten Namen zu keinen Missverständnissen führt. Für Client und Server hat es unterschiedliche Konsequenzen, wenn sie mit einer Gegenseite kommunizieren, die einen anderen Stand der Spezifikation implementiert. Für die Implementierung von Clients werden einige Empfehlungen ausgesprochen, für Server einige diesbezügliche Regeln formuliert.

Empfehlung für Client-Implementierungen. 

Regel: Abwärtskompatibilität (Server). Im Umgang mit Clients, die einen älteren Stand der Spezifikation implementieren, muss ein veloconnect-konformer Server folgende Regeln beachten:

  1. Sofern eine Anfrage des Client mit der oben beschriebenen Transformation der Namensräume in eine gültige Anfrage umgesetzt werden kann, ist diese transformierte Anfrage gemäß der Spezifikation zu beantworten
  2. Andernfalls hat der Server die Wahl, ob die Anfrage gemäß einer früheren Sepzifikation beantwortet wird oder ob der Fehlercode 406 zurückgeliefert wird.

Regel: Aufwärtskompatibilität (Server). Im Umgang mit Clients, die einen neueren Stand der Spezifikation implementieren, muss ein veloconnect-konformer Server folgende Regeln beachten:

  1. Sofern eine Anfrage des Client durch eine entsprechende Transformation der Namensräume in eine gültige Anfrage umgesetzt werden kann, ist diese transformierte Anfrage gemäß der Spezifikation zu beantworten
  2. Andernfalls wird der Fehlercode 405 zurückgeliefert.