getRelatedListValues

Web-Service-Methoden › Listen-/Abfragemethoden › getRelatedListValues

getRelatedListValues

Die folgenden Parameter gelten für die Methode „getRelatedListValues“:

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
objectHandle	Zeichenfolge	Gibt die Objektkennung an.
listName	Zeichenfolge	Gibt einen Listentyp-Attributnamen für das Objekt an.
numToFetch	Ganzzahl	Legt die maximale Anzahl an zurückzugebenden Zeilen fest. Kann nicht null sein. Geben Sie -1 an, um alle Zeilen zurückzugeben. Hinweis: Ungeachtet der angegebenen Ganzzahl geben die Webservices höchstens 250 Zeilen pro Aufruf zurück.
Attribute	Zeichenfolge[]	Gibt ein Array aus einem oder mehreren Attributnamen an, für die Werte abgerufen werden sollen. Namen mit Punkten sind zulässig.
getRelatedListValuesResult	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten.
numRowsFound	Integer Holder	Bezeichnet das "Integer Holder"-Objekt zum Erfassen zurückgegebener Daten.

Beschreibung

Gibt Werte für Listen zurück, die zu einem bestimmten Objekt gehören. Die Listen müssen als QREL oder BREL definiert sein. Verwenden Sie die LREL-Methoden, um LREL-Typen abzufragen.

So hat beispielsweise das Request-Objekt eine zugehörige Liste mit der Bezeichnung "children", die dessen untergeordnete Requests angibt. Bei dieser Methode handelt es sich um eine kennungsfreie Alternative zu „getRelatedList()“. Das Rückgabeformat ähnelt dem von „getListValues()“, wie im Folgenden dargestellt:

<numRowsFound>

< UDSObjectList >

<UDSObject>
<Handle>
<AttributeName0>
<AttributeName1>

Sie können Informationen für die Listenattribute eines Objekts mithilfe des Objektschemas (majic) abrufen. Alternativ kann die Methode „getObjectTypeInformation()“ verwendet werden.

Rückgabe

Diese Methode gibt Folgendes zurück:

XML-Element	Typ	Beschreibung
<getRelatedListValuesResult>	N. rel.	Gibt das äußere Element (<UDSObjectList>) an, das eine Sequenz von <UDSObject>-Elementen enthält. Jedes <UDSObject>-Element enthält ein <Handle>-Element und null oder mehr <AttributeNameX>-Elemente.
<numRowsFound>	Ganzzahl	Gibt die Gesamtzahl der Zeilen in der abgefragten Liste an. Hinweis: Die Gesamtanzahl der Zeilen entspricht nicht unbedingt der Anzahl der zurückgegebenen Zeilen.

XML-Element

Typ

Beschreibung

N. rel.

Gibt das äußere Element (<UDSObjectList>) an, das eine Sequenz von <UDSObject>-Elementen enthält. Jedes <UDSObject>-Element enthält ein <Handle>-Element und null oder mehr <AttributeNameX>-Elemente.

Ganzzahl

Gibt die Gesamtzahl der Zeilen in der abgefragten Liste an.

Hinweis: Die Gesamtanzahl der Zeilen entspricht nicht unbedingt der Anzahl der zurückgegebenen Zeilen.