i-effect Manual
i-effect Manual
Breadcrumbs

%Variablen% im *SERVER Modul

Die folgenden Variablen (%NAME%) können in der Prozessautomatisierung und beim Anlegen von Workflows im *SERVER Modul verwendet werden. Sie stehen innerhalb eines Befehlsparameters als Platzhalter und werden zur Laufzeit durch die entsprechenden Werte ersetzt.

Name

Beschreibung

Anwendungsbeispiele

Beispiele - ausgelöste Werte 

%IFSPATH%

Der Pfadname der zur Verarbeitung ausgewählten IFS-Datei.

RPLSTRIFS FRMPATH('%IFSPATH%')  FRMIFSFILE('%IFSFILE%') REPLACE((HEX25 *CRLF))

RPLSTRIFS FRMPATH('/home/ieffect/edi/in') FRMIFSFILE('invoic.edi') REPLACE((HEX25 *CRLF))

%IFSFILE%

Der Dateiname der zur Verarbeitung ausgewählten IFS-Datei.

RPLSTRIFS FRMPATH('%IFSPATH%')  FRMIFSFILE('%IFSFILE%') REPLACE((HEX25 *CRLF))

RPLSTRIFS FRMPATH('/home/ieffect/edi/in') FRMIFSFILE('invoic.edi') REPLACE((HEX25 *CRLF))

%IFSFILEBASE%

Der Basisdateiname (Dateiname ohne Pfad und Erweiterung) der zur Verarbeitung ausgewählten IFS-Datei.

RUNMAP TOPATH('%OUTPUTPATH%/%IFSFILEBASE%_%TIMESTAMP%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/orders_2021-02-01-17.05.32.897245.edi')

%DB2FILE%

Der Dateiname der zur Verarbeitung ausgewählten DB2-Datei.

CPYF FROMFILE(%DB2LIB%/%DB2FILE%) FROMMBR(%DB2MBR%)  

CPYF FROMFILE(EDIIN/ORDERS) FROMMBR(ORDERS)  

%DB2LIB%

Der Bibliotheksname der zur Verarbeitung ausgewählten DB2-Datei.

CPYF FROMFILE(%DB2LIB%/%DB2FILE%) FROMMBR(%DB2MBR%)  

CPYF FROMFILE(EDIOUT/INVOIC) FROMMBR(INVOIC)  

%DB2MBR%

Der Teildateiname der zur Verarbeitung ausgewählten DB2-Datei.

CPYF FROMFILE(%DB2LIB%/%DB2FILE%) FROMMBR(%DB2MBR%)  

CPYF FROMFILE(EDIOUT/DESADV) FROMMBR(DESADV)  

%SPLFILE%

Der Name der zur Verarbeitung ausgewählten Spool-Datei.

CHGSPLFA FILE(%SPLFILE%)  JOB(%JOBN%/%SPLUSER%/%SPLJOB%)  SPLNBR(%SPLFILNR%)

CHGSPLFA FILE(INVNEW1)  JOB(133576/IEFFECT/MANUALTASK)  SPLNBR(1)

%SPLJOB%

Der Name des Jobs, der die Spool-Datei erstellt hat.

DLTSPLF FILE(%SPLFILE%)  JOB(%JOBN%/%SPLUSER%/%SPLJOB%)  SPLNBR(%SPLFILNR%)

DLTSPLF FILE(INVNEW1)  JOB(133576/IEFFECT/MANUALTASK)  SPLNBR(1)

%SPLUSER%

Der Benutzername des Jobs, der die Spool-Datei erstellt hat.

HLDSPLF FILE(%SPLFILE%)  JOB(%JOBN%/%SPLUSER%/%SPLJOB%)  SPLNBR(%SPLFILNR%)

HLDSPLF FILE(INVNEW1)  JOB(133576/IEFFECT/MANUALTASK)  SPLNBR(1)

%JOBN%

Die Nummer des Jobs, der die Spool-Datei erstellt hat.

