Open Source Dokumentenmanagement
Dokumentation

Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core installieren (Übersicht)

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:

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:

  1. Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
  2. Wählen Sie im Menü Base System > Configurations > Active Modules.
  3. Setzen Sie entweder einen Haken bei Licensed (wenn Sie eine gültige Lizenz besitzen) oder Test License (wenn Sie sich auf einem Testsystem befinden).
  4. Aktivieren Sie rechts die Module, indem Sie einen Haken setzen.
  5. Klicken Sie auf Save.
  6. 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 XML interface online DATEV (XML) Online DATEV XML-Schnittstelle online konfigurieren
DATEV XML interface online (with positions) DATEV (XML) Online mit Positionen
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:

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

So installieren Sie ZIP-Dateien und Konfigurationsprojekte:

  1. Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
  2. Wählen Sie im Menü Base System > Actions > Install Package.
  3. Klicken Sie auf Choose file und wählen Sie die ZIP-Datei.
  4. 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:

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


Beispiel

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


Erläuterung des Beispiels

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:
  1. Skript file-template-1.js
  2. 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.