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 parameterNtk
specifies 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 theNtk
parameter.)Ntt=search_term
. The keyword parameterNtt
specifies 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