agorum core client integration

Die agorum core client integration dient zur einfachen Ablage von Dokumenten und E-Mails per Drag-and-drop. So können Benutzer Dateien oder E-Mails direkt auf die agorum core client integration ziehen, die sich an eine definierbaren Stelle am Bildschirmrand befindet. Dies können Dokumente vom jeweiligen PC sein oder aber auch E-Mails aus Programmen wie Outlook und Thunderbird.

Je nach Konfiguration landen die abgelegten Dokumente direkt im Posteingang des Benutzers (im agorum core explorer), oder es öffnet sich eine konfigurierbare Oberfläche, in der der Benutzer die gewählten Dokumente ablegen kann.

Die agorum core client integration installieren

1. Laden Sie das Set-up-Programm herunter und führen Sie es aus. Diese .exe-Datei ist nach diesem Muster benannt:

   setup-agorum-core-drop-x_x_x_y-zzzz.exe
   

   Hinweis: x, y und z stehen für die entsprechende Version.
   
   Beispiel (Version fett markiert)

   setup-agorum-core-drop-9_0_0_3-1129.exe
   

   Ist bereits eine Version vorhanden, aktualisiert sie sich.

Allgemeine Funktionsweise

Die agorum core client integration definiert sich über ein Add-on-JavaScript. Sie müssen alle agorum core client integrations dort eintragen. Bei der Initialisierung der agorum core client integration auf dem Server legen Sie fest, in welchen Ordner eine Datei, die auf die agorum core client integration abgelegt wird, in agorum core abgelegt wird. Diese Ablage kann endgültig sein oder gesteuert werden:

Steuerung über eine Ablage-Konfiguration im agorum core konfigurator
Auf den definierten Ordner der agorum core client integration müssen etwa die Metadaten area (vererbt) und identifier (nicht vererbt) gelegt werden. Diese verwendet das System dann für den Selektor. Im zugehörigen Skript können Sie die Ablage der Dokumente über die Dropfläche steuern.

Steuerung der Ablage durch einen Aktiven Ordner, der auf den Ordner der agorum core client integration gesetzt wird
Ein Aktiver Ordner verarbeitet die über die agorum core client integration abgelegten Dokumente.

Wenn Sie eine agorum core client integration mit einem eigenen Namen einrichten, müssen Sie auch den Aufruf beim Add-on für diese agorum core client integration definieren. Im Add-on können Sie mehrere agorum core client integrations aufrufen.

Das Add-on-Skript in die MetaDB eintragen

1. Öffnen Sie in der Seitenleiste Administration und dann MetaDB.
2. Öffnen Sie den Pfad:

   MAIN_MODULE_MANAGEMENT/client/AddOns
   

3. Legen Sie in diesem Pfad über  folgendes Property-Entry an:
   
   Name
   drop-area.js
   
   Datentyp
   Inhalt (Content)
   
   Wert (Content)
   <Inhalt des Skripts>
   
   Beispiel für das Skript:

   /* global Ext, Actions */
   
   Ext.onReady(function() {
     // Hier den Pfad definieren, in den die Dropfläche die Daten ablegt
     Actions.Client.initDrop('/agorum/roi/SmartAssistant/DropArea');
   });

   Die Funktion Actions.Client.initDrop können Sie mit mehreren Parametern aufrufen:

   Actions.Client.initDrop(folder, name);
   

   Parameter
   
   folder
   Definiert den Ordner, in den das System die Dokumente ablegt. Der Ordner muss vorhanden sein, etwa /agorum/roi/SmartAssistant/DropArea oder home:MyFiles.
   
   name (optional)
   Definiert den Namen der agorum core client integration, etwa acmf_wf_inbox (siehe agorum core client integration auf dem Client starten).
   
   Beispiel des Skripts drop-area.js mit mehreren Einträgen:

   /* global Ext, Actions */
   
   Ext.onReady(function() {
     // Beispiel für Eigene Dateien des aktuellen Benutzers
     //Actions.Client.initDrop('home:MyFiles');
     
     Actions.Client.initDrop('/agorum/roi/SmartAssistant/DropArea');
     
     // Drop.exe param1 param2
     // param1 = Name der Dropfläche
     // param2 = Farbe der Dropfläche gold oder etwa so #1F1F1F
     // wurde gestartet im Autostart mit den Parametern: "C:\Program Files (x86)\agorum\agorum core Drop\Drop.exe" acmf_wf_inbox olive 
     // 
     Actions.Client.initDrop('/agorum/roi/SmartAssistant/DropAreaWF', 'acmf_wf_inbox');  // Zweite Dropfläche
   
     // Drop.exe param1 param2
     // param1 = Name der Dropfläche
     // param2 = Farbe der Dropfläche gold oder etwa so #101010
     // wurde gestartet im Autostart mit den Parametern: "C:\Program Files (x86)\agorum\agorum core Drop\Drop.exe" acmf_automover green 
     // 
     Actions.Client.initDrop('/agorum/roi/SmartAssistant/DropAreaAutoMover', 'acmf_automover');  // Dritte Dropfläche
   
     // Drop.exe param1 param2
     // param1 = Name der Dropfläche
     // param2 = Farbe der Dropfläche gold oder etwa so #101010
     // wurde gestartet im Autostart mit den Parametern: "C:\Program Files (x86)\agorum\agorum core Drop\Drop.exe" acmf_mandanten blue 
     // 
     Actions.Client.initDrop('/agorum/roi/SmartAssistant/Dropfläche Mandanten', 'acmf_mandanten');  // Vierte Dropfläche
   });

