AfAbmFldSet

AfAbmFldSet(int1, alpha2, alpha3[, int4]) : int
Inhalt eines Arbeitsmappenfeldes setzen
int1 Nummer der Arbeitsmappe alpha2 Name des Feldes alpha3 Inhalt des Feldes int4 Id des Feldes (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmFldClear(), AfAbmFldCreate(), AfAbmFldDelete(), AfAbmFldGet()

Diese Funktion setzt den Inhalt des Arbeitsmappenfeldes (alpha2) der Arbeitsmappe (int1). Falls die ID des Feldes bekannt ist, kann diese in (int4) übergeben werden. In diesem Fall wird (alpha2) nicht berücksichtigt.

Die Funktion setzt füllt den Inhalt des Feldes mit dem Parameter (alpha3). Konnte dies erfolgreich durchgeführt werden wird _ErrOk zurückgegeben. Falls das Feld bereits gesperrt ist, wird _rLocked zurückgegeben.

Abhängig vom Datentyp muss der übergebene Wert in eine Zeichenkette gewandelt werden. Dazu stehen die Anweisungen zur Konvertierung von Datentypen (Cnv...()>) zur Verfügung. Logische Werte müssen als "1" (true) oder "0" (false) geschrieben werden.

Beispiel:

sub ConvertAL
(
  aLogic : logic;
)
: alpha;

{
  if (aLogic)
    return('1');
  else
    return('0');
}

...
tResult # AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true));
...

Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:

/AbmNr	Nummer der Arbeitsmappe
/AbmField	Name des Feldes
/AbmFldContent	Inhalt des Feldes
/AbmFldId	Id des Feldes (optional)
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Zum Beispiel:
/user=admin /password=troja /action=fnc /fnc=AfAbmFldSet /AbmNr=600448 /AbmField=KundenNummer /AbmFldContent=17901 /RsltPath=c:\temp\AFAPIRES.TXT

In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rLocked	1	Datensatz ist gesperrt - Das Feld wird gerade editiert und ist daher gesperrt.
sAfErrNoRecAbm	-20026	Die Arbeitsmappe existiert nicht.
sAfErrNoRights	-20029	Die Berechtigung ist nicht ausreichend.
sAfErrNoRecAbmFld	-20037	Das Arbeitsmappenfeld existiert nicht.
sAfErrNoAbmFldGrpDefined	-20040	Der Arbeitsmappe ist keine Gruppe von Arbeitsmappenfeldern zugeordnet.

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.