Release Notes 2.3

Hinweis: map.apps Smart Search Extension ist eng mit smart.finder gekoppelt, daher sind die Release Notes beider Produkte identisch.

What’s New

Apache Solr als externer Dienst

Die interne Suchkomponente Apache Solr wird ab dieser Version nicht mehr als Bestandteil von {product-name} ausgeliefert. Um die Funktionsfähigkeit von {product-name} zu gewährleisten muss Apache Solr als externer Dienst in Ihrer Infrastruktur bereitgestellt werden.

Informationen zur Installation von Apache Solr finden Sie unter Benötigte Software.

Informationen zur Konfiguration von {product-name} in ihrer Apache Solr Instanz finden Sie unter Apache Solr Konfiguration.

map.apps Smart Search Extension eingestellt

map.apps Smart Search wird ab dieser Version nicht mehr als eigenständige Extension weitergeführt. Die Smart Search Funktionalität ist vollständig in {product-name} integriert und kann wie gewohnt genutzt werden.

Eine detaillierte Übersicht über die Änderungen und die Schritte zum Update auf diese Version finden Sie in den Update-Hinweisen unter map.apps Smart Search Extension.

Standalone Client eingestellt

Die Client-Applikation des {product-name} wird ab dieser Version nicht mehr als Teil des Produktes bereitgestellt. Um die ausgelieferten Apps und Bundles von {product-name} nutzen zu können, wird eine bestehende map.apps-Instanz benötigt.

Die Installation der {product-name} Bundles und Apps ist im Abschnitt Installation der Client-Webapp beschrieben.

Für den Betrieb der Server Komponente ist map.apps nicht notwendig.

Ende des Result Center Supports ab map.apps Version 4.20

Ab map.apps Version 4.20 wird das map.apps Result Center (Bundle resultcenter) nicht mehr enthalten sein. Wir empfehlen stattdessen das Bundle result-ui in Verbindung mit dem Bundle sf_result-ui zu verwenden.

Falls Sie vorerst das Bundle resultcenter weiterverwenden möchten, können Sie die letzte Version des Bundles aus dem con terra Developer Network herunterladen. Das Bundle sf_resultlist-resultcenter, das zur Einbindung des Result Centers in {product-name} benötigt wird, ist weiterhin Bestandteil von {product-name}.

Integration Job-Manager

Mit der Einstellung des Standalone-Clients entfällt die Notwendigkeit, aus den mitgelieferten Apps den Job-Manager aufzurufen. Dieser ist im map.apps Manager in einem separaten Tab integriert und ist hier wie gewohnt nutzbar.

Daher wurden in den Apps Sidebar und Tool für den Aufruf des Job-Managers entfernt.

Filter für die Indexierung externer CSWs

Bei der Indexierung externer OGC Catalog Services oder INSPIRE Discovery Services kann nun ein optionaler Filter angegeben werden. Somit können z.B. nur Dokumente mit einem speziellen Schlüsselwort oder innerhalb eines definierten Raumausschnittes indexiert werden. Ohne die Angabe eines Filters wird der komplette Inhalt des Dienstes indexiert.

Update-Hinweise

Falls Sie bei dem Update mehrere Versionen überspringen, befolgen Sie bitte auch alle Update-Hinweise der dazwischenliegenden Versionen.

Nicht mehr unterstützte Properties

solr.solr.home

Verzeichnispfad zum solr.home.

Neue Properties

solr.server.url

URL zur verwendeten Apache Solr Instanz.

Standardwert: http://localhost:8983/solr

Umbenennung von Java Packages

Die Basis-Java Packages wurden von de.conterra.finder in de.conterra.smartfinder umbenannt.

Diese Änderung betrifft auch die Konfigurationsdateien der jeweiligen Indexe (conf/solrconfig.xml und conf/schema.xml ), da hier die Java-Klassen referenziert werden (z.B. RequestProcessorFactory, FieldType, etc.).

Die map.apps Smart Search Extension ist nun Teil von {product-name}. Im Zuge der Integration wurden kleine Optimierungen an Konfiguration und Namensgebung durchgeführt, die im Folgenden dokumentiert werden.

Umbenennung des Solr-Index

Der Solr-Index wurde von smartsearch in featuresearch umbenannt.

Integration map.apps Bundle

Die Funktionalität des map.apps Bundles sf_smartsearch wurde in das Bundle sf_store integriert.

Hierbei wurden folgende Anpassungen vorgenommen.

Komponente SmartSearchStore

Die Komponente SmartSearchStore wurde in FeatureDocumentStore umbenannt und ist nun Bestandteil des Bundles sf_store.

