Datenbankübertragung AIS-I: Konfiguration

Datenbankübertragung AIS-I: Konfiguration
Zurück

Für die Konfiguration der Datenübertragung gibt es eine XML-Datei. Sie befindet sich standardmäßig im Verzeichnis IFAS/Vorlagen/AIS-I. Im Folgenden wird die Handhabung dieser Datei beschrieben.

IFAS-Exporter.xml

Diese Datei ermöglicht es, den Datenbestand der Übertragung, sowie die Zieldatenbank einzustellen. Es handelt sich um eine XML-Datei, d.h. die Struktur lässt sich mit einem Browser (Internet Explorer, Firefox) überblicken. Für die Bearbeitung dieser Datei eignet sich ein gewöhnlicher Text-Editor. Empfehlenswert hierfür sind andere Textbearbeitungsprogramme als Notepad, welches in einigen Fällen Darstellungsprobleme verursachen könnte.

Die Struktur dieser XML-Datei beinhaltet 4 grundlegende Typen von Marken (oder auch HTML-Tags, mit den dazugehörigen Attributen). Genauere Informationen zu den Marken befinden sich hier.

Die grüngefärbten Bereiche verdeutlichen, welche Marken andere umschließen

Die 1. Marke (<IFAS-BS-Export>) gibt u.a. an, welche Export-Version vorliegt. Sie umschließt alle folgenden Marken, d.h. ein </IFAS-BS-Export> befindet sich am Ende der XML-Datei.
Die 2. Marke (<Ziel-Anwendung>) gibt die Definition der Datenbank an, in die Daten von der IFAS-Datenbank transferiert werden sollen. Sie umschließt alle Marken innerhalb der Marke <IFAS-BS-Export>.
Die 3. Marke (<Ziel-Tab>) wählt eine bestimmte Tabelle in der Zieldatenbank aus, in die bestimmte Felder übertragen werden sollen. Sie umschließt alle feld-Marken innerhalb der gewünschten Ziel-Tabelle.
Die 4. Marke (<feld>) ist die Definition der Übergabe eines (IFAS-)Feldes.

Beschreibung der Marken (HTML-Tags inkl. Attribute)

(1) - Marke

(2) - Attribut } syntax

(3) - Wert

Die im Folgenden beschriebenen Syntaxen (oder auch Attribute) bewirken die eigentlichen Einstellungen jeder Marke. Eine Marke ohne Attribut(e) erfüllt praktisch keinen Zweck.

<IFAS-BS-Export>

Diese Marke ist die erste Marke in der XML-Struktur und umschließt alle weiteren Marken.

Syntax Beschreibung Beispiel

version Versions-Kennzeichen, damit das Programm die Gültigkeit der Konfiguration verifizieren kann. <IFAS-BS-Export version="1.0">

<Ziel-Anwendung>

Mit dieser Marke kann die Zieldatenbank für die Übertragung (i.d.R. AIS-I) eingestellt werden. Die Marke kann mehrmals verwendet werden, falls mehr als eine Zieldatenbank geplant ist.

Syntax Beschreibung Beispiel

name Name der Anwendung, muss eindeutig sein (und darf daher auch nicht mit einer der Zieltabellennamen übereinstimmen!) <Ziel-Anwendung name="AIS-I">

db-name Name, der aus der ndat.dft geladen wird, falls die Anwendung eine eigene Datenbankverbindung benötigt. <Ziel-Anwendung db-name="AIS-I">

modul Kann bei der Verwendung eines speziellen IFAS-Export-Moduls eingesetzt werden. Im folgenden Beispiel ist es jedoch AIS-I. <Ziel-Anwendung name="AIS-I" modul="AISI">

datformat Format-Anweisungen, in diesem Fall speziell für das Datum (z.B. yy-MM-dd, yyyy-MM-dd, MM-dd, etc.). <Ziel-Anwendung name="AIS-I" datformat="yyyy-MM-dd">

<Ziel-Tab>

Definiert eine Zieltabelle, welche mindestens 1 Feld besitzen muss. Diese Marke umschließt somit feld-Marken

Syntax Beschreibung Beispiel

