Metodi dei servizi Web › Metodi elenco/query › getRelatedListValues

Argomento precedente: getRelatedList

Argomento successivo: getPendingChangeTaskListForContact

getRelatedListValues

I parametri seguenti sono validi per il metodo getRelatedListValues:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

objectHandle

Stringa

Identifica l'handle dell'oggetto.

listName

Stringa

Identifica un nome di attributo di tipo elenco per l'oggetto.

numToFetch

Numero intero

Determina il numero massimo di righe da restituire.

  • Questo valore non può essere zero
  • Specificare -1 per la restituzione di tutte le righe

Nota: indipendentemente dal numero intero specificato, i servizi Web possono restituire un massimo di 250 righe per chiamata.

attributi

String[]

Identifica un array di uno o più nomi di attributo per cui caricare i valori. I nomi puntati sono ammessi.

getRelatedListValuesResult

String Holder

Identifica l'oggetto String Holder per la cattura dei dati restituiti.

numRowsFound

Integer Holder

Identifica l'oggetto Integer Holder per la cattura dei dati restituiti.

Descrizione

Restituisce i valori per gli elenchi correlati a un oggetto specifico. Gli elenchi devono essere definiti come QREL o BREL. Utilizzare i metodi LREL per eseguire query sugli elenchi di tipo LREL.

Ad esempio, per l'oggetto Richiesta è presente un elenco correlato denominato "figlio", ovvero un elenco delle relative richieste figlio. Questo metodo è un elenco senza handle alternativo al metodo getRelatedList(). Il formato restituito è simile a quello del metodo getListValues(), come indicato dall'esempio seguente:

<numRowsFound>

< UDSObjectList >

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

È possibile recuperare informazioni per gli attributi di elenco di un oggetto mediante lo schema dell'oggetto (majic). In alternativa è possibile utilizzare il metodo getObjectTypeInformation().

Valore restituito

Questo metodo restituisce quanto segue:

Elemento XML

Tipo

Descrizione

<getRelatedListValuesResult>

N/D

Identifica l'elemento esterno, <UDSObjectList>, che contiene una sequenza di elementi <UDSObject>. Ogni elemento <UDSObject> contiene un elemento <Handle> e zero o più elementi <AttributeNameX>.

<numRowsFound>

Numero intero

Indica il numero totale di righe presenti nell'elenco sottoposto a query.

Nota: il numero totale di righe non è necessariamente il numero di righe restituite.