Aufgaben aus System | i-effect Handbuch

Innerhalb von System gibt es eine Reihe von Aufgaben.

image2016-6-2 12:52:23.png

Folgenden Aufgaben stehen zur Verfügung:

Aufgabe	Beschreibung
addFileProcessKeywordValue	Setzt ein Wert für ein Schlüsselwort der Vorgangsverfolgung. In diesem Vorgang wird dann ein neuer Eintrag mit diesem Schlüssel und dem entsprechenden Wert hinzugefügt. Schlüssel können auch in der datei index_configuration.xml im Mapper/conf Verzeichnis auf der AS400 Maschine editiert werden.
addLogbookMessage	Fügt einen neuen Eintrag in das Logbuch dieser Sitzung ein.
copyAllOutputFiles	Dieser Task kopiert alle Ausgabedateien in ein neues Ziel (wenn vom Zielmodul mehrere Dateien erstellt werden). Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizerten Dateinamen, d.h. dieser Pfad und Dateiname werden verwendet.
copyFile	Diese Aufgabe kopiert eine Quelldatei in eine angegebene Zieldatei. Existiert die Zieldatei bereits, wird diese überschrieben. Quell- und Zieldatei müssen mit absolutem Pfad angegeben werden.
copyInputFile	Dieser Task kopiert die Eingangsdatei in ein neues Ziel. Ist der Paramter type: RELATIVE -> Pfad, so wird der Ausgabedateiname aus dem Runmap verwendet. Ist der Paramter type: ABSOLUTE -> Datei, so wird dieser Pfad als absolut (inklusive Dateiname) behandelt.
copyOutputFile	Dieser Task kopiert die Ausgabedatei in ein neues Ziel. Nur die zuletzt generierte Ausgabedatei wird zum kopieren vorgemerkt (wenn noch keine Ausgabedatei generiert wurde, führt dies zu einem Fehler). Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizerten Dateinamen, d.h. dieser Pfad und Dateiname werden verwendet.
execCmdCall	Führt einen System Befehl auf dem System aus.
getBoolean	Gibt den Wert der gelieferten Variablen als Boolean zurück.
getDouble	Gibt den Wert der gelieferten Variablen als Double zurück.
getFloat	Gibt den Wert der gelieferten Variablen als Float zurück.
getInteger	Gibt den Wert der gelieferten Variablen als Integer zurück.
getLong	Gibt den Wert der gelieferten Variablen als Long zurück.
getOccurenceLevelCount	Gibt die Anzahl der Source-Schlüssel Ebenen (Keyparts) zurück. Beispiel: DB(-1);CONNECT_ID(-1);DBSYSTEM(-1);SCHEMA(-1);TABLE(-1);COLUMN(-1) gibt 6 zurück
getOccurence	Gibt das Vorkommen des gewünschten Schlüsselteils (Index - beginnend bei 0) zurück. Beispiel: DB(-1);CONNECT_ID(-1);DBSYSTEM(-1);SCHEMA(-1);TABLE(2);COLUMN(1) gibt 2 zurück.
getProcessID	Sucht einen Prozess anhand der festgelegten Parameter. Gibt im Erfolgsfall die UNIQUE_ID zurück. Im Fehlerfall wird -1 zurück geliefert. Die Variablen müssen als Keyword Values für das gewünschte Mapping registriert sein.
getString	Gibt den Wert der übergebenen Variablen als Datentyp String zurück.
getSystemVar	Dieser Task liest eine Umgebungsvariable vom Typ *SYS auf dem System. Existiert diese Variable nicht, so wird ein leerer String zurückgegeben
jdbcSqlLookup	Mit diesem Task können Sie mittels eines SQL-Queries spezielle Daten einer Datenbank deren Verbindung durch die dbURL definiert wird zu lesen. Der Query darf nur EINEN Wert als Ergebnismenge liefern! Beispiele für die URL: für Microsoft SQL Server: jdbc:microsoft:sqlserver://host:port;databasename=name;user=yourUser;password=yourPwd Die url wird verschlüsselt in der .map Datei gespeichert! Aus Lizenz-technischen gründen sind Javatreiber für die einzelnen Datenbanksysteme nicht dabei. Laden sie sich diese von dem jeweiligen Datenbankhersteller in Form einer .jar-Datei herunter und legen sie diese in folgendem Verzeichnis ab: /i-effect/VXRXM0/Mapper/lib
jdbcSqlUpdate	Mit dieser Aufgabe können Sie UPDATE, INSERT oder DELETE SQL-Statements ausführen.
moveAllOutputFfiles	Dieser Task verschiebt alle Ausgabedateien in ein neues Ziel (anstelle des Ausgabepfades des Runmap Befehls). Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizerten Dateinamen, d.h. dieser Pfad und Dateiname werden verwendet.
moveFile	Diese Aufgabe verschiebt eine Quelldatei zu einem neuen Ziel. Quell- und Zieldatei müssen mit absolutem Pfad angegeben werden. Das Zielverzeichnis muss schon existieren.
moveInputFile	Dieser Task verschiebt die Eingangsdatei zu einem neuen Ziel (anstelle des Errorpfades des Runmap Befehls. Bei erfolgreichen Mapping wird die Eingangsdatei lediglich ins Archiv KOPIERT). Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizerten Dateinamen, d.h. dieser Pfad und der neue Dateiname
moveOutputFile	Dieser Task verschiebt die Ausgabedatei zu einem neuen Ziel (anstelle des Ausgabepfades des Runmap Befehls). Nur die zuletzt generierte Ausgabedatei wird zum Verschieben vorgemerkt (wenn noch keine Ausgabedatei generiert wurde, führt dies zu einem Fehler). Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizierten Dateinamen, d.h. dieser Pfad und Dateiname werden verwendet.
numberFormat	Formatiert eine Nummer in das gewünschte Format. Siehe http://docs.oracle.com/javase/6/docs/api/java/text/DecimalFormat.html
resetVar	Setzt den Wert der übergebenen Variable auf den Initialwert zurück.
retrieveFileTimeStamp	Gibt den TimeStamp der Datei zurück.
runReport	Triggert einen RUNREPORT.
setBoolean	Setzt den übergebenen Wert als neuen Wert der Variablen.
setDouble	Setzt den übergebenen Wert als neuen Double Wert der Variablen.
setFloat	Setzt den übergebenen Wert als neuen Float Wert der Variablen.
setInteger	Setzt den übergebenen Wert als neuen Integer Wert der Variablen.
setLong	Setzt den übergebenen Wert als neuen Long Wert der Variablen.
setOccurence	Setzt das gewünschte Vorkommen OccurenceValue auf das Ziel Element OccurenceLevel. Beispiel: Der Task ist an folgendem Mapping definiert: EDIFACT;UNEDIFACT;D96A;INVOIC;BGM;DTM;2380 In diesem Fall würde der Quellwert in das DTM;2380 der dritten Nachricht gemappt, da der OccurenceLevel 5 das BGM (die Nachricht) darstellt und der OccurenceValue 3 die 3.
setOutputFileName	Dieser Task verschiebt die kommenden Ausgabedateien in ein neues Ziel (anstelle des Ausgabepfades des Runmap Befehls). Wird also angegeben bevor die Ausgabedatei geschrieben/registriert wird. Der Paramter type: RELATIVE spezifiziert ein neues Verzeichnis, und der Dateiname wird aus dem Runmap verwendet. Der Paramter type: ABSOLUTE spezifiziert ein Voll-Qualifizierten Dateinamen, d.h. dieser Pfad und Dateiname werden verwendet.
setProcessID	Setze die Prozess-ID der aktuellen Sitzung.
setString	Liefert den eingegebenen Wert als String zurück.
setSystemVar	Dieser Task setzt ein Umgebungsvariable vom Typ *SYS auf dem System. Existiert diese Variable, so wird sie ersetzt.
setToError	Bricht den aktuellen Mapping-Prozess ab und setzt den Status auf ERROR.
sqlLookup	Mit dieser Aufgabe können Sie mit SQL-Queries spezielle Daten aus der (System i) Datenbank zu lesen. Sollte der SELECT mehr als ein Ergebnis zurück-liefern, wird genau nur das erste Ergebnis genommen. Wenn kein Ergebnis existiert, wird eine leere Zeichenkette zurückgegeben.
sqlUpdate	Mit dieser Aufgabe können SQL-Statements vom Typ UPDATE/INSERT/DELETE auf der Datenbank des Mapper-Core-Systems ausgeführt werden. Das Ergebnis liefert die Anzahl der beteiligten Zeilen zurück oder -1, wenn keine Veränderungen erfolgt sind.
startServerTask	Startet einen I-EFFECT Server Task. Sollten hierbei Fehler auftreten, haben diese keine Auswirkung Mapping.
transferOccurence	Entnimmt das Vorkommen der angegebenen Quell-Schlüssel-Ebene und setzt es dem angegebenen Ziel-Schlüssel auf der angegebenen Ebene (targetOccurenceLevel) als neuen Wert.