In diesem Abschnitt der Konfiguration "shop.config" legen Sie die Prüfungen der Verfügbarkeit externer Systeme fest.
Der Abschnitt <ExternSystemLiveChecks> kann maximal 10 Unterabschnitte <+Entry> enthalten, in denen jeweils eine einzelne Prüfung der Verfügbarkeit eines externen Systems festgelegt wird. Jeder Prüfung wird eine ID zugewiesen, die als Argument für das Tag {WS-ExternSystemLiveCheck()} verwendet werden kann.
<ExternSystemLiveChecks>
<+Entry>
ID = search
URL = https://...
Type = 1
CheckMode = always
Timeout = 1000
</+Entry>
...
</ExternSystemLiveChecks>
Achtung: |
|
Für eine gültige Prüfung müssen folgende Parameter gültige Werte erhalten: ▪ID (Wert darf nicht leer sein) ▪Type (Wert muss ein gültiger und verfügbarer Type bzw. eine Zahl sein) |
Ist einer dieser Werte ungültig, kann diese Prüfung nicht angewendet werden. Jedes Tag {WS-ExternSystemLiveCheck()} mit einer nicht oder ungültig konfigurierten ID als Argument wird nicht ersetzt!
Parameter |
Zweck |
Werte |
---|---|---|
ID |
Eindeutige Kennung der Prüfung zur Verwendung mit dem Tag Referenz: WS-ExternSystemLiveCheck() |
|
URL |
Adresse des LiveCheck-Aufrufs des externen Systems. |
|
Type |
Typ des externen Systems bzw. der Prüfung 1: Dienstleister: beliebig Die Schnittstelle kann durch Sie oder einen externen Dienstleister angebunden werden. Die Beschreibung der Schnittstelle finden Sie weiter unten. 2: Dienstleister: Findologic Alivetest für die Onlinesuche (alivetest.php) |
1 2 |
CheckMode |
Modus, wann der LiveCheck an das externe System gestellt wird (die Prüfung erfolgt durch das Bereichs-Tag {WS-ExternSystemLiveCheck()}, maximal einmal pro Seitenaufruf): Always: Die Anfrage wird bei jeder Prüfung an das externe System gestellt failPersistant: Die Anfrage wird so lange bei jeder Prüfung an das externe System gestellt, bis der LiveCheck das erste Mal fehlschlägt. Danach wird jede weitere Prüfung für die Sitzung als fehlgeschlagen gewertet und keine weitere Anfrage gestellt. successPersistant: Die Anfrage wird so lange bei jeder Prüfung an das externe System gestellt, bis der LiveCheck das erste Mal erfolgreich war. Danach wird jede weitere Prüfung für die Sitzung als erfolgreich gewertet und keine weitere Anfrage gestellt. |
always failPersistant successPersistant Standard: always |
Timeout |
Zeitspanne, in der das externe System antworten muss. Antwortet das externe System nicht vollständig innerhalb dieser Zeitspanne, so wird die Prüfung als fehlgeschlagen gewertet. Achtung: Wenn das externe System nicht erreichbar ist, kann der Seitenaufruf verzögert werden. Wenn der Wert zu klein gewählt wird, schlägt die Prüfung evtl. fehl obwohl das externe System verfügbar ist, da das externe System nicht in der vorgegebenen Zeitspanne antworten kann. Wenn der Wert zu groß gewählt wird und das externe System ist nicht verfügbar, wird der Seitenaufbau evtl. stark verzögert. |
Angabe in Millisekunden, Wert zwischen 1 und 3000. Standard: 3000 |
Hinweis: |
|
Wenn die Prüfung für das von Ihnen eingesetzte externe System nicht verfügbar ist, kontaktieren Sie bitte WEBSALE AG. |
Beschreibung der Schnittstelle für den LiveCheck vom Typ 1
Bei einem LiveCheck vom Typ 1 stellt WEBSALE V8s eine "HTTP-Get"-Anfrage an die im Parameter URL angegebene Adresse. Liefert das externe System als HTTP-Antwort OK zurück, war die Prüfung erfolgreich. Bei keiner bzw. allen anderen Antworten war die Prüfung nicht erfolgreich.
Beispiel
Grundgerüst einer Anbindung der Schnittstelle in PHP:
<? // Hier können Sie individuelle(n) Prüfung(en) implementieren. // Während der Prüfungen dürfen keine Ausgaben erfolgen // Speichern Sie das Ergebnis in der Variable result: // true für LiveCheck erfolgreich // false für LiveCheck nicht erfolgreich if ($result == true) echo "OK"; else echo "Not OK"; ?>
Wegweiser: Externe Includes verwenden
Referenz: WS-ExternSystemLiveCheck()