Beispiele

Hier wird anhand von Beispielen Aufbau und Funktion der INI- und Inputdateien erläutert. Spezielle Beispiele für Abfragen mit dem HitBatch-Client siehe auch Abfragen.

Grundsätzlicher Aufbau

Ini-Dateien

[GLOBAL]
USERID=<Ihre Betriebsnummer>
PIN=<Ihre PIN>
MBN=0
MANDANT=0

PRIMARYSERVER=hitserver.hi-tier.de
PRIMARYPORT=2222
BACKUPSERVER=hitbackup.hi-tier.de
BACKUPPORT=2222

PROTOLEVEL=2
SATZINTERVALL=100
MELDEWEG=4
ANTWORTVERBOSE=3
SCHWERE=1
TIMEOUT=200
BLOCKMAX=100
BLOCKRESTLOG=blockrest.log

SETCOUNT=<Anzahl nachfolgender Sets>
STARTSET=1

Dahinter folgen ein oder mehrere Sets, die jeweils durch ein [SET-N] eingeleitet werden (N steht für eine fortlaufende Nummer, beginnend bei 1). Jeder Set enthält mindestens folgende Einträge:

[SET-N]
MELDUNG=<gewünschte Meldung>
COMMAND=<Befehl oder *>
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=<Datendatei>
OUFILE=<Ausgabedatei>
LOGFILE=<Logdatei>
GOODFILE=<Datei der korrekten Datensätze>
BADFILE=<Datei der fehlerhaften Datensätze>
CSVIN=0
CSVOUT=0

Die mit Farbe markierten Stellen müssen an die eigenen Anforderungen angepaßt werden. In den nun folgenden Beispielen werden einige Fälle mit konkreten Angaben durchgespielt. Die Beschreibung dieser Felder findet sich auf einer separaten Seite.

Datendateien

Die Feldnamen-Liste enthält die zur gewünschten Meldeart verwendeten Feldnamen, die jeweils in GROSSbuchstaben geschrieben und durch Semikolons ';' getrennt werden. Leerzeichen sind in der gesamten Zeile nicht zulässig, auch nicht am Ende. Wird die Aktion der Meldung (also XS, XB, IS, IB, etc.) mit in die Datendatei übernommen, dann erhält sie in der ersten Spalte der Zeile 1 einen "*" und in der jeweils ersten Spalte der darunterstehenden Zeilen den Befehl (meist ist er identisch, kann aber verschieden sein, je nach Zweck).

Die Datenliste enthält Zeile für Zeile mit ebensoviele Elemente, wie in der Feldnamenzeile stehen. Es dürfen KEINE Leerzeilen und umgebrochene Zeilen in der Datei stehen! Eine Datenzeile enthält alle Daten in der Reihenfolge, wie sie in der Feldnamenzeile vorgegeben werden.

Die Elemente zur Meldung, die in der Dokumentation zur Meldungsart mit PK-x (mit x=1...n) und MAN gekennzeichnet sind, müssen in der Datendatei angegeben werden (d.h. sie dürfen nicht leer sein); optionale Felder (OPT) dagegen können angegeben werden. Wichtig: Wird auch nur in einer einzigen Datenzeile ein optionales Feld benötigt, dann müssen der Feldname in der ersten Zeile ergänzt und in jeder Datenzeile die entsprechende Information eingesetzt werden. Leere Elemente werden dann einfach weggelassen (das benötigte ';' nicht vergessen!). In einer Datendatei dürfen immer nur Daten einer Meldungsart stehen.

Die Feldnamen-Liste enthält auch hier zur gewünschten Meldeart verwendeten Feldnamen, analog den Datendateien für Meldungen. Auch die Behandlung der Aktion zur Meldung ist identisch. Die Feldnamen-Liste wird hierbei jedoch verwendet, um die Felder anzugeben, aus denen bei den nachfolgenden Abfragen die Ergebnisse angezeigt werden sollen. Statt einer Feldliste kann ein einzelner Stern "*" angegeben werden, der anzeigt, daß aus allen der Meldeart zugeordneten Feldern Ergebnisse angezeigt werden sollen. Wichtig: Die Angabe der Aktion zur Meldung ist unabhängig von der Feldnamenliste selbst, d.h. wenn alle Felder einer Meldung angezeigt und die Aktion mit in die Datendatei übernommen werden sollen, dann darf nicht nur ein "*" eingetragen werden, sondern zwei durch ein ";" getrennte Sterne: "*;*"!

