Zum Inhalt

Jobs und steps

Jobs und steps

ADIB-Jobs

Im Zusammenhang des ADIB ist ein "Job" eine "Klammer" um mehrere inhaltlich zusammengehörende Applikations-Integrations-Aufgaben. Jede einzelne Aufgabe wiederum stellt einen "Step" dar, der im nächsten Abschnitt erläutert wird. Wichtig bei dem Job ist das Thema Ausführungszeit. Hierbei definieren Sie, zu welchem Zeitpunkt (und damit auch wie oft) der Job ausgeführt werden soll. So können Sie zB. einen Job jeden Tag um 1:00 nachts laufen lassen In einem "ADIB-Job" definieren Sie

  • Ist der Job aktiv?
  • Auf welchen Instanzen soll der Job ausgeführt werden?
  • An welcher Position soll der Job ausgeführt werden?
  • Name des Jobs
  • Beschreibung
  • Welcher Job soll direkt im Anschluss ausgeführt werden?
    • Hiermit können Sie eine Verkettung von Jobs umsetzen.
  • Zeiten, zu denen der Job ausgeführt werden soll
    • Hierbei nutzen Sie das etablierte "cron-format"
    • Beispiel: "0 3 - - - 1-5" : führt den Job jeden Werktag (1=Montag, 5=Freitag) um 3:00 nachts aus

Die folgende Abbildung zeigt die angelegten Jobs Jobliste des ADIB {.is-info}

Das folgende Kapitel geht auf die Steps ein, die die Kernelemente der Konfiguration darstellen.

ADIB-Steps

Ein Step stellt eine Applikations-Integrations-Aufgabe dar. Sie ist in der Regel definiert durch ein Quellsystem und ein Zielsystem sowie eine Abbildungs-Vorschrift, die besagt, wie die Daten der Quelle in das Ziel transportiert werden sollen.

Darüber hinaus kann ein Step auch weitere Elemente enthalten:

  • Nachfolge-Prozess - zB. um eine eMail zu versenden nach erfolgreichem Abschluss der Aufgabe
  • Vorgänger-Prozess - zB. Dateien von einem entfernten Verzeichnis (zB. via FTP) abrufen
  • Webservice-Komponente - also das Abrufen von Daten von einem Webservice ODER das Übertragen von Daten zu einem Webservice

Die folgende Abbildung zeigt die Übersicht über die Steps - gefiltert für den Job "Import2ADIB" Stepliste des ADIB {.is-info}

Die Spalten der angezeigten Tabelle haben folgende Bedeutung:

  • Active / Parameter / Position: Hierüber aktivieren Sie den Steps bzw. gelangen in verschiedene Konfigurations-Schritte
    • Active: Ist der Step aktiv (Sie können somit sehr einfach einen Step deaktivieren - ohne ihn zu löschen!)
    • Parameter: Dies öffnet einen "Wizard", über den die Parameter (zB. Verbindungs-Parameter etc.) definiert werden
    • Position: Dies öffnet eine Liste (direkt unter dem entsprechenden Step), über den die zu übertragenen Felder ("Positions") definiert werden
  • Job: Definiert, zu welchem Job der entsprechende Step gehört
  • Instance: Auf welchen Instanzen soll der Step ausgeführt werden?
  • Position: Definiert die Abarbeitungs-Reihenfolge der Steps innerhalb eines Jobs
  • Step: Der Name des Steps
  • Description: Eine Beschreibung zu dem Steps
  • preProcess: Definiert den Pre-Prozess (siehe unten)
  • srcModule: Definiert das Quell-Modul (siehe unten)
  • wsModule: Definiert das Webservice-Modul (siehe unten)
  • destModule: Definiert das Ziel-Modul (siehe unten)
  • postProcess: Definiert den Post-Prozess (siehe unten)
  • Functions: Öffnet ein Fenster, über das weitere Details zu dem Step definiert werden

Das Detailfenster zu dem Step enthält folgende Einstell-Möglichkeiten: Stepliste des ADIB

  • dryRun: startet einen Prozess, der die Verbindungen der definierten Module prüft - und dann zB. die möglichen Felder einer definierten Datenbank-Tabelle ausliest und zurückgibt
  • stepmodus: definiert, ob jeweils alle Werte übertragen werden sollen (fullTransfer) - oder nur im Vergleich zum letzten Daten-Transfer geänderte Daten (deltaWholeLine) - oder die Datenzeilen, die nicht mehr existieren (deltaDroppedLine)
  • setLastExecutionTime : hiermit steuern Sie das Datum der letzten Ausführung. Dies ist interessant, wenn der Step so konfiguriert ist, dass er nur nur geänderte Datensätze abruft - Sie diesen aber für den nächsten Durchlauf alle Datensätze ab dem definierten Zeitpunkt abrufen möchten.
  • resetIncremental : setzt im Falle von stepmodus ungleich "fullTransfer" den Vergleichsbuffer zurück. Dies hat zur Folge, dass beim nächsten Durchlauf ALLE Daten erneut übertragen werden. Hierbei muss die Instanz definiert werden.
  • connectstepid: definiert den Nachfolge-Prozess
  • steppositionmodus: wenn dieser auf "all" steht, werden alle (bekannten) Felder übertragen - die Angabe von "step-positions" ist in diesem Fall nicht erforderlich
  • flexmapping_list: sofern der Step keine "einfache Feld-zu-Feld Übertragung" machen soll - sondern eine komplexe Umwandlung von Datenstrukturen (z.B. Umwandlung eines EAV-Modells in eine strukturierte Tabelle), so wird an dieser Stelle die (vorher angelegte) Flexmapping-List ausgewählt.
  • ws_templateid: definiert (im Falle eines Webservice-Moduls) das Webservice-Template
  • Elastic-Template: definiert (im Falle eines ADIB-Portal-Steps) das Portal-Template

Zunächst wird ein Überblick über die vorhandenen Module / Prozesse gegeben, bevor auf die anzulegenden Parameter sowie die Step-Positionen eingegangen wird.