AfAbmFldSet: Unterschied zwischen den Versionen
Die Seite wurde neu angelegt: „<languages /> <translate> <table class=head> <tr> <td class="BigTitle" colspan="2" align="center">file:DE_Schriftzug.gif</td> </tr> <tr clas…“ |
Jens (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
||
| Zeile 74: | Zeile 74: | ||
werden wird <font class=source>_ErrOk</font> zurückgegeben. Falls das Feld bereits | werden wird <font class=source>_ErrOk</font> zurückgegeben. Falls das Feld bereits | ||
gesperrt ist, wird <font class=source>_rLocked</font> zurückgegeben.</p> | gesperrt ist, wird <font class=source>_rLocked</font> zurückgegeben.</p> | ||
Abhängig vom Datentyp muss der übergebene Wert in eine Zeichenkette gewandelt werden. Dazu stehen die Anweisungen zur Konvertierung von Datentypen (<font class=source>Cnv...()></font>) zur Verfügung. Logische Werte müssen als "1" (<font class=source>true</font>) oder "0" (<font class=source>false</font>) geschrieben werden. | |||
<b>Beispiel:</b> | |||
<pre class=source> | |||
sub CnvAL | |||
( | |||
aLogic : logic; | |||
) | |||
: alpha; | |||
{ | |||
if (aLogic) | |||
return('1'); | |||
else | |||
return('0'); | |||
} | |||
... | |||
tResult # AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true)); | |||
... | |||
</pre> | |||
<p><p>Bei der Verwendung mit der | <p><p>Bei der Verwendung mit der | ||
Version vom 27. Oktober 2023, 08:51 Uhr
 |
|||||||||||||||||||||||||
| AFAbmFldSet(int1, alpha2, alpha3[, int4]) : int |
|
||||||||||||||||||||||||
| Inhalt eines Arbeitsmappenfeldes setzen | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
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 CnvAL
(
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.