Die Abfrageausdrücke enthalten Zeile für Zeile korrekte Ausdrücke der Abfragesprache von HIT (HIT Query Language, kurz HIT-QL). Jeder Teil eines Ausdrucks wird durch ein ";" getrennt. Die Ausdrücke können im einzelnen sein:

<Feldname> steht für den Feldnamen der Meldung, dessen Wert verglichen werden soll. <Feldinhalt> erlaubt das Vergleichen zweier Feldinhalte, wobei der Feldname in eckigen Klammern angegeben werden muß, z.B. [BNR15]. <Konstante> ist ein konstanter Wert wie eine Betriebsnummer oder ein Nachname. Die <Konstantenliste> besteht aus mehreren durch ";" getrennte <Konstante>n. Das Ende einer <Konstantenliste> ergibt sich aus dem logischen Kontext der HIT-QL. Zwischen den drei Teilen in der Liste wird jeweils ein ";" eingefügt.

Die Verknüpfungen dienen dem logischen Verbinden zweier Ausdrücke. Wenn Sie z.B. nur wissen wollen, welche Ihrer Tiere nach dem 21.10.1999 geboren wurden und zugleich eine Ohrmarke zwischen 276000912340000 als 276000912345678 haben, geben Sie in einer Zeile folgendes an: GEB_DATR;GE;21.10.1999;AND;LOM;BW;276000912340000;276000912345678.

Datenbeispiele

GEBURT

LOM;BNR15;GEB_DATR;RASSE;GESCHL_R;LOM_MUT
276000900000001;2760912345678;19.10.1999;41;1;276000934567890
276000900000002;2760912345678;19.10.1999;41;1;276000934567891
276000900000003;2760912345678;19.10.1999;41;1;276000934567897
276000900000004;2760912345678;19.10.1999;41;1;276000934567893
...

Falls z.B. das Kalb mit der Ohrmarke 276090000000002 ein Mehrling ist, dann muß eine zusätzliche Spalte eingeführt werden:

LOM;BNR15;GEB_DATR;RASSE;GESCHL_R;LOM_MUT;MEHRLING
276000900000001;2760912345678;19.10.1999;41;1;276000934567890;
276000900000002;2760912345678;19.10.1999;41;1;276000934567891;1
276000900000003;2760912345678;19.10.1999;41;1;276000934567897;
276000900000004;2760912345678;19.10.1999;41;1;276000934567893;
...

Unbenutzte Werte in der optionalen Spalte MEHRLING dürfen dann leer gelassen werden.

Da diese Datendatei keine Spalte mit dem Namen "*" hat, muß in der Ini-Datei der Parameter COMMAND z.B. auf XS gesetzt werden und darf nicht "*S" oder nur "*" sein.

ABGANG

Die Meldungsart ABGANG benötigt mindestens die Angaben LOM (Ohrmarke des abzugebenden Rinds), BNR15 (Betriebsnummer) und ABGA_DAT (Datum, an dem das Rind abgegeben wird). Beispiel:

*;LOM;BNR15;ABGA_DAT
XS;276000900000001;276091234567890;19.10.1999
XS;276000900000002;276091234567890;19.10.1999
XS;276000900000003;276091234567890;19.10.1999
XS;276000900000004;276091234567890;19.10.1999
...

Hier ist die Spalte "*" mit vollständigen Aktionen angegeben, daher darf in der Ini-Datei der Parameter COMMAND nur auf "*" gesetzt werden.

Zu beachten ist, daß ein Rind von einem Bauernhof, das zur Schlachtung in den Schlachthof soll, nur mit ABGANG gemeldet wird und nicht als SCHLACHTUN.

ZUGANG

Die Meldung ZUGANG benötigt mindestens die Angaben LOM (Ohrmarke des zugehenden Rinds), BNR15 (Betriebsnummer) und ZUGA_DAT (Datum, an dem das Rind angenommen wird). Beispiel:

*;LOM;BNR15;ZUGA_DAT
X;276000900000001;276091234567890;19.10.1999
X;276000900000002;276091234567890;19.10.1999
X;276000900000003;276091234567890;19.10.1999
X;276000900000004;276091234567890;19.10.1999
...