name Name der Zieltabelle. Muss eindeutig sein. Es handelt sich entweder um die Tabelle a_ast (erweiterte BS-Daten),a_betr (BS-Grunddaten) oder i_schl (Schlüsselwerttabelle). <Ziel-Tab name="a_betr">

ifas-tab IFAS-Tabelle(n) (auf die die Anwendung zugreifen soll), bei mehreren durch Komma getrennt. Default ist die bs-Tabelle. <Ziel-Tab name="a_betr" ifas-tab="bs,bs_po">

ifas-key=ifas-tab Angabe des Schlüsselfeldes (muss eindeutig sein). Es handelt es sich entweder um die Tabelle a_ast,a_betr oder i_schl. Weiterhin ist es möglich, mehrere Ifas-Tabellen zu selektieren. Nach Angabe der ersten folgt die nächste durch ein Komma getrennt. <Ziel-Tab name="a_ast" ifas-tab="bs" ifas-key="bs_nr">

depends <Ziel-Tab name="a_ast" depends="a_betr" ifas-tab="bs" ifas-key="bs_nr">

<feld>

Die Marke zur Definition eines Feldes. Muss von der Definition einer Zieltabelle umgeben sein.

Syntax Beschreibung Beispiel

name Angabe des Feldnamens innerhalb der Zieltabelle. Mitverwendet werden muss der Klassenname (z.B. bs., bs_po., etc). <feld name="as_id">

format Bestimmung des Formates des Zielfeldes. Kann beispielsweise für die Formatierung des Datums (für einen konkreten Fall) benutzt werden. <feld name="as_erf_dat" ftyp="Date" format="dd-MM-yyyy" ifas-feld="bs_angelegt" aktion="insert"/>

length Angabe für die Festlegung der Zeichenlänge eines Feldes, beispielsweise für Integers oder Strings. <feld name="bt_plz" ifas-feld="bs_po.po_plz" restrict="notnull" length="10" aktion="insert" ftyp="String"/>

restrict Spezielle Einstellung für die Übergabe eines Feldes: Daten dürfen keine Leerwerte enthalten, beispielsweise ""):
notnull
key - Fordert ein Schlüsselfeld
reference - Verweisfeld, ermöglicht also den Verweis auf ein anderes Feld. Hierfür wird ein weiteres Attribut benötigt: refname <feld name="as_bt_id" ftyp="Int" restrict="reference" refname="bt_id" aktion="insert" />

refname Zusätzliches Attribut, was angewendet werden muss, falls reference (als Verweisfeld, s.u.) verwendet wird. Möglicherweise wird der Klassenname (z.B. bs., bs_po., etc) benötigt.

ftyp Definiert den Feld-Typ. Hierbei müssen Ndat-kompatible Bezeichnungen verwendet werden:
String - Zeichenkette
Double - Gleitkommazahl mit doppelter Genauigkeit
Int - Ganzzahl mit oder ohne Vorzeichen
Short - Ganzzahl (Grenzen: -32.767 bis 32768)
Long - Gannzahl (Grenzen: -9,22*10¹⁸ bis 9,223*10¹⁸)
Boolean - Bool'scher Wert für wahr (Wert "J") / falsch (Wert "N")
Date - Datumswert - benötigt die Mitverwendung des format-Attributs <feld name="bt_id" ftyp="Int" restrict="key" methode="bt_id" aktion="insert" />

ifas-feld Das Bezugsfeld in Ifas. Es handelt sich um eine Pflichtangabe, es sei denn der Wert wird über eine spezielle Methode bestimmt (s.u.), es ist ein Default-Wert definiert, oder es ist ein Referenz-Feld (in dem Fall wird der Wert des zugehörigen Schüsselfeldes eingetragen). Wenn bei der Definition der Ziel-Tabelle eine Liste von Ifas-Referenz-Tabellen aufgeführt wird, muss hier der Klassenname verwendet werden. <feld name="bt_ott" ifas-feld="bs_po.po_teil" length="30" aktion="insert" ftyp="String" />

