Open Source Dokumentenmanagement
Dokumentation

Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > Übersicht tags

agorum core plugin manager

Über den agorum core plugin manager verwalten Sie Ihre Plug-ins in agorum core. Sie können Plug-ins:

Hinweis: Der agorum core plugin manager steht dem Super-Administrator roi standardmäßig zur Verfügung. Sie können den plugin manager auch für andere Benutzer / Administratoren freischalten. Tragen Sie dazu den zu berechtigenden Benutzer in folgende ACL ein:

ACL_acpluginmanager_agorum.acpluginmanager_pluginInstaller

Symbole

Die nachfolgend aufgeführten Symbole begegnen Ihnen in agorum core, wenn Sie mit Plug-ins arbeiten:

Plug-in-/Paket-Bereich

agorum core plugin manager öffnen

  1. Klicken Sie links in der Seitenleiste auf Plug-ins verwalten.

    Ergebnis: Der agorum core plugin manager öffnet sich.

Aufbau des agorum core plugin managers

Aufbau des agorum core plugin managers
  1. Übersicht der Plug-ins
    Enthält eine Übersicht der zur Verfügung stehenden und installierten Plug-ins sowie Plug-ins, die Sie aktualisieren können.
  2. Informationen über das Plug-in
    Wählen Sie mit einem Mausklick ein Plug-in, erscheinen rechts eine Beschreibung und im Bereich links oben je nach Status des Plug-ins folgende Schaltflächen:

    • installieren
    • erneut installieren
    • aktualisieren
    • deinstallieren

    Unterhalb der Informationen zu einem gewählten Plug-in werden nach Klick auf die oben genannten Schaltflächen Logs zum jeweiligen Plug-in angezeigt. Diese Logs sind nur solange sichtbar, wie das Plug-in installiert, aktualisiert oder deinstalliert wird. Das Log verschwindet danach wieder.

Ein Plug-in installieren

Installieren Sie ein Plug-in immer zuerst auf einem Testsystem, sofern Sie es ausprobieren möchten.

  1. Wählen Sie das Plug-in, das Sie installieren möchten.

    Bei manchen Plug-ins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plug-ins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plug-in auf installieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System installiert das gewählte Plug-in.
Ein Plug-in installieren

Ein Plug-in erneut installieren

Haben Sie ein Plug-in installiert, steht in der Übersicht der Plug-ins die installierte Versionsnummer einschließlich der Information, ob diese noch aktuell ist, zur Verfügung. Sie können das Plug-in an dieser Stelle erneut installieren. Das System entfernt dabei alle bereits vorhandene Strukturen und erstellt sie neu.

  1. Wählen Sie das Plug-in, das Sie erneut installieren möchten.

    Bei manchen Plug-ins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plug-ins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plug-in auf erneut installieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System installiert das gewählte Plug-in erneut.
Ein Plug-in erneut installieren

Die Plug-in-Liste aktualisieren

Aktualisieren Sie die Plug-in-Liste regelmäßig, um die Information zu erhalten, ob Updates zu installierten oder neue Plug-ins vorliegen.

So aktualisieren Sie die Plug-in-Liste:

  1. Klicken Sie links in der Übersicht über Plug-ins auf Plug-in-Liste aktualisieren (Internet).

    Ergebnis: Das System lädt die Bedienoberfläche neu und zeigt die aktualisierten Informationen an.
Die Plug-in-Liste aktualisieren

Hinweis: Wenn Sie auf die Schaltfläche Plug-in-Liste aktualisieren (Internet) klicken und der agorum core-Server zu diesem Zeitpunkt keine Internetverbindung hat, kann die Plug-in-Liste nicht aktualisiert werden. Ein entsprechender Hinweis mit einem Link erscheint. Diesen Link können Sie kopieren, um die Plug-ins auf einem anderen PC mit Internetverbindung manuell als ZIP-Paket herunterzuladen und auf den agorum core-Server zu kopieren.

Ein Plug-in aktualisieren

Überprüfen Sie regelmäßig, ob es eine neue Version eines Plug-ins gibt. Darin enthalten sind Bugfixes, Neuerungen und Änderungen. Alle Dokumentationen zu Plug-ins beziehen sich zudem immer auf die neueste Plug-in-Version.

Nachdem Sie die Plug-in-Liste aktualisiert haben, erscheint in der Spalte update ein Eintrag mit update, wenn Ihre Plug-in-Version veraltet ist.

Veraltete Plug-ins