Hier ist die Spalte "*" nur als Aktionstyp angegeben, daher darf in der Ini-Datei der Parameter COMMAND z.B. nur auf "*S" gesetzt werden, so daß der "*" durch den Wert aus der Spalte ersetzt wird (ergäbe hier "XS").

SCHLACHTUN

(Namen von Meldungen sind höchstens 10 Zeichen lang, daher fehlt hinten das G!)
Die Meldung SCHLACHTUN benötigt mindestens die Angaben LOM (Ohrmarke des zu schlachtenden Rinds), BNR15 (Betriebsnummer), SCHL_DAT (Datum, an dem das Rind im Betrieb zur BNR15 geschlachtet wird), SCHL_NR (Schlachtnummer des Schlachtbetriebes) und SCHL_KAT (Kategorie des Schlachtkörpers). Beispiel:

*;LOM;BNR15;SCHL_DAT;SCHL_KAT
XS;276000900000001;276091234567890;19.10.1999;3
XS;276000900000002;276091234567890;19.10.1999;3
XS;276000900000003;276091234567890;19.10.1999;2
XS;276000900000004;276091234567890;19.10.1999;5
...

Hier ist die Spalte "*" mit vollständigen Aktionen angegeben, daher darf in der Ini-Datei der Parameter COMMAND nur auf "*" gesetzt werden.

TOD

Die Meldung TOD benötigt mindestens die Angaben LOM (Ohrmarke des verendeten oder hausgeschlachteten Rinds), BNR15 (Betriebsnummer) und TOD_DAT (Datum, an dem das Rind getötet wird). Beispiel:

*;LOM;BNR15;TOD_DAT
XS;276000900000001;276091234567890;19.10.1999
XS;276000900000002;276091234567890;19.10.1999
XS;276000900000003;276091234567890;19.10.1999
XS;276000900000004;276091234567890;19.10.1999
...

Möchte man z.B. die Todesart TOD_ART mitvermerken, ergänzt man eine neue Spalte (hier die 4.):

*;LOM;BNR15;TOD_ART;TOD_DAT
XS;276000900000001;276091234567890;1;19.10.1999
XS;276000900000002;276091234567890;1;19.10.1999
XS;276000900000003;276091234567890;2;19.10.1999
XS;276000900000004;276091234567890;1;19.10.1999
...

Ini-Datei zu den Beispielen:

[GLOBAL]
USERID=<Ihre Betriebsnummer>
PIN=<Ihre PIN>
MBN=0
MANDANT=0

PRIMARYSERVER=hitserver.hi-tier.de
PRIMARYPORT=2222
BACKUPSERVER=hitbackup.hi-tier.de
BACKUPPORT=2222

PROTOLEVEL=2
SATZINTERVALL=100
MELDEWEG=4
ANTWORTVERBOSE=3
SCHWERE=1
TIMEOUT=200
BLOCKMAX=100
BLOCKRESTLOG=blockrest.log

SETCOUNT=5
STARTSET=1

[SET-1]
MELDUNG=GEBURT
COMMAND=XS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=geburt.in
OUFILE=geburt.out
LOGFILE=geburt.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

[SET-2]
MELDUNG=ABGANG
COMMAND=*
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=abgang.in
OUFILE=abgang.out
LOGFILE=abgang.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

[SET-3]
MELDUNG=ZUGANG
COMMAND=*S
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=zugang.in
OUFILE=zugang.out
LOGFILE=zugang.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

[SET-4]
MELDUNG=SCHLACHTUN
COMMAND=*
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=schlachtun.in
OUFILE=schlachtun.out
LOGFILE=schlachtun.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0CSVOUT=0

[SET-5]
MELDUNG=TOD
COMMAND=*
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=tod.in
OUFILE=tod.out
LOGFILE=tod.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Anzumerken ist noch, daß für Meldungen der Eintrag für OUFILE ohne Bedeutung ist, d.h. es wird immer eine leere Datei erzeugt. Er kann somit wegelassen werden.

Abfragen

Abfragen liefern grundsätzlich Datenzeilen zurück. Eine einfache Abfrage, die nur die Anzahl der Datenzeilen liefert, ist momentan nicht implementiert, jedoch ist sie für spätere Versionen des HitServers vorgesehen. Die Ini-Datei sieht gegenüber der obigen nur leicht verändert aus:

