Objekte suchen

OpenSearch

OpenSearch sucht mittels der Processes-Expertensuche nach Processes-Objekten.
Syntax OpenSearch (QueryString)
Parameter
QueryString
Suchbefehl als Variant (String)
Das Format entspricht der folgenden Form: SEARCH Objekttyp WHERE Suchbedingung
Objekttyp
Der Objekttyp ist der Definitionsname des gewünschten helpLine-Objekttyps, beispielsweise „Employee“ oder „IncidentRequest“. Alternativ können Sie den Basistyp, für Vorgänge also CASE, angeben.
Suchbedingung
Die Suchbedingung entspricht der Syntax der Expertensuche.
Rückgabewert Suchergebnis als Variant (IHLObject)
Anmerkung: Beispiele zur Verwendung dieser Methode finden Sie auch in der Beschreibung der Methoden SaveObject und RemoveObject.
Tipp: Die Suchbedingung können Sie im Processes-ClassicDesk definieren und mit Kopieren und Einfügen in Ihr Script kopieren.

Die Abfrage der einzelnen Objekte wird mit Hilfe der HLObject-Methode GetItems erzielt. Über die HLObject-Methode GetItemCount kann die Anzahl der gefundenen Objekte ermittelt werden. Die Werte der einzelnen Objekte werden mit Hilfe der HLObject-Methode GetValue abgefragt. Dieses wird im folgenden Beispiel näher erläutert.

Beispiel: Liste der Unternehmen (Objekttyp Company) in einer Datei speichern.

Alle Objekte vom Typ „Company“ suchen und den Namen in eine Datei schreiben.
...
' Suche definieren
QryString = "SEARCH Company WHERE HLOBJECTINFO.ID >= 0"
Set Qry = hlcontext.OpenSearch (QryString)

' Ermitteln der Anzahl der gefundenen Objekte (Unternehmen)
objTextFile.Write "Unternehmen in der Liste: " & _
        Qry.GetItemCount (0, 0) & VbCrLf
objTextFile.Write "---------------------------------" & VbCrLf

' Namen der gefundenen Unternehmen in der Datei schreiben
Companies = Qry.GetItems (0, -1, -1, 0)
For each Company in Companies
 objTextFile.Write Company.GetValue _
        ("OrganisationGeneral.OrganisationName",0,0,0,0) & VbCrLf
Next

objTextFile.Write "---------------------------------" & VbCrLf
objTextFile.Close