Hinweise

	POP ("Post-Processing") Befehlsfolgen sind Makro-Befehle mit der die Ausgaben des HitBatch-Clients aufbereitet werden können.
	Sie dienen insbesondere zur Filterung und Umformatierung von CSV-Dateien.
	Das Programm wird nur noch als Bestandteil des HitBatch-Client ausgeliefert und installiert.
	Das selbstständige Java-Programm HitPop wird nicht weiter gepflegt
	Weitere Hinweise siehe analog HitBatch-Client.

Versionshistorie

Beschreibung

Allgemeine Hinweise zum HIT-POST-PROCESSING

Damit die Ausgabe in die OUT-Files flexibler angepasst werden kann, um z.B. den Output direkt in Excel-gerechtes CSV zu wandeln (Dezimalpunkt-Problematik) oder um Timestamps als Input in einem späteren Step nutzen zu können, werden Befehle zum "POST-PROCESSING" eingeführt.

Es kann eine beliebige Anzahl von Befehlen nacheinander angegeben werden. Ab Version 5 kann das vorangestellte POP_ weggelassen werden, d.h. ein POP_TSTAMP und TSTAMP führen die selbe Aktion durch.

Alle Befehle werden in der gegebener Folge abgearbeitet. Der jeweils nächste Befehl arbeitet auf die schon veränderten Inhalte und ggf. veränderten Strukturen (wenn z.B. eine Spalte ausgeschlossen wird, müssen die nachfolgenden Befehle das berücksichtigen).

Ziel ist es, bestimmte Zeilen oder ganze Spalten zu verwerfen oder die Zeilen oder einzelne Spalten gezielt zu verändern. Seit Ende 2015 darf man als große Vereinfachung die Spalten mit Namen statt Positions-Nummer angeben. Je nach Kontext müssen

Aufrufsyntax

Für das Testprogramm:

java -cp "HitBatch.jar;HitUpros.jar" HitBatch.HitPop HitPop.ini

In der Parameterdatei sowohl für das Testprogramm als auch für den HitBatch:

[SET-1]
...
POPFILE=dateiname.pop
OUTFILE=dateiname.out
...

Ablauf

1. Holt die Namen von Input-, Output-, Log- und POP-Befehls-Datei aus der INI-Datei.
2. Lies dann alle Zeile der Inputdatei und schreibt sie unter Ausführung der POP-Befehle in die Outputdatei.
3. Als Input eignen sich Outputdateien aus dem HitBatch.
4. Wenn sich eine Befehlsfolge als geeignet für die Nachbearbeitung einer HitBatch-Outputdatei erwiesen hat, kann die entsprechende POP-Datei auch direkt im HitBatch verwendet werden.

POP - Post-Processing Befehle

Beispiele

; Werfe alle Zeilen weg die den String "Exception" enthalten
POP_RDROP Exception

; Ersetze in der ganzen Zeile das Vorkommen von "%--" (als NULL-Indikator) durch den Leerstring ""  
POP_RCHNG %--;

; Erstze in Spalte 1 den Dezimalpunkt "." durch eine Komma ","
POP_CCHNG 1;.;,

; Verwerfe Zeile wenn 2. Spalte größer gleich 100.000 ist
POP_CXDROP 2;>=;100000

; Formatieren in Spalte 2 vorkommende Timestamps wie es Excel auch als Date-Time-Value akzeptiert
; Mikrosekunden werden dabei ignoriert, könnten mit ".SSSSSS" aber einbezogen werden.
POP_TSTAMP 2;dd.MM.yyyy hh.MM.ss

; Formatieren in Spalte 3 vorkommende Datumswerte wie es Excel auch als Date-Value akzeptiert
POP_DATE 3;dd.MM.yyyy

; Formatieren in Spalte 4 vorkommende Zeitwerte wie es Excel auch als Time-Value akzeptiert
POP_TIME 4;hh.MM.ss

; Formatieren in Spalte 5 vorkommende Zahlenwerte wie es Excel auch als Number-Value akzeptiert, mit
; zwei Nachkommastellen (gerundet)
; Der Punkt deutet nur die Stelle des Dezimaltrenners an, dieser ist je nach LOCALE-Einstellung
; unterschiedlich, in Deutsch ein Komma.
POP_NUM 5;##0.00

; Formatieren in Spalte 6 vorkommende Strings als Uppercase
POP_UCASE 6

; Formatieren in Spalte 7 vorkommende Strings als Lowercase
POP_LCASE 7

