Ab Version 33 sind auch Dateinamen zulässig - siehe Fußnote 3)

Die jeweils aktuellen Informationen zu den Internet-Adressen und Ports des HI-Tier siehe hier.

Die jeweils aktuellen Informationen zu den Internet-Adressen und Ports des HI-Tier siehe hier.

Die Angaben PrimaryServer, BackupServer und alle HitServer.n ergeben eine Liste von verbindbaren HitServern, die der HitBatch (standardmäßig) per Zufallsauswahl zuzugreifen versucht. Ist ein Server nicht erreichbar, wird der nächste versucht und das solange, bis sich ein Server verbindet, oder der HitBatch abbricht, weil alle Server nicht erreichbar waren. Der Parameter ConnTimeout erlaubt dabei die Angabe einer Wartezeit zwischen den Versuchen. Es sollten mindestens zwei unterschiedliche Serverangaben vorhanden sein.

Wird weder PrimaryServer noch BackupServer angegeben, ist HitServer.1 ist erforderlich (und nicht mehr optional). Wie die Angaben verarbeitet und beim Verbinden ausgewählt werden, lässt sich mit dem Parameter ServerReihenfolge steuern. Bis einschl. HitBatch v53 müssen PrimaryServer und BackupServer angegeben werden.

	0: nur PrimaryServer und BackupServer verarbeiten (alle HitServer.n ignorieren), beim Verbinden zufällig auswählen
	1: nur alle HitServer.n verarbeiten (PrimaryServer und BackupServer ignorieren), beim Verbinden zufällig auswählen
	2: PrimaryServer, BackupServer und alle HitServer.n verarbeiten, beim Verbinden zufällig auswählen
	3: PrimaryServer, BackupServer und alle HitServer.n verarbeiten, beim Verbinden wie angegeben der Reihe nach auswählen

ServerReihenfolge=2 ist Vorgabe. Wert 3 erlaubt eine vordefinierte Abarbeitung einer Serverliste, ist jedoch nicht zu empfehlen.

Es wird dabei im System-Zeichensatz protokolliert.

Wird CIPHERLEVEL=1 oder =2 verwendet, dann muss hier der öffentliche Schlüssel für die Anmeldungsverschlüsselung angegeben werden. Dazu kann man entweder den Schlüssel in Hex-Notation oder als Verweis auf eine Datei in der Form @<dateipfad> angeben.

Den aktuell gültigen öffentlichen Schlüssel finden Sie auf einer eigenen Seite.

ab Version 62:
Erlaubt ist die Angabe einer Transformationsvorschrift gemäß dem Java Cryptographic Extensions (JCE) Framework als Zeichenkette. Das Format ist "algorithm/mode/padding", wobei algorithm für den Namen des Cipher steht, mode den Blockmodus und padding die Auffüllvorschrift festlegt. Folgende Transformationskomponenten können miteinander kombiniert verwendet werden:

	algorithm: Blowfish, TripleDES, AES, Twofish
	mode: ECB, CBC, CFB, OFB
	padding: TBC, PKCS7

WICHTIG: alle Komponenten können erst dann verwendet werden, wenn die Crypto-Bibliothek Bouncy Castle v1.76 und höher mit eingebunden wird (siehe Programmaufruf)! Ohne diese Bibliothek sind nur diese möglich:

	algorithm: Blowfish
	mode: ECB, CBC
	padding: TBC

Wird ENC_SYM nicht angegeben (leer), dann wird abwärtskompatibel "Blowfish/CBC/TBC" verwendet.

Die alte Variante des ENC_SYM mit den numerischen Parametern 1 und 2 (ab Version 61) wird nach wie vor unterstützt, aber man erhält beim LOGON einen Hinweis dies umzustellen.

Der Wert ist das Geheimnis des eingerichteten zweiten Faktors (im Web abfragbar). Es sind auch Dateinamen zulässig - siehe Fußnote 3).

Bei WRITERESTART=1 verhält sich der HitBatch wie bisher.

	0: Nein, keine Ersetzung
	1: nur in INI-File bei Befehl=...
	2: in INI-File bei Befehl und dortigen Dateipfaden
	3: in INI-File bei Befehl, dortigen Dateipfaden und allen Datenzeilen des InFile (InFile wird nur bearbeitet, wenn keine InputTemplate angegeben wird, denn im Template findet sowieso eine Ersetzung der Makros statt)

Welche Makros möglich sind, siehe hier.

Legt fest, auf welchem Weg der HitBatch mit den HitServern "reden" soll (Default: HITP)
Mögliche Werte sind

	HITP, DIREKT = HitServer-Direktverbindung via Parameter PrimaryServer:PrimaryPort oder BackupServer:BackupPort
	REST, HTTP = HTTP-REST-Webserver-Verbindung via Parameter HttpRestUrlFirst oder HttpRestUrlSecond
	BEIDE = erst via HITP versuchen und wenn nicht erreichbar, dann via REST

