AfArcDelete

AfArcDelete(alpha1, var int2[, logic3]) : int
Archiv löschen
alpha1 Nummer des Archives int2 Bereich, in dem ein Fehler aufgetreten ist logic3 Fehler beim Anhang ignorieren (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcCreate()

Die Funktion löscht das übergebene Archiv mit allen zugehörige Informationen und Anhangdateien. Im ersten Schritt wird das Archiv zur Löschung markiert, der Index-Server löscht dann das Archiv.

Als Parameter (int2) muss eine ganzzahlige Variable angegeben werden. In dieser Variablen steht nach dem Aufruf der Funktion im Fehlerfall der Datenbankbereich, in dem ein Fehler beim Löschen des Archives aufgetreten ist. Der Wert kann mit folgenden Konstanten verglichen werden:

Konstante	Wert	Bedeutung
sAfAreaPartArcTxt	30000	Archiv-Text
sAfAreaPartIdxJobs	30218	Indexserver-Jobs
sAfAreaPartArcSelState	30219	Archiv-IndexStatus
sAfAreaPartArcMain	30220	Archivdatensatz
sAfAreaPartArcDocCopy	30222	Archiv-Dokumentkopien (Die Konstante wird in einer der kommenden Versionen entfernt, statt dessen müssen die Konstanten sAfAreaPartArcDistr, sAfAreaPartArcDistr2 und sAfAreaPartArcDistr3 verwendet werden.)
sAfAreaPartArcDistr	30235	Archiv-Dokumentverteilung
sAfAreaPartArcDistr2	30236	Archiv-Dokumentverteilung (zugewiesene Sachbearbeiter)
sAfAreaPartArcDistr3	30237	Archiv-Dokumentverteilung (ausgewählte Dateien)
sAfAreaPartArcKeyWord	30223	Archiv-Stichwörter
sAfAreaPartArcDocCopy2	30224	Archiv-Dokumentkopie-Anhang
sAfAreaPartArcArcTypen	30225	Archiv-Archivtypen
sAfAreaPartArcFile	30226	Archiv-Anhangdateien
sAfAreaPartArcHistorie	30230	Archiv-Historie
sAfAreaPartArcWflDet	30240	Archiv-WorkFlow-Details
sAfAreaPartArcAbm	30261	Archiv-Arbeitsmappen

Über den optionalen Parameter (logic3) kann übergeben werden, dass ein Archiv gelöscht wird, auch wenn beim Lesen der Anhangdateien in den BLOB-Datenbanken Fehler auftreten (z.B. dass die Datei nicht gelöscht werden kann). Diese Option darf nicht immer angewendet werden! Sie darf nur in konkreten Einzelfällen genutzt werden, da sonst Dateireste in der Datenbank übrig bleiben können.

Bei Fragen kontaktieren Sie bitte den ArcFlow-Support.

Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:

/ArcNr	Archivnummer des zu löschenden Archivs
/ErrIgnore	Fehler beim Löschen des BLObs ignorieren
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Zum Beispiel:
/user=admin /password=troja /action=fnc /fnc=AfArcDelete /ArcNr=2008.0000012 /ErrIgnore=0 /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 den beiden folgenden Zeilen wird die Fehlermeldung und die Dateinummer abgelegt.

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rLocked	1	Ein anderer Benutzer hat das Archiv zur Zeit gesperrt.
_rNoRec	5	Das zu löschende Archiv wurde nicht gefunden.
sAfErrNoRights	-20029	Die Berechtigungen reichen nicht aus.

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.