Verbindung des agorum core clients festlegen

Der agorum core client verbindet sich über ein Netzlaufwerk mit agorum core, per SMB (agorum core dms drive) oder per WebDAV (agorum core cloud share). Diese Dokumentation beschreibt, wie der agorum core client das Laufwerk wählt und wie Sie die Verbindung mit Startparametern und in der MetaDB festlegen.

Laufwerk automatisch wählen

Startet der agorum core client ohne Parameter, prüft er die verbundenen Netzlaufwerke in alphabetischer Reihenfolge der Laufwerksbuchstaben. Er verwendet das erste Laufwerk, über das er eine Verbindung zu agorum core herstellen kann, etwa E: vor Z:. Das gilt für SMB- und WebDAV-Laufwerke.

• Verbinden Sie das Netzlaufwerk, bevor der agorum core client startet. Ein nachträglich verbundenes Laufwerk erkennt der agorum core client erst nach einem Neustart.
• Der agorum core client verbindet sich immer nur mit einem agorum core System. Sind Laufwerke zu mehreren Systemen verbunden, öffnen sich per Doppelklick nur Dokumente des Systems, dessen Laufwerk den alphabetisch ersten Buchstaben hat.

Beispiel: Folgende Netzlaufwerke sind verbunden:

dms (\\meinefirma.agorum.com\dms) (G:)
dms (\\testsystem.agorum.com\dms) (Y:)
dms (\\dataroom.partnerfirma.agorum.com\dms) (Z:)

Der agorum core client verbindet sich mit meinefirma.agorum.com, weil G: der alphabetisch erste Buchstabe ist. Soll er sich mit einem anderen System verbinden, legen Sie das Laufwerk mit dem Parameter -l oder die Freigabe mit dem Parameter -u fest.

Startparameter des agorum core clients einstellen

Startparameter hängen Sie an den Aufruf der Datei AgorumClient.exe an. Im Standard liegt sie im Verzeichnis C:\Program Files (x86)\agorum\agorum core Client. Haben Sie den agorum core client in ein anderes Verzeichnis installiert, passen Sie den Pfad in den Beispielen an.

Gehen Sie wie folgt vor, um Parameter einzustellen:

1. Legen Sie eine Verknüpfung der Datei AgorumClient.exe an oder erstellen Sie eine Batch-Datei.
2. Öffnen Sie die Eigenschaften der Verknüpfung und hängen Sie im Feld Ziel die Parameter an.
3. Beenden Sie einen laufenden agorum core client und starten Sie ihn über die Verknüpfung oder die Batch-Datei neu.
   
   Ergebnis: Der agorum core client verbindet sich mit den angegebenen Einstellungen. Sie können die Verknüpfung oder die Batch-Datei auch in den Autostart einbinden.

Parameter einstellen

-l laufwerk:

Baut eine Verbindung zu dem Server auf, der über den angegebenen Laufwerksbuchstaben verbunden ist. Das Laufwerk kann per SMB oder per WebDAV verbunden sein. Sind mehrere agorum core Systeme verbunden, bestimmen Sie über den Parameter -l, mit welchem System sich der agorum core client verbindet.

Beispiel für das Feld Ziel

"C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -l z:

Beispiel für eine Batch-Datei

REM
REM  Startet den agorum core client auf einem definierten Laufwerk
REM

"C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -l z:

-u <UNC-Pfad>

Baut eine Verbindung zu der Freigabe auf, die der UNC-Pfad angibt, statt über ein verbundenes Laufwerk. So muss kein Netzlaufwerk durchgehend verbunden sein. Der UNC-Pfad richtet sich nach dem Protokoll:

Beispiel für das Feld Ziel (SMB)

"C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -u \\192.168.56.101\dms

Beispiel für das Feld Ziel (WebDAV)

"C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -u \\server.domain@SSL\webdav\dms

Beispiel für ein Startskript (agorumclient.cmd), das Sie etwa in den Autostart einbinden können:

start "agorum core client" "C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe" -u \\<agorum-Server-Adresse>\dms

Den Aufruf, mit dem Windows den agorum core client für agorum:-Links startet, können Sie in der Registry von Windows unter folgendem Schlüssel anpassen:

HKEY_CLASSES_ROOT\agorum\shell\open\command

-d

Startet den agorum core client im Debug-Modus, in dem das System zusätzliche und erweiterte Ausgaben in die Protokolldatei schreibt. Wo die Datei liegt und wie Sie sie auswerten, steht unter Probleme mit agorum core client und Doppelklick beheben.

-c <Anweisung>

Der Parameter führt die angegebene JavaScript-Anweisung aus, sobald die Verbindung zum Server hergestellt ist. Wenn schon eine Instanz des agorum core clients läuft, gibt das System die Anweisung an diese zur Ausführung weiter. Diesen Parameter verwendet das System intern für die Verarbeitung von agorum:...-URIs.

Beispiele

-c "window.open('/roiwebui/workflow_module')"

Das obige Beispiel öffnet die Workflow-Ansicht:

-c "Actions.open('123456')"

Das obige Beispiel öffnet das Objekt mit der ID 123456 entsprechend der im agorum core smart assistant konfigurator konfigurierten Open-Action.

Verbindungseinstellungen des agorum core clients in der MetaDB ändern

Den Server, mit dem sich der agorum core client verbindet, ermittelt er aus dem Pfad der verbundenen Freigabe. Protokoll und Port legen Sie in der MetaDB unter folgendem Pfad fest:

MAIN_MODULE_MANAGEMENT/client

Ist dort der Eintrag URL vorhanden, verwendet der agorum core client stattdessen diese URL.

Port

Im Standard ist die Einstellung Port deaktiviert (#Port). Entfernen Sie das Zeichen # aus dem Namen, um die Einstellung zu aktivieren. Wenn agorum core auf einem anderen Port als dem Standard-Port 443 läuft, tragen Sie den gewünschten Port ein.

Protocol

Im Standard verbindet sich der agorum core client über eine gesicherte SSL-Verbindung (https). Sie können als Wert ebenfalls http verwenden.

/MetaDb/MAIN_MODULE_MANAGEMENT/dynawebservices/common/DefaultUrl

URL

Wenn der Eintrag URL existiert, verwendet der agorum core client diese URL. Gehen Sie wie folgt vor, um eine abweichende Verbindungs-URL zu konfigurieren:

1. Öffnen Sie links in der Seitenleiste Administration > MetaDB.
2. Öffnen Sie den Pfad:

   MAIN_MODULE_MANAGEMENT/client

3. Erstellen Sie einen neuen MetaDB-Eintrag URL, wenn noch kein entsprechender Eintrag vorhanden ist.
4. Tragen Sie als Wert die gewünschte Verbindungs-URL ein.
5. Speichern Sie die Änderungen.
   
   Ergebnis: Der agorum core client verbindet sich nach einem Neustart über die eingetragene URL.

Beispiel für die Konfiguration einer Verbindungs-URL für agorum core client

Zugriff über einen Reverse Proxy

Greifen Arbeitsplätze über einen Reverse Proxy auf agorum core zu, verbindet sich der agorum core client mit dem Hostnamen aus dem Pfad der Freigabe sowie mit Protocol und Port aus der MetaDB. Leiten Sie deshalb unter diesem Hostnamen und Port neben WebDAV auch die Weboberfläche von agorum core weiter. Liegt WebDAV auf einem anderen Port als die Weboberfläche, tragen Sie den Port der Weboberfläche unter Port ein oder legen eine URL fest.