Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- extensibility:plugins-runnable [2024/08/20 15:06] – adm-dlatikay
+++ extensibility:plugins-runnable [2025/07/03 14:02] (aktuell) – [Beispiel] adm-dlatikay
@@ Zeile 5: / Zeile 5: @@
 ===== Beschreibung =====
-Ausführbare Plugins sind dadurch gekennzeichnet, dass sie eine öffentliche Klasse des Basistyps ''%%AutomationScriptBase%%'' implementieren. Dadurch erhält das Plugin einen Einsprungpunkt für die Laufzeitumgebung, in den hineingestartet werden kann. Kompilierung und Bindung an die Laufzeitumgebung erfolgt dabei mit dem gleichen Mechanismus, der auch mit direkt in Hintergrund-Jobs eingebetteten Skripten zum Einsatz kommt. Der Vorteil bei der Verwendung eines Plugins liegt hier darin, dass die in CAATS integrierte Entwicklungsumgebung zum Erstellen und Bearbeiten dieser Skripts verwendet werden kann, und die so erstellen Skripten getestet und abgespielt werden können, ohne zuvor eine Hintergrund-Job-Definition hochladen zu müssen.
+Ausführbare Plugins sind dadurch gekennzeichnet, dass sie eine öffentliche Klasse des Basistyps ''%%AutomationScriptBase%%'' implementieren. Dadurch erhält das Plugin einen Einsprungpunkt für die Laufzeitumgebung, in den hineingestartet werden kann. Kompilierung und Bindung an die Laufzeitumgebung erfolgt dabei mit dem gleichen Mechanismus, der auch mit direkt in Hintergrund-Jobs eingebetteten Skripten zum Einsatz kommt. Der Vorteil bei der Verwendung eines Plugins liegt hier darin, dass die in CAATS integrierte Entwicklungsumgebung zum Erstellen und Bearbeiten dieser Skripten verwendet werden kann, und die so erstellen Programme getestet und abgespielt werden können, ohne zuvor eine Hintergrund-Job-Definition hochladen zu müssen.
-===== Beispiele =====
+===== Beispiel =====
-Beispiel
+<file csharp runnable_plugin_example.cs>
+public class ExampleWorker : AutomationScriptBase
+{
+    public ExampleWorker(ScriptedAutomator scriptHost, IdentityBase executiveIdentity, IEventBus eventBus)
+        : base(scriptHost, executiveIdentity, eventBus)
+    {
+    }
+    public override bool Execute()
+    {
+        /* Ein minimales Beispiel eines direkt ausführbaren CAATS-Plugins */
+        Job.Success($"{Job.Name.First().Content} successfully completed");
+        return true;
+    }
+}</file>
 ===== Fehlercodes und Lösungen =====
@@ Zeile 16: / Zeile 31: @@
 ^ Fehlercode      ^ Bedeutung       ^ Lösung          ^
-| CAATS0002 | No suitable public type for runnable plugin | Definiern Sie in Ihrem Skript eine öffentliche Klasse des verlangten Basistyps |
+| CAATS0002 | No suitable public type for runnable plugin \\ //Each kind of plugin must use a well-known namespace and interface/base type for its main class, so the automation can instantiate and call it// | Definiern Sie in Ihrem Skript eine öffentliche Klasse des verlangten Basistyps |
-| CAATS0004 | Runnable plugin exposes more than one main class | Reduzieren Sie die Anzahl der öffentlichen Klassen des angegebenen Basistyps in Ihrem Skript auf 1 |
+| CAATS0004 | Runnable plugin exposes more than one main class \\ //Each plugin script must export exactly one main class that satisfies the automator's type constraints// | Reduzieren Sie die Anzahl der öffentlichen Klassen des angegebenen Basistyps in Ihrem Skript auf 1 |