+xns/Data
Message: GetListElements

+xns/Core/XNSObject
   |
   +--+xns/Core/Message
         |
         +--+xns/Data/GetListElements


Retrieves the elements of a list.

To: Identity supplying the data, either directly or via its contracts with other identities.
From: Identity requesting data.


 

Input
+xns/Core/XNSAddress Address Address of the list from which elements are to be retrieved.
Integer Depth Indicator of how deep to traverse the XML.
Boolean IncludeTypes Should the type attribute be set on returned elements?
Integer Limit The maximum number of elements from the list to be returned.
Integer Skip The number of elements to be skipped when satisfying the get list elements request.
String Type The data type of the object to be created upon message return.
 

Output
+xns/Core/ElementList Data The data returned.
 

Exceptions
DataSetTooLarge The number of elements in the list is too large to handle.
 

Input Detail

Address

Address of the list from which elements are to be retrieved.  

DataType: +xns/Core/XNSAddress
 


Depth

Indicator of how deep to traverse the XML. If depth=0, then the elements of the list, but not of contained objects, are returned. If depth=-1, then all the data, as deep as exists, are returned.  

DataType: Integer
 


IncludeTypes

Should the type attribute be set on returned elements? True=the type attribute is set on all elements returned; False=the type attribute is set on the requested elements only if their data type does not match exactly the data type rquested.  

DataType: Boolean
 


Limit

The maximum number of elements from the list to be returned.  

DataType: Integer
 


Skip

The number of elements to be skipped when satisfying the get list elements request.  

DataType: Integer
 


Type

The data type of the object to be created upon message return. This is a string in the format +xns/Core/XNSObject. If the data type is not known, a data type of +xns/Core/XNSObject can be specified; in this case, the actual data type of the derived object can be found in the 'type' attribute.  

DataType: String
 


 

Output Detail

Data

The data returned.  

DataType: +xns/Core/ElementList
 

List: true
 


Publishing Identity: +xns
© 2002 XNSORG
Last Updated: 07/09/2002