f$ABAS_Auftraganlegen (engl. f$ABAS_NewOrder)
f$ABAS_Auftraganlegen (engl. f$ABAS_NewOrder)
Mit dieser Funktion werden ein Auftrag und die Positionen des Auftrags nach ABAS geschrieben. Die Positionen werden ohne Struktur übertragen. Falls es notwendig ist, Positionen mit Struktur zu übertragen, muss der Auftrag mit den Positionen der obersten Ebene mittels dieser Funktion angelegt werden und anschließend die Struktur in eine XML-Datei geschrieben werden. Die Positionsnummern sind alphanumerisch. Es ist also durchaus erlaubt, z.B. 2.1 als Positionsnummer zu verwenden. In den meisten Fällen ist es ausreichend, den Auftrag ohne Struktur anzulegen, alle Positionen mit ihren Positionsnummern zu übertragen. Die Nummer des angelegten Auftrags wird auf der Parametergruppe der Auftragsdaten zurückgeliefert.
Mit dieser Funktion können auch bestehende Aufträge verändert werden. Dazu muss als erstes Feld eine eindeutige Identifikation des Auftrags übergeben werden. Insbesondere beim Start des Regelwerks aus ABAS ist dies eine gebräuchliche Vorgehensweise. Bei der Konfiguration einer einzelnen Position soll in der Regel auch nur diese Position verändert werden. Um dies zu steuern, wird bei der Übergabe der Daten anstelle der Anzahl die negative Zeilennummer der indizierten Parametergruppe übergeben.
Bitte beachten: Der Name der Parametergruppen wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen.

Syntax: | Status = f$ABAS_Auftraganlegen (FeldListeM,PGM,Anzahl,FeldlisteP,PGP) | ||
| Argument | Typ | Bedeutung |
| FeldlisteM | Zeichenkette | Feldliste der ePOS Parameter der Parametergruppe PGM, die in den Kopf des Auftrags geschrieben werden sollen. |
| PGM | Zeichenkette | Name der Parametergruppe, die die Daten des Auftrags enthält. Diese Parametergruppe muss entweder nicht indiziert sein, oder es muss der verwendete Index mitgegeben werden (z.B. 'Auftragsdaten[1]' |
| Anzahl | Ganzzahl | Anzahl der zu übertragenden Positionen, bzw. die negative Zeilennummer, wenn nur eine Position verändert werden soll. |
| FeldlisteP | Zeichenkette | Feldliste der ePOS Parameter der Parametergruppe PGP, die bei den Positionen des Auftrags geschrieben werden sollen. |
| PGP | Zeichenkette | Name der Parametergruppe, die die Daten der Positionen enthält. Diese Parametergruppe muss indiziert sein. |
Ergebnis: | Ganzzahl | Status des Funktion: -5 : Eine Feldliste ist Leer -4 : Übergabeparameter nicht konsistent -3 : Die Operation ist fehlgeschlagen (Mit Hilfe der Logdatei kann eine Fehleranalyse vorgenommen werden) -2 : Die ABAS Schnittstelle ist nicht installiert -1 : Die Schnittstelle ist nicht angemeldet 0 : Der Auftrag wurde erfolgreich übertragen | |
Beispiel: | Status = f$abas_anmelden('linux',6550,'erp','sy') f$abas_logfile('c:\\temp\\abas' + f$datum('jjjjMMtt_hh_mm_ss') +'.log') FelderAuftrag = 'AuftragNr,Kunde,Stand' FelderPosition = 'PosNr,MaterialNr,Menge,ListenpreisME' Status = f$abas_auftraganlegen (FelderAuftrag,'abas_auftrag',AnzPos,FelderPosition,'abas_positionen') f$abas_logfile('') Status = f$abas_abmelden() | ||