RLSSPLF FILE(%SPLFILE%)  JOB(%JOBN%/%SPLUSER%/%SPLJOB%)  SPLNBR(%SPLFILNR%)

RLSSPLF FILE(INVNEW1)  JOB(133576/IEFFECT/MANUALTASK)  SPLNBR(1)

%USRDTA%

Das Benutzerdaten-Attribut (USRDTA) der Spool-Datei.

CVTSPLPDF OUTPFILE('%HOME%/%USRDTA%.pdf')

CVTSPLTXT OUTPFILE('/HOME/IEFFECT/INVNEW1.txt')

%USRDFNDTA%

Das USRDFNDTA-Attribut der Spool-Datei.

SNDEMAIL RECIPIENT('%USRDFNDTA%')

SNDEMAIL RECIPIENT('info@menten.com')

%TMP%

Der Name des temporären Systemverzeichnisses.

CVTSPLPDF OUTPFILE('%TMP%/%SPLFILENAME%')

CVTSPLPDF OUTPFILE('/TMP/INVNEW1.pdf)

%HOME%

Der "Heimatpfad" ("/HOME/USERNAME") des Benutzers, der diesen Job ausführt.

CVTSPLXLS OUTPFILE('%HOME%/%SPLFILENAME%')

CVTSPLXLS OUTPFILE('/HOME/IEFFECT/INVNEW1.xls)

%CURDIR%

Das aktuelle Verzeichnis des Benutzers mit dem der Serverjob gestartet wurde. 

RUNMAP TOPATH('%CURDIR%/%MSGTYPE%_%ABSENDER%_%EMPFAENGER%_%TIMESTAMP%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/INVOIC_40077310000XX_40210170000XX_2021-02-01-17.05.32.897245.edi')

%USER%

Name des aktuellen Benutzers.

SNDEMAIL RECIPIENT('%USER%')

SNDEMAIL RECIPIENT('i-effect@menten.com')

%DATE%

Tagesdatum im Format DD.MM.YYYY

RUNMAP TOPATH('%OUTPUTPATH%/ORDERS_%_%DATE%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/ORDERS_04.02.2021.edi')

%YEAR%

Die aktuelle Jahreszahl im Format YYYY.

RUNMAP TOPATH('%OUTPUTPATH%/ORDERS_%YEAR%.%MONTH%.%DAY%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/ORDERS_2021.02.04.edi')

%YEAR2%

Die aktuelle Jahreszahl im Format YY.

RUNMAP TOPATH('%OUTPUTPATH%/ORDERS_%YEAR2%.%MONTH%.%DAY%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/ORDERS_21.02.04.edi')

%MONTH%

Der aktuelle Monat im Format MM.

RUNMAP TOPATH('%OUTPUTPATH%/ORDERS_%YEAR%.%MONTH%.%DAY%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/ORDERS_2021.02.04.edi')

%MONTHNAME%

Der ausgeschriebene aktuelle Monat.

SNDEMAIL SUBJECT('Salesreport for %DAY% %MONTHNAME% %YEAR%')

SNDEMAIL SUBJECT('Salesreport for 04 february 2021')

%DAY%

Der aktuelle Tag im Format DD.

RUNMAP TOPATH('%OUTPUTPATH%/ORDERS_%YEAR%.%MONTH%.%DAY%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/EDI/OUT/ORDERS_2021.02.04.edi')

%WEEKDAY%

Der Name des aktuellen Wochentags.

SNDEMAIL SUBJECT('ORDERS vom %WEEKDAY%, %DATE%, %TIME%')

SNDEMAIL SUBJECT('ORDERS vom Freitag, 04.02.2021. 14:32')

%TIME%

Die aktuelle Uhrzeit im Format HH:MM:SS.

SNDEMAIL SUBJECT('ORDERS vom %WEEKDAY%, %DATE%, %TIME%')

SNDEMAIL SUBJECT('ORDERS vom Freitag, 04.02.2021. 14:32')

%TIMESTAMP%

Der aktuelle Zeitstempel im Format YYYY-MM-DD-HH.MM.SS.MSMSMS

RUNMAP TOPATH('%CURDIR%/%MSGTYPE%_%ABSENDER%_%EMPFAENGER%_%TIMESTAMP%.edi')

RUNMAP TOPATH('/HOME/IEFFECT/INVOIC_40077310000XX_40210170000XX_2021-02-01-17.05.32.897245.edi')

%SESSIONNUMBER%

Die aktuelle i-effect Sitzungsnummer

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERTSAKID%, Logbuch Sitzungsnummer: %SESSIONNUMBER%')

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: 2543, Logbuch Sitzungsnummer: 364523')

%SERVERTASKID%

Aktuelle laufende Servertasknummer.

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERTSAKID%, Logbuch Sitzungsnummer: %SESSIONNUMBER%')

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: 2543, Logbuch Sitzungsnummer: 364523')

%SERVERJOB%

Aktuelle laufende Servertasknummer.

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERJOB%, Logbuch Sitzungsnummer: %SESSIONNUMBER%')

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: 2543, Logbuch Sitzungsnummer: 364523')

%LASTSERVERTIMESTAMP%

Zeitstempel des letzten Aufrufes dieses Serverjobs im
Format YYYY-MM-DD-HH.MM.SS.MSMSMS

CVTDBFXL FROMFILE(*SQL)
TOSTMF('/HOME/IEFFECT/Vorgangsprotokoll_%TIMESTAMP%')
SQL('SELECT * FROM ieffectdb/vorgang WHERE REGTIMSTMP < ''%LASTSERVERTIMESTAMP%''')

CVTDBFXL FROMFILE(*SQL)
TOSTMF('/HOME/IEFFECT/Vorgangsprotokoll_%TIMESTAMP%')
SQL('SELECT * FROM ieffectdb/vorgang WHERE REGTIMSTMP < ''2021-02-01-17.05.32.897245''')

%GETENVVAR:EnvVarName%

Der Wert der Umgebungsvariablen "EnvVarName" 

CVTSPLPDF OUTPFILE('/%SRVDIR%/%GETENVVAR:ORDER_NR%.pdf')

CVTSPLPDF OUTPFILE('/HOME/IEFFECT/SERVER/OUT/1234567.pdf')

%ARCHIVEFILE%

Der vollständige Pfadname der in der Vorgangsverwaltung gespeicherten Archiv-Datei.

PRCFWD FRMIFSFILE('%ARCHIVEFILE%')

PRCFWD FRMIFSFILE('/HOME/IEFFECT/EDI/ARCHIVE/orders.edi')

%SQL_LOOKUP:sqlQuery%

Ergebnis der Ausführung der SQL Abfrage "sqlQuery".

SNDEMAIL RECIPIENT('demo@menten.com')
SUBJECT('Preislistennummer: %SQL_LOOKUP:select VALUE from IEFFECTDB/VORGANGV
where SITZUNG = %SESSIONNUMBER% and KEY = "DOCUMENT_NR" and DIRECTION = "*OUT" limit 1% erfolgreich versendet')

SNDEMAIL RECIPIENT('demo@

menten.com

')
SUBJECT('Preislistennummer: 1234567 erfolgreich versendet')

%UNH_MESSAGETYPE%

Der Nachrichtentyp aus dem UNH-Segment einer EDIFACT-Datei (UNH Datenelement S009-0065).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNH_MESSAGETYPE%' IFTMIN) ('%UNH_MESSAGERELEASE%' 96A)) DELETE(*YES) 

CPYEFFEDI FRMIFSFILE('//home/ieffect/edi/in') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('IFTMIN' IFTMIN) ('%UNH_MESSAGERELEASE%' 96A)) DELETE(*YES) 

%UNH_MESSAGERELEASE%

Der Nachrichten-Release aus dem UNH-Segment einer EDIFACT-Datei (UNH Datenelement S009-0054).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNH_MESSAGETYPE%' IFTMIN) ('%UNH_MESSAGERELEASE%' 96A)) DELETE(*YES) 

CPYEFFEDI FRMIFSFILE('//home/ieffect/edi/in') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('IFTMIN' IFTMIN) ('96A' 96A)) DELETE(*YES) 

%UNB_ORIGINATOR%

Der Absender aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement S002-0004).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('5674872354376' 5674872354376)) DELETE(*YES)

