K Stand 4.1.08 |
K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst |
||
| (3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcAbmAdd(alpha1, int2[, logic3]) : 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 46: | Zeile 46: | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[:Category:Befehle für Archive|Verwandte Befehle]], | [[:Category:Befehle für Archive|Verwandte Befehle]], | ||
[[ | [[AfArcAbmDelete#|AfArcAbmDelete()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 79: | Zeile 79: | ||
</table> | </table> | ||
== Beispiel == | |||
<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung | <tabber> | ||
geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.</p></ | |-|ArcFlowRemoteControl= | ||
<pre class=source> | |||
af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArcAbmAdd /ArcNr=2008.0000012 /AbmNr=600448 /ErrOnExist=true /RsltPath=c:\temp\AFAPIRES.TXT | |||
</pre> | |||
<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.</p> | |||
</tabber> | |||
<p> | <p> | ||
| Zeile 139: | Zeile 143: | ||
[[Category:Befehle für Archive]] | [[Category:Befehle für Archive]] | ||
[[Category:Befehle für Arbeitsmappen]] | [[Category:Befehle für Arbeitsmappen]] | ||
 |
|||||||||||||||||||||
| AfArcAbmAdd(alpha1, int2[, logic3]) : int |
|
||||||||||||||||||||
| Archiv zu einer Arbeitsmappe hinzufügen | |||||||||||||||||||||
|
|||||||||||||||||||||
Mit der Funktion lässt sich das in (alpha1) übergebene Archiv zu der in (int2) übergebenen Arbeitsmappe hinzufügen. Ist das Archiv bereits in der Arbeitsmappe enthalten, wird der Wert _rOk zurückgegeben. Soll auch in diesem Fall ein Fehler zurückgegeben werden, muss in (logic3) true übergeben werden. Ist in (int2) eine Vorlagemappe angegeben, ist das Resultat sAfErrNoRights (-20029). Bei erfolgreicher Durchführung der Funktion wird der Wert _ErrOk zurückgegeben.
Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:
| /ArcNr | Nummer des Archivs |
| /AbmNr | Nummer der Arbeitsmappe |
| /ErrOnExist | Fehlerrückgabe bei vorhandener Zuweisung |
| /RsltPath | Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird. |
af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArcAbmAdd /ArcNr=2008.0000012 /AbmNr=600448 /ErrOnExist=true /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 |
| _rNoRec | 5 | Es existiert kein Archiv mit der in (alpha1) angegebenen Nummer. |
| _rExists | 6 | Das Archiv ist bereits der Arbeitsmappe zugeordnet (nur, wenn logic3 = true) |
| sAfErrNoRecAbm | -20026 | Die in (int2) übergebene Arbeitsmappe existiert nicht. |
| sAfErrNoRights | -20029 | Die Berechtigungen reichen nicht aus. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