methode In einigen fällen werden die neu einzufügenden Daten nicht aus einem Ifas-Datenbankfeld bezogen, sondern berechnet (spezielle Ids, Sequenz-Nummern etc.). In diesen Fällen ist der Name der Berechnungsmethode anzugeben. Das Programm baut sich daraus den resultierenden Methodennamen zusammen, indem es den ersten Buchstaben als Großbuchstaben und den Rest als Kleinbuchstaben übernimmt und ein "get" davorsetzt (unabhängig von der Groß/Kleinschreibung). Aus xxxx (Anzahl der Buchstaben/Zeichen unbestimmt) wird also die Methode getXxxx(). Ist dieser Parameter gesetzt, werden alle ifas-feld-referenzen (s. ifas-feld) ignoriert. <feld name="as_bhnr" methode="behoerde" restrict="notnull" ftyp="String" aktion="update" />

konstante Das Feld wird mit dem angegebenen Konstanten Wert gefüllt, alle anderen Angaben werden ignoriert. <feld name="as_akzi" konstante="1" ftyp="String" />

default Bei Bestimmung dieses Attributs wird der Wert (als Standard- bzw. Default-Wert) in das Zielfeld eingegeben, falls das Ifas-Feld keinen Wert liefert. <feld name="as_strnr" ifas-feld="bs_strasse" aktion="insert" default="keine Angabe" ftyp="String" />

aktion Dieses Attribut Legt fest, ob das Zielfeld nur bei Insert-Aktionen (Attributwert insert) oder bei jedem Update (Attributwert update) aktualisiert werden soll.
<feld name="as_id" aktion="insert" ftyp="Int" methode="as_id" restrict="key" />

Zurück

Syntax	Beschreibung	Beispiel
name	Name der Anwendung, muss eindeutig sein (und darf daher auch nicht mit einer der Zieltabellennamen übereinstimmen!)	<Ziel-Anwendung name="AIS-I">
db-name	Name, der aus der ndat.dft geladen wird, falls die Anwendung eine eigene Datenbankverbindung benötigt.	<Ziel-Anwendung db-name="AIS-I">
modul	Kann bei der Verwendung eines speziellen IFAS-Export-Moduls eingesetzt werden. Im folgenden Beispiel ist es jedoch AIS-I.	<Ziel-Anwendung name="AIS-I" modul="AISI">
datformat	Format-Anweisungen, in diesem Fall speziell für das Datum (z.B. yy-MM-dd, yyyy-MM-dd, MM-dd, etc.).	<Ziel-Anwendung name="AIS-I" datformat="yyyy-MM-dd">

Syntax	Beschreibung	Beispiel
name	Name der Zieltabelle. Muss eindeutig sein. Es handelt sich entweder um die Tabelle a_ast (erweiterte BS-Daten),a_betr (BS-Grunddaten) oder i_schl (Schlüsselwerttabelle).	<Ziel-Tab name="a_betr">
ifas-tab	IFAS-Tabelle(n) (auf die die Anwendung zugreifen soll), bei mehreren durch Komma getrennt. Default ist die bs-Tabelle.	<Ziel-Tab name="a_betr" ifas-tab="bs,bs_po">
ifas-key=ifas-tab	Angabe des Schlüsselfeldes (muss eindeutig sein). Es handelt es sich entweder um die Tabelle a_ast,a_betr oder i_schl. Weiterhin ist es möglich, mehrere Ifas-Tabellen zu selektieren. Nach Angabe der ersten folgt die nächste durch ein Komma getrennt.	<Ziel-Tab name="a_ast" ifas-tab="bs" ifas-key="bs_nr">
depends		<Ziel-Tab name="a_ast" depends="a_betr" ifas-tab="bs" ifas-key="bs_nr">

