Module aktivieren sowie ZIP-Dateien und Konfigurationsprojekte installieren

agorum core pro liefert verschiedene Module mit, die Sie vor Benutzung aktivieren müssen. Dazu gehören etwa folgende Module:

agorum core adminsync
agorum core docform
agorum core mailadapter

Individuelle Einstellungen installieren Sie mithilfe einer ZIP-Datei.

Ein Modul aktivieren

Entscheiden Sie vor Aktivierung eines Moduls, ob Sie dieses auf einem Produktivsystem oder einem Testsystem aktivieren möchten.

Produktivsystem
Sie benötigen eine gültige Lizenz. Wenden Sie sich an Ihren agorum-Kundenberater.

Testsystem
Sie benötigen keine Lizenz und können Erweiterungen testen.

So aktivieren Sie ein Modul:

Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
Wählen Sie im Menü Base System > Configurations > Active Modules.
Setzen Sie entweder einen Haken bei Licensed (wenn Sie eine gültige Lizenz besitzen) oder Test License (wenn Sie sich auf einem Testsystem befinden).
Aktivieren Sie rechts die Module, indem Sie einen Haken setzen.
Klicken Sie auf Save.
Starten Sie agorum core neu.

Ergebnis: Das Modul ist aktiv.

Um das Modul zu deaktivieren, entfernen Sie den Haken, speichern Sie und starten Sie danach agorum core neu.

Ein Modul aktivieren

Modulübersicht

Diese Liste gibt einen Überblick über alle aktuellen Module, die Sie aktivieren können.

Modul	Beschreibung	Link
Admin Sync	Durch eine Konfiguration von agorum core adminsync synchronisieren Sie Ihre Benutzer- und Berechtigungsstruktur vollständig per ADS und LDAP mit agorum core.	agorum core adminsync
DATEV CSV interface	DATEV Rechnungswesen Pro	DATEV-Schnittstelle Rechnungswesen Pro konfigurieren
DATEV CSV interface (with positions)	DATEV Rechnungswesen Pro mit Positionen	DATEV-Schnittstelle Rechnungswesen Pro konfigurieren
DATEV XML interface online	DATEV (XML) Online	DATEV XML-Schnittstelle online konfigurieren
DATEV XML interface online (with positions)	DATEV (XML) Online mit Positionen	DATEV XML-Schnittstelle online konfigurieren
DocForm	agorum core docform liest aus Dokumenten wichtige Werte aus, etwa bei Rechnungen die Rechnungsnummer, das Rechnungsdatum und mehr. Verwenden Sie das Mietmodell von agorum core, aktivieren Sie alle docform-Module. Dadurch stehen bei der Anwendung mehr Optionen zur Verfügung.	agorum core docform Module für agorum core docform aktivieren
DocForm extended	Durch dieses Modul akzeptiert agorum core docform Dokumente, die eigene Textinformationen enthalten.
DocForm positions	Das Modul agorum core docform positions erlaubt es, etwa Rechnungen mit Positionen auszulesen.
DocForm verify	agorum core docform verify verifiziert Dokumente, um sie sicher abzulegen.	Verifizierung mit agorum core docform verify durchführen
Mail adapter	Mit einem E-Mail-Adapter holen Sie E-Mails aus einem E-Mail-Postfach per IMAP an und legen Sie automatisch in agorum core ab.	agorum core mailadapter administrieren
Mail compression	agorum core legt E-Mails einmal im Original ab und zusätzlich für alle Anhänge und E-Mail-Bodys eigene Dokumente, um darauf zugreifen zu können. Mit diesem Modul / Worker löschen Sie den Content der zusätzlichen Dokumente (Anhänge und E-Mail-Bodys).	E-Mail-Kompression per Worker einrichten
Preview	agorum core preview erzeugt die Vorschau eines Dokuments. Sind Sie sich unsicher, aktivieren Sie diese Einstellung.	agorum core preview
SAP	Erstellt eine Schnittstelle zu SAP.	agorum core SAP-Schnittstelle konfigurieren
Smart Assistant config designer	Durch den agorum core smart assistant konfigurator konfigurieren Sie etwa das Kontextmenü von agorum core.	agorum core smart assistant konfigurator
Storage	Mit diesem Modul lagern Sie Dokumenteninhalte aus der agorum core-Datenbank aus.	agorum core storage
Storage container	Mit diesem Modul lagern Sie Dokumenteninhalte aus der agorum core-Datenbank aus. Dient als Erweiterung zum normalen agorum core storage.
Storage de-duplicate	Dieses Modul entfernt doppelte Dokumenteninhalte aus dem Storage, wodurch der Speicherbedarf steigt. Dient als Erweiterung zum normalen agorum core storage.
WOPI	Für die Integration von Office Online verwendet agorum core das WOPI-Protokoll (Web Application Open Platform Interface). Sie können neben dem WOPI-Protokoll ONLYOFFICE über den agorum core plugin manager an agorum core anbinden.	undefined>WOPI-Protokoll in agorum core einrichten
ZUGFeRD	ZUGFeRD beschreibt das Format elektronischer Rechnungen.	agorum core docform agorum core docform - Dokumenttyp ZUGFeRD

