diff --git a/requirements.txt b/requirements.txt index e1e4afe8..b2d18774 100644 --- a/requirements.txt +++ b/requirements.txt @@ -20,6 +20,7 @@ sphinx-comments==0.0.3 sphinx-fontawesome==0.0.6 sphinx-intl==2.0.1 sphinx-notfound-page==0.8 +sphinx-toolbox==3.4.0 sphinx-rtd-theme==1.0.0 sphinxcontrib-applehelp==1.0.2 sphinxcontrib-contentui==0.2.5 diff --git a/source/_static/images/daten-suchen/Suche_open-data.png b/source/_static/images/daten-suchen/Suche_open-data.png new file mode 100644 index 00000000..bb89a26a Binary files /dev/null and b/source/_static/images/daten-suchen/Suche_open-data.png differ diff --git a/source/_static/images/daten-suchen/Suchmodi_OR.png b/source/_static/images/daten-suchen/Suchmodi_OR.png new file mode 100644 index 00000000..5e218d25 Binary files /dev/null and b/source/_static/images/daten-suchen/Suchmodi_OR.png differ diff --git a/source/_static/images/daten-suchen/Suchmodus_plusundminus.png b/source/_static/images/daten-suchen/Suchmodus_plusundminus.png new file mode 100644 index 00000000..78a68f4a Binary files /dev/null and b/source/_static/images/daten-suchen/Suchmodus_plusundminus.png differ diff --git a/source/_static/images/daten-suchen/Suchvorschlaege.png b/source/_static/images/daten-suchen/Suchvorschlaege.png new file mode 100644 index 00000000..5b5a73b3 Binary files /dev/null and b/source/_static/images/daten-suchen/Suchvorschlaege.png differ diff --git a/source/_static/images/daten-suchen/Trefferliste_de.png b/source/_static/images/daten-suchen/Trefferliste_de.png new file mode 100644 index 00000000..ee330a20 Binary files /dev/null and b/source/_static/images/daten-suchen/Trefferliste_de.png differ diff --git a/source/_static/images/daten-suchen/bild-facetten.png b/source/_static/images/daten-suchen/bild-facetten.png new file mode 100644 index 00000000..940c9164 Binary files /dev/null and b/source/_static/images/daten-suchen/bild-facetten.png differ diff --git a/source/_static/images/daten-suchen/keywords-suche.png b/source/_static/images/daten-suchen/keywords-suche.png new file mode 100644 index 00000000..4cf7ca92 Binary files /dev/null and b/source/_static/images/daten-suchen/keywords-suche.png differ diff --git a/source/_static/images/daten-suchen/phrasensuche.png b/source/_static/images/daten-suchen/phrasensuche.png new file mode 100644 index 00000000..67a10816 Binary files /dev/null and b/source/_static/images/daten-suchen/phrasensuche.png differ diff --git a/source/_static/images/daten-suchen/slug-organisation.png b/source/_static/images/daten-suchen/slug-organisation.png new file mode 100644 index 00000000..26e7cfc6 Binary files /dev/null and b/source/_static/images/daten-suchen/slug-organisation.png differ diff --git a/source/_static/images/daten-suchen/sortieren-nach.png b/source/_static/images/daten-suchen/sortieren-nach.png new file mode 100644 index 00000000..ee0b1528 Binary files /dev/null and b/source/_static/images/daten-suchen/sortieren-nach.png differ diff --git a/source/_static/images/daten-suchen/suche-in-description_1.png b/source/_static/images/daten-suchen/suche-in-description_1.png new file mode 100644 index 00000000..9d5968e1 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-description_1.png differ diff --git a/source/_static/images/daten-suchen/suche-in-description_2.png b/source/_static/images/daten-suchen/suche-in-description_2.png new file mode 100644 index 00000000..897d9bea Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-description_2.png differ diff --git a/source/_static/images/daten-suchen/suche-in-description_3.png b/source/_static/images/daten-suchen/suche-in-description_3.png new file mode 100644 index 00000000..de951671 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-description_3.png differ diff --git a/source/_static/images/daten-suchen/suche-in-organisation-begriff.png b/source/_static/images/daten-suchen/suche-in-organisation-begriff.png new file mode 100644 index 00000000..13906e33 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-organisation-begriff.png differ diff --git a/source/_static/images/daten-suchen/suche-in-title_auschliessen.png b/source/_static/images/daten-suchen/suche-in-title_auschliessen.png new file mode 100644 index 00000000..912f0678 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-title_auschliessen.png differ diff --git a/source/_static/images/daten-suchen/suche-in-title_einschliessen.png b/source/_static/images/daten-suchen/suche-in-title_einschliessen.png new file mode 100644 index 00000000..dc5aaecf Binary files /dev/null and b/source/_static/images/daten-suchen/suche-in-title_einschliessen.png differ diff --git a/source/_static/images/daten-suchen/suche-organisation.png b/source/_static/images/daten-suchen/suche-organisation.png new file mode 100644 index 00000000..9937b7d8 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-organisation.png differ diff --git a/source/_static/images/daten-suchen/suche-wortstamm.png b/source/_static/images/daten-suchen/suche-wortstamm.png new file mode 100644 index 00000000..7d7e07f2 Binary files /dev/null and b/source/_static/images/daten-suchen/suche-wortstamm.png differ diff --git a/source/_static/images/daten-suchen/suchfeld-opendataswiss.png b/source/_static/images/daten-suchen/suchfeld-opendataswiss.png new file mode 100644 index 00000000..7e60fe00 Binary files /dev/null and b/source/_static/images/daten-suchen/suchfeld-opendataswiss.png differ diff --git a/source/_static/images/daten-suchen/suchmodi_and.png b/source/_static/images/daten-suchen/suchmodi_and.png new file mode 100644 index 00000000..4a9d2e6b Binary files /dev/null and b/source/_static/images/daten-suchen/suchmodi_and.png differ diff --git a/source/conf.py b/source/conf.py index b1ee9792..40fa74a4 100644 --- a/source/conf.py +++ b/source/conf.py @@ -14,6 +14,7 @@ import os import sphinx_rtd_theme import sphinx_fontawesome +import sphinx_toolbox from dotenv import load_dotenv @@ -41,6 +42,7 @@ 'notfound.extension', 'sphinx_comments', 'sphinxcontrib.contentui', + 'sphinx_toolbox.collapse' ] notfound_no_urls_prefix = True diff --git a/source/content/nutzen/daten-suchen.rst b/source/content/nutzen/daten-suchen.rst index cd98dbac..b64aa82c 100644 --- a/source/content/nutzen/daten-suchen.rst +++ b/source/content/nutzen/daten-suchen.rst @@ -14,111 +14,336 @@ Wie finde ich die Daten, die ich brauche? .. container:: Intro Um Ihnen die Suche nach Daten zu erleichtern, bietet opendata.swiss - ein Suchfeld an sowie Filtermöglichkeiten. Sie können mittels sogenannter - Abfragesyntax (Querysyntax) komplexe Suchanfragen gegen die Metadaten - von opendata.swiss vornehmen. - Hier erklären wir Ihnen, wie die Suche funktioniert, geben Erläuterungen - zur Abfragesyntax und bieten Ihnen hilfreiche Beispiele. + ein Suchfeld an sowie Filtermöglichkeiten. Sie können einfache Suchanfragen stellen oder + mittels sogenannter Abfragesyntax (Querysyntax) komplexere Suchanfragen formulieren. + Diese Seite erklärt, wie die Suche funktioniert, erläutert die Abfragesyntax + und stellt hilfreiche Beispiele zur Verfügung. + +Sie können nach Datasets auf der `Einstiegsseite von opendata.swiss `__ +oder unter der Rubrik `Daten `__ suchen. +Auf der `Organisationsseite `__ können Sie nach Organisationen +suchen. Wenn Sie an Beispielen für die Wiederverwendung von `Open Government Data `__ +interessiert sind, finden Sie unter der Rubrik `Showcases `__ Applikationen, Visualisierungen und Veranstaltungen. + +Wie funktioniert das Suchfeld von opendata.swiss? +------------------------------------------------- + +Das Suchfeld von opendata.swiss ist so konzipiert, dass es einfache +Phrasen (Suchbegriffe ohne komplexe Syntax) verarbeiten und nach einzelnen Begriffen +in mehreren Metadatenfeldern mit unterschiedlicher Gewichtung suchen kann, je nach +Bedeutung der einzelnen Metadatenfelder. So hat beispielsweise das +Feld ``Titel`` eine stärkere Gewichtung als das Feld ``Beschreibung``. Die +Suchmaschine Solr ordnet Ihre Anfrage entsprechend ein und liefert Ihnen +je nach Suchstrategie die passenden Treffer. + +.. figure:: ../../_static/images/daten-suchen/suchfeld-opendataswiss.png + :alt: Suchfeld auf der Seite Daten auf opendata.swiss + + + + +.. collapse:: Suchindex + + Der Suchindex ist im Grunde die *Datenbank*, in der alle Informationen für die Suche gespeichert werden. + Es wird ein benutzerdefiniertes Schema mit allen Datensatzfeldern, die indiziert werden sollen, verwendet. + Das Schema ist flach, das heisst verschachtelte Elemente wie Ressourcen müssen anders + gespeichert werden, damit Solr sie indizieren kann. Das Gleiche gilt für die mehrsprachigen Felder, + die alle mit dem dazugehörenden Sprachsuffix gespeichert werden. So enthält ``keywords_en`` die englischen + Schlüsselwörter. Standarmässig werden alle Felder, die zu einem Datensatz gehören, in ein + Feld (genannt ``text``) kopiert, so dass der Suchprozess nur ein Feld überprüfen muss, um eine + Übereinstimmung zu finden. Wenn also ein Benutzer eine Suche mit der Abfrage ``Wetter`` in das Suchfeld + eingibt, führt Solr diese Abfrage über das Feld ``text`` aller Datensätze aus. + + .. csv-table:: URL + :align: center + :header: "Index-Name", "Name des Metadatenfeldes" + + "downloadURL", "DownloadURL" + "res_url", "URL der Ressource" + + + .. csv-table:: Text-Felder + :align: center + :header: "Index-Name", "Name des Metadatenfeldes" + + "name", "Slug des Datasets, z.B. *wassertemperaturen-freibader*" + "title", "Titel des Datasets" + "title_string", "Titel" + "license", "Nutzungsbedingungen" + "groups", "Kategorien" + "organization", "Organisation" + "res_name", "Titel der Ressource" + "res_format", "Format der Ressource" + "res_description", "Beschreibung der Ressource" + "identifier", "Identifier" + "see_alsos", "Verwandte Datasets" + "maintainer", "Kontaktstelle" + "author", "Urheber Showcase" + "publisher", "Publisher" + "contact_points", "Kontaktstellen" + + .. csv-table:: Übersetzte Felder + :align: center + :header: "Index-Name", "Name des Metadatenfeldes" + + "title", "Titel des Datasets" + "keywords", "Schlagwörter" + "groups", "Kategorien" + "organization", "Organisation" + "res_name", "Titel der Ressource" + "res_description", "Beschreibung der Ressource" + + + +.. figure:: ../../_static/images/daten-suchen/Trefferliste_de.png + :alt: Suche auf opendata.swiss + +Trefferliste +------------- +In der Trefferliste werden alle Datasets angezeigt, die den von Ihnen eingegebenen Suchkriterien entsprechen. Wenn +Sie keine Suchkriterien ausgewählt haben, wird Ihnen eine Liste aller auf opendata.swiss vorhandenen Datasets angezeigt. + +In der Trefferliste finden Sie unterhalb des Suchfeldes die Anzahl der Datasets, die Ihrer Suchanfrage entsprechen. +Damit Sie sich einen schnellen Überblick über die gefundenen Datasets verschaffen können, werden diese mit folgenden Metadaten angezeigt: +``Titel des Datasets``, ``Name der Organisation``, ``Kategorien``, ``Beschreibung``, ``Letzte Aktualisierung der Metadaten (Ebene Dataset/Ressource)``, +``Formate`` und ``Schlagwörter``. + +Durch Anklicken des Dataset-Titels gelangen Sie zur Dataset-Seite, mit den wichtigen Beschreibungen (Metadaten) des +entsprechenden Datasets, wie Titel, Beschreibung, Nutzungsbedingungen, etc. Die Daten können entweder direkt über eine Download-URL heruntergeladen +werden oder, wenn sie nur über eine Landing Page verfügbar sind, über eine Zugangs-URL. Dies können Sie direkt +auf der Dataset-Seite machen oder Sie können auch weiter auf die Ressourcen-Seite navigieren. + +Filtern +------- +Duch Anklicken der entsprechenden Facetten der Filterkategorien können Sie Ihre +Suchergebnisse verfeinern. Es kann nach *Kategorien*, *Schlagwörtern*, *Organisationen*, +*politischen Ebenen*, *Nutzungsbedingungen* und den *Formaten* gefiltert werden. Wenn Sie +nach Datasets einer bestimmten Kategorie suchen, können Sie diese direkt +von der Startseite von `opendata.swiss `__ bereits filtern. + +.. figure:: ../../_static/images/daten-suchen/bild-facetten.png + :alt: Filterfacetten + +In der Rubrik `Daten `__ finden Sie alle Filtermöglichkeiten +links neben der Trefferliste. Eine Mehrfachauswahl innerhalb einer Filterkategorie ist möglich, jedoch +nur innerhalb der gefilterten Ergebnisse in der Trefferliste (Schnittmenge). Interessieren Sie sich beispielsweise für Datasets +aus den Kategorien *Geographie* oder *Raum und Umwelt*, müssen Sie diese einzeln nacheinander auswählen, da sonst nur Dataset, +die beide Kategorien tragen gefunden werden. Nachdem Sie einen Filter gesetzt haben, können Sie die Trefferliste mit weiteren Filtermöglichkeiten, wie zum Beispiel *Formate* +erweitern. Zum Beispiel wenn ich nur an Dataset interessiert bin, die der Kategorie *Geographie* zugehörig sind, +aber nur Ressourcen mit dem Format *JSON* enthalten. + + +Sortieren +--------- +Sie haben die Möglichkeit, Ihre Trefferliste zu sortieren. Dazu stehen Ihnen die Sortierung nach +*Relevanz*, *Daten zuletzt geändert*, *Metadaten zuletzt geändert*, *Name aufsteigend* und nach +*Name absteigend* zur Verfügung. + +.. figure:: ../../_static/images/daten-suchen/sortieren-nach.png + :alt: sortieren nach + +.. admonition:: Wichtig + + Bei der Suche nach einem Begriff im Index, wird für jedes Dataset eine + Punktzahl berechnet. Mit der Option *Relevanz* werden die Ergebnisse in + der Trefferliste nach der Punktzahl absteigend sortiert. + +Stichwortsuche +--------------- + +Bei der Stichwortsuche geben Sie Ihre(n) Suchbegriff oder Ihre Suchbegriffe in das Suchfeld ein. +Während der Eingabe erscheint unterhalb des Suchfeldes eine Auswahl von `Vorschlägen `__. +Diese können Sie bei Bedarf anklicken. Mit der Eingabetaste (Enter) starten Sie die Suche. + +.. admonition:: Wichtig + + Bitte achten Sie auf die korrekte Schreibweise Ihrer Suchbegriffe. + Falsch eingegebene Suchbegriffe ergeben keine Treffer. Gross- und + Kleinschreibung wird nicht berücksichtigt. + +Vorschläge für Suchbegriffe +--------------------------- + +Bei der Eingabe von Suchbegriffen werden Ihnen Vorschläge angezeigt, +die Sie bei Bedarf auswählen können. Für jede Sprache wird mehrmals täglich +ein in sich geschlossener Solr-Index aufgebaut. Das bedeutet, dass Änderungen +an Datasets oder neue Datasets nicht sofort in den Vorschlägen berücksichtigt werden. + +.. figure:: ../../_static/images/daten-suchen/suchvorschlaege.png + :alt: Suche auf opendata.swiss + +.. collapse:: Index - Vorschläge für Suchbegriffe + + + Der entsprechende Index für die Vorschläge ist aus den folgenden Feldern aufgebaut: -Technical background --------------------- - -opendata.swiss has a very powerful search engine, that can help you to -find exactly the datasets you want. The search is provided by the open -source component `Apache Lucene/Solr `__. -Every dataset is -indexed by Solr when it gets updated, and if you perform a search on the -portal, this index is queried to efficiently deliver results. - -The search index is basically the “database” where all the information -for the search is saved. It uses a custom schema with all the dataset -fields that should be indexed. The schema is flat, i.e. nested elements -like resources must be saved differently, in order for Solr to index -them. The same applies to the multilingual fields, which are all stored -with the language suffix, e.g. ``keywords_en`` contains the English -keywords. - -By default, all the fields that belong to a dataset are copied in one -field (called *“text”*), so that the search process only has to check -one field to find a match. So if a user submits a search with the query -“weather”, Solr runs this query against the *“text”* field of all -datasets. - -Search Index ------------- - -The search index contains the following fields: - -:URLs: ``url``, ``ckan_url``, ``download_url``, ``res_url`` - -:Text-fields: ``extras_*``, ``res_extras_*``, ``urls``, ``name``, - ``title``, ``title_string``, ``text``, ``license``, ``notes`` - ``tags``, ``groups``, ``organization``, ``res_name`` - ``res_format``, ``res_description``, ``identifier``, ``see_alsos`` - ``maintainer``, ``author``, ``publishers``, ``contact_points`` - -:Translated fields: ``title``, ``keywords``, ``groups`` - ``organization``, ``res_name``, ``res_description`` - -Find more detailed information about the Solr configuration in the -`official Solr documentation `__. -The config and schema of opendata.swiss is available on GitHub: - -- `Solr configuration and schema of opendata.swiss `__ - -The source of the referenced files in the ``solr.xml`` -(e.g. ``italian_stop.txt``, ``fr_elision.txt``, etc.) can be found in -the official CKAN-Repository of the current `CKAN-Version on -Github `__. -All other files (e.g. ``stopwords.txt``) are provided by Solr. - -Query syntax ------------- - -Solr has its own `query syntax `__ -to write complex queries. Depending on the query, Solr uses a different -query parser to determine what to do. - -Search operators ----------------- - -- Use ``+{field}:{value}`` to include a search term, - e.g. ``+title_en:power`` - to find all datasets, whose English title contains the word “power” -- Use ``-{field}:{value}`` to exclude a search term, - e.g. ``+title_en:power -title_en:hydraulic`` - to find all datasets, whose English title contains the word “power”, - but not “hydraulic” -- Use ``AND`` to combine several search terms that all must match, - e.g. ``keywords_en:(geology AND geophysics)`` - to find all datasets that have both tags ``geology`` and - ``geophysics`` -- Use ``OR`` to combine several search terms, where one of them must - match, - e.g. ``organization:(kanton-thurgau OR stadt-zurich)`` -- All of these options can be further combined together, - e.g. ``organization:(kanton-thurgau OR stadt-zurich) karte`` - -Searchterm suggestions ----------------------- - -The search-field of opendata.swiss provides -searchterm-suggestions when a user types into it. For each language a -self-contained Solr index is built multiple times throughout the day. -That means that changes to datasets or new data won’t be reflected in -the suggestions immediately. - -The index is based on the following fields: - -- ``dataset-title`` (translated) -- ``keywords`` (translated) -- ``groups`` (translated) -- ``organization`` (translated) -- ``distribution-name`` (translated) -- ``author`` -- ``maintainer`` -- ``contact_points`` -- ``publishers`` -- ``identifier`` -- ``distribution-format`` + .. csv-table:: Index - Vorschläge für Suchbegriffe + :align: center + :header: "Index-Name", "Name des Metadatenfeldes" + + "dataset-title (translated)", "Titel des Datasets" + "keywords", "Schlagwörter" + "groups", "Kategorien" + "organization", "Organisation" + "distribution-name", "Titel der Ressource" + "author", "Einreichende Person oder Stelle in der Showcase-Rubrik" + "publishers", "Publisher" + +Suchsprache +----------- + +Die Syntax kommt von Solr und das Vokabular von opendata.swiss + +.. collapse:: Tabelle Solr-Syntax + + .. csv-table:: Solr-Syntax + :align: center + :header: "Syntax-Element", "Funktion", "Beispiel", "Bedeutung" + + "`*`", "Existenz", "title_de:*", "Hat einen deutschen Titel" + "`-`", "Ausschluss", "-title_de:open", Deutscher Titel enthält nicht Begriff *open* + "`+`", "Einschluss", "+title_fr:ouvert", Französischer Titel enthält Begriff *ouvert* + "`? *`", "Wildcards", "", "ein Zeichen, beliebig viele Zeichen" + "AND", "und", "keywords_en:(geodaten&&energy)", "Schnittmenge" + "OR", "oder", "organization:(kanton-thurgau || stadt-zurich)", "Vereinigungsmenge" + +Erweiterte Suche mithilfe von Operatoren +----------------------------------------------- + +Eine Suchanfrage gliedert sich in einzelne Begriffe ``open``, `Phrasen `__ +``open data`` und Operatoren. Um eine komplexere Suchanfrage zu erstellen, können Sie mehrere +Begriffe oder Phrasen mit Suchoperatoren kombinieren. Die Suchlogik folgt der +Syntax von `Apache Lucene/Solr `__. +Der Standardoperator im Suchfeld ist der `Operator `__ ``OR`` . Das bedeutet, dass, +wenn Sie mehrere Begriffe in das Suchfeld eingeben, die Suchanfrage als OR-Anfrage behandelt wird, +ohne dass Sie diesen Operator eingeben müssen. Wenn Sie den Begriff *open data* in das Suchfeld eingeben, +werden *open* und *data* als Einzelbegriffe behandelt. In der Trefferliste finden +Sie nun Datasets aufgelistet, bei denen *open* **oder** *data* im Suchindex gefunden wurde. +Wenn Sie nach der Phrase *open data* suchen wollen, dann müssen Sie +die Begriffe in Anführungs- und Schlusszeichen setzen: "open data". + +.. figure:: ../../_static/images/daten-suchen/suche_open-data.png + :alt: Suche nach Begriffen open und data ohne Operatoren + +Suchmodi +-------- +**OR (||)** +^^^^^^^^^^^ +Der Operator ``OR`` gibt Ihnen alle Datasets zurück, die den Begriff *open* oder *data* +in ihrem Index enthalten. Dieser Operator ist als Standardoperator im Suchfeld implementiert. +Sie können daher mehrere Begriffe auch ohne ``OR`` in das Suchfeld eingeben. + +.. figure:: ../../_static/images/daten-suchen/suchmodi_OR.png + :alt: Suche nach Begriffen open und data mit dem OR-Operator + +**AND (&&)** +^^^^^^^^^^^^ +Mit dem Operator ``AND`` werden alle Datasets angezeigt, deren Suchindex *open* und *data* enthält. +Datasets, die nur einen dieser Begriffe enthalten, erscheinen nicht in der Trefferliste. + +.. figure:: ../../_static/images/daten-suchen/suchmodi_and.png + :alt: Suche nach Begriffen open und data mit dem AND-Operator + +**Ein- und Ausschluss von Begriffen (+)(-)** +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Wenn Sie nach Datasets suchen, die den Begriff *open*, aber nicht den Begriff *data* enthalten sollen, +können Sie den gewünschten Begriff mit dem Operator ``+`` einschliessen und den unerwünschten +Begriff mit dem Operator ``-`` ausschliessen. + +.. figure:: ../../_static/images/daten-suchen/Suchmodus_plusundminus.png + :alt: Suche nach Begriffen mit Plus-Zeichen vor open und Minus-Zeichen vor data + +**Phrasensuche** +^^^^^^^^^^^^^^^^ +Mit Anführungszeichen können Sie nach Begriffen suchen, die zusammengehören. In der Trefferliste +finden Sie mit ``"open data"`` nun Datasets, die *open data* als Phrase enthalten. Entscheidend ist +die Reihenfolge der beiden Begriffe. Datasets, die die Phrase *data open* enthalten, erscheinen +nicht in der Trefferliste. + +.. figure:: ../../_static/images/daten-suchen/phrasensuche.png + :alt: Suche nach dem Begriff open data mit Anführungszeichen + +**Suche in den Feldern** +^^^^^^^^^^^^^^^^^^^^^^^^ +Wenn Sie nach einem Dataset suchen, in dessen Beschreibung der Begriff *open data* vorkommen soll, +können Sie dem Begriff die Feldbezeichnung ``description`` gefolgt von einem **Doppelpunkt** ``:`` voranstellen. + +.. figure:: ../../_static/images/daten-suchen/suche-in-description_1.png + :alt: Suche in description nach Phrase open data + +Wenn Sie nach einem Dataset suchen, das sowohl *open* als auch *data* in seiner Beschreibung enthalten soll, +können Sie eine Suchanfrage mit dem Operator ``AND`` formulieren und in Klammern hinter die Feldbezeichnung setzen. +Dasselbe können Sie mit dem Operator ``OR`` tun, wenn entweder der Begriff *open* oder der Begriff +*data* in der Beschreibung des Datasets vorkommen soll. + +.. figure:: ../../_static/images/daten-suchen/suche-in-description_2.png + :alt: Suche in description mit AND-Operator + +.. figure:: ../../_static/images/daten-suchen/suche-in-description_3.png + :alt: Suche in description mit OR-Operator + +Sie können auch Begriffe innerhalb eines `bestimmten Feldes einschliessen `__: ``+{field}:{value}``. +Wenn Sie zum Beispiel an einem Dataset interessiert sind, in dessen englischem Titelfeld der Begriff ``power`` +vorkommen soll. + +.. figure:: ../../_static/images/daten-suchen/suche-in-title_einschliessen.png + :alt: +title_en:power + +Die gleiche Suche ist auch möglich, wenn Sie zusätzlich einen Begriff ausschliessen wollen: ``-{field}:{value}``. Sie suchen +zum Beispiel nach einem Dataset, in dessen englischem Titelfeld zwar der Begriff ``power`` vorkommt, nicht aber der Begriff ``hydraulic``. + +.. figure:: ../../_static/images/daten-suchen/suche-in-title_auschliessen.png + :alt: +title_en:power -title_en:hydraulic + +Weiter können Sie auch nach Datasets suchen, die bestimmte Schlüsselwörter enthalten. Sie möchten zum Beispiel alle +Datasets mit den englischsprachigen Schlagwörtern ``geology`` und ``geophysics`` finden. + +.. figure:: ../../_static/images/daten-suchen/keywords-suche.png + :alt: keywords_en:(geology AND geophysics) + +Es ist auch möglich, mehrere Suchbegriffe mit dem Operator ``OR`` zu verknüpfen. Zum Beispiel möchten Sie +ein Dataset finden, das entweder von der Organisation ``Kanton Thurgau`` oder ``Stadt Zürich`` publiziert wird. +Bei dieser Suche muss jedoch der Slug der Organisation angegeben werden. Diesen finden Sie in der URL der Organisationsseite +der jeweiligen Organisation. In unserem Beispiel wäre das für den `Kanton Thurgau `__: ``kanton-thurgau``. + +.. figure:: ../../_static/images/daten-suchen/slug-organisation.png + :alt: URL der Organisation Kanton Thurgau + +.. figure:: ../../_static/images/daten-suchen/suche-organisation.png + :alt: organization:(kanton-thurgau OR stadt-zurich) + +Diese Suche kann auch noch erweitert werden. In unserem Beispiel mit dem Suchbegriff ``karte``. + +.. figure:: ../../_static/images/daten-suchen/suche-in-organisation-begriff.png + :alt: organization:(kanton-thurgau OR stadt-zurich)karte + +**Wortstämme** +^^^^^^^^^^^^^^ +Bitte beachten Sie bei der Suche in bestimmten Feldern, dass Wortstämme und +Sonderzeichen nur in den sprachspezifischen Feldern berücksichtigt werden. Damit zum Beispiel +das Dataset ``Luftbilder swisstopo farbig`` in der Trefferliste erscheint, können sie folgende +Suchanfrage in das Suchfeld eingeben: ``title_de:(bild AND farbe)``. + +.. figure:: ../../_static/images/daten-suchen/suche-wortstamm.png + :alt: title_de:(bild AND farbe) + +.. admonition:: Wichtig + + Im allgemeinen Textfeld werden Wortstämme nicht berücksichtigt. + Wenn nur das Feld ``title`` in die Suche eingegeben wird, ohne ``_de``, + wird das entsprechende Dataset nicht gefunden. + +.. admonition:: Wichtig + + Im allgemeinen Textfeld ergeben nur exakte Übereinstimmungen + der Begriffe, wie z.B. ``Luftbilder`` und ``farbig`` Treffer. + +SOLR-Konfiguration +------------------ +Ausführlichere Informationen zur Solr-Konfiguration finden Sie in der offiziellen `Solr-Dokumention `__ (Englisch). +Die `Konfiguration und das Schema von opendata.swiss ist auf Github `__ verfügbar. +``solr.xml`` referenzierte Dateien, wie ``italian_stop.txt``, ``fr_elision.txt``, etc., sind im offiziellen CKAN-Repository der aktuellen +`CKAN-Version auf Github `__ zu finden. Alle anderer Dateien (z.B. ``stopwords.txt``) werden +von Solr bereitgestellt. +