Das Protokoll HITP ist in jedem Fall vorzuziehen, da die Performance deutlich besser ist.

REST ist z.B. vorübergehend für diejenigen interessant, die mit den Standard-Ports (2222, 2223, etc) nicht durch einen Proxy können/dürfen.

Wichtig ist, dass die HitRAW-Schnittstelle verwendet wird, da nur diese HIT-Protokoll-Antworten unbearbeitet verarbeiten kann.

Nur sichere Verbindungen via SSL sind möglich, als Protokoll muss "https" angegeben werden (nicht "http").

Hinweis: Die SSL-Sitzungsaushandlung ("SSL handshake") ist strikt, d.h. ein zwar gültiges Zertifikat, das nicht zum geforderten Domainnamen passt, wird dennoch abgewiesen und die Verbindung bricht sofort wieder ab!

URL für die Verbindung zum Testsystem:

HttpRestUrlFirst=https://www3.hi-tier.de/HitTest2/api/hitraw
HttpRestUrlSecond=https://www4.hi-tier.de/HitTest2/api/hitraw

URL für die Verbindung zur Produktion:

HttpRestUrlFirst=https://www3.hi-tier.de/HitCom2/api/hitraw 
HttpRestUrlSecond=https://www4.hi-tier.de/HitCom2/api/hitraw

Die Liste kann Präfixe (IP-Adressen, die auf "." enden), Suffixe (Domainnamen, die mit "." beginnen) oder konkrete Hostnamen enthalten und alle Einträge werden durch ";" getrennt angegeben.

Die Einträge "localhost" und "127.0.0.1" werden grundsätzlich der Ausnahmenliste hinzugefügt.

Wichtig: Es wird keine DNS-Namensauflösung durchgeführt! Für den Abgleich der über Proxies umzuleitenden Anfragen werden die Ausnahmen nur mit der Rechnername der oben angegebenen URLs abgeglichen.

Ab Version 33 sind auch Dateinamen zulässig - siehe Fußnote 3)

bzw.

OuFile

Seit Version 46, Stand 16.10.2014 Zeitstempel-Option

	[pfad\]name.erweiterung: Dateiname wie angegeben
	[pfad\]name.*.erweiterung: Stern in Dateiname wird durch Standard-Zeitstempel ersetzt, also z.B: "Out.2014-10-16-10-22-51-970.csv"
	[pfad\]name.*format*.erweiterung: Stern durch individuellen Zeitstempel ersetzt, also z.B: "*yyyy-MM-dd*"

Diese Verarbeitungsmöglichkeit erlaubt eine individuelle Nachbearbeitung von Zeilen und Spalteninhalten; um z.B. den Output besser an die Inportbedürfnisse nachfolgender Programme wie z.B. Microsoft Excel anzupassen. Eine Auflistung möglicher POP-Funktionen findet sich hier unter POP-Funktionen.

Der Parameter darf bei Filter-Steps mit FilterArt=2 - 31 nicht verwendet werden. Fügen Sie einfach nach der Filterverarbeitung einen weiterten Step mit FilterArt=1 zur Verarbeitung von POP-Befehlen hinzu.

	3: analog 0, aber in die erste Spalte kommt die Zeilennummer der Inputdatei
	4: analog 1, aber in die erste Spalte kommt die Zeilennummer der Inputdatei
	5: ähnlich 1, aber speziell für Excel-Import optimierte Datenformate (empfohlen wenn Daten in Excel geöffnet werden sollen)
	6: analog 5, aber in die erste Spalte kommt die Zeilennummer der Inputdatei

Ein Sonderfall ist zu beachten: Wird bei CSVOUT das ADIS-Dateiformat verwendet (d.h. CSVOUT=2), dann muss CSVIN auch auf dieses Format verwenden, weil sonst der HitBatch abbrechen würde (hat mit der Handhabung der ADIS-Datenstrukturen im HitBatch zu tun).

Mit der Version 39 des HitBatch-Clients wurden Probleme mit der CSV-Verarbeitung im Modus CSVIN/CSVOUT=1 behoben:

	Das Programm entfernt jetzt korrekt Hochkommas aus der Input-Datei im Modus CSVIN und bearbeitet verdoppelte Begrenzungszeichen
	Im Modus CSVOUT=1 erzeugt das Programm besser formatierte Ausgabedateien; insbesondere die Weiterverarbeitung mit Microsoft Excel wurde erleichtert

Sollte aber das alte "falsche" Verhalten weiter benötigt werden, kann das mittels CSVALTEVERSION=1 erzwungen werden.

Beispiel:
InputTemplate=BNR15;EQ;#[3];ORDER;DBET_VON