Tipps:

Lassen Sie ein aktiviertes Modul auf Ihrem Testsystem aktiv, wenn Sie es nicht mehr benötigen.
Deaktivieren Sie ein Modul auf Ihrem Produktivsystem, um unnötigen Datenverbrauch zu vermeiden.

Veraltete Module

Diese Module sind veraltet und rein aus Kompatibilitätsgründen zu älteren agorum core-Versionen aufgeführt.

Modul	Beschreibung	Link
Dataroom	Dieses Modul wird als Plugin angeboten. Installieren Sie den agorum core dataroom daher über den agorum core plugin manager.	agorum core dataroom
File adapter	Dieses Modul indizierte vorhandene, aber nicht mehr aktiv genutzte Fileserver und zeigte sie im DMS an.	–
Preview thumbnails	Mithilfe von agorum core preview thumbnails erscheinen E-Mail-Anhänge, Dokumente an Notizen und vieles mehr in den Mitteilungen sowie im Eingang als kleines Bild neben der entsprechenden Nachricht.	agorum core preview thumbnails
Search highlighting	Dieses Modul zeigte gesuchte Wörter im Dokument an. Es wurde mittlerweile durch das Plugin agorum core search view tab abgelöst. Lassen Sie dieses Modul aktiviert, wenn es bereits aktiv ist.	agorum core search view tab
Smart Folder	smart folder stellen physikalisch in agorum core vorhandene Informationen virtuell flexibel dar. Lassen Sie dieses Modul aktiviert, wenn es bereits aktiv ist.	–
Sync	agorum core sync 2.0 wird nicht mehr weiterentwickelt. Hiermit synchronisieren Sie Objekte im DMS mit beliebig vielen anderen agorum core-Servern.	undefined>agorum core sync 2.0

Eine ZIP-Datei und ein Konfigurationsprojekt installieren

In bestimmten Fällen müssen Sie ZIP-Dateien / Konfigurationsprojekte installieren:

Wenn Sie von Ihrem Entwicklungsteam oder Ihrem agorum-Ansprechpartner eine individuelle Konfiguration als ZIP-Datei erhalten haben.
Wenn Sie in einer Test- oder Entwicklungsumgebung Daten erfolgreich getestet haben und diese in ein anderes agorum core-System (Produktivsystem) importieren möchten.

Speichern Sie diese ZIP-Dateien / Konfigurationsprojekte auf Ihrem PC ab.

So installieren Sie ZIP-Dateien und Konfigurationsprojekte:

Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
Wählen Sie im Menü Base System > Actions > Install Package.
Klicken Sie auf Choose file und wählen Sie die ZIP-Datei.
Klicken Sie auf Install.

Ergebnis: Das System lädt die ZIP-Datei hoch.

• Warten Sie, bis im darunter stehenden Log die Meldung Package Installed Sucessfully steht.
• Schlägt die Installation fehl, ist der häufigste Fehler eine Inkompatibilität der Konfiguration und der installierten agorum core-Version. Prüfen Sie, ob die Versionen zusammenpassen, oder kontaktieren Sie das Entwicklungsteam. Kopieren Sie dazu das Log heraus oder erstellen Sie einen Screenshot.

Eine ZIP-Datei und ein Konfigurationsprojekt installieren

Struktur einer ZIP-Datei

Eine exportierte ZIP-Datei (Konfigurationsprojekt) aus einem agorum core-System enthält Ordner und Dateien. Ordner haben eine spezielle Funktion und können typische Archivordner sein, in dem sich nur Dokumente befinden.

Besitzt ein Ordner einen bestimmten Namen, löst dieser eine Aktion / Funktion aus. So können Sie mit diesen Kennungen etwa Folgendes erreichen:

Dateien in ein bestimmtes Verzeichnis in agorum core ablegen (über die Kennung ac)
Dateien in ein bestimmtes Verzeichnis auf dem Server ablegen, auf dem agorum core installiert ist (über die Kennung fs)
XML-Skripte (agorum core agoscript) ausführen (über die Kennung xml)
JavaScript ausführen (über die Kennung js)

Funktionsweise beim Import einer ZIP-Datei

Importieren Sie eine ZIP-Datei, prüft das System im ersten Schritt die Ordnerstruktur und ob ein Ordner mit bekannter Kennung vorliegt. Bei einem Treffer interpretiert das System die darunterliegenden Daten entsprechend der ersten gefundenen Kennung.

