AfArcFileAdd

AfArcFileAdd(alpha1, alpha2, var int3[, logic4]) : int
Archiv ein Dokument hinzufügen
alpha1 Nummer des Archives alpha2 Name und Pfad der externen Datei int3 Nummer des Anhangs logic4 Keine automatische Zuordnung (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcFileDelete(), AfArcFileEdit()

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.