TimelineSearch Command

Use the TimelineSearch command in a Logic Template to search a timeline index for records containing a date/time value that lies within the same sub-timeline as a user specified date and time, or to locate records containing a date/time value that lies within a sub-timeline that is touched by a user specified date-time range. To obtain exact results, the records returned by the search request should then be filtered by either the DateFilter command or by the TimeFrameFilter command.

To execute a Search Timeline Index request, use the TimelineSearch command with five arguments:

TimelineSearch( fc, idx, date, pas, wt );

TimelineSearch Arguments

Argument

Description

fc

The function code defining how to merge results.( NONRESTRICTIVE, RESTRICTIVE )

idx

The timeline index to be searched.

date

The HTML variable containing the first and final time in the requested range or the only time in the requested range.

pas

The pass during which the search is to be executed.

wt

The weighting value to apply to this search. The weighting value may be passed directly or within an HTML variable.

Access the TimelineSearch Dialog Box by selecting the Timeline Index->Timeline Index menu item under the Searching category of the Logic Template editor command menu.

Examples

Command

Description

TimelineSearch( NONRESTRICTIVE, ReservationDateindex, RequestedDate, 1, 4);

Search timeline index named "ReservationDateIndex" during pass 1 with a weighting value of 4. Search for the value stored in HTML variable "RequestedDate" and OR results with other indexes.

RequestedDate = "Nov 15, 2003";

TimelineSearch( RESTRICTIVE, ReservationDateindex, RequestedDate, 3, 0);

Search timeline index named "ReservationDateIndex" during pass 3 without a weighting value. Search for the date "November 15, 2002" and AND results with other indexes.

IF ( RequestedDate )

TimelineSearch( NONRESTRICTIVE, ReservationDateindex, RequestedDate, 1, Weight);

ENDIF

IF the HTML variable contains something other than zero, search the timeline index named "ReservationDateIndex" during pass 1 for the value stored in HTML variable "RequestedDate" and OR the results to other indexes using a weighting value stored in HTML variable "Weight"

TimeRange = ["4:00 pm" :: "10:30 pm" ];

TimelineSearch( RESTRICTIVE, ShowTimeIndex, TimeRange, 3, 0);

 

Search timeline index named "ShowTimeIndex" during pass 3 without a weighting value. Search for a time within the range "4:00 pm" up to "10:30 pm" and AND results with other indexes.