AfArcSearchRmtCtrlShow

Aus ArcFlow Wiki
Version vom 22. Oktober 2024, 15:22 Uhr von Jens (Diskussion | Beiträge) (Stand 4.1.09)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen
 AfArcSearchRmtCtrlShow(alpha1, date2, date3) : int

Nicht ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Ausführbar mit der Application Remote ControlNicht ausführbar von der Script-API

Archiv-Suche durchführen und in ArcFlow anzeigen
alpha1 Suchstring
date2 Start-Datum
date3 Ende-Datum
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfArcSearchRmtCtrl(), AfArcSearchDefBegin(), AfArcSearchStart() AfArcSearchResLstGet()

Die Funktion führt eine Suche in ArcFlow durch. Die Suche wird durch den in (alpha1) übergebenen Suchstring und einem Datumsbereich (date3) und (date4) eingeschränkt. Das Ergebnis der Suche wird in ArcFlow angezeigt.

Das Datum in den Parametern (date3) und (date4) kann in den Formaten Jahr-Monat-Tag, Tag-Monat-Jahr oder Monat-Tag-Jahr angegeben werden. Dies ist auch die Reihenfolge, in der das Datum versucht wird zu interpretieren. Die Angabe von "01.02.03" wird als 3. Februar 2001, "12.13.14" als 13. Dezember 2014 interpretiert.

Es können mehrere Suchbegriffe im Suchstring enthalten sein. Sind die Suchbegriffe durch Leerzeichen voneinander getrennt, werden alle Archive gefunden, die alle Suchbegriffe beinhalten (UND-Verknüpfung). Werden die Suchbegriffe mit Kommata voneinander getrennt, werden alle Archive gefunden, die mindestens einen der Suchbegriffe beinhalten (ODER-Verknüpfung). Alternativ zu Leerzeichen und Komma können auch die Begriffe "and" und "or" angegeben werden.

Die Funktion kann nur über die Application Remote Control aufgerufen werden. Die Parameter werden mit folgenden Namen übergeben:

/SearchStr Suchstring
/DateBegin Start-Datum
/DateEnd Ende-Datum
/RsltPath Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.
/Flags optionale Parameter

Als optionale Parameter kann zur Zeit nur der Wert 1 angegeben werden. Mit diesem Flag wird dem Suchstring ein "*" angehängt.

Beispiel:

/user=admin /password=troja /action=open_dialog /fnc=AfArcSearchRmtCtrlShow /SearchStr="Kaffeemaschine ArcFlow" /DateBegin=2020-01-01 /DateEnd=2020-01-31 /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. Die Anzeige der gefundenen Archive erfolgt in ArcFlow.

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

Konstante Wert Bedeutung
_ErrOk 0 ok - kein Fehler aufgetreten

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