Seit Version 57 auch:
InputTemplate=BNR15;EQ;#[BNR15_P];ORDER;DBET_VON

Daten:
BNR15_P;DTYP_ZUO;BNR15_C;DZUO_VON
090000000001;1;090000000011;1.1.2000
090000000002;1;090000000012;1.1.2000

Erzeugt:
BNR15_P;DTYP_ZUO;BNR15_C;DZUO_VON

Im Template sind auch relative Datumskonstanten möglich:
%Heute%, %Gestern%, %Heute<t>T<m>M<j>J%

Beispiel: InputTemplate=GEB_DATR;BW;%Heute-60T+0M+0J%;%Gestern%

Beispiel:
HeaderTemplate=$COUNT(#[1])

Daten:
BNR15_P;DTYP_ZUO;BNR15_C;DZUO_VON
090000000001;1;090000000011;1.1.2000
090000000002;1;090000000012;1.1.2000

Erzeugt:
$COUNT(BNR15_P)

	das HeaderTemple mit der Überschriftszeile der Inputdatei verarbeitet
	das InputTemplate mit den einzelnen Datenzeilen der Inputdatei

Wenn man auch in der Headerzeile (also dem Objektteil des resultierenden HITP-Befehls) Variablen der jeweiligen Datenzeile statt der Überschriftzeile verarbeiten möchte, muss man TemplateArt=1 wählen. Wenn man relative Datumskonstanten wie z.B. %Heute% im Header verwenden will, muss ebenfalls TemplateArt=1 gewählt werden.

	0: Standard (Default)
	1: Header mit jeder Datenzeile verarbeiten

Beispiel:
HeaderTemplate=#VERBLEIB(LOM;#[1])
InputTemplate=LOM;EQ;#[2]
TemplateArt=1
 

Daten:
Datum;Lom
1.1.2010;DE0913105103
1.1.2011;DE0913105310
1.1.2012;DE0913114005
1.1.2002;276000913101004
1.1.2002;276000913101999
 

Erzeugt den aktuellen Verbleib der Tiere zu unterschiedlichen Stichtagen.

Beispiel:

BefehlTemplate=*1:RB/C;J:BTR_D/$ROWKEY(1/BNR15_HA);#BESTREY(31.12.2016;31.12.2016;BNR15;0;0;0;0/BNR15;DAT_VON;DAT_BIS;BREGY_SUM):BNR15;=;#[1]

BefehlTemplate=.....#[spaltenname]

	@NAME(<dateilpfad>) - gibt nur den Namen mit Erweiterung, ohne Pfad zurück
	@SIZE(<dateilpfad>) - gibt die Größe der Datei in Bytes zurück
	@DATE(<dateilpfad>) - gibt das Datum der Datei zurück (Filedate, i.d.R. Datei der Erzeugung)
	@TIME(<dateilpfad>) - gibt die Uhrzeit der Datei zurück
	@TS(<dateilpfad>) - gibt Datum und Uhrzeit der Datei zurück
	@CONTENT(<dateilpfad>) - gibt den Inhalt der Datei Base64 kodiert zurück (dieses Format wird im HIT-Protokoll transferiert)
	@MD5(<dateilpfad>) - gibt die MD5-Prüfsumme der Datei zurück
	@GUID_FOR(<dateilpfad>) - gibt eine eindeutige GUID für den Dateinamen zurück, mittels "FilterFile=<dateiname für GUID-Substitution>" kann damit für denselben Dateinamen einheitlich dieselbe GUID in verschiedenen Übertragungsschritten verwendet werden

Beispiele:

FD_K_BILD;FD_BILD;FD_MD5
@GUID_FOR(Bild_001.jpg);@CONTENT(Bild_001.jpg);@MD5(Bild_001.jpg)
@GUID_FOR(Bild_002.jpg);@CONTENT(Bild_002.jpg);@MD5(Bild_002.jpg)

FD_K_DATA;FD_K_BILD0;FD_K_BILD1;FD_K_BILD2;FD_NAME;FD_FDATE;FD_FSIZE;FD_EXIF;FD_BP_X;FD_BP_Y
@GUID_FOR(Bild_001.data);@GUID_FOR(Bild_001.jpg);@GUID_FOR(Bild_001a.jpg);@GUID_FOR(Bild_001b.jpg);Bild_001.jpg;@DATE(Bild_001.jpg);@SIZE(Bild_001.jpg);EXIF ...;;
@GUID_FOR(Bild_002.data);@GUID_FOR(Bild_002.jpg);@GUID_FOR(Bild_002a.jpg);@GUID_FOR(Bild_002b.jpg);Bild_002.jpg;@DATE(Bild_002.jpg);@SIZE(Bild_002.jpg);EXIF ...;;