Kennung	Beschreibung
fs	Kopiert die darunterliegende Ordnerstruktur auf dem Server in das Installationsverzeichnis, etwa unter /opt/agorum/agorumcore/. Verwenden Sie die Kennung fs nur, wenn Sie über ein detailliertes Verständnis der Funktionsweise von agorum core verfügen.
ac	Kopiert die darunterliegende Ordnerstruktur in die agorum core-Datenbank. Die darunter liegende Ordnerstruktur muss ab dem root-Ordner beginnen, im Regelfall /agorum/roi/Files. Files ist der Pfad, den Sie im agorum core explorer unter Dateien sehen.
xml	Interpretiert die darunter liegenden XML-Dateien und parst diese. Bei dieser Kennung legt das System die Reihenfolge normalerweise anhand der darunterliegenden Ordner fest. Diese Festlegung muss nicht zwingend über Ordner geschehen, sondern kann auch über die Dateinamen der XML-Dateien erfolgen. Die Reihenfolge / Sortierung erfolgt nach ASCII.
js	Führt die darunterliegenden Skripte (JavaScript) aus. Bei dieser Kennung legt das System die Reihenfolge normalerweise anhand der darunterliegenden Ordner fest. Diese Festlegung muss nicht zwingend über Ordner geschehen, sondern kann auch über die Dateinamen der JS-Dateien erfolgen. Die Reihenfolge / Sortierung erfolgt nach ASCII.
css, img, icons	Kopiert die darunterliegenden Dateien und Ordner an die richtige Stelle im agorum core-System. Verwenden Sie eine solche Kennung, legt das System im Ordner deploy/post und deploy/pre im Konfigurationsprojekt je nach verwendeter Kennung die Ordner css, img oder icons an. Das System bildet den Namen dieses Ordners automatisch aus dem Projektpräfix plus der verwendeten Kennung und hängt das Wort _module an (siehe folgendes Beispiel): Projektpräfix acdemoproject_ Verwendete Kennung img Ergebnis (Pfad) acdemoproject_module/img Möchten Sie etwa eigene Styles definieren und müssen dabei etwa auf das Bild close.png unterhalb des Ordners acdemoproject_module/img referenzieren, lautet die URL: /roiwebui/acdemoproject_module/img/close.png
messages	Kopiert die Message-Dateien an die korrekte Stelle im agorum core-System. Das System importiert diese Message-Dateien in den Ordner deploy/pre des jeweiligen Konfigurationsprojekts. Es handelt sich hierbei um Übersetzungskeys. Die Message-Dateien müssen folgende Benennung aufweisen: Message_[Sprache].properties Beispiel für Deutsch Messages_de.properties Beispiel für Englisch Messages_en.properties

Das System führt den Import in einer einzelnen Transaktion aus.
Tritt ein Fehler auf, führt es automatisch einen Rollback aus und macht Änderungen bis zum Auftreten des Fehlers wieder rückgängig.

Beispiel

Die nachfolgende Struktur wurde durch die export.yml-Datei angelegt und dann als ZIP-Datei verpackt:

01
- ac
  - agorum
    - roi
      - customer
        
        Beispiel
        
        js
        
        file_script1.js
        
        file_script2.js
        
        yml
        
        export.yml
        
        metadata.yml
02
- xml
  - create-base-struktur.xml
  - create-user.xml
03
- xml
  - create-acl.xml
  - create-gruppen.xml
04
- fs
  - jboss
    - server
      - default
        
        deploy
        
        roi.ear
        
        roiwebui.war
        
        abc.jsp
05
- 01
  - js
    - file-template-1.js
- 02
  - js
    - file-template-2.js
06
- mailarchiv.zip

Erläuterung des Beispiels

Das System sortiert die Dateien und Ordner nach ASCII.
Es arbeitet die Dateien und Ordner und somit die Kennungen von oben nach unten ab.

Kennung	Beschreibung
ac	Das System legt die beiden Dateien file_script1.js und file_script2.js unter /agorum/roi/customer/Beispiel/js ab. Es legt zudem die beiden Dateien export.yml und metadata.yml unter /agorum/roi/customer/Beispiel/yml ab. Da die Kennung js unterhalb von ac liegt, interpretiert das System die darunterliegenden Ordner nicht, sondern legt sie als normale Ordner an.
xml	Das System führt Folgendes aus: zuerst das Skript create-base-struktur.xml danach das Skript create-gruppen.xml dann die beiden darunterliegenden Skripte create-acl.xml und create-gruppen.xml
fs	Das System legt auf dem Server folgende Struktur an: jboss/server/default/deploy/roi.ear/roiwebui.war/abc.jsp
js	Das System führt Folgendes aus: Skript file-template-1.js Skript file-template-2.js Erkennt das System eine ZIP-Datei, die nicht unter einer Kennung liegt, wertet es diese als eigenständige ZIP-Datei und führt sie aus. In diesem Beispiel führt es demnach die letzte Datei mailarchiv.zip als eigenständige Datei aus. Hier können dann erneut alle Kennungen (ac, fs, xml, js) vorhanden sein.