Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
typeflat

Ein Element vom Typ An element of type vct:RequestType besteht aus folgenden Elementenhas the following constituents:

Name

TypType/Vorkommenoccurrence

BeschreibungDescription

vct:BuyersID

udt:IdentifierType

Kennzeichnung des Käufers, wie z.B. KundennummerBuyer's ID, e.g. customer number.

vct:Credential

vct:CredentialType

Zur Autorisierung des Client, siehe untenClient authorization; see below.

vct:TransactionID

xsd:normalizedString?

Zur Identifikation der TransaktionsinstanzTransaction instance identifier.

vct:IsTest

xsd:boolean?

Indikator, ob die Operation nur testweise ausgeführt werden soll (vgl. Testbetrieb)

Die Definition des Typs vct:CredentialType erscheint redundant, ist jedoch so gewählt, um später durch Erweiterung mögliche andere Authentifizierungsmechanismen (wie z.B. Zertifikate) zu unterstützen.

Beschreibung

Name

Typ/Vorkommen

Indicator as to whether the operation should only be performed as a test (refer to test operation).

The definition of type vct:credentialtype appears redundant, but is chosen so as to support further authentication mechanisms (such as certificates) possibly resulting from later extensions.

Name

Type/occurrence

Description

vct:Password

xsd:string

PasswortPassword.

Als Einschränkung des Typs Defined as a constraint of type vct:RequestType ist der Typ is the type vct:TransactionRequestType definiert; die Einschränkung besteht darin, dass das Element ; the constraint dictates use of the element vct:TransactionID verwendet werden muss.

...

Rule SellersID

Das optionale Element SellersID im Request und Response war bis veloconnect The optional SellersID element in requests and responses was provided until Veloconnect 1.1 für den Fall vorgesehen, dass ein Server unter der gleichen URL für verschiedene Lieferanten eine veloconnect Implementierung hostet. Da von dieser Möglichkeit bisher nie Gebrauch gemacht wurde und es auch technisch einfach möglich ist, verschiedene Mandanten auf einer veloconnect Server Implementierung über unterschiedliche Zugangs-URLs zu trennen, darf dieses Element ab veloconnect 1.3 nicht mehr verwendet werden.

Serialisierung von Elementen vom Typ RequestType

Zur Serialisierung der URL-Bindung ist eine Anfrage zunächst als Folge von Parametern darzustellen. Die Namen der Parameter sind wie folgt, in case a server hosted a Veloconnect implementation under the same URL for different vendors. Because this option has never been used, and it is also technically easy to separate different vendors on a Veloconnect server implementation via different access URLs, this element may no longer be used from Veloconnect 1.3 onward.

Serialization of RequestType elements

To serialize a URL binding, a request must first be represented as a sequence of parameters. Parameter names are as follows:

...

  • RequestName

  • BuyersID

  • Password

  • TransactionID

  • IsTest

  • version

Hinzu kommen eventuell noch weitere Parameter, die jeweils bei der Definition der einzelnen Operationen angegeben werden. Als Wert der genannten Parameter ist der Inhalt der gleichnamigen Unterlemente des jeweiligen Request-Elements zu verwenden, bzw. beim Parameter "RequestName" der Name dieses Elements selbst.

Regel: Parameter version

  • Version

Further parameters might also be specified in the respective definitions of the operations. Serving as the value of each specified parameter is the content of the identically named sub-element of the respective request element, or the name of the element itself in the case of the "RequestName" parameter.

Rule: Version parameter

...

  1. Only the following values are permissible for the version parameter: 1.0, 1.1, 1.2, 1.3

  2. Nicht zulässige Werte für version sind vom Server zu ignorieren.

  3. Bei zulässigem Wert für version antwortet der Server gemäß der neuesten Version der Spezifikation, die er unterstützt und die kleiner oder gleich der Version ist, die im Parameter version angegeben ist.

...

Der Parameter version ist erst mit veloconnect 1.3 eingeführt worden. D.h. Server, die nur eine ältere Version der Spezifikation unterstützen, ignorieren diesen Parameter.

Server, die bereits veloconnect 1.3 unterstützen können diesen Parameter benutzen, um weitestgehende Abwärtskompatibilität zu Clients zu erreichen, die noch nicht veloconnect 1.3 unterstützen, indem sie bei Abwesenheit des Parameters version nach veloconnect 1.1 verfahren.

  1. .

  2. Impermissible values for versions are to be ignored by the server.

  3. If a value for a version is permissible, the server responds according to the latest version of the specification which it supports and which is less than or equal to the version specified in the version parameter.

Info

The version parameter has only been introduced with veloconnect 1.3, i.e. servers which only support an older version of the specification ignore this parameter.

 Servers which already support veloconnect 1.3 can use this parameter to maximize downward compatibility with clients which do not yet support veloconnect 1.3, by proceeding according to veloconnect 1.1 in an absence of the parameter version.

 Clients which already support veloconnect 1.3 should always use the parameter version.