Versions Compared

Key

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

Sowohl in Anfragen als auch in Antworten kann das Element IsTest verwendet werden. Die Verwendung dieses Indikators soll es ermöglichen, Client-Implementierungen zu testen und möglichen Fehlern im Zusammmenspiel der beteiligten Komponenten auf den Grund zu gehen, ohne dabei geschäftliche Transaktionen auszulösen. Damit dies gewährleistet ist, gelten für einen veloconnect-konformen Server, bzw. für dessen Betreiber folgende Regeln:

Regel: Testbetrieb

  1. Jedem, der ein berechtigtes Interesse daran hat, ist in angemessener Zeit ein Zugang zur Benutzung der veloconnect-Schnittstelle zu gewähren. Ob das Interesse berechtigt ist, entscheidet im Einzelfall der Betreiber des Servers. Die Entwicklung einer veloconnect-Schnittstelle für einen Client begründet in der Regel ein berechtigtes Interesse. Der Zugang kann auf eine angemessene Zeit befristet werden und kann voraussetzen, dass sich der Interessent zur Vertraulichkeit verpflichtet und den Zugang nur für die angegebenen Zwecke verwendet.

  2. Wird in einer Anfrage oder einer Antwort das Element IsTest nicht benutzt, so ist dies äquivalent zur Verwendung dieses Elements mit dem Inhalt false.

  3. In einer Operation haben die jeweiligen IsTest-Element in Anfrage und Antwort den gleichen Wert. Ist dieser Wert true, so wird die Operation als Test betrachtet.

  4. In einer Transaktion darf einer Operation, die als Test durchgeführt wird, weder eine Operation, die nicht als Test durchgeführt wird, folgen noch vorausgehen. Falls der Client eine Anfrage schickt, die hierzu in Widerspruch steht, so hat der Server den Fehlercode 435 zurückzuliefern.

  5. Eine Operation, die als Test durchgeführt wird, darf keine geschäftlichen Transaktionen zwischen Käufer und Verkäufer auslösen.

  6. Die Antworten, die ein Server in einer Test-Operation zurückgibt, unterscheiden sich nicht von der gleichen Operation, die nicht als Test durchgeführt wird; es sei denn, dies ist zur Erfüllung der vorangegangenen Regel erforderlich.

...

Das Flag IsTest nur in der Transaktion Order und hier nur in der Operation FinishOrder relevant, da es hier um den Unterschied geht, ob eine Bestellung wirklich ausgeführt wird oder nicht.

...

Requests as well as responses can use the IsTest element. This indicator is intended to allow testing of client implementations and investigation of possible errors in the interplay between involved components without triggering business transactions. To ensure this, the following rules apply to a Veloconnect-compliant server and its operator:

Rule: Test operationgel:

  1. Anyone with a legitimate interest in using the Veloconnect interface must be granted access to it within a reasonable time. Whether the interest is legitimate is decided on an individual basis by the server's operator. Development of a Veloconnect interface for a client usually gives rise to a legitimate interest. Access may be limited to a reasonable period of time, and may require the interested party to commit to confidentiality and use access only for the purposes stated.

  2. If the IsTest element is not used in a request or response, it is equivalent to using this element with content set to false.

  3. The IsTest elements in the request and response forming part of an operation have the same value. If this value is true, the operation is considered a test.

  4. In a transaction, an operation performed as a test must not be followed or preceded by an operation not performed as a test. If the client sends a request which conflicts with this, the server must return error code 435.

  5. An operation performed as a test must not trigger business transactions between buyer and seller.

  6. The responses which a server returns in a test operation do not differ from those in the same operation not performed as a test, unless this is necessary to comply with the previous rule.

Info

The IsTest flag is only relevant in transaktion order, and here only in the FinishOrder operation, because this involves the distinction between whether or not an order is actually executed.

For all other transactions or operations, there is ultimately no difference between whether IsTest= true or IsTest=false.