Aktionen im Kontextmenü des Windows-Explorer einbinden

Sie können eine Aktion aus dem agorum core smart assistant konfigurator in das Kontextmenü des Windows-Explorer einbinden.

Hinweis: Der agorum client unterstützt aktuell nicht von Haus aus die Darstellung von aguila-widgets in einem eigenen Fenster. Verwenden Sie stattdessen:

window.open('/roiwebui/aguila_module?type=aguila.widget.type&prop1=val1&prop2=val2');

Vorbereitung

Datei „client.js“ anlegen

Diese Datei enthält ein Programm, das die agorum core client-Aktion mit dem gewählten Objekt verknüpft und diese mit der ObjektId aufruft.

Öffnen Sie den Pfad zum agorum core client. Sie finden Sie diesen standardmäßig unter:
```
C:\Program Files (x86)\agorum\agorum core client\
```
Legen Sie in diesem Verzeichnis den Ordner context an.
Legen Sie in diesem Ordner die Datei client.js an.

Befüllen Sie die Datei mit folgendem Inhalt:

try {
  var objInfo = WScript.
                CreateObject('Scripting.FileSystemObject').
                OpenTextFile(WScript.Arguments(1) + '.$$GO$$', 1, true).
                ReadAll();
  var id = objInfo.
           substring(
             objInfo.indexOf('<ObjectId>') + 10,
             objInfo.indexOf('</ObjectId>')
           );
  WScript.
  CreateObject("WScript.Shell").
  Run("agorum:" + WScript.Arguments(0) + ":" + id);
}
catch (err) {
  WScript.Echo("Kein agorum core-Objekt");
}

Hinweis: Das JavaScript ist so geschrieben, dass die Aktionen nur auf dem agorum core dms drive (Netzlaufwerk) funktionieren. Führen Sie die Aktion über das Kontextmenü etwa auf einer Datei auf dem Desktop aus, so erhalten Sie die Fehlermeldung Kein agorum core Objekt.

Die Aktion in der Registry von Windows registrieren

Um eine Aktion aus dem agorum core smart assistant konfigurator in der Registry von Windows zu registrieren, gehen Sie wie nachfolgend beschrieben vor.

Symbol für das Kontextmenü wählen

Das hier gewählte Symbol steht später neben der Aktion im Kontextmenü. Sie können auch ein eigenes Symbol wählen.

Öffnen Sie den Registry-Editor in Windows.
Öffnen Sie den Pfad:

Wenn die Aktion auf einer Datei ausgeführt werden soll:
```
HKEY_CLASSES_ROOT\*\shell\
```
Wenn die Aktion auf einem Ordner ausgeführt werden soll:
```
HKEY_CLASSES_ROOT\Folder\shell
```
Legen Sie einen Schlüssel mit Rechtsklick > Neu > Schlüssel an.
Benennen Sie diesen entsprechend der agorum core smart assistant-Aktion.
Legen Sie unterhalb des Schlüssels eine neue Zeichenfolge mit Rechtsklick > Neu > Zeichenfolge an.
Vergeben Sie einen Namen für das Symbol.
Geben Sie als Wert den Pfad zur Datei agorumclient.exe an. Im Standard finden Sie die Datei unter:
```
C:\Program Files (x86)\agorum\agorum core Client\AgorumClient.exe
```

Die Aktion registrieren

Legen Sie einen Unterschlüssel unterhalb des Schlüssels für die Aktion an.
Vergeben Sie den Namen command.
Passen Sie die dort mit Rechtsklick auf Datei > Ändern enthaltene Standard-Zeichenfolge an.

Beispiel
```
wscript "C:\Program Files (x86)\agorum\agorum core Client\context\client.js" "action:openAsa" "%1"
```
Ergebnis: Mit diesem Beispiel öffnet sich der agorum core explorer. In diesem Wert steht die eigentliche agorum core client-Aktion. Diese ruft das System über ein wscript auf, dem es drei Parameter übergibt:

Aufruf des Client-Programmes per client.js
Dieses Client-Programm holt die eindeutige agorum-ID des markierten Dokuments und ruft dann die eigentliche Aktion aus dem agorum core explorer auf.

Name der aufzurufenden Aktion aus dem agorum core explorer
```
action:<Aktionsname aus dem agorum core explorer >
```
Parameter %1
Enthält den Namen des markierten Dokuments.

Beispiele

Beispiel für eine Aktion auf einer Datei

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\*\shell\agorum Eigenschaften\command]
@="wscript \"c:\\Program Files (x86)\\agorum\agorum core Client\\context\\client.js\" \"action:Detailsanzeigen\" \"%1\""
[HKEY_CLASSES_ROOT\*\shell\agorum Eigenschaften]
"Icon"="c:\\Program Files (x86)\\agorum\\agorum core Client\\AgorumClient.exe"

Beispiel für eine Aktion auf einen Ordner

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Folder\shell\Partnerakte anlegen\command]
@="wscript \"c:\\Program Files (x86)\\agorum\agorum core Client\\context\\client.js\" \"action:_acso_Partnerakteanlegen\" \"%1\""
[HKEY_CLASSES_ROOT\Folder\shell\Partnerakte anlegen]
"Icon"="c:\\Program Files (x86)\\agorum\\agorum core Client\\AgorumClient.exe"