%UNB_ORIGINATORQ%

Der Absender-Qualifier aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement S002-0007).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_ORIGINATORQ%' 14) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('5674872354376' 5674872354376) ('14' 14)) DELETE(*YES)

%UNB_RECIPIENT%

Der Empfänger aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement S003-0010).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_RECIPIENT%' 5674872354376)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('5674872354376' 5674872354376)) DELETE(*YES)

%UNB_RECIPIENTQ%

Der Empfänger-Qualifier aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement S003-0007).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_RECIPIENT%' 5674872354376) ('%UNB_RECIPIENTQ%' 14) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('5674872354376' 5674872354376) ('14' 14)) DELETE(*YES)

%UNB_INTREF%

Die Datenaustauschreferenz aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement 0020).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_INTREF%' 1234872)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('1234872' 1234872)) DELETE(*YES)

%UNB_TEST%

Das Testkennzeichen aus dem UNB-Segment der EDIFACT-Datei (UNB Datenelement 0035).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_TEST%' 1)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('5674872354376' 5674872354376) ('1' 1)) DELETE(*YES)

%UNH_MESSAGEVERSION%

Die Nachrichten-Version aus UNH-Segment der EDIFACT-Datei (UNH Datenelement S009-0052).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_TEST%' 1) ('%UNH_MESSAGEVERSION%' D)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_TEST%' 1) ('D' D)) DELETE(*YES)

