Allgemein

Der Integrationserver überwacht den EventStream und kann auf Wunsch Powershell-Scripte ausführen, wenn sich der Wert eines vorgegebenen Felds ändert. Diese Funktion interagiert direkt mit dem EventStream. Somit werden die Trigger auch nachträglich ausgeführt, wenn der IntegrationService eine Weile ausgeschaltet gewesen ist und er anschließend wieder gestartet sind.

Einstellungen

Die Einstellungen geschehen aktuell manuell in einer appsettings.json. Eine Integration in den AntonyHubClient kann leicht nachgeholt werden. Eine Beispieldatei ist weiter unten zu finden.

Es wird ein CustomFieldTrigger Element erzeugt, welches eine Liste beherbergt. Es können damit beliebig viele Trigger definiert werden. Anschließend folgt eine Id, welche eindeutig sein muss. Am besten wird einfach eine neue Id gewürfelt. Anschließend folgt der Name des Felds, welches überwacht werden soll. Zunächst muss die Id des Felds herausgesucht werden - am einfachsten aus dem antony-Client und mit einem “Field_” als Präfix eingetragen werden. In unseren Beispiel also “Field_1456” für das CustomField mit der Id 1456.

{
  "CustomFieldTrigger": [
    {
      "Id": "5C1A8F61-78D1-447A-A34B-B31C4757F45A",
      "FieldName": "Field_1456",
      "ModuleName": "PowerShell",
      "Parameter": {
        "ScriptPath": "C:\\tmp\\TestScript.ps1",
        "WorkingDirectory": "C:\\tmp",
        "Parameter": {
          "Parameter1": 28,
          "Parameter2": "testparameter"
        }
      }
    }
  ]
}

Anschließend wird der ModuleName eingetragen. Für einen Powershell Befehl lautet dieser PowerShell. Achtung: Dies ist nicht der ModuleKey. Diese Einstellungen sind bisher Allgemein und beschreiben nicht den “Aktor”. Dieser wird mit dem Parameter Objekt konfiguriert. Dessen Inhalt ist abhängig vom verwendeten Modul (hier Powershell) - die verfügbaren Module werden weiter unten beschrieben.

Ist die Konfiguration eingetragen, muss der IntegrationServer neugestartet werden. Anschließend wird der Dienst die Konfiguration lesen - sofern er sich im config Unterordner befindet und den Trigger konfigurieren.

Powershell