Action: GetPreviousSibling

Purpose: Returns a pointer to the previous Sibling of a specified Node. This Action is usually used after a call to the GetLastChild Action or a previous call to the GetPreviousSibling Action. If the Previous Sibling is also the First Child Node, then a further call to the GetPreviousSibling Action will return an empty response.

Action-specific name/value pairs:

Parameter Name Description
NodeOID The OID of the node whose Previous Sibling node is to be retrieved.

Alternatively, the parameters above can be incorporated into a single JSON string and specified using the parameter name JSON, eg:

{NodeOID:"1-7"}

Example Request

Action=GetPreviousSibling
&MDBAccessKeyId=[your access key id]
&NodeOID=1-7
&Signature=[computed signature]
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-06-14T13%3A19%3A41
&Version=2009-04-15
&db=mdbx

or:

Action=GetPreviousSibling
&JSON=%7BNodeOID%3A%221-7%22%7D
&MDBAccessKeyId=[your access key id]
&OutputFormat=JSON
&Signature=[computed signature]
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-06-14T13%3A19%3A41
&Version=2009-04-15
&db=mdbx

Example Response

XML

<?xml version='1.0'?>
<GetPreviousSiblingResponse xmlns="http://mdbx.mgateway.com/doc/2009-06-05/">
   <GetPreviousSiblingResult>
      <NodeOID>
         1-8
      </NodeOID>
      <NodeType>
         1
      </NodeType>
      <TagName>
         test
      </TagName>
   </GetPreviousSiblingResult>
</GetPreviousSiblingResponse>

Note that this Action also retrieves the NodeType of the PreviousSibling node, and its TagName if the PreviousSibling Node is an Element.

If no Previous Sibling node exists, the response will be as follows:

<?xml version='1.0'?>
<GetPreviousSiblingResponse xmlns="http://mdbx.mgateway.com/doc/2009-06-05/">
   <GetPreviousSiblingResult />
</GetPreviousSiblingResponse>

JSON (ie if OutputFormat=JSON specified in the Request)

{NodeOID:"1-8",NodeType:1,TagName:"test"}

Note that this Action also retrieves the NodeType of the PreviousSibling node, and its TagName if the PreviousSibling Node is an Element.

If no Previous Sibling node exists, the response will be as follows:

{NodeOID:""}