Dokumentation & Guides (v.1.1.2)

Aufgaben-Planung

In der workflows.json im Installations-Verzeichnis können beliebig viele Aufgaben (Tasks) mit beliebig vielen Einzelschritten (Steps) angelegt werden. Die Aufgaben werden in flexiblen Zeit-Intervallen (Cronjobs) automatisch ausgeführt werden.

Zeit-Intervalle (Cronjobs) festlegen:

https://crontab.guru/examples.html

Aufgaben-Objekt

Jede Aufgabe ist ein JSON-Objekt und wird in der workflows.json in Knoten Tasks eingefügt.

Felder

FeldDetails
IdName der Aufgabe (Keine Leer- und Sonderzeichen)
IntervalIntervall zur Ausführung der Aufgabe. Das Format muss in Cron beschrieben sein. https://crontab.guru/examples.html
StepsObjekt mit den einzelnen Schritten.

Aufgaben-Schritte (Steps)

Jeder Schritt hat eigene Konfigurationen mit eigenen Parametern. In den Ressourcen der entsprechenden Funktionen sind die Parameter beschrieben.

FeldDetails

|Type | Name der Funktion. | |Config | Konfiguration der Funktion mit Parametern|

Hier die Liste der Funktionen: Link folgt - sorry

Workflow-Beispiel

{
  "Tasks": [
    {
      "Id": "Bestandsexporte",
      "Interval": "0 */1 * * ?",
      "Steps": [
        {
          "Type": "WriteCsvFromQuery",
          "Config": {
            "TenantId" : "200-001",
            "DestinationFile": "C:\\_ROINX\\_temp\\lager.csv",
            "QueryFile": "C:\\_ROINX\\_addons\\sqlBestandsExport.sql"
          }
        },
	{
          "Type": "InvokeAmeise",
          "Config": {
            "InputFile": "C:\\_ROINX\\_temp\\lager.csv",
            "TemplateId": "IMP1",
            "TenantId": "100-001",
            "JtlHomeDirectory": "C:\\Program Files (x86)\\JTL-Software"
          }
        },
	{
          "Type": "MoveFile",
          "Config": {
            "SourceDirectory": "C:\\_ROINX\\_temp",
            "DestinationDirectory": "C:\\_ROINX\\_archive",
            "FilePattern": "*.csv",
            "AddDatePrefix": true
          }
        }
      ]
    }
  ]
}

Erklärung

Intervall: 0 */1 * * * zu jeder ersten Minuten in jeder Stunde

  1. Schritt “WriteCsvFromQuery” Erzeugt eine CSV Datei (DestinationFile) aus dem Ergebnis einer SQL-Abfrage innerhalb einer .sql-Datei (Queryfile) für den Mandanten 200-001 (TenantId).

  2. Schritt “InvokeAmeise” Führt die JTL Ameise mit der Import-Vorlage 1 (TemplateId) mit der Datei lager.csv (InputFile) für den Mandanten 100-001 (TenantId) aus.

  3. Schritt “MoveFile” Verschiebt alle .csv-Dateien (FilePattern) aus dem Quell-Verzeichnis (SourceDirectory) ins Ziel-Verzeichnis (DestinationDirectory) und versieht alle verschobenen Dateien mit einem Präfix (AddDatePrefix)

Best Practice und Tutorials

Hier finden Sie eine Übersicht über unsere Tutorials: Link folgt - Sorry!