Aktualität der Daten Prüfen

Die Aktualität der zugrunde liegenden Daten ist bei einem Such-Service enorm wichtig. Um dies überprüfen zu können, gibt es eine Schnittstelle, die diese Informationen liefert. In der FACT-Finder-Konfiguration lässt sich für jede Datenbank ein Zeitraum angeben. Wird die Datenbank innerhalb dieses Zeitraums nicht aktualisiert, betrachtet FACT-Finder diese als veraltet und liefert über diese Schnittstelle entsprechende Informationen.

Text-Schnittstelle

Diese Funktion ist nur über eine HTTP-Schnittstelle verfügbar und unter folgender URL aufrufbar:

$stringEscapeUtils.escapeHtml($body)

Als Parameter übergeben Sie bitte einen entsprechenden Benutzer. Zusätzlich können Sie über den Parameter channel, diese Schnittstelle speziell für einen oder mehrere Channels anfragen. Wollen Sie mehrere abfragen, so müssen Sie die Channelnamen durch Komma getrennt übergeben.

Sind alle Daten aktuell, bekommen Sie keine Rückgabe. Sind eine oder mehrere der abgefragten Datendateien veraltet, erhalten Sie eine Rückgabe, die etwa so aussieht:

expired file for channel de: productData - Tue Apr 27 10:06:07 CEST 2010
expired file for channel de: database - Tue Apr 27 10:06:10 CEST 2010

XML-Schnittstelle

Sie können die Aktualitätsinformationen auch in einem XML-Format zurückgeliefert bekommen. Sollten Sie dies wünschen, müssen Sie beim Aufruf zusätzlich den Parameter format=xml übergeben. Als Rückgabe erhalten Sie beispielsweise folgendes:

<ff xsi:noNamespaceSchemaLocation="schema/7.2/ffdatabaseexpiration.xsd">
  <messages channel="de">
    <message>images - Wed Mar 23 16:52:52 CET 2011</message>
    <message>productData - Fri Apr 08 10:29:07 CEST 2011</message>
    ...
  </messages>
...
</ff>

JSON-Schnittstelle

Wenn der Parameter format=json übergeben wird, so erhalten Sie die Antwort im JSON-Format.

{
  "de": [
    "productData - Fri Apr 08 10:29:07 CEST 2011",
    "images - Wed Mar 23 16:52:52 CET 2011",
    ...
  ],
  ...
}

Die Rückgabe besteht aus einer Map, die als Schlüssel den Channelnamen und als Wert eine Liste mit den Meldungen hat. Sollten keine Nachrichten vorhanden sein, so ist diese Map leer.

Die JSON-Schema-Definition befindet sich unter:

$stringEscapeUtils.escapeHtml($body)