Durchsuchbare Dokumentation aufrufen

Zurück zur Dokumentationsübersicht

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

Tipp: Sie können mehrere agorum core client integrations definieren. Kennzeichnen Sie diese auf dem Client mit unterschiedlichen Farben.

  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:

Installationsverzeichnis\agorum\agorum core Drop\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
Parameter Beschreibung
name Definiert den Namen der agorum core client integration.
color Definiert die Farbe der agorum core client integration.

Sie können den Farbnamen oder den Farbcode verwenden.


Beispiel

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

Farbcodes

Farbname Farbcode
Red #FF0000
Cyan #00FFFF
Blue #0000FF
Darkblue #0000A0
LightBlue #ADD8E6
Purple #800080
Yellow #FFFF00
Lime #00FF00
Magenta #FF00FF
White #FFFFFF
Silver #C0C0C0
Grey #808080
Black #000000
Orange #FFA500
Brown #A52A2A
Maroon #800000
Green #008000
Olive #808000

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.

Hinweis: Für ein Beispiel zur Anwendung der Dropfläche siehe Dropfläche mit dem agorum core basic archive verwenden.

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.