%UNH_MESSAGEAGENCY%

Die Nachrichten-Controlling-Stelle aus dem UNH-Segment der EDIFACT-Datei (UNH Datenelement S009-0051).

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_TEST%' 1) ('%UNH_MESSAGEVERSION%' D) ('%UNH_MESSAGEAGENCY%' UN)) DELETE(*YES)

CPYEFFEDI FRMIFSFILE('/%IFSPATH%/%IFSFILE%') TODIR('/home/ieffect/edi/in/IFTMIN/D96A') PARMS(('%UNB_ORIGINATOR%' 5674872354376) ('%UNB_TEST%' 1) ('D' D) ('UN' UN)) DELETE(*YES)

%WEBCONTROLSESSIONLINK%

Mit Hilfe dieser Variablen wird ein Link zur Verfügung gestellt, mit dem direkt in das Sitzungslogbuch der betreffenden Sitzung innerhalb von i-effect WebControl verwiesen werden kann.

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERTSAKID%, Logbuch Sitzungsnummer: %SESSIONNUMBER%') MSGTEXT('Webcontrol Sitzung: %WEBCONTROLSESSIONLINK%')

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERTSAKID%, Logbuch Sitzungsnummer: %SESSIONNUMBER%') MSGTEXT('Webcontrol Sitzung:

https://MAPIK.GL.MENTEN.DE:443

')

%SERVERJOBDESCRIPTION%

Die Kurzbeschreibung des Servereintrags.

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-9-48.png?version=1&modificationDate=1612868988695&api=v2

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-10-43.png?version=1&modificationDate=1612869044475&api=v2

%SERVERERRORMESSAGES%

Die Joblog-Nachrichten des aktuellen Jobs mit einer Bewertung >= 30

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-14-59.png?version=1&modificationDate=1612869300044&api=v2

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-29-4.png?version=1&modificationDate=1612870145299&api=v2

%SERVERERRORMESSAGESHTML%

