1. Using the System as a Public User
1.1 Searching for a CLASS entry
Any user has the ability to search for CLASS entries, using the public page.
In page CLASS Consultation, a set of available criteria is available.
- Simulation Date: The date that will be used for retrieving valid keywords for that specific date, from EBTI3, that will be available in "Classification Document Keywords".
Information Type: The available selections are Classification Documents, CN Notes
and TARIC Information. Depending on the selection, the search will retrieve results from the selected
- If Classification documents is selected, the area with additional criteria "Classification Document Information" and "Classification Document Keywords" are enabled in the form.
- Free Text: Any text that will be used for searching within documents across CN, TARIC and CLASS.
- Classification Document Information:
- Document Reference: The Reference number of CLASS Entry.
- Classification Information Type: There are three check boxes, CCC Conclusion, Classification Regulation and EJC Ruling. According to the selection the results will be filtered to Information Types matching it.
Official Journal Reference Information:
- The user can set criteria regarding the Official Journal Reference. The Date, Series or Range of Series, Subseries of the Official Journal, as well as a specific Page. Note that when Number of Series is selected, a textbox is displayed, while once Range is selected, there are two textboxes, From and To, to set the Range.
- Document Publication Date: A date range, during which the Document was published, will be used to filter the results. Only documents that were published within that range will be offered.
- Document Validity Period: A date range, during which the Document is or was valid, will be used to filter the results. Only documents that are or were valid within that range will be offered.
Classification Document Keywords: Keywords that are provided by the EBTI3 system and are
with specific CLASS entries.
- In the text box Search for Keywords, the user can enter text in order to search for the available keywords from the EBTI3 system, in the specified date in Simulation Date.
- The user can select the operator between the keywords. AND means that all keywords must be present, while OR means that any of the keywords may be present.
- After pressing the button with the magnifying glass, that implies search, a list of Available Keywords will be presented to the user. Every keyword has a checkbox on the left, to allow selection. When the needed keywords are selected the plus (+) button, that implies add, may be pressed, in order for the keywords to populate the Selected Keywords list.
- In Selected Keywords, the list of keywords that are used in searching is presented. Every keyword has a checkbox on the left, to allow selection. The user can either select as many keywords as needed and select to remove them by pressing the minus (-) button, that implies remove the selected keywords, or press the eraser button which will remove all the keywords from the selected keywords list.
Commodity Codes: Are received from TARIC and can be used to filter results.
- In the text box Input Commodity Code, the user can enter text in order to search for Commodity Codes. This can be a specific number, or a range of numbers. Note that when Range is selected, then two textboxes are shown, in order for the user to define a range.
- The user can press the chain button in order to redirect to DDS2-TARIC to see more details about the Commodity Code.
- After setting a code or a range, it can be added to the Selected Commodity Codes by pressing the plus (+) button.
- In Selected Commodity Codes, the list of codes that are used in searching is presented. Every code has a checkbox on the left, to allow selection. The user can either select as many codes as needed and select to remove them by pressing the minus (-) button, that implies remove the selected codes, or press the eraser button which will remove all the codes from the selected commodity codes list.
Upon completing the criteria with the desired information, the user can press "Search" in the bottom right area to search with the selected criteria, or "Clear Form" to reset the form and empty the fields.
1.2 CLASS Consultation Results
All the results of CLASS entries matching the selected criteria in the search, will be presented in a list on a new page. The columns of the list are the Commodity Code and its description. The list is using the accordion type, meaning that all the list elements can be expanded within the list, in order for the user to explore the details of each entry.
Depending on the sources of the CLASS entry, different options are available to the user. Another level of detail can be seen depending on the origin of the information.
When the user searches free text in combination with search criteria in the Classification Information section in all three information types, the application will search for all combined matches of this, AND operation, in the Classification documents and only for the free text in CN Notes and TARIC.
When the user searches with search criteria in the Classification Information section in combination with either a single commodity or a commodity code range in all three information types, the application will search for all combined matches of this, AND operation, in the Classification documents and only for the commodity code (range) in CN Notes and TARIC.
When the user searches with search criteria in the Classification Information section in all three information types, the application will search for all combined matches of this, AND operation, in the Classification documents.
All the documents can be downloaded, using the button with a downwards pointing arrow.
Additionally, any TARIC related information can be further detailed, by visiting the DDS2-TARIC, pressing the corresponding button Show in DDS2-TARIC.
At the top of the page, a list of the defined criteria is shown, and the user is offered with the option to alter these criteria, by pressing the Edit Search Criteria button. This will redirect him/her to the search page, with the used criteria prefilled.
1.3 Search Query Syntax
The way in which the search query is formed can have an impact on the search results. Other configurations and built-in algorithms have their impact as well.
Below are some aspects to take into account in order to understand the returned results.
Use double quotes to receive results where the quoted search term is exactly matched in terms of order and without stemming. This is case insensitive.
For example, searching for "better regulations" will only return documents where this is matched. It will not match better regulation or better use of regulations
Use AND between two terms to get results that only contain both terms regardless of their location. For example search for Better AND Regulation will return documents that contain both terms such as Better understanding of regulations and regulations for better servicesOR
Use OR to between two terms to get results that contain either term or both at the same time. For example searching for Better OR regulations will return better use of IT and better regulations of IT services and sick leave regulations
Note: Default operator is set to OR by default unless configured differently.
Use the minus symbol - to exclude results that contain a term. For example Better -Regulations will return documents that contain Better but not Regulations
The use of + however does not force the results to include the term.
Minus symbol should be prepended by a space
Minus symbol should not be followed by a space
The supported wildcard operators are the following:
1. The asterisk * : that matches zero or more characters.
2. The question mark ?: that matches any single character. (e.g. f?rm will match farm, form and firm)
- The use of wildcards might not be always helpful since the query terms are not stemmed when included in a wildcard pattern (e.g. fermented* will not match fermented because it is stemmed in the index to ferment but not stemmed in the search query)
- As stated by Elastic, using patterns with * or ? at the beginning can increase the iterations needed to find matching terms and slow search performance.
- Search terms are stemmed to their morphological root. For example: searching for player will match play, playing, players, playful, and so on because it is stemmed to play
- Terms are also stemmed on the index time in order to match the stemmed query terms. For example if the ingested content contais playing it is indexed as play
- Pay attention when using wildcards and double quotes because this stops the stemming for example searching for playin* will not find play
- Stemming is language dependent; this means that the term is stemmed
to its morphological root in the language specified in the search or ingestion command.
- For example ingesting the word playing in a french document will not make it stemmed to play because it is not a French word.
- On the same time, if you search for écriture in English, this will not find documents where écrit is mentioned because it is not an English word hence it does not have a morphological root.
- musicale will not find musique the morphological root for musicale is music not musiq
- households will be stemmed into household thus it will not match housing or holders
We use the built-in standard tokenizer from Elastic Search that provides grammar based tokenization (based on the Unicode Text Segmentation algorithm).
For example report-summary is tokenized into two items: report summary while report_summary is tokenized to only one item: report_summary