getChangesEx (Version 1)

Diese Methode liefert eine Liste aller Auftrage zurück, die seit dem übergebenen Zeitpunkt verändert wurden. Diese Methode liefert, wenn die zurückgegebene Anzahl Auftragsnummern ~10000 ist einen Timestamp zurück. Dieser Response Timestamp muss in den weiteren Folgerequest unbedingt mitgegeben werden, bis ein leeres Ergebnis zurückkommt(rekursive Anfrage!).

Objekt: /net/dsb/vhs3/PurchaseOrder
Methode: getChangesEx
Version: 1.0.0

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
timestamp	D / 19	M	Timestamp im Format JJJJ-MM-TT HH:MM:SS oder JJJJMMTTHHMMSS. Dieser Zeitpunkt wird in der Zeitzone des WSI Servers interpretiert. Alle Änderungen ab diesem Zeitpunkt (inklusive) werden zurückgegeben. Zusätzlich enthält der Response ein „timestamp“ element, das im nächsten Request verwendet werden sollte.
service-provider	AN / 3	K	Einschränkung des Ergebnisses auf einen bestimmten Dienstleister.

Rückgabe Element

XML Fragment purchase-order mit den Elementen purchase-order-id und purchase-order-number. Zusätzlich noch ein Zeitstempel, bis zum dem alle Änderungen geliefert wurden. Dieser kann/muss für zukünftige Anfragen verwendet werden.

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3" >
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <timestamp>2003-08-19 14:25:01</timestamp>
  </body>
</message>

Beispiel Response

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3">
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <purchase-order>
      <purchase-order-number>1234567</purchase-order-number>
      <purchase-order-id>437</purchase-order-id>
    </purchase-order>
    ...
    <purchase-order>
      <purchase-order-number>1234599</purchase-order-number>
      <purchase-order-id>445</purchase-order-id>
    </purchase-order>
    <timestamp>2003-08-20 16:25:01</timestamp>
  </body>
</message>