PDF Export

getByAttribute

  • Objekt: /net/dsb/avs3/SubscriptionOrder
  • Methode: getByAttribute
  • Version: 1.0.0
  • Fuba: /DSB/_ISM_E_SEL_BY_MM_IWW

Diese Methode bringt alle Abos zurück, die zu dem übergebenen Auftrags-/ Geschäftspartnerattribut gehören. Der Response kann maximal 200 Abos enthalten.
Der aufrufende Client muss ein paging prozess implementieren, um alle relevanten Abos zurückzubekommen. Beim Iterieren über einen größeren Abobestand, müssen die Elemente ‘from-hit’ und ‘max-hit-count’ (optional) genutzt werden.

Hinweis:
Die Verwendung dieser Web-Services muss explizit mit dem Kundenberater abgestimmt werden und erfordert u.U. kundenspezifische Anpassungen.

Parameter

Name Typ / LängeKann / MussBeschreibung
attribute n. a. M XML-Fragment ‚attribute‘ siehe unten.
return-address-type AN / 2 K Hier können die zurückzuliefernden Rollen angegeben werden(AG, WE, VM, RE). Dieser Parameter kann mehrfach vorkommen. WE kommt immer mit.
return-current-we-addressAN / 1 k Legt fest ob beim WE die tagesaktuelle Adresse gelesen werden soll. Ansonsten wird die Adresse die zum Zeitpunkt des letzten Versandes gültig war verwendet.
Y = ja
N = nein (Default)
return-valid-to-by-evt AN / 1 k Legt fest ob das Lieferende im Response anhand des EVT bestimmt werden soll.
Y = ja
N = nein (Default)
from-hit N K Falls die Ergebnismenge eingeschränkt werden soll, dann hier den ersten Treffer angegeben der zurückgeliefert werden soll. Default ist 0.
max-hit-count N / 4 k Anzahl der maximal zurückgelieferten Treffer(1-200) , Default: 200
deep-search AN / 1 k Y = Tiefe Suche N = Keine Tiefe Suche (default)

Rückgabe Element

XML-Struktur 'subscription-order'. Diese Struktur entspricht der Beschreibung von 'new-subscription', siehe unten

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="avs/3" >
  <header>
    <client>286</client>
    <avs3-sales-organization>0100</avs3-sales-organization>
    <avs3-service-provider>DSB</avs3-service-provider>
    <service-object>/net/dsb/avs3/SubscriptionOrder</service-object>
    <service-method>getByAttribute</service-method>
    <service-version>1.0.0</service-version>
 
  </header>
  <body>
    <attribute>
      <type>type</type>
      <value>value</value>
    </attribute>
    <return-address-type>AG</return-address-type>
    <return-address-type>WE</return-address-type>
    <return-current-we-address>Y</return-current-we-address>
    <return-valid-to-by-evt>Y</return-valid-to-by-evt>
    <from-hit>0</from-hit>
    <max-hit-count>100</max-hit-count>
    <deep-search>Y</deep-search>
  </body>
</message>

Beispiel Response

<message version="1.0" system="avs/3">
  <header>
    <client>999</client>
    <avs3-sales-organization>9999</avs3-sales-organization>
    <avs3-service-provider>123</avs3-service-provider>
  </header>
  <body>
    <subscription-order>
      ...
    </subscription-order>
  </body>
</message>

Response Struktur

Cookies helfen bei der Bereitstellung von Inhalten. Durch die Nutzung dieser Seiten erklären Sie sich damit einverstanden, dass Cookies auf Ihrem Rechner gespeichert werden. Weitere Information