Grundlagen der Konfigurationsdatei

Als Basis für die smart.finder SDI-Benutzeroberfläche dient map.apps. Alle Funktionen, die für die Darstellung von smart.finder SDI im Webbrowser erforderlich sind, sind innerhalb einer App in map.apps beschrieben. Um die Konfiguration von smart.finder SDI anzupassen, werden deshalb Grundkenntnisse in map.apps vorausgesetzt.

Die hier beschriebenen Konfigurationsgrundlagen können für smart.finder SDI in der Standalone-Variante angewendet werden, aber auch, falls Sie den smart.finder Client in Kombination mit map.apps betreiben.

Web-Anwendungen auf der Basis von map.apps werden Apps genannt. In map.apps ist es möglich eine beliebige Anzahl von Apps zu erstellen. Diese basieren alle auf einer Menge von Programmmodulen, sogenannten Bundles. Bei der Installation von smart.finder SDI werden die Bundles von smart.finder SDI zu map.apps hinzugefügt und können anschließend in allen Apps verwendet werden.

Jede App umfasst eine Konfigurationsdatei namens app.json. In ihr legen Sie fest, welche Bundles in die App eingebunden sind und wie diese Bundles konfiguriert sind.

Die Funktionen von smart.finder SDI lassen sich durch Konfiguration in der app.json oder am Backend an die eigenen Wünsche anpassen.

Aufbau

Die Konfigurationsdatei verwendet die JSON-Syntax. Auf der obersten Ebene enthält sie die Abschnitte load und bundles.

load

Die für eine App benötigten Bundles werden im load-Abschnitt unter allowedBundles aufgelistet. Jedem Bundlenamen kann nach dem @-Zeichen noch die gewünschte Version angefügt werden.

"load": {
    "allowedBundles": [
        "<bundlename>@<versionsnummer>",
        "...weitere Bundles"
    ]
}
bundles

In diesem Abschnitt findet die Konfiguration der Bundles statt.

Jedes Bundle besteht in der Regel aus einer oder mehreren Komponenten, für die in der app.json-Datei bestimmte Eigenschaften konfiguriert werden können. Für Eigenschaften, die in der app.json-Datei nicht konfiguriert werden, wird — sofern vorhanden — der Standardwert verwendet. Die Bundle-Konfiguration ist in die folgenden Ebenen gegliedert:

"bundles": {
    "<Bundlename>": {
        "<Komponentenname>": {
            "<konfigurierte Eigenschaft>": "<Wert>"
        }
    }
}

In dem folgenden, nicht vollständigen Auszug aus einer app.json werden die Bundles sf_template-main, sf_frontpage und sf_catalog geladen. Außerdem sind für die CardsCatalogConfig-Komponente des sf_catalog-Bundles die Kategorien konfiguriert.

{
  "load": {
    "allowedBundles": [
      "sf_template-main",
      "sf_frontpage",
      "sf_catalog"
    ]
  },
  "bundles": {
    "sf_catalog": {
      "CardsCatalogConfig": {
        "categories": [
          {
            "id": 1,
            "name": "Wasser",
            "value": "wasser"
          },
          {
            "id": 2,
            "name": "Natur",
            "value": "natur"
          }
        ]
      }
    }
  }
}

Bearbeitung

Um eine app.json-Datei zu bearbeiten, gibt es zwei Möglichkeiten.

  • Direkte Bearbeitung der Datei im Dateisystem, wenn Sie smart.finder SDI als in der Standalone-Variante verwenden

  • Bearbeitung über den map.apps Manager, bei einer bereits vorhandenen map.apps-Instanz

Sichern Sie die app.json, bevor Sie Änderungen daran vornehmen.

Im Dateisystem

Wenn Sie smart.finder in der Standalone-Variante, also als eigenständiges Produkt ohne eine vorhandene Installation von map.apps verwenden, ändern Sie die Dateien im Dateisystem. Die Ordner der einzelnen Apps, in denen sich die app.json-Dateien befinden, liegen im Verzeichnis [TOMCAT_HOME]/smartfinder-sdi/js/apps. Sie können diese mit einem gewöhnlichen Texteditor bearbeiten.

Im map.apps Manager

Wenn Sie die Bundles auf einer vorhandenen map.apps-Instanz installiert haben, können Sie die Dateien über den map.apps Manager bearbeiten.

  1. Öffnen Sie den map.apps Manager.
    Dieser ist standardmäßig unter der Adresse https://<yourserver>/mapapps/manager erreichbar.

  2. Klicken Sie im Reiter Apps auf die App, die Sie ändern möchten.

  3. Wählen Sie App-Editor. Es öffnet sich ein Fenster, in dem der Inhalt der app.json angezeigt wird.

  4. Bearbeiten Sie die Datei. Der Editor unterstützt Sie bei der Einhaltung der korrekten Syntax.

  5. Speichern Sie die Datei.

Weitere Informationen zum App-Editor bietet die map.apps Dokumentation.

Dokumentation

Die Dokumentation zu den Konfigurationsmöglichkeiten der einzelnen Bundles erhalten Sie über den folgenden Link:

https://<yourserver>/smartfinder-sdi/resources/jsregistry/root

Die Namen aller smart.finder SDI Bundles beginnen mit dem Kürzel sfsdi_. smart.finder-Bundles beginnen mit dem Kürzel sf_. Das macht es einfacher, sie von den map.apps-Standardbundles zu unterscheiden.