+xns/Data
Message: Add

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


Adds an instance of a data object to an identity.

This message adds the specified data object to the identity and returns the data path of the newly added object. The 'parent' argument points to a list of objects of the same type to which the data object can be added. The 'before' argument can be specified to add the object before this object in the list.

To: Identity to whom the data object will be added.
From: Identity or exposure providing the data object to be added.


 

Input
+xns/Core/DataID Before Address of data object in list before which this object is to be added.
String ContractID Identifier of the XNS contract governing the change.
+xns/Core/XNSObject Object Data object to be added.
+xns/Core/DataID Parent Address of list of objects to which the data object is to be added.
 

Output
+xns/Core/DataID DataPath Data path of the newly added object.
 

Exceptions
BeforeNotFound Data object before which this data object is to be added cannot be found.
 

Input Detail

Before

Address of data object in list before which this object is to be added.  

DataType: +xns/Core/DataID
 


ContractID

Identifier of the XNS contract governing the change. If the data change request is originated from an XNS contract, then the from-identity is the data provider, and this element identifies the contract authorizing the provider to make this update.  

DataType: String
 


Object

Data object to be added.  

DataType: +xns/Core/XNSObject
 

Required: true
 


Parent

Address of list of objects to which the data object is to be added.  

DataType: +xns/Core/DataID
 


 

Output Detail

DataPath

Data path of the newly added object.  

DataType: +xns/Core/DataID
 


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