When you search a literal field, ASN Search returns only those items that contain an exact match for the complete search string in the specified field. For example, the statement notation field is configured as a literal field and so when you search for "CCSS.Math.Content.K.CC.B.4b" it will return the standard with that exact notation. This differs from text fields, where the specified search terms can appear anywhere within the field in any order.
Literal fields are often used in conjunction with faceting to enable users to drill down into the results according to the faceted attributes. For more information about faceting, see Getting and Using Facet Information.
Searching Literal Fields with the Boolean Query Parameter
To search literal fields, you must use the Boolean Query parameter, bq
. To search a literal field, prefix the search string with the name of the literal field you want to search, followed by a colon. The search string must be enclosed in single quotes. For example:
../search?bq=statement_notation:'CCSS.Math.Content.K.G.A.1'
This searches the statement notation field of each item and matches all items whose statement notation field contains the value of CCSS.Math.Content.K.G.A.1. To be a match, the field value must be an exact match for the search string. For example, items that contain the value CCSS.Math.Content.K.G.A.2 in the statement notation field will not be included in the search results when you search for CCSS.Math.Content.K.G.A.1.
In addition to searching literal fields, the bq
parameter can be used to search specific text and uint fields. To combine matches against multiple fields, you can use the Boolean operators and, or, and not. For more information about constructing Boolean queries, see Constructing Boolean Search Queries.
Note
To find out what literal field are offered in ASN Search see Field Names and Types.
Using Wildcards in Literal Searches
When searching literal fields, you can use the wildcard operator to find values that start with a particular string. For example, using the statement notation field in ASN Search, if you search for "CCSS.Math*", it will match all of the items for Common Core Math. Remember to be a match, the entire string up to the wildcard operator must match exactly.