Die folgenden Parameter gelten für die Methode „doQuery“:
|
Parameter |
Typ |
Beschreibung |
|---|---|---|
|
SID |
Ganzzahl |
Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde. |
|
ObjectType |
Zeichenfolge |
Gibt den abzufragenden Objekttyp (Factory) an. |
|
WhereClause |
Zeichenfolge |
(optional) Gibt die Where-Klausel für die Abfrage an. |
Beschreibung
Führt eine SQL-ähnliche Auswahl für den angegebenen Objekttyp durch. Außerdem wird eine Listenkennung zurückgegeben, die auf eine Liste mit den aus der Abfrage zurückgegebenen Zeilen verweist, wobei jede Zeile für ein CA SDM-Objekt steht, das mit der angegebenen Where-Klausel übereinstimmt. Der Anrufer kann Werte für die Listenzeilen anhand von „getListValues()“ abrufen.
Hinweis: Weitere Informationen zu Where-Klauseln finden Sie unter "Where-Klauseln".
Wichtig! Die Objektliste wird auf dem CA SDM-Server gespeichert und verbraucht Systemressourcen. Der Anrufer ist für die Freigabe der Liste anhand von „freeListHandles()“ verantwortlich. Beim Speichern einer Liste im Arbeitsspeicher werden die Speicheranforderungen für den Prozess möglicherweise jenseits des 2GB-Limits erweitert, was zu Arbeitsspeicherverlusten und Systemfehlern führen kann.
Mit dieser Funktion erstellte Listen sind homogen, d. h., alle Objekte weisen den gleichen Typ auf und sind statisch. Dies bedeutet, dass die Liste zu keinem Zeitpunkt geändert wird, selbst wenn eine Datenänderung an einem Objekt sie aus der ursprünglichen Where-Klausel ausschließt.
Rückgabe
Eine Listenkennung, die mit „freeListHandle()“ freigegeben werden muss.
|
XML-Element |
Typ |
Beschreibung |
|---|---|---|
|
<listHandle> |
Ganzzahl |
Gibt die Listenkennung an. |
|
<listLength> |
Ganzzahl |
Gibt die Länge der generierten Liste an. |
|
Copyright © 2013 CA.
Alle Rechte vorbehalten.
|
|