[GLOBAL]
USERID=<Ihre Betriebsnummer>
PIN=<Ihre PIN>
MBN=0
MANDANT=0

PRIMARYSERVER=hitserver.hi-tier.de
PRIMARYPORT=2222
BACKUPSERVER=hitbackup.hi-tier.de
BACKUPPORT=2222

PROTOLEVEL=2
SATZINTERVALL=100
MELDEWEG=4
ANTWORTVERBOSE=3
SCHWERE=1
TIMEOUT=200
BLOCKMAX=100
BLOCKRESTLOG=blockrest.log

SETCOUNT=5
STARTSET=1

[SET-1]
MELDUNG=BETRD
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=bestand.in
OUFILE=bestand.out
LOGFILE=bestand.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Delta-Abfragen

Delta-Abfragen erlauben das Ermitteln von Datensätzen seit der zuletzt gemachten Delta-Abfrage. Damit können Sie z.B. zyklisch jede Woche alle in der vorangegangenen Woche gemachten Geburten abfragen. Nach der Ausführung einer Delta-Abfrage wird der momentane Zeitpunkt vermerkt, ab dem die nächste Delta-Abfrage ihre Daten ermittelt.

Eine Standard-Delta-Abfrage hat den Befehl RS/D. Diese liefert nur die momentan offenen Meldungen. Sollen abgeschlossene und offene Meldungen auf diese Weise abgefragt werden, dann benutzt man den Befehl RS/H. N7eben diesen beiden gibt es noch zwei abgewandelte Delta-Varianten: RS/M für eine Delta-Abfrage analog RS/D und RS/N analog RS/H, jedoch wird in beiden Fällen der momentane Zeitpunkt nicht vermerkt. Sie können damit also die Delta-Funktionalität wiederholt testen.

Bestand eines Betriebes

Als Landwirt möchte man seinen Bestand zu einem bestimmten Datum ermitteln. Dazu fragt man die Meldungsart BETRD ab und gibt der Abfrage die Funktion #BESTREG mit. Die Bedingungen für die Abfrage sind, daß eine bestimmte Betriebsnummer verglichen werden muß und daß der Bestand des gegebenen Zeitraumes bzw. Tages (wenn Zeitraum auf einen Tag fällt) ausgegeben wird.

[SET-1]
MELDUNG=BETRD
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=bestand.in
OUFILE=bestand.out
LOGFILE=bestand.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Die erste Zeile gibt an, welche Felder die Abfrage ausgeben soll. Da aber nur eine Funktion angegeben wurde, wird zuerst diese Funktion aufgerufen und deren Felder ausgegeben. Die Parameter für die Funktion #BESTREG legen den Tag fest, hier vom 19.10.1999 bis 19.10.1999 (d.h. Stichtagsabfrage), und als auszugebende Felder werden alle in der Tabelle #BESTREG angegebenen Spalten ausgegeben. Als Meldungsart muß BETRD (d.h. MELDUNG=BETRD) angegeben werden (siehe Ini-Dateiausschnitt).

Möchte man jedoch den Bestand eines Betriebes in einem Zeitraum ermitteln, dann genügt die Änderung des Stichtages in einen Zeitraum:

Im Beispiel wird der Bestand über eine Woche vom 19.10.1999 bis einschließlich 26.10.1999 ausgegeben:

Monatliche Abgänge ermitteln

Ein Landwirt möchte monatlich seine gesamten Abgänge ermitteln. Dazu ruft er an jedem Monatsende den HitBatch auf, der ihm mit dem Befehl RS/H alle seit der letzten Delta-Abfrage abgeschlossenen und offenen Abgänge ausgibt.

Es wird nur auf die Betriebsnummer des Landwirtes geprüft. In der Ini-Datei muß dann im Set die MELDUNG=ABGANG und zudem das Feld COMMAND=RS/H gesetzt sein. Der dazugehörige Set im Ini-File hat folgende Form:

[SET-2]
MELDUNG=ABGANG
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=mon_abgang.in
OUFILE=mon_abgang.out
LOGFILE=mon_abgang.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Vorgangstabellen ausgeben lassen

Wenn Plausi-Prüfungen in HIT ergeben, daß die logische Abfolge der Tierbewegungen aus irgend einem Grund nicht korrekt sind, dann werden in der Vorgangstabelle Datensätze für den betreffenden Betrieb abgelegt, der den Fehler ausgelöst hat. Diese Datensätze muß die Regionalstelle auslesen und anhand der Fehlermeldungen die Meldung(en) korrigieren, ggf. den Betrieben mitteilen.