Die agorum core client integration auf dem Client starten

Auf dem Client muss das Modul setup-agorum-core-drop-x_x_xx_x-xxx.exe installiert sein. Starten Sie die agorum core client integration per Doppelklick auf die Drop.exe:

Die agorum core client integration mit Parametern starten

Diese Konfiguration ist optional. Verwenden Sie sie bei mehreren Installationen, etwa wenn das agorum core basic archive zusammen mit dem agorum core smart archive vorhanden ist.

1. Passen Sie das Add-on-Skript in desk4web an.
2. Kopieren Sie das Programm Drop.exe.
3. Fügen Sie es als Verknüpfung an einer beliebigen Stelle ein, etwa auf dem Desktop.
4. Öffnen Sie die Eigenschaften der Verknüpfung über das Kontextmenü.
5. Wechseln Sie in die Registerkarte Verknüpfung.
6. Geben Sie im Feld Ziel den Parameter acsas ein.
7. Benennen Sie die agorum core client integration um, etwa in Drop smart archiv.
   
   Ergebnis: Sie können die agorum core client integration per Doppelklick öffnen.

Beispiel des agorum core amart archives
mit der Farbe grün

Erläuterung der Oberfläche

Ziel: "Installationsverzeichnis\agorum\agorum core Drop\Drop.exe" name color

Ziel: "C:\Program Files(x86)\agorum\agorum core Drop\Drop.exe" acsas green

Farbcodes

Mit dem agorum core server verbinden

Die agorum core client integration verbindet sich automatisch mit dem agorum core server über den agorum core client. Dieser verbindet sich im Standard immer mit dem ersten agorum dms drive, den er findet, sortiert nach dem Laufwerksbuchstaben A bis Z.

Probleme und Lösungen

Unvollständige Fehlermeldung

Liegt hinter der agorum core client integration eine fehlerhafte Aktion, die das System über die agorum core smart assistant-Konfiguration ausführt, kann im Client eine unvollständige Fehlermeldung erscheinen, etwa:

Unlesbare Fehlermeldung

Fehlerdefinition

Diesen Fehler finden Sie im agorum core explorer. Dazu muss der Ablageordner der agorum core client integration dort angezeigt werden.

Gehen Sie wie folgt vor:

1. Öffnen Sie im agorum core explorer den Ablageordner.
2. Legen Sie eine Datei per Drag-and-drop in den Ordner ab.
   
   Ergebnis: Derselbe Fehler tritt auf, dieses Mal mit einer vollständigen Fehlermeldung.

Lesbare Fehlermeldung

In diesem Falle wurde keine Ablageregel für diesen Bereich definiert, oder es gibt bei allen Ablagen keinen für diesen Bereich passenden Selektor.

Lösung (Beispiel)

Die agorum core client integration ist folgendermaßen eingestellt:

Actions.Client.initDrop('home:MyFiles')

Es existiert nur eine Ablageregel mit einem Selektor auf [~~area=....].

An Orten, wo kein Selektor definiert ist, treten die obigen Fehlermeldungen auf.

Um den Fehler zu beheben, definieren Sie einen Selektor, hier etwa für den Bereich MyFiles:

Name
MyFiles

Selektor
[acl=12000]  

Damit gilt für den Privatbereich ACL=12000.

Fehler bei mehreren agorum core client integrations

Beim Testen sind oftmals mehrere agorum core dms drives mit unterschiedlichen agorum core servern verbunden.

Der agorum core client verbindet sich im Standard mit dem ersten auffindbaren agorum core dms drive. Dabei geht er die Sortierung der Laufwerksbuchstaben von A bis Z durch und verbindet sich mit dem ersten belegten Buchstaben.

Beispiel

Die agorum core dms drives H und M existieren. Der agorum core client verbindet sich mit Laufwerk H, da H im Alphabet vor M kommt. 

Wird jetzt die agorum core client integration verwendet, reagiert diese auf den agorum core dms drive H und versucht, die Objekte dort abzulegen.

Prüfen Sie, ob es mehrere agorum core dms drives gibt und wenn ja, ob das richtige Laufwerk, das zum Testen gedacht ist, verbunden ist. Wenn nicht, trennen Sie alle anderen ungenutzten agorum core dms drives, damit Sie die agorum core client integration korrekt testen können.