f$ABAS_Datenlesen (engl. f$ABAS_GetData)

Mit dieser Funktion können beliebige Daten aus ABAS gelesen werden. Die Suche wird über eine SuchParametergruppe gesteuert und einen Suchstring, der individuell zusammengesetzt werden kann. Die beiden Suchmechanismen können kombiniert werden. Beim Zusammensetzen des Suchstrings gilt: Das Trennzeichen zwischen zwei Kriterien ist das Semikolon (;). Aus der Suchparametergruppe werden allerdings nur diejenigen Parameter ausgewertet, bei welchen in der Parametergruppendefinition in der Spalte Benennung eine Zuordnung zu einem ABAS Feld hergestellt wurde. Es wird immer mit Wildcard gesucht. Für die Suche muss ein Tabellenname angegeben werden. Dies könnte beispielsweise Verkauf:Auftrag sein. Da bei einer Verwendung dieser Schlüsselworte die Suche nur dann funktioniert, wenn das ABAS System auf Deutsch eingestellt ist, wird empfohlen, stattdessen die internen Nummern der Tabellen zu verwenden:

Diese Liste kann mit dem Tool EDPViewer eingesehen werden.

Bitte beachten: Der Name der Parametergruppen wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen.

Syntax:	Status = f$ABAS_Datenlesen (TabellenName, SuchPG, ErgPG, NameAnzahl, Sortierung [,Suchkriterium])
	Argument		Typ	Bedeutung
	Tabellenname		Zeichenkette	Name der Tabelle, in welcher gelesen werden soll.
	SuchPG		Zeichenkette	Name der Parametergruppe, die die Suchkriterien enthält. Diese Parametergruppe muss entweder nicht indiziert sein, oder es muss der verwendete Index mitgegeben werden.
	ErgPG		Zeichenkette	Name der Parametergruppe, auf welche die Daten der Tabelle geschrieben wird. Diese Parametergruppe muss indiziert sein. Bei Bedarf wird die Größe der Parametergruppe angepasst.
	NameAnzahl		Zeichenkette	Name des Parameters, auf welchen die Anzahl der gefundenen Datensätze geschrieben wird.
	Sortierung		Zeichenkette	Sortierkriterium. Hier ist lediglich der Feldname anzugeben, nach welchem sortiert werden soll. Es kann nicht nach jedem beliebigen Feld sortiert werden, sondern nur nach den Feldern, die auch bei der interaktiven Suche gewählt werden können.
	Suchkriterium		Zeichenkette	Individuelles Suchkriterium in ABAS Syntax. Dieses Argument ist optional
Ergebnis:	Ganzzahl	Status des Funktion: -5 : Die Spalte Benennung der Parametergruppe ist nicht gefüllt -4 : Übergabeparameter nicht konsistent -3 : Die Operation ist fehlgeschlagen (Mit Hilfe der Logdatei kann eine Fehleranalyse vorgenommen werden) -2 : kein Datensatz gefunden -1 : Die Schnittstelle ist nicht angemeldet 0 : Die Daten wurden erfolgreich gelesen
Beispiel:	In diesem Beispiel werden alle Anschriften gelesen, deren Name mit A beginnt. Status = f$abas_anmelden('linux',6550,'erp','sy') f$abas_logfile('c:\\temp\\abas' + f$datum('jjjjMMtt_hh_mm_ss') +'.log') Anschrift_s.Rufname ='A' Status = f$abas_datenlesen ('0:1', 'Anschrift_s', 'Anschriften', 'Anzahl', '') f$abas_logfile('') Status = f$abas_abmelden()