Checking the data is up to date

In a search service, it is enormously important that the underlying data be up to date. To check this, there is an interface that supplies this information. In the FACT-Finder configuration, a period of time is indicated for each database. If the database is not updated within this period, FACT-Finder considers it out of date and delivers corresponding information via this interface.

Text interface

This function is only available via an HTTP interface and can be invoked at the following URL:

$stringEscapeUtils.escapeHtml($body)

Please enter an appropriate user as a parameter. In addition, using the parameter channel, you can specially query this interface for one or more channels. If you want to query several, you must enter the channel names separated by a comma.

If all data is up to date you will receive nothing back. If one or more of the queried data files is out of date, you will receive a response that looks similar to the following:

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 Interface

You can also receive the obsolescence report in an XML format. If this is what you require, you must add the parameter format=XML to your call. The data will be returned in the format shown in this example:

<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>

The messages (message) are structured into messages tags, one for each channel. If no messages exist you will only receive the ff tag in response.

JSON Interface

You can pass the parameter format=json to request the response in JSON format.

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

The output consists of a map that contains the channel name as the key and a value comprising a list of messages. If no messages exist the map is returned empty.

The JSON schema definition can be found under:

$stringEscapeUtils.escapeHtml($body)

Page Contents