Syntax	Beschreibung	Beispiel
name	Angabe des Feldnamens innerhalb der Zieltabelle. Mitverwendet werden muss der Klassenname (z.B. bs., bs_po., etc).	<feld name="as_id">
format	Bestimmung des Formates des Zielfeldes. Kann beispielsweise für die Formatierung des Datums (für einen konkreten Fall) benutzt werden.	<feld name="as_erf_dat" ftyp="Date" format="dd-MM-yyyy" ifas-feld="bs_angelegt" aktion="insert"/>
length	Angabe für die Festlegung der Zeichenlänge eines Feldes, beispielsweise für Integers oder Strings.	<feld name="bt_plz" ifas-feld="bs_po.po_plz" restrict="notnull" length="10" aktion="insert" ftyp="String"/>
restrict	Spezielle Einstellung für die Übergabe eines Feldes: Daten dürfen keine Leerwerte enthalten, beispielsweise ""): *notnull* *key* - Fordert ein Schlüsselfeld *reference* - Verweisfeld, ermöglicht also den Verweis auf ein anderes Feld. Hierfür wird ein weiteres Attribut benötigt: *refname*	<feld name="as_bt_id" ftyp="Int" restrict="reference" refname="bt_id" aktion="insert" />
refname	Zusätzliches Attribut, was angewendet werden muss, falls reference (als Verweisfeld, s.u.) verwendet wird. Möglicherweise wird der Klassenname (z.B. bs., bs_po., etc) benötigt.
ftyp	Definiert den Feld-Typ. Hierbei müssen Ndat-kompatible Bezeichnungen verwendet werden: String - Zeichenkette Double - Gleitkommazahl mit doppelter Genauigkeit Int - Ganzzahl mit oder ohne Vorzeichen Short - Ganzzahl (Grenzen: -32.767 bis 32768) Long - Gannzahl (Grenzen: -9,2210¹⁸ bis 9,22310¹⁸) Boolean - Bool'scher Wert für wahr (Wert "J") / falsch (Wert "N") Date - Datumswert - benötigt die Mitverwendung des format-Attributs	<feld name="bt_id" ftyp="Int" restrict="key" methode="bt_id" aktion="insert" />
ifas-feld	Das Bezugsfeld in Ifas. Es handelt sich um eine Pflichtangabe, es sei denn der Wert wird über eine spezielle Methode bestimmt (s.u.), es ist ein Default-Wert definiert, oder es ist ein Referenz-Feld (in dem Fall wird der Wert des zugehörigen Schüsselfeldes eingetragen). Wenn bei der Definition der Ziel-Tabelle eine Liste von Ifas-Referenz-Tabellen aufgeführt wird, muss hier der Klassenname verwendet werden.	<feld name="bt_ott" ifas-feld="bs_po.po_teil" length="30" aktion="insert" ftyp="String" />
methode	In einigen fällen werden die neu einzufügenden Daten nicht aus einem Ifas-Datenbankfeld bezogen, sondern berechnet (spezielle Ids, Sequenz-Nummern etc.). In diesen Fällen ist der Name der Berechnungsmethode anzugeben. Das Programm baut sich daraus den resultierenden Methodennamen zusammen, indem es den ersten Buchstaben als Großbuchstaben und den Rest als Kleinbuchstaben übernimmt und ein "get" davorsetzt (unabhängig von der Groß/Kleinschreibung). Aus *xxxx* (Anzahl der Buchstaben/Zeichen unbestimmt) wird also die Methode *getXxxx(). Ist dieser Parameter gesetzt, werden alle ifas-feld-referenzen (s. ifas-feld*) ignoriert.	<feld name="as_bhnr" methode="behoerde" restrict="notnull" ftyp="String" aktion="update" />
konstante	Das Feld wird mit dem angegebenen Konstanten Wert gefüllt, alle anderen Angaben werden ignoriert.	<feld name="as_akzi" konstante="1" ftyp="String" />
default	Bei Bestimmung dieses Attributs wird der Wert (als Standard- bzw. Default-Wert) in das Zielfeld eingegeben, falls das Ifas-Feld keinen Wert liefert.	<feld name="as_strnr" ifas-feld="bs_strasse" aktion="insert" default="keine Angabe" ftyp="String" />
aktion	Dieses Attribut Legt fest, ob das Zielfeld nur bei Insert-Aktionen (Attributwert *insert) oder bei jedem Update (Attributwert update*) aktualisiert werden soll.	<feld name="as_id" aktion="insert" ftyp="Int" methode="as_id" restrict="key" />