getRelatedListValues

Métodos de servicios Web › Métodos de lista/consulta › getRelatedListValues

getRelatedListValues

Los siguientes parámetros se aplican al método getRelatedListValues:

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
objectHandle	Cadena	Determina el identificador de objeto.
listName	Cadena	Identifica un nombre de atributo de tipo lista para el objeto.
numToFetch	Entero	Representa el número máximo de filas que desea devolver. No puede ser cero. Especifique -1 para devolver todas las filas. Nota: Independientemente del número entero especificado, Servicios Web puede devolver un máximo de 250 filas por llamada.
atributos	Cadena[]	Identifica una matriz de uno o más nombres de atributo para los que se van a buscar valores. Se permiten nombres con puntos.
getRelatedListValuesResult	String Holder	Identifica el objeto String Holder para capturar los datos devueltos.
numRowsFound	Integer Holder	Identifica el objeto Integer Holder para capturar los datos devueltos.

Description

Devuelve valores para listas relacionadas con un objeto determinado. Las listas se deben definir como QREL o BREL. Utilice los métodos de LREL para consultar los tipos de LREL.

Por ejemplo, el objeto de solicitud tiene una lista relacionada denominada “children”, que contiene sus solicitudes secundarias. Este método es una alternativa de lista sin identificador para getRelatedList(). El formato devuelto es parecido a getListValues(), de acuerdo con lo que se indica a continuación:

<numRowsFound>

< UDSObjectList >

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

Se puede recuperar información sobre los atributos de la lista de objetos mediante el esquema de objetos (majic). Un método alternativo consiste en utilizar getObjectTypeInformation().

Resultado

Este método incluye las devoluciones siguientes:

Elemento XML	Tipo	Descripción
<getRelatedListValuesResult>	N/D	Identifica el elemento externo, <UDSObjectList>, que contiene una secuencia de elementos <UDSObject>. Cada elemento <UDSObject> contiene un elemento <Handle> y cero o más elementos <AttributeNameX>.
<numRowsFound>	Entero	Indica el número total de filas de la lista consultada. Nota: El número total de filas no necesariamente es el número de filas devueltas.

Elemento XML

Tipo

Descripción

N/D

Identifica el elemento externo, <UDSObjectList>, que contiene una secuencia de elementos <UDSObject>. Cada elemento <UDSObject> contiene un elemento <Handle> y cero o más elementos <AttributeNameX>.

Entero

Indica el número total de filas de la lista consultada.

Nota: El número total de filas no necesariamente es el número de filas devueltas.