AfArcFileAdd: Unterschied zwischen den Versionen
Jens (Diskussion | Beiträge) K Jens verschob die Seite AFArcFileAdd nach AfArcFileAdd, ohne dabei eine Weiterleitung anzulegen |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcFileAdd(alpha1, alpha2, var int3[, logic4]) : 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 52: | Zeile 52: | ||
<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]], | ||
[[ | [[AfArcFileDelete#|AfArcFileDelete()]], | ||
[[ | [[AfArcFileEdit#|AfArcFileEdit()]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 101: | Zeile 101: | ||
<p>Zum Beispiel:<br> | <p>Zum Beispiel:<br> | ||
<font class=source>/user=admin /password=troja /action=fnc /fnc=2008.0000012 /Path="c:\ArcFlow\Import\Brief. | <font class=source>/user=admin /password=troja /action=fnc /fnc=AfArcFileAdd /ArcNr=2008.0000012 /Path="c:\ArcFlow\Import\Brief.docx" /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 29. Oktober 2024, 08:49 Uhr
 |
|||||||||||||||||||||||||
| AfArcFileAdd(alpha1, alpha2, var int3[, logic4]) : int |
|
||||||||||||||||||||||||
| Archiv ein Dokument hinzufügen | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Die Funktion fügt die in (alpha2) angegebene Datei zu dem in (alpha1) übergebenen Archiv hinzu.
Der Archiv-Datensatz wird zu diesem Zweck kurzzeitig gesperrt und nach dem Speichervorgang wieder entsperrt. Ist der Datensatz bereits von einem anderen Benutzer gesperrt, können die Inhalte nicht gespeichert werden und es wird der Wert _rLocked zurückgegeben.
Als Parameter (int3) muss eine ganzzahlige Variable angegeben werden, in der nach Aufruf der Funktion die Nummer des angelegten Anhangs zur Verfügung steht.
Soll keine automatische Zuordnung des Dokuments zu Arbeitsmappen erfolgen, muss im Parameter (logic4) true übergeben werden.
Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:
| /ArcNr | Nummer des Archivs |
| /Path | Name und Pfad der externen Datei |
| /RetAuto | Automatische Zuordnung |
| /RsltPath | Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird. |
Zum Beispiel:
/user=admin /password=troja /action=fnc /fnc=AfArcFileAdd /ArcNr=2008.0000012 /Path="c:\ArcFlow\Import\Brief.docx" /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. In der folgenden Zeile wird die Nummer der Anhangdatei geschrieben.
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| _rLocked | 1 | Das Archiv ist von einem anderen Benutzer gesperrt. |
| _rNoRec | 5 | Das angegebene Archiv existiert nicht. |
| _ErrFsiNoFile | -20 | Die angegebene externe Datei existiert nicht. |
| _ErrFsiNoPath | -21 | Der Pfad zu der angegebenen externen Datei existiert nicht. |
| _ErrFsiAccessDenied | -23 | Der Zugriff auf die externe Datei wurde verweigert. |
| _ErrFsiLockViolation | -28 | Sperrkonflikt in der externen Datei. |
| _ErrFsiOpenFailed | -29 | Die externe Datei konnte nicht geöffnet werden. |
| _ErrBinNoPath | -1502 | Der Pfad in der BLOB-Datenbank ist nicht vorhanden. |
| _ErrBinNoFile | -1503 | Datei in der BLOB-Datenbank ist nicht vorhanden. |
| _ErrBinNoData | -1504 | Datei in der BLOB-Datenbank ist leer. |
| _ErrBinNoLock | -1505 | Datei in der BLOB-Datenbank ist nicht gesperrt. |
| _ErrBinLocked | -1506 | Datei in der BLOB-Datenbank ist von einem anderen Benutzer gesperrt. |
| sAfErrNoRights | -20029 | Die Berechtigungen sind nicht ausreichend. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
