AfArcAbmAdd: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
K Jens verschob die Seite AFArcAbmAdd nach AfArcAbmAdd, ohne dabei eine Weiterleitung anzulegen
K Stand 4.1.09
 
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFArcAbmAdd(alpha1, int2[, logic3]) : int</td>
     <td class="title">&nbsp;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]][[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]]
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()]]
[[AfArcAbmDelete#|AfArcAbmDelete()]]
   </td>
   </td>
</tr>
</tr>
Zeile 80: Zeile 80:


<p>Zum Beispiel: <br>
<p>Zum Beispiel: <br>
<font class=source>/user=admin /password=troja /action=fnc /fnc=AFArcAbmAdd /ArcNr=2008.0000012 /AbmNr=600448 /ErrOnExist=true /RsltPath=c:\temp\AFAPIRES.TXT</font></p>
<font class=source>/user=admin /password=troja /action=fnc /fnc=AfArcAbmAdd /ArcNr=2008.0000012 /AbmNr=600448 /ErrOnExist=true /RsltPath=c:\temp\AFAPIRES.TXT</font></p>


<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung  
<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung  

Aktuelle Version vom 18. Oktober 2024, 12:26 Uhr

 AfArcAbmAdd(alpha1, int2[, logic3]) : int

Ausführbar von der APIAusführbar von der ProgrammierschnittstelleAusführbar mit der Application Remote ControlAusführbar von der Script-API

Archiv zu einer Arbeitsmappe hinzufügen
alpha1 Nummer des Archives
int2 Nummer der Arbeitsmappe
logic3 Fehler bei vorhandener Zuweisung (optional)
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfArcAbmDelete()

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.

Zum Beispiel:
/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.