ApiFeedback().Search

Initiates a time-based search of conversational (Feedback) data for a particular user.

Description

If there is some conversational data for the named user, it is searched for Concepts, within the given time range, and a structure is set up containing the data for sequential reference. A null value for Concepts will cause the method to return all of the given user’s utterances within the given time range. A null value for startTime causes the search to have no beginning time boundary, and a null value for endTime causes the search to have an ending boundary of the current data and time.

Note that the “strip” parameter allows you to remove selected Concepts from consideration in the search. For instance, you can easily discard “a”, “an”, “the”, or other unimportant Concepts from being required by the internal search.

Example Usages (C#)


bool success = _core.ApiFeedback().Search(“robert”, “rock music”, “rolling
stones”, true, “3/8/2010 12:15:12”, “3/10/2010 12:15:12”);
bool success = _core.ApiFeedback().Search(“lisa”, “construction”, null, true, null, null);

Parameters

String username A string value naming the user whose conversational data will be searched.
String concepts A string value containing one or more Concepts that are expected in the data.
String strip A string value containing one or more Concepts that should not be considered.
String username A string value naming the user whose conversational data will be searched.
String exclude A string value containing one or more Concepts that will cause a particular utterance to be excluded from the search.
String startTime A string containing a formatted date / time.
String endTime A string containing a formatted date / time.
bool requireAll A boolean value indicating whether all Concepts are required for an an utterance is included.
bool related A boolean value indicating whether closely related Concepts will be accepted as valid.

Returns

A boolean success or failure of the operation.

See Also

  • ApiFeedback().SearchRemoveFromStack
  • ApiFeedback().SearchGetString
  • ApiFeedback().SearchGetTime
  • ApiFeedback().SearchNext

ApiFeedback()