; Es können auch mehrer Befehle auf eine Spalte angewendet werden
POP_CCHNG 8;ä;Ä
POP_CCHNG 8;Ä;AE
POP_CCHNG 8;ü;Ü
POP_CCHNG 8;Ü;UE
POP_CCHNG 8;ö;Ö
POP_CCHNG 8;Ö;OE
POP_CCHNG 8;ß;SS
POP_UCASE 8

; Formatiere ...
POP_KOMMA GVE_KUH;[3]
POP_KOMMA BNR15;0

POP_PROZENT ANT_TOD;[2]

; Spalten anhängen, Register-Anteile berechnen und formatieren
APP_COLS W0;W1;W2;W3;W4_8;W8_20;W20_X

REG_ANT W0;T; 0;E; 7;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W1;T; 7;E;14;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W2;T;14;E;21;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W3;T;21;E;28;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W4_8;T;28;E;56;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W8_20;T;56;E;140;A;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR
REG_ANT W20_X;T;140;E;9999999;E;DAT_VON;DAT_BIS;DAT_EIN;DAT_AUS;GEB_DATR

POP_PROZENT W0;3
POP_PROZENT W1;3
POP_PROZENT W2;3
POP_PROZENT W3;3
POP_PROZENT W4_8;3
POP_PROZENT W8_20;3
POP_PROZENT W20_X;3

Spezielle Hinweise zu Formatierungspattern

Date/Time Format Syntax

To specify the time format use a time pattern string. In this pattern, all ASCII letters are reserved as pattern letters, 
which are defined as the following:

Symbol   Meaning                 Presentation        Example
 ------   -------                 ------------        -------
 G        era designator          (Text)              AD
 y        year                    (Number)            1996
 M        month in year           (Text & Number)     July & 07
 d        day in month            (Number)            10
 h        hour in am/pm (1~12)    (Number)            12
 H        hour in day (0~23)      (Number)            0
 m        minute in hour          (Number)            30
 s        second in minute        (Number)            55
 S        millisecond             (Number)            978
 E        day in week             (Text)              Tuesday
 D        day in year             (Number)            189
 F        day of week in month    (Number)            2 (2nd Wed in July)
 w        week in year            (Number)            27
 W        week in month           (Number)            2
 a        am/pm marker            (Text)              PM
 k        hour in day (1~24)      (Number)            24
 K        hour in am/pm (0~11)    (Number)            0
 z        time zone               (Text)              Pacific Standard Time
 '        escape for text
 ''        single quote                              '
 
The count of pattern letters determine the format. 
(Text): 4 or more pattern letters--use full form,
        < 4--use short or abbreviated form if one exists. 
(Number): the minimum number of digits. 
          Shorter numbers are zero-padded to this amount. 
          Year is handled specially; that is, if the count of 'y' is 2,
          the Year will be truncated to 2 digits. 
(Text & Number): 3 or over, use text, otherwise use number. 
Any characters in the pattern that are not in the ranges of ['a'..'z']
and ['A'..'Z'] will be treated as quoted text. 
For instance, characters like ':', '.', ' ', '#' and '@' will appear in the
resulting time text even they are not embraced within single quotes. 

A pattern containing any invalid pattern letter will result in a thrown
exception during formatting or parsing. 

Examples: 

 Format Pattern                         Result US Locale                        German locale
 --------------                         ----------------                        --------------
 "yyyy.MM.dd G 'at' hh:mm:ss z"    ->>  1996.07.10 AD at 15:08:56 PDT           1958.12.31 n. Chr. at 01:02:03 GMT+01:00
 "EEE, MMM d, ''yy"                ->>  Wed, July 10, '96                       Mi, Dez 31, '58
 "h:mm a"                          ->>  12:08 PM                                1:02 AM
 "hh 'o''clock' a, zzzz"           ->>  12 o'clock PM, Pacific Daylight Time    01 o'clock AM, GMT+01:00
 "K:mm a, z"                       ->>  0:00 PM, PST
 "yyyyy.MMMMM.dd GGG hh:mm aaa"    ->>  1996.July.10 AD 12:08 PM

Number Format Syntax

Symbol  Meaning
 0      a digit
 #      a digit, zero shows as absent
 .      placeholder for decimal separator
 ,      placeholder for grouping separator.
 ;      separates formats.
 -      default negative prefix.
 %      divide by 100 and show as percentage
 X      any other characters can be used in the prefix or suffix
 '      used to quote special characters in a prefix or suffix.

Examples:

 Format Pattern		Result
 ###,###.000		->> 1.234,450  

Zurück zum Anfang