A basic record
search requires two request URL parameters,
Ntk and
Ntt. This topic describes
Ntk and
Ntt and provides examples of their use.
The search key parameters are described as follows:
Ntk=search_key. The search key parameterNtkspecifies the property or dimension that will be examined by the search. Specify a property or dimension as a value for this parameter. (You can also specify a search interface as a value for theNtkparameter.)Ntt=search_term. The keyword parameterNttspecifies the search term.
The URL query parameters for record searches have the following characteristics:
The navigation dimension value (
N) and the record search parameters (Ntk,Ntt) are joined by a Boolean AND.Only records selected by the navigation dimension value (
N) are examined by the record search.Record search parameters must accompany a standard navigation request, even if that basic navigation request is empty (
N=0).A request without a Navigation value (
N) is invalid, even if a property key (Ntk) and keyword (Ntt) are specified.
Example 59. Examples of queries with Ntt and Ntk
For example, consider the following records:
|
Rec ID |
Dimension value (Wine Type) |
Name property |
Description property |
|---|---|---|---|
|
1 |
Red (Dim Value 101) |
Antinori Toscana Solaia |
Dark ruby in color, with extremely ripe... |
|
2 |
Red (Dim Value 101) |
Chateau St. Jean |
Dense, rich, and complex describes this California... |
|
3 |
White (Dim Value 103) |
Chateau Laville |
Dense and vegetal, with celery, pear, and spice flavors... |
|
4 |
Other (Dim Value 103) |
Jose Maria da Fonseca |
Big, ripe, and generous, layered with honey... |
For
example, the following query returns records 1 and 4, because the navigation
request is empty (N=0)
<application>?N=0&Ntk=Description&Ntt=Ripe
However, the following query returns only record 1, because the
navigation request (N=101) is already filtering the record set
to records 1 and 2:
<application>?N=101&Ntk=Description&Ntt=Ripe
The following query is invalid because it does not include a
navigation request (N):
<application>?Ntk=Description&Ntt=Ripe
