fromSOAP {SSOAP} | R Documentation |
Convert an XML node representing
a SOAP value to an S object.
The different functions handle different
types of SOAP objets.
This also works on an XML string or filename.
The fromSOAPArray
supports the offset
and position
attributes for partially
transmitted and sparse arrays.
Currently, there are limits on the
fromSOAP(node, root = NULL, converters = SOAPPrimitiveConverters, append = TRUE, type = NULL, findReturn = TRUE, multiRefs = list()) fromSOAPStruct(node, root = NULL, converters = SOAPPrimitiveConverters, type = NULL, multiRefs = list()) fromSOAPArray(node, type = NULL, root = NULL, converters = SOAPPrimitiveConverters, multiRefs = list(), simplify = TRUE)
node |
the XML node (and sub-nodes) giving the SOAP content.
The fromSOAP function works recursively, operating on
sub-nodes, etc. This argument is the individual node.
|
root |
the top-most node of the XML ``document''
which is used for resolving href references
within elements to other nodes.
This doesn't change across the recursive calls. |
converters |
a named-list of functions.
The names are used to find the appropriate converter
for a non-array or non-struct SOAP object.
The name comes from the value of the ``xsi:type'' attribute
or from the string ``xsd:<element name>''
where element-name is the name of the XML node.
This will become more advanced in the future.
|
append |
a logical value indicating whether to merge the converters with the default SOAPPrimitiveConverters, or use them as is. This is available for covenience so that the caller doesn't have to perform the two-step merging herself. |
type |
an optional type identifier
that if not specified is computed from the
xsi:type attribute of the XML node (node )
if available. |
findReturn |
a logical value indicating whether to recursively
descend the XML node to find the <return> element and process
that rather than working directly from node .
|
multiRefs |
? |
simplify |
a logical value that, if TRUE ,
causes fromSOAPArray to try to convert the
list of elements into a vector. It does this only if the
element type of the SOAP array is "primitive",
defined currently as being in the names of the
SOAPPrimitiveConverters list.
This is similar to the simplification step
sapply
performs after calling lapply . |
Duncan Temple Lang <duncan@wald.ucdavis.edu>
http://www.w3.org/TR/SOAP/ http://www.omegahat.org/SSOAP, http://www.omegahat.org/bugs.