In diesem Abschnitt der Konfiguration "shop.config" legen Sie die Einstellungen für die Schnittstelle zur asynchronen Datenübermittlung fest.

Wegweiser: Asynchronous-Server-Side-Events

<ASSE>
   <+Entry>
      ID                    =
      Endpoint              =
      Type                  =
      PayloadParameterName  =
      ContentType           =
      ServiceCategory       =
      <DefinitionOfOK> 
         <+ConditionGroup>
            <+Condition>
               Proof           = 
               DataSelector    = 
               Type            =
               Value           = 
            </+Condition>
         </+ConditionGroup>
      </DefinitionOfOK>
      <AdditionalHeaders>
         <+HttpHeader>
            Name               = 
            Value              = 
         </+HttpHeader>
      </AdditionalHeaders>
   </+Entry>
</ASSE>

 

Parameter

Zweck

Werte

<+Entry>

einzelne Einträge

-

ID

eindeutiger Bezeichner

alphanumerisch, max. 64 Zeichen

Endpoint

Endpunkt, an den die Daten übermittelt werden sollen

Hinweis: Hier können auch WEBSALE-Tags angegeben werden.

URL

Type

Übermittlung der Daten als POST-, GET- oder PUT-Request

Post

Get

Put

Standard: Post

PayloadParameterName

optional, setzt vor die Payload einen Parameternamen

 

ContentType

Datenformat, z. B. XML, JSON

z. B.
application/json

application/xml

application/txt

ServiceCategory

steuert die Anzahl an Fehlversuchen, die zeitlichen Abstände und das Timeout (von WEBSALE vorgegeben)

Tracking

OrderNotification

<DefinitionOfOK>

optionaler Abschnitt für Bedingungen einer erfolgreichen Zustellung, wenn nicht angegeben: einmaliges "FireAndForget"

-

<+ConditionGroup>

Gruppe von Prüfungen, ODER-verknüpft

-

<+Condition>

einzelne Prüfungen der erfolgreichen Zustellung, UND-verknüpft

-

Proof

Bedingung einer erfolgreichen Zustellung

HTTPStatusCode: Erst, wenn der Server des externen Systems mit einem bestimmten Statuscode, z.B. 200, antwortet, wird die Übertragung als erfolgreich gewertet.

ContentType: Datenformat

ResponsePlain: Die Antwort, die als erfolgreich gewertet werden soll, kann auch definiert werden, z. B. "OK". Liefert das System als HTTP-Antwort "OK" zurück, war die Prüfung erfolgreich. Bei keiner bzw. allen anderen Antworten war die Prüfung nicht erfolgreich.

ResponseJSON: Wie ResponsePlain, jedoch im JSON-Format

ResponseJSONData: Prüft die zurückgegebenen JSON-Daten nach einzelnen Feldern. Benötigt die Parameter DataSelector und Type

HTTPStatusCode
ContentType
ResponsePlain
ResponseJSON
ResponseJSONData

DataSelector

Auswahl des Datenfeldes. Nur, wenn Proof gleich ResponseJSONData

 

Type

Art der Prüfung

filled: Feld ist gefüllt

empty: Feld ist leer

value: Der Wert des Feldes entspricht dem in Value angegebenen Wert

notvalue: Der Wert des Feldes entspricht nicht dem in Value angegebenen Wert

inlist: Der Wert des Feldes ist Teil der in Value angegebenen Liste

notinlist: Der Wert des Feldes ist nicht Teil der in Value angegebenen Liste

greater: Der Wert des Feldes ist größer als der in Value angegebene Wert

smaller: Der Wert des Feldes ist kleiner als der in Value angegebene Wert

filled

empty

value

notvalue

inlist

notinlist

greater

smaller

Value

zu prüfender Wert, nur relevant, wenn Type = value, notvalue, inlist, notinlist, greater oder smaller ist.

 

<AdditionalHeaders>

optional, wenn externe Systeme zusätzliche Informationen im HTTP-Header bei der Übermittlung erwarten

-

<+HttpHeader>

Jeder Parameter benötigt einen eigenen <+HttpHeader>-Abschnitt

-

Name

Name des zu übermittelnden Parameters

 

Value

Wert des zu übermittelnden Parameters