... tResult # AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true)); ...
AfAbmFldSet: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) K Stand 4.1.10 Beispiel angepasst |
Jens (Diskussion | Beiträge) K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst |
||
| Zeile 8: | Zeile 8: | ||
<td class="title"> AfAbmFldSet(int1, alpha2, alpha3[, int4]) : int</td> | <td class="title"> AfAbmFldSet(int1, alpha2, alpha3[, int4]) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | [[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen|Ausführbar von der API]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen|Ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen|Ausführbar von der Script-API]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 77: | Zeile 77: | ||
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. | 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. | ||
== Beispiel == | |||
<tabber> | |||
|-|ScriptAPI= | |||
<pre class=source> | <pre class=source> | ||
... | ... | ||
tResult # AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true)); | tResult # AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true)); | ||
... | ... | ||
</pre> | </pre> | ||
|-|ArcFlowAPI= | |||
<pre class=source> | |||
... | |||
tResult # AF.API:AfAbmFldSet(tAbmId, tAbmFldName, CnvAL(true)); | |||
... | |||
</pre> | |||
</tabber> | |||
<p><p>Bei der Verwendung mit der | <p><p>Bei der Verwendung mit der | ||
Aktuelle Version vom 18. Dezember 2025, 09:50 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
... tResult # AF.API: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.
