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