So aktualisieren Sie ein Plug-in:

  1. Wählen Sie ein Plug-in, das in der Spalte update einen Eintrag aufweist.

    Bei manchen Plug-ins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plug-ins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plug-in auf aktualisieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System aktualisiert das gewählte Plug-in.
Ein Plug-in aktualisieren

Ein Plug-in deinstallieren

Sie benötigen die jeweils aktuelle Version eines Plug-ins, um es deinstallieren zu können. Aktualisieren Sie das Plug-in, sofern es nicht aktuell ist.

So deinstallieren Sie ein Plug-in:

  1. Wählen Sie links in der Liste ein Plug-in.
  2. Klicken Sie bei den Informationen auf deinstallieren.

     
    Plug-in im agorum core plugin manager deinstallieren


    Ergebnis: Ein Dialog öffnet sich.
  3. Wählen Sie links in der Liste einen Eintrag.

    Ergebnis:
    • Rechts erscheint eine Beschreibung dessen, was bei einer Deinstallation genau gelöscht wird. Die Beschreibung kann Ihr Administrator individuell festlegen.
    • Der Haken bei Testmodus aktiv ist standardmäßig gesetzt und verhindert, dass das System das gewählte Plug-in direkt deinstalliert. Stattdessen führt das Log nur auf, was das System deinstalliert, wenn Sie die Deinstallation ausführen. Möchten Sie das Plug-in direkt deinstallieren, entfernen Sie den Haken.

    Tipp: Ihr Administrator / Entwickler kann definieren, was bei einer Deinstallation eines Plug-ins gelöscht wird. Diese Definition führt er in der Uninstall-Datei des Plug-ins durch.

     

    Folgende Unterscheidungen kann der Administrator / Entwickler etwa vornehmen:


    • Sichtbare Daten des Plug-ins deinstallieren, sodass das Plug-in nicht mehr als solches zu sehen ist, die Daten dazu aber bestehen bleiben.

    • Komplettes Plug-in deinstallieren: Das System entfernt die Sichtbarkeit des Plug-ins und alle Daten zum Plug-in.

    • Nur einen Teil des Plug-ins deinstallieren, etwa ein Workflow von mehreren Workflows.

  4. Klicken Sie auf Deinstallieren.

     
    Gewähltes Plug-in deinstallieren
  5. Bestätigen Sie die Abfrage zum Deinstallieren.

    Ergebnis (bei inaktivem Testmodus): Das System deinstalliert das markierte Plug-in und lädt eine ZIP-Datei auf den lokalen Rechner herunter. Die ZIP-Datei können Sie etwa dazu verwenden, um nach der Deinstallation das gelöschte Plug-in wieder zu installieren. Eine solche Sicherung befindet sich außerdem zusätzlich im Ordner Eigene Dateien/Administration/workspace/agorum.uninstall.manager/save.

    Ergebnis (bei aktivem Testmodus): Das System deinstalliert das markierte Plug-in nicht. Es lädt eine ZIP-Datei auf den lokalen Rechner herunter. Die ZIP-Datei können Sie etwa dazu verwenden, um nach der Deinstallation das gelöschte Plug-in wieder zu installieren. Eine solche Sicherung befindet sich zudem zusätzlich im Ordner Eigene Dateien/Administration/workspace/agorum.uninstall.manager/save.

Beschreibung der Spalten in der Plug-in-Auswahl

Spalte Beschreibung
Plug-in Definiert den Namen des Plug-ins.

Taucht hier ein Plug-in mehrmals unter demselben Namen auf, handelt es sich etwa um verschiedene Deinstallationsschritte. Etwa löscht diese Deinstallation nur einen Teil eines Plug-ins, etwa nur einen Workflow.
Version Definiert die Version des Plug-ins.
Dateiname Definiert den Namen des Deinstallationsschrittes.

Ein Administrator definiert diesen Namen. Er kann etwa eine Deinstallation, bei der immer der Testmodus aktiviert ist, mit uninstall-test betiteln.
Name Definiert den Namen des Projekts, das zum Plug-in gehört.

Ein Plug-in deaktivieren

Neben dem Deinstallieren von Plug-ins können Sie Plug-ins deaktivieren. Verwenden Sie dazu die Aktion agorum core smart assistant Add-ons aktiv / inaktiv schalten des agorum core template managers.

Verwenden Sie ein Plug-in, das auch Ordner anlegt, etwa das agorum core basic archive, können Sie diese Ordner nur anhand von Berechtigungen oder manuellem Löschen aus dem System entfernen. Beim manuellen Löschen dieser Ordner verbleiben jedoch Altdaten im System, etwa Benutzergruppen und ACLs.