Installation von Produkterweiterungen

Installation der Bundles

Erweiterungen werden über den map.apps Manager installiert. Dazu werden die entsprechenden Bundles (JAR- oder ZIP-Datei) über das Bundles-Menü hochgeladen. Nach erfolgter Installation stehen die Bundles zur Nutzung in Apps zur Verfügung.

Beachten Sie zudem die Installationsanleitung der jeweiligen Erweiterung. In manchen Fällen ist es notwendig, weitere Serverkomponenten zu installieren.

Sollte die zu installierende Erweiterung die Bundles von map.apps Linie 3 voraussetzen, ist es erforderlich, die Bundles von map.apps Linie 3 nachzuinstallieren. Die Installation ist im Abschnitt Installation von map.apps Linie 3 Bundles beschrieben.

Konfiguration des map.apps Managers

Manche Erweiterungen integrieren sich in den map.apps Manager. Dies muss dem Manager nach der Installation der Bundles über die Konfiguration bekannt gemacht werden. Hierzu gibt es folgende Konfigurationsoptionen:

Option Beschreibung

Option	Beschreibung
`manager.config.viewbundles`	Eine kommasepariert Liste der Bundle-Namen, die im Manager geladen werden. Bundle-Namen der Erweiterungen müssen ergänzt werden. Die im Produkt enthaltenen Management-Bundles sind: appmanagement App und App-Vorlagen-Verwaltung reportmanagement Bericht-Vorlagen-Verwaltung bundlemanagement Bundle-Verwaltung bundleupdatechecker Testest ob neue Bundleversionen zur Verfügung stehen Der Standard-Wert ist `appmanagement, reportmanagement, bundlemanagement, bundleupdatechecker`.
`manager.config.activetool`	Die ID des Tools des initial aktiven Tabs. Der Standard-Wert ist `appmanagement_appListTool`.

manager.config.viewbundles

Eine kommasepariert Liste der Bundle-Namen, die im Manager geladen werden. Bundle-Namen der Erweiterungen müssen ergänzt werden. Die im Produkt enthaltenen Management-Bundles sind:

appmanagement: App und App-Vorlagen-Verwaltung
reportmanagement: Bericht-Vorlagen-Verwaltung
bundlemanagement: Bundle-Verwaltung
bundleupdatechecker: Testest ob neue Bundleversionen zur Verfügung stehen

Der Standard-Wert ist appmanagement, reportmanagement, bundlemanagement, bundleupdatechecker.

manager.config.activetool

Die ID des Tools des initial aktiven Tabs. Der Standard-Wert ist appmanagement_appListTool.

Kompatibilitätsmodus map.apps Manager 3.x

Für Erweiterungen, die nicht kompatibel mit dem aktuellen map.apps Manager sind, bietet map.apps die Möglichkeit der Integration des Managers in einem Kompatibilitätsmodus. Hierzu gibt es folgende Konfigurationsoptionen:

Option Beschreibung

Option	Beschreibung
`manager.3x.config.enabled`	Aktiviert den Manager in Version 3.x, wenn der Wert auf true gesetzt wird. Daraufhin erscheint ein neuer Tab im map.apps Manager über den auf den Manager 3.x zugegriffen werden kann. Alternativ kann man den Manager 3.x direkt über die URL `/manager/3.x/` aufrufen.
`manager.3x.config.viewbundles`	Eine kommaseparierte Liste der Bundles, die im Manager geladen werden. Bundle-Namen der Erweiterungen müssen ergänzt werden. Gegebenenfalls gibt es Bundles für den Manager 3.x und Manager 4.x. Dann ist es notwendig die korrekte Version zu definieren, damit das korrekte Management-Bundle geladen wird und es keine Versionskonflikte gibt. Beispiel: `sdi_appstatusmanagerintegration@^3.2.0`
`manager.3x.config.activetool`	Die ID des Tools des initial aktiven Tabs.

manager.3x.config.enabled

Aktiviert den Manager in Version 3.x, wenn der Wert auf true gesetzt wird. Daraufhin erscheint ein neuer Tab im map.apps Manager über den auf den Manager 3.x zugegriffen werden kann. Alternativ kann man den Manager 3.x direkt über die URL /manager/3.x/ aufrufen.

manager.3x.config.viewbundles

Eine kommaseparierte Liste der Bundles, die im Manager geladen werden. Bundle-Namen der Erweiterungen müssen ergänzt werden. Gegebenenfalls gibt es Bundles für den Manager 3.x und Manager 4.x. Dann ist es notwendig die korrekte Version zu definieren, damit das korrekte Management-Bundle geladen wird und es keine Versionskonflikte gibt.

Beispiel: sdi_appstatusmanagerintegration@^3.2.0

manager.3x.config.activetool

Die ID des Tools des initial aktiven Tabs.

Der Kompatibilitätsmodus erfordert die Installation der map.apps Linie 3 Bundles, welche im Abschnitt Installation von map.apps Linie 3 Bundles beschrieben ist.

Deinstallation von Erweiterungen

Um eine Erweiterung zu deinstallieren müssen die über den map.apps Manager hinzugefügten Bundles gelöscht werden. Gehen Sie hierzu in den Tab "Bundles" im map.apps Manager und geben Sie den Produktnamen der Erweiterung in den Filter ein. Markieren und löschen Sie anschließend alle Bundles.

Beachten Sie zudem die Installationsanleitung der jeweiligen Erweiterung. In manchen Fällen kann es notwendig sein, weitere Serverkomponenten zu deinstallieren.