Open Source Dokumentenmanagement
Dokumentation
Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > Übersicht tags > Base System
JS Action
Über das agorum core support tool können Sie eigenständige Überprüfungen programmieren. Dazu erstellen Sie Ihre eigenen Skripte, die Sie über das agorum core support tool jederzeit mit einem Klick starten.
Unterschied zwischen JavaScript-Konsole, JS Action und Skripte
Wenn Sie sich bereits mit agorum core auskennen, wissen Sie, dass Sie an den unterschiedlichsten Stellen Skripte einpflegen oder aufrufen können:
- Sie können die JavaScript-Konsole verwenden.
- Sie können eigene Skripte schreiben und diese im System speichern.
Prinzipiell war der Grundgedanke hinter der JS Action, dass auf einfache Art und Weise eigene Metriken und Prüfungen gebaut werden können, die durch das agorum core support tool nicht abgedeckt oder mitgegeben werden.
Wenn etwa in den Metriken der Search Engine für einen Kunden bestimmte Informationen fehlen, dann würde theoretisch die Möglichkeit bestehen, diese durch eine JS Action selbst abzufragen. Ein kleines Beispiel könnte sein, dass dadurch ausgeben werden kann, welche Objekte in welchen Storage-Back-ends abgelegt sind.
Prinzipiell können diese Aufgaben auch über die JavaScript-Konsole oder durch ein eigenes Skript erledigt werden. Nur kommt hier der geschichtliche Aspekt ins Spiel. Die JS Action wurde entwickelt, als es noch nicht so einfach möglich war, die JavaScript-Konsole zu öffnen oder gar einfach ein Skript auszuführen. Die einfachste Möglichkeit zu diesem Zeitpunkt war, sich zentral ein paar Skripte abzulegen, mit denen ein Status abgefragt werden konnte.
Sie entscheiden also, welchen Zugriff Sie bevorzugen.
Der Vorteil bei der Nutzung der JS Action liegt darin, dass Sie alle Überprüfungen bezüglich des Systems an einem Ort vorliegen haben und Sie und Ihre Kollegen sich somit schnell zurechtfinden. Sagt Ihnen dieses Vorgehen nicht zu, können Sie eigene Skripte erstellen und diese etwa über das agorum core information center oder den agorum core smart assistant aufrufen. Auch die Erstellung eines eigenen Custom-Services ist möglich. Ihre Wahl hängt somit von Ihrem Anwendungsfall und Vorlieben ab.
Ein Skript erstellen
- Wählen Sie im agorum core support tool links im Menü Base System > Actions > JS Action.
Ergebnis: Die Oberfläche zum Erstellen des Skripts öffnet sich. - Tragen Sie einen Namen für das Skript ein.
- Fügen Sie das Skript ein (siehe auch agorum core JavaScript-API).
Hinweis: Die in der JS Action erstellten Skripte werden in der MetaDb als mehrzeilige Property angelegt.
- Klicken Sie auf Execute.
Ergebnis: Das Skript wird gestartet.
Im Abschnitt Log können Sie das Ergebnis prüfen.
Ein Skript regelmäßig ausführen
- Klicken Sie auf Save as new action.
Ergebnis: Das Skript erscheint links im Menü unterhalb von JS action.
Das Skript dieser neuen Aktion ist änderbar, der gesetzte Name bleibt bestehen. Sie können über diesen Bereich das JavaScript manuell starten, aktualisieren oder löschen.
Schaltfläche „Save and Execute“ vs. Schaltfläche „Update action“
Die Schaltfläche Save and execute legt das Skript als eigenen Knoten im agorum core support tool an und führt es zugleich einmalig aus. Diese Schaltfläche wählen Sie auch dann, wenn Änderungen im Code des Skripts durchgeführt wurden und dieses gleich ausgeführt werden soll.
Die Schaltfläche Update action wählen Sie, wenn Sie die Action oder das Skript aktualisiert haben und dieses nicht ausführen möchten, etwa wenn Sie einen Kommentar aktualisiert, eingefügt oder gelöscht haben.
Eine JavaScript-Aktion umbenennen
Ein Umbenennen ist nicht direkt möglich. Gehen Sie stattdessen folgendermaßen vor:
- Erstellen Sie eine neue Aktion mit dem gewünschten Namen (siehe Ein Skript regelmäßig ausführen).
- Kopieren Sie das Skript der nicht gewünschten Aktion in die neue Aktion.
- Löschen Sie die alte JavaScript-Aktion.