Die folgenden Properties konnten an der Komponente SmartSearchStore bis {product-name} Version 3.x konfiguriert werden. Ab {product-name} Version 3.x werden diese Properties nicht mehr unterstützt. Die Konfiguration erfolgt nun mithilfe von Suchvorlagen (QueryTemplates).

  • editDistance

    Die fuzzy Suche wird nun innerhalb einer Suchvorlage definiert. Diese wird an der Komponente FeatureDocumentStore über die Property queryTemplate konfiguriert.

    Siehe auch: Fuzzy Suche oder in der Dokumentation des Bundles sf_store.

  • singleBoostWeight, groupedBoostWildcardWeight, groupedBoostWeight

    Diese Properties wurden genutzt, um die Gewichtung von Suchergebnissen zu beeinflussen. Die Gewichtung wird nun innerhalb einer Suchvorlage (QueryTemplate) definiert. Die Komponente FeatureDocumentStore enthält eine vordefinierte Suchvorlage, die die ursprünglichen Standardwerte enthält. Diese Suchvorlage kann mit der Property queryTemplate angepasst werden.

    Siehe auch: Suchvorlagen oder in der Dokumentation des Bundles sf_store.

Beachten Sie, dass bei einer Migration von map.apps Smart Search Extension 2.x auf {product-name} 3.x die Server Komponente migriert werden muss, da Apache Solr nicht mehr als Teil von {product-name} ausgeliefert wird. Die Einrichtung von Apache Solr ist im folgenden Abschnitt beschrieben.

Client-Anwendung

Um die Bundles und Apps des {product-name} nutzen zu können, ist eine map.apps-Instanz erforderlich.

Die Installation der {product-name} Bundles und Apps ist hier beschrieben.

Apache Solr Konfiguration

Zum Betrieb von {product-name} ist die Bereitstellung einer Apache Solr Instanz Voraussetzung. Informationen zur Installation und Konfiguration von Apache Solr finden Sie unter https://solr.apache.org/.

Verwenden Sie als Apache Solr Distribution die full Variante. Die slim Variante enthält nicht die erforderlichen Module und ist daher nicht geeignet.

Da Apache Solr nun als externer Dienst betrieben wird, ergeben sich dadurch folgende Änderungen für {product-name}:

solr.home Konfiguration

Im SOLR_HOME Verzeichnis werden die Indexe verwaltet und persistiert. Das SOLR_HOME Verzeichnis befindet sich standardmäßig unter [SOLR_INSTALL_DIR]/server/solr.

Sie können Apache Solr auch mit einem anderen Verzeichnis starten. In diesem Fall müssen Sie dies entsprechend anpassen. Hier bestehen folgende Möglichkeiten:

  • in der Datei [SOLR_INSTALL_DIR]/bin/solr.in.sh (Linux) oder [SOLR_INSTALL_DIR]/bin/solr.in.cmd (Windows)

  • als Systemumgebungsvariable

  • beim Start von Apache Solr mit dem Parameter --solr-home <dir>

Kopieren Sie den Inhalt des Verzeichnisses [RELEASE-ORDNER]/solr/cores in das SOLR_HOME Verzeichnis. Danach sehen Sie folgende Verzeichnisstruktur:

/SOLR_HOME
 /core0
 /featuresearch
 /indexingmanagement
 /lib
 /...

Kopieren Sie nun die Datei SOLR_HOME/lib/jts-core-[VERSION].jar in das Verzeichnis [SOLR_INSTALL_DIR]/server/solr-webapp/webapp/WEB-INF/lib. Die Präsenz dieser Bibliothek an exakt dieser Stelle ist seitens Apache Solr vorgegeben.

Übernahme existierender Indexe

Für die Übernahme existierender Indexe muss sichergestellt sein, dass die Datei conf/solrconfig.xml der jeweiligen Cores mit den ausgelieferten Dateien in der Version 3 übereinstimmen.

Wenn Sie Anpassungen an den Dateien conf/solrconfig.xml und conf/schema.xml durchgeführt haben oder komplett eigene Cores nutzen wird empfohlen, diese Dateien mit den ausgelieferten Dateien der Version 3 zu vergleichen und ggf. Anpassungen vorzunehmen.

Nach Veränderung der Datei conf/schema.xml müssen die jeweiligen Indexe neu gebaut werden.

Ausgelaufene Unterstützung

  • Der Standalone-Client des smart.finder wurde entfernt.

  • Das Bundle omnisearch wird nicht mehr verwendet. Die App sf-full-screen-map-omnisearch wurde entfernt.

Abkündigungen

  • Der security.mode ONLY_AUTHN wird in einer der zukünftigen Versionen eingestellt.

Bekannte Einschränkungen

SNR-1129

[Security] Support secured Solr server instance

Changelog

3.0.0

New Features and Improvements

SNR-936

[Server] Decoupling smart.finder service from Apache Solr

SNR-1100

[Bundles] Integrate Smart Search bundles with smart.finder

SNR-1075

[Indexing] Support filter constraints with CSW jobs

SNR-1120

[Documentation] Add clause on NODE_TLS_REJECT_UNAUTHORIZED in CLI usage

SNR-1127

[Rollout] Remove Standalone Client

Fixed Issues

SNR-1107

[Bundles] sf-dialog-container element is missing in RootComponent.vue

SNR-1116

[Documentation] Wrong URL for login with CLI

SNR-1117

[CLI] Unable to export jobs with special characters in title