Die Joblog-Nachrichten des aktuellen Jobs mit einer Bewertung >= 30 formatiert als HTML-Text.

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-12-9.png?version=1&modificationDate=1612869130440&api=v2

http://confluence.menten.com/download/attachments/71928998/image2021-2-9_12-12-57.png?version=1&modificationDate=1612869178139&api=v2

%STATUS%

Bei der Verwendung der Servervariable %STATUS% als Sonderwert in MSGTEXT-Parameter des SNDEMAIL-Befehls wird der Nachrichtentext aus einer Vorlage entnommen, die im Lieferumfang des Produkts enthalten ist.

Es handelt sich um eine HTML-Vorlage, die im Verlauf des Workflows eines Servertasks dazu verwendet werden kann, Statusinformationen zu versenden.
In der Vorlage werden die wichtigsten Parameter des abgelaufenen Jobs, als auch ein Link auf die entsprechende Sitzung in WebControl gezeigt.

SNDEMAIL SUBJECT('Verarbeitungsfehler aufgetreten, Serverjob: %SERVERTSAKID%, Logbuch Sitzungsnummer: %SESSIONNUMBER%') MSGTEXT('%STATUS%')

http://confluence.menten.com/download/attachments/71928998/image2021-2-4_16-55-51.png?version=1&modificationDate=1612454152417&api=v2

%IFSPATH_IND:occurence%

Der Teil des Pfadnamens der IFS-Datei, dessen Index im Parameter "occurence" angegeben ist.

CPYEFFUNIQ FRMIFSFILE('%IFSPATH%/%IFSFILE%') TODIR('HOME/IEFFECT/EDI/ARCHIVE/%IFSPATH_IND:4%')

CPYEFFUNIQ FRMIFSFILE('/home/ieffect/edi/invoic/invoic.edi')
TODIR('HOME/IEFFECT/EDI/ARCHIVE/INVOIC')

%GETSEQUENCE:sequence%

Der Wert der angegebenen SQL-Sequence "sequence".

RUNMAP MAPID('INVOIC_XML') FS(*NONE)
TOPATH('%HOME%/EDI/OUT/XML/INVOIC_%GETSEQUENCE:CUSTOM_SEQ%.xml')

RUNMAP MAPID('INVOIC_XML') FS(*NONE)
TOPATH('/HOME/IEFFECT/EDI/OUT/XML/INVOIC_327567.xml')

%CONTRL_EMAIL_FROM%

Mit Hilfe dieser Variablen kann die E-Mail-Adresse des Absenders der EDI-Nachricht zur weiteren Verarbeitung übergeben werden.

SNDEMAIL RECIPIENT('%CONTRL_EMAIL_FROM%') SUBJECT('%IFSFILE%') MSGTEXT('Diese Nachricht wurde maschinell erstellt') ATTACH('/%IFSPATH%/%IFSFILE%')

SNDEMAIL RECIPIENT('edifact@Host.Domain') SUBECT('CONTRL__99107430000XX_99009630000XX_20210204_120228887.txt') MSGTEXT('Diese Nachricht wurde maschinell erstellt') 
ATTACH('/%HOME%i/edi/out/CONTRL__9910743000004_9900963000009_20210204_120228887.txt')

%CONTRL_EMAIL_TO%

Mit Hilfe dieser Variablen kann die E-Mail-Adresse des Absenders der EDI-Nachricht zur weiteren Verarbeitung übergeben werden.

SNDEMAIL RECIPIENT('%CONTRL_EMAIL_TO%') SUBJECT('%IFSFILE%') MSGTEXT('Diese Nachricht wurde maschinell erstellt') ATTACH('/%IFSPATH%/%IFSFILE%')

SNDEMAIL RECIPIENT('edifact@Host.Domain') SUBECT('CONTRL__99107430000XX_99009630000XX_20210204_120228887.txt') MSGTEXT('Diese Nachricht wurde maschinell erstellt') 
ATTACH('/%HOME%i/edi/out/CONTRL__9910743000004_9900963000009_20210204_120228887.txt')