Die Daten müssen aus der Tabelle VORGANG geholt werden, so daß das Ini-File etwa so aussieht:

[SET-3]
MELDUNG=VORGANG
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=vorgang.in
OUFILE=vorgang.out
LOGFILE=vorgang.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Aus der Tabelle gibt der HitBatch die Felder VORGNR (Vorgangsnummer), VORGLFN (laufende Nummer zur Vorgangsnummer), PLAUSINR (Fehlernummer der Plausiprüfung), SCHWERE (Schwere des Fehlers) aus. Zusätzlich werden zu allen zur gegebenen Bedingung (hier: Vorgangsnummer soll gleich 13 sein) gefundenen Datensätze von den Organisationsdaten die Spalten LOM, MEHRLING und BNR15 mit ausgegeben. Die Ausgabefelder der Funktion !ORGDATEN, d.h. die Feldnamen hinter dem '/' in der Funktionsparameterliste, beziehen sich im Beispiel auf Felder der Meldeart GEBURT. Liefert die Vorgangstabelle jedoch Datensätze anderer Entitäten, z.b. ABGANG und ZUGANG, dann werden von den Feldern in der Ausgabefelderliste nur die gefüllt, die auch in der Entitätentabelle vorkommen. Bei ZUGANG würden nur die Spalten LOM und BNR15 gefüllt, Spalte MEHRLING jedoch nicht, da diese in der Tabelle ZUGANG nicht existiert.

Bewegungsmeldungen zu einem Tier ermitteln

Möchte man eine Liste von Tierbewegungen zu einem Tier erhalten, frägt man die Bewegungsmeldungen ab. Sie erhalten dann Informationen über alle Bewegungsmeldungen zu einem Tier nach Datum sortiert: GEBURTA, ERSTERF, GEBURT, EUEIN, IMPMARK, ABGANG, ZUGANG, AUSFUHR, SCHLACHTUN, TOD. Die Funktion !BEWMELD erwartet eine Ohrmarkennummer aus einer Entität, die das Feld LOM bereitstellt, und liefert aus der Datenbank alle vorhandenen Daten aus den aufgelisteten Meldungstabellen. Geben Sie bestimmte Ausgabefelder an, dann werden diese soweit möglich gefüllt. Eine Ini-Datei dafür sieht etwa so aus:

[SET-4]
MELDUNG=VORGANG
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=vorgang.in
OUFILE=vorgang.out
LOGFILE=vorgang.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

Abfrage von Tierende-Daten zu abgegangenen Tieren

Möchte man sämtliche Tierende-Daten eines Betriebes erhalten, von dem die Tiere abgegangen sind, dann hilft Ihnen die #TIERENDE-Abfragefunktion. In der Liste sind dann alle Meldungen zu den gegebenen Tieren aufgelistet, die zu folgenden Entitäten gehören: TOD, SCHLACHTUN und AUSFUHR. Eine Ini-Datei dafür sieht etwa so aus:

[SET-5]
MELDUNG=ABGANG
COMMAND=RS
DATALINESSOFAR=0
INPUTAFTERSUCCESS=0
TESTDOPPELTEHEADER=1
INFILE=ab_tierende.in
OUFILE=ab_tierende.out
LOGFILE=ab_tierende.log
GOODFILE=
BADFILE=
CSVIN=0
CSVOUT=0

BNR15;LOM;#TIERENDE;TIER_END;DAT_END
276090000000002;276000909876857;*) s.u.;%--;%--
%--;%--;%--;8;10.11.1999
276090000000002;276000712345678;*) s.u.;%--;%--
276090000000002;276000910000001;*) s.u.;%--;%--
276090000000002;276000910000020;*) s.u.;%--;%--
276090000000002;276000910000021;*) s.u.;%--;%--
276090000000002;276000910000023;*) s.u.;%--;%--
276090000000002;276000910000024;*) s.u.;%--;%--
276090000000002;276000910000026;*) s.u.;%--;%--
276090000000002;276000912341233;*) s.u.;%--;%--
276090000000002;276000912345660;*) s.u.;%--;%--
276090000000002;276000912345677;*) s.u.;%--;%--
%--;%--;%--;8;06.06.2000