| Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
| help:thesaurus:searching [2018/09/12 16:10] – jahnke | help:thesaurus:searching [2018/09/12 16:14] – jahnke |
|---|
| ======CERL Thesaurus Help====== | ======CERL Thesaurus Help====== |
| ===== Searching ===== | |
| |
| ===== Available Search Fields ===== | |
| |
| | ==== Full text search ==== |
| | {{ :resources:cerl_thesaurus:editing:search1.png?300|Search}} |
| | Probably the easiest approach to searching the CT is to use one or more terms in the full text search field. A full text search in the new environment will typically yield more hits than in the previous system, due to different indexing principles applied to the data. (To let your search mimic the behaviour of the old system, see below.) |
| |
| The CERL Thesaurus comes with a complex index that allows for sophisticated searches. The following search fields are available: | As a default your search result will be grouped the types of entities it contains: Corporate Names, Imprint Names, Places and Persons. Each group will display the first 25 hits and a link to the full set, if available. |
| | You may click a heading in these list to access the full record. |
| |
| ^ field ^ Fields ^ Description ^ | Clicking on "Show all ... records" will present the records of that set in a list that can be paged through using the buttons at the bottom of the page. |
| | active_in | 515$3 \\ with $0 'actv','resd','teac','schl','stud' or 'trad' | id of a place of activity of an entity \\ ''active_in:cnl00028786'' | | |
| | address | 515$a$d$e$r | search within the address of an entity \\ ''address:"Kerk-straat"'' | | |
| | based_in | 515$3 \\ with $0 'dioc' | id of the place a diocese or parish is based in \\ ''based_in:cnl00014398'' | | |
| | born_in | 515$3 \\ with $0 'brth' | id of the place a person was born in \\ ''born_in:cnl00008322'' | | |
| | child_of | 500$3 \\ with $0 'ex:hasParent' | id of a person who is a parent to another person | | |
| | collaborator_of | 500$3,510$3 \\ with $0 'ex:hasCollaborator' | id of a person or printer who has worked together with another person or printer | | |
| | corporateName | 212$a$b$e$r, 412$a$b$e$r | name (heading or variant) of a corporate entity (word) \\ ''corporateName:university'' | | |
| | corporateName.orig | 212$a$b$e$r, 412$a$b$e$r | name (heading or variant) of a corporate entity (phrase) | | |
| | dedup | 001c/p0-2 \\ with 831#1 present in the record | type of a record that is marked for deduplication \\ ''dedup:cnl'' | | |
| | died_in | 515$3 \\ with $0 'deat' | id of a place where a person died | | |
| | duplicate_of | 831#1$a | id of a record that could be a duplicate of another record | | |
| | external_id | 801$b$c | ID from an external file \\ ''external_id:gnd'' or ''external_id:(gnd 1029934118)'' | | |
| | feature | 956, 516 | a certain feature/chunk of information of a record \\ ''prdv'' Printers' Devices \\ ''prov'' Provnance Information \\ ''imag'' Image \\ feature:prdv | | |
| | gender | 120$a | a person's or printer's gender (code) \\ ''a'' female \\ ''b'' male \\ ''u'' unknown \\ ''gender:a'' | | |
| | has_member | 512$3 \\ with $0 'ex:isMemberOf' | id of a corporate body that has members | | |
| | id | 001, 035$z | CERL Thesaurus ID \\ ''id:cnc00006222'' | | |
| | imprintName | 210$a$b$e$r, 410$f$a$b$e$r | a name of a printer/bookseller etc. (heading or variant) (word) \\ ''imprintName:sermartelli'' | | |
| | imprintName.orig | 210$a$b$e$r, 410$f$a$b$e$r | a name of a printer/bookseller etc. (heading or variant) (phrase) | | |
| | last_changed | 999$a$b \\ only the last occurrence of 999 | date a record has last been changed \\ ''last_changed:[2017-12-01 TO * ]'' all records changed at or after Dec, 1st 2017 | | |
| | lived_in | 515$3 \\ with $0 'resd' | id of a place where a person lived | | |
| | location | 123$d$f | Geographic coordinates of a place | | |
| | name | 200/210/212/215$a$b$e$r, 400/410/412/415$f$a$b$e$r | name of an entity (word). This index is a combination of personalName, imprintName, corporateName and placeName \\ ''name:hamburg'' | | |
| | name.orig | 200/210/212/215$a$b$e$r, 400/410/412/415$f$a$b$e$r | name of an entity (phrase). This index is a combination of personalName.orig, imprintName.orig, corporateName.orig and placeName.orig | | |
| | note | 300$a,350$a,356$a | a general note, activity note or geographic note \\ ''note:printer'' | | |
| | parent_of | 500$3 \\ with $0 'ex:hasChild' | id of a person that is the child of another person | | |
| | placeName | 215$a$e$r, 415$a$e$r | name (heading or variant) of a place (word) \\ ''placeName:hamburg'' | | |
| | placeName.orig | 215$a$e$r, 415$a$e$r | name (heading or variant) of a place (phrase) | | |
| | personalName | 200$a$b$e$r, 400$f$a$b$e$r | name (heading or variant) of a person (word) \\ personalName:aristoteles | | |
| | personalName.orig | 200$a$b$e$r, 400$f$a$b$e$r | name (heading or variant) of a person (phrase) \\ personalName:aristoteles | | |
| | predecessor_of | 500/510/512$3 | id of the entity that is the successor of another entity | | |
| | record_flag | 830$6 | a specific record marker \\ ''record_flag:ba18'' | | |
| | related_to | 500/510/512/515$3 | id of a record related to another record (backlinks) \\ ''related_to:cnl00032270'' | | |
| | school_in | 515$3 \\ with $0 'schl' | id of a place where a person visited a school | | |
| | sign | 516$a$n | description of a sign/marks/device etc \\ ''sign:tortuga'' | | |
| | spouse_of | 500$3 \\ with $0 'ex:hasSpouse' | id of a person that has been married to another person | | |
| | studied_in | 515$3 \\ with $0 'stud' | id of a place where a person visited a university | | |
| | subordinate_to | 512$3 \\ with $0 'ex:hasSuperiorHierarchicalLevel' | id of a corporate entity that has a sub division | | |
| | successor_of | 500/510/512$3 \\ with $0 'ex:hasPredecessor' | id of an entity that is a predecessor to another entity | | |
| | superior_to | 512$3 \\ with $0 'ex:hasSubordinateHierarchicalLevel' | id of a corporate entity that is a sub-division of another corporate entity | | |
| | tought_in | 515$3 \\ with $0 'teac' | id of a place where a person was teaching (e.g. at a school or university) | | |
| | traded_in | 515$3 \\ with $0 'trad' | id of a place where another entity conducted business | | |
| | type | 001c/p0-2 | record type \\ type:cnp | | |
| | visited | 515$3 \\ with $0 'vist' | id of a place a person has visited | | |
| | year_end | 340$x | search for entities whose activity or existence ended before, in or after a certain year \\ ''year_end:>1800'' \\ year_end:<1500 | | |
| | year_start | 340$x | search for entities whose activity or existence started before, in or after a certain year \\ ''year_start:[1530 TO 1560]'' | | |
| |
| | To bookmark a record, click the bookmark icon in the top right corner of the record. You can access your bookmarked records from the item "Bookmarks" in the top navigation bar. |
| |
| ===== Query Syntax ===== | |
| Search fields of the type **string** (except those ending in ''.orig'') are word indexed, case-insensitive and diacritics are replaced by the base character. They can be searched by just typing the search term after the search key's name, separated by a colon: | |
| |
| * ''name:hamburg'' the term //hamburg// should appear in the //name:// field | ==== Limiting and sorting your search results ==== |
| * ''personalName:(visser jacob)'' the terms //visser// and //jacob// should appear in the //personalName:// field in any order, regardless if adjacent or not | |
| * ''imprintName:"sermartelli e fratelli"'' the terms //sermartelli e fratelli// should appear in the //imprintName:// field in exactly this order | |
| |
| The fields named **.orig** contain the original field's content as a phrase, case-sensitive, diacritics are not replaced: | |
| * ''imprintName.orig:"Bartolommeo Sermartelli e fratelli, Firenze"'' | |
| |
| Search fields of the type **date** allow for range searches: | If your search yields too many hits, you can reduce the size of your resultset using one of the limiting options in the right column of the result screen. |
| |
| * ''last_changed:[2017-05-1 TO 2017-05-31]'' all records that have last been edited //in May 2017// | The option "Search for names only" will limit your search to the headings and variant names fields of a record, thus emulating the search behaviour of the old CERL Thesaurus web interface. |
| * ''year_start:<1600'' all entities that were born or started their activity //before the year 1600//. | |
| |
| Search terms can be combined by using the **Boolean Operators** ''AND'', ''OR'' and ''NOT''. Please note that these must always be written in upper case. | {{ :resources:cerl_thesaurus:editing:search2.png?300|Search}} |
| |
| * ''year_start:<1600 AND feature:prdv'' all records where the activity/birth date is before 1600 and that contain descriptions of printers devices | The limit "by feature" option allows you to select those records from the current sets that contain either provenance information, Links to the printers' devices or images (portraits). The number in parentheses indicates the size of the resultset after applying the limitation. You may also limit your result by the gender of the described person (persons and imprint names). |
| * ''name:sermartelli AND name:(bartolomeo OR michelangelo)'' all records where the name field contains //Sermartelli// and either //Bartolomeo// or //Michelangelo//. | |
| |
| **Truncation/Wildcards** can be used as well. Please that using wildcards will slow down the response time remarkably. | The search results are by default sorted alphabetically. If you want to consult them in chronological order, you may do so by clicking "chronologically (earliest first)" or "chronologically (latest first)" from the "Sort your result" section below the Limit options. |
| |
| * ''?'' replaces exactly one character | ==== Using search keys ==== |
| * ''*'' replaces any number or characters including zero | |
| | You may formulate more complex queries using the following search keys in the search box. A search key must always be followed by a colon and the value you are searching for without any blanks. You may also use parentheses and the Boolean operators AND, OR and NOT (note that the Boolean operators must be written in capital letters). |
| | |
| | Truncation is possible by adding an asterisk (*) to the search term. To search for phrases, put those in quotation marks ("). |
| | |
| | |address|search within the address of an entity \\ ''address:"Kerk-straat"''| |
| | |corporateName|search only within the names (headings and variants) of corporate entities \\ ''corporateName:university''| |
| | |dedup|search for records marked for deduplication (see below) \\ ''dedup:cnl''| |
| | |external_id|search for IDs from external files \\ ''external_id:gnd'' or ''external_id:(gnd 1029934118)''| |
| | |feature|search for records with certain features \\ ''prdv'' Printers' Devices \\ ''prov'' Provnance Information \\ feature:prdv | |
| | |gender|search for persons or printers by their gender \\ ''a'' female \\ ''b'' male \\ ''u'' unknown \\ ''gender:a''| |
| | |id|search for a CERL Thesaurus ID \\ ''id:cnc00006222''| |
| | |imprintName|search only within the names (headings and variants) of printers etc. \\ ''imprintName:sermartelli''| |
| | |last_changed|search for records last changed at a certain date or within a certain time period \\ ''last_changed:[2017-12-01 TO * ]'' all records changed at or after Dec, 1st 2017| |
| | |name|search only within name fields \\ ''name:hamburg''| |
| | |note|search only within note fields \\ ''note:printer''| |
| | |placeName|search only within the names (headings and variants) of places \\ ''placeName:hamburg''| |
| | |personalName|search only within the names (headings and variants) of persons \\ personalName:aristoteles| |
| | |record_flag|search for records bearing a specific marker \\ ''record_flag:ba18''| |
| | |related_to|search for records that link to the given record id. There is a number of search keys that allow for more detailled searches for certain relationship types, which are not listed here. \\ ''related_to:cnl00032270''| |
| | |sign|search within the sign/marks/devices fields \\ ''sign:tortuga''| |
| | |type|search for a certain record type \\ type:cnp| |
| | |year_end|search for entities whose activity or existence ended before, in or after a certain year \\ ''year_end:>1800'' \\ year_end:<1500| |
| | |year_start|search for entities whose activity or existence started before, in or after a certain year \\ ''year_start:[1530 TO 1560]''| |
| | |
| | a complete list of available search keys can be found here: [[indexing]] |
| | |
| | ==== Working with the Search History ==== |
| | |
| | |
| | The last 20 searches you have performed (or records you've consulted in full display) are recorded in your search history and can be seen from the item "History" in the top navigation bar. You can go back to a particular search or record by clicking on the query or record id. |
| | |
| | The search history is associated with the current session. If you don't do anything in the web interface for more than two hours, logout or if you clear your browser cookies, the session will be terminated and the search history will be no longer available. Data associated with terminated sessions is deleted from the server after 24 hours. |
| | |
| | |
| | ==== Browsing alphabetical indexes ==== |
| | {{ :resources:cerl_thesaurus:editing:browse.png?300|Browse}} |
| | You may search for names of places, corporate bodies, printers, persons and entities for which provenance information is available by using alphabetical browse lists. They are available from the item "Browse" in the top navigation bar. |
| | |
| | Select an alphabetical browse list from the dropdown and type the first few characters of your search term into the field next to it and hit "Browse" to open the list at the desired position. To go to the previous or next section of the list, use the navigation buttons at the bottom of the page. |
| | |
| | The number at the left of each entry indicates the number of records that hold the particular name form. Clicking on the entry itself will trigger a search and present the records. |
| |
| |
| ===== Searching Relationships ===== | |
| A number of the search keys listed above allow to retrace the relationship between the entities described in the CERL Thesaurus. It is assumed that one part of the relationship is known, e.g. a person or a place and using this person's or place's id, we can retrieve the records that link back to it. | |
| |
| For example: Knowing the ID for the place "Tübingen", we can retrieve persons who went to university here: ''studied_in:cnl00014526'' | |
