Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Verfügbar seit Version

Status
colourYellow
title2.22.88
des IntegrationsServers

Einstellungen

Die Einstellungen geschehen aktuell manuell in einer der appsettings.trigger.json (falls nicht existiert, einfach erzeugen, kann belieb viele json Dateien geben) des IntegrationService. Eine Integration in den AntonyHubClient kann leicht nachgeholt werden. Eine Beispieldatei ist weiter unten zu finden.

...

Code Block
 "Parameter": {
        "ScriptPath": "C:\\tmp\\TestScript.ps1",
        "WorkingDirectory": "C:\\tmp",
        "CheckExitCode": true,
        "CustomValueParameterName": "CustomValue",
        "ProcessTimeout": 1000,
        "Parameter": {
          "Parameter1": 28,
          "Parameter2": "testparameter"
        }
      }

Name

Beschreibung

Bemerkung

ScriptPath

Dies ist das einzige, notwendige Feld. Dieses Script wird durch den Trigger aufgeführt

WorkingDirectory

Ist dieses Feld gesetzt, wird das Arbeitsverzeichnis der Powershell auf den eingetragenen Wert gesetzt. Ist es nicht gesetzt, wird das Arbeitsverzeichnis des IntegrationServers verwendet

Default: Nicht gesetzt

CheckExitCode

Mit dieser Einstellung wird der IntegrationServer angewiesen den ExitCode des Scripts nicht zu überprüfen. Das hat zur Folge, dass eine Änderung eines CustomFields als Verarbeitet gilt, auch wenn das Script nicht erfolgreich beendet wurde.

Default: true

CustomValueParameterName

Mit dieser Einstellung kann der Name des Parameters konfiguriert werden, welcher den Wert des geänderten CustomFields enthält.

Default: CustomValue

ProcessTimeout

Antwortet das Powershellscript nicht (zum Beispiel weil es einen Remote-Call ausführt) wird der Prozess nach dem Timeout beendet. Die Angabe ist in Millisekunden

Default: 61440 ms = 1 Minute

Parameter

Hier können zusätzliche Parameter angegeben werden, welche an das Powershellscript übergeben werden sollen.

Der Typ des Parameters wird leider noch nicht übernommen und muss im Powershellscript “string” ein

Code Block
languagepowershell
  param(
      [Parameter()]
      [string]$CustomValue,
      [Parameter()]
      [string]$Parameter1,
      [Parameter()]
      [string]$Parameter2
  )
    
  Add-Content  C:\tmp\test.txt "${CustomValue} (${Parameter1}, ${Parameter2})"

SkipOnEmptyValues

Dieses Feld bietet die Möglichkeit auch dann das Skript auszuführen, wenn der enthaltene Wert leer